Fórmulas

Importante

O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no AWS re:POST ou por meio do Premium AWS Support.

Receitas são aplicações Ruby que definem a configuração de um sistema. Elas instalam pacotes, criam arquivos de configuração a partir de modelos, executam comandos de shell, criam arquivos e diretórios, e assim por diante. Normalmente, você faz com que AWS OpsWorks as pilhas executem receitas automaticamente quando um evento de ciclo de vida ocorre na instância, mas você também pode executá-las explicitamente a qualquer momento usando o comando Execute Recipes stack. Para obter mais informações, consulte Sobre receitas.

Uma receita geralmente consiste em grande parte de uma série de recursos, cada um dos quais representa o estado desejado de um aspecto do sistema. Cada recurso inclui um conjunto de atributos que define o estado desejado e especifica qual ação deve ser executada. O Chef associa cada recurso a um provedor apropriado que executa a ação. Para obter mais informações, consulte Referência de recursos e provedores.

Um recurso package ajuda a gerenciar pacotes de software em instâncias do Linux. O exemplo a seguir instala o pacote do Apache.

...
package 'apache2' do
  case node[:platform]
  when 'centos','redhat','fedora','amazon'
    package_name 'httpd'
  when 'debian','ubuntu'
    package_name 'apache2'
  end
  action :install
end
...

O Chef usa o provedor de pacote apropriado para a plataforma. Muitas vezes, um valor é atribuído aos recursos de atributo, mas é possível usar as operações lógicas de Ruby para executar atribuições condicionais. O exemplo mostra um operador case que utiliza node[:platform] para identificar a instância do sistema operacional e define o atributo package_name apropriadamente. Os atributos podem ser inseridos em uma receita, usando a sintaxe do nó padrão do Chef e o Chef a substitui com o valor associado. Além dos atributos de receita, qualquer atributo pode ser utilizado no nó do objeto.

Após determinar o nome do pacote, o segmento de código termina com uma ação install que instala o pacote. Outras ações para este recurso incluem upgrade e remove. Para obter mais informações, consulte: pacote.

Muitas vezes é útil separar tarefas complexas de instalação e configuração em uma ou mais subtarefas, cada uma implementada como uma receita separada para executar sua receita primária no momento apropriado. O exemplo a seguir mostra a linha de código que segue o exemplo anterior:

include_recipe 'apache2::service'

Para que uma receita execute uma receita criança, use a palavra-chave include_recipe seguida pelo nome da receita. As receitas são identificadas através da utilização da sintaxe padrão do Chef CookbookName::RecipeName, em que RecipeName omite a extensão .rb.

nota

Uma declaração include_recipe executa efetivamente a receita nessa etapa na receita principal. No entanto, o que de fato acontece é que o Chef substitui cada declaração include_recipe com o código especificado da receita, antes que ele execute a receita principal.

Um recurso directory representa um diretório, como aquele que contém os arquivos do pacote. O seguinte recurso default.rb cria um diretório de log do Linux.

directory node[:apache][:log_dir] do
    mode 0755
    action :create
end

O diretório de log é definido em um dos arquivos de atributo de receitas. O recurso especifica o modo do diretório como 0755, e usa uma ação create para criar o diretório. Para obter mais informações, consulte diretório. Esse recurso também pode ser usado com instâncias do Windows.

O recurso execute representa comandos, tais como comandos de shell ou scripts. O exemplo a seguir gera arquivos de module.load.

execute 'generate-module-list' do
  if node[:kernel][:machine] == 'x86_64'
    libdir = 'lib64'
  else
    libdir = 'lib'
  end
  command "/usr/local/bin/apache2_module_conf_generate.pl /usr/#{libdir}/httpd/modules /etc/httpd/mods-available"
  action :run
end

O primeiro recurso determina o tipo de CPU. [:kernel][:machine] é outro atributo automático que o Chef gera para representar diversas propriedades do sistema, nesse caso, o tipo de CPU. Em seguida, ele especifica o comando, um script Perl e usa uma ação run para executar o script, o que gera arquivos de module.load. Para obter mais informações, consulte execute.

Um recurso template representa um arquivo, normalmente um arquivo de configuração, que deve ser gerado a partir de um dos arquivos de modelo do livro de receitas. O exemplo a seguir cria um arquivo de configuração httpd.conf a partir do modelo apache2.conf.erb, discutido em Modelos.

template 'apache2.conf' do
  case node[:platform]
  when 'centos','redhat','fedora','amazon'
    path "#{node[:apache][:dir]}/conf/httpd.conf"
  when 'debian','ubuntu'
    path "#{node[:apache][:dir]}/apache2.conf"
  end
  source 'apache2.conf.erb'
  owner 'root'
  group 'root'
  mode 0644
  notifies :restart, resources(:service => 'apache2')
end

O recurso determina o nome e a localização do arquivo gerado, baseando-se na instância do sistema operacional. Em seguida, ele especifica apache2.conf.erb como o modelo a ser usado para gerar o arquivo e define o proprietário do arquivo, o grupo, e o modo. Ele executa a ação notify para notificar o recurso service que representa o servidor Apache para reiniciar o servidor. Para obter mais informações, consulte modelo.