Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Estructura de las recetas

Un libro de recetas es principalmente un conjunto de recetas que puede realizar una amplia variedad de tareas en una instancia. Para ver claramente cómo se implementan las recetas, utilizaremos un ejemplo sencillo. La siguiente es la receta de configuración para la HAProxycapa integrada. En este punto, solo tiene que fijarse en la estructura general; no se preocupe demasiado por los detalles, los trataremos en ejemplos posteriores.

package 'haproxy' do
  action :install
end

if platform?('debian','ubuntu')
  template '/etc/default/haproxy' do
    source 'haproxy-default.erb'
    owner 'root'
    group 'root'
    mode 0644
  end
end

include_recipe 'haproxy::service'

service 'haproxy' do
  action [:enable, :start]
end

template '/etc/haproxy/haproxy.cfg' do
  source 'haproxy.cfg.erb'
  owner 'root'
  group 'root'
  mode 0644
  notifies :restart, "service[haproxy]"
end

En el ejemplo siguiente se resaltan los principales elementos de las recetas, que se describen en las secciones posteriores.

Recursos

Las recetas son principalmente un conjunto de recursos de Chef. Cada uno especifica un aspecto determinado del estado final de la instancia, como un paquete que debe instalarse o un servicio que debe iniciarse. El ejemplo tiene cuatro recursos:

Los recursos permiten especificar el estado de la instancia de una forma declarativa. En segundo plano, cada recurso tiene asociado un proveedor que se encarga de realizar las tareas necesarias, como, por ejemplo, instalar paquetes, crear y configurar directorios, iniciar servicios, etc. Si los detalles de la tarea dependen de un sistema operativo determinado, el recurso dispone de varios proveedores y utiliza el más adecuado para el sistema. Por ejemplo, en un sistema Red Hat Linux, el proveedor de package utiliza yum para instalar paquetes. En un sistema Ubuntu Linux, el proveedor de package utiliza apt-get.

Puede implementar un recurso como un bloque de código Ruby con el formato general siguiente.

resource_type "resource_name" do
  attribute1 'value1'
  attribute2 'value2'
  ...
  action :action_name
  notifies : action 'resource'
end

Los elementos son:

En ocasiones, los recursos dependen del sistema operativo.

Par obtener descripciones de recursos estándar, como los atributos, acciones y notificaciones disponibles para cada recurso, consulte la sección de información sobre recursos y proveedores.

Control del flujo

Dado que las recetas son aplicaciones Ruby, puede utilizar las estructuras de control de Ruby para incorporar un control de flujo en la receta. Por ejemplo, puede utilizar la lógica condicional de Ruby para que la receta se comporte de forma distinta según el sistema. La HAProxy receta incluye un if bloque que usa un template recurso para crear un archivo de configuración, pero solo si la receta se ejecuta en un sistema Debian o Ubuntu.

Otro escenario habitual suele producirse cuando se usa un bucle para ejecutar un recurso varias veces con diferentes valores de atributo. Por ejemplo, puede crear un conjunto de directorios utilizando un bucle para ejecutar un recurso directory varias veces con nombres de directorio diferentes.

Recetas incluidas

include_recipe incluye otras recetas en el código, lo que le permite modularizar las recetas y volver a utilizar el mismo código en varias recetas. Cuando ejecuta la receta host, Chef sustituye cada elemento include_recipe por el código de la receta especificada antes de ejecutar la receta host. Las recetas incluidas se identifican con la sintaxis cookbook_name::recipe_name de Chef estándar, donde recipe_name omite la extensión .rb. El ejemplo incluye una recetahaproxy::service, que representa el HAProxy servicio.