As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Etapa 1: criar o livro de receitas
<a name="gettingstarted-cookbooks-create-cookbook"></a>

**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](https://repost.aws/) ou por meio do Premium [AWS Support](https://aws.amazon.com/support).

Comece criando um livro de receitas. Esse livro de receitas não fará muito para começar, mas servirá como base para o restante desta demonstração.

**nota**  
Esta etapa mostra como criar um livro de receitas manualmente. Você pode criar um livro de receitas em menos tempo com o kit de desenvolvimento Chef ([Chef DK](https://docs.chef.io/#chef-dk-title)), executando o comando [https://docs.chef.io/ctl_chef.html#chef-generate-cookbook](https://docs.chef.io/ctl_chef.html#chef-generate-cookbook) na sua estação de trabalho local. Contudo, este comando cria várias pastas e arquivos desnecessários para esta demonstração.

**Para criar o livro de receitas**

1. Na estação de trabalho local, crie um diretório chamado `opsworks_cookbook_demo`. É possível usar um nome diferente, mas substitua-o por `opsworks_cookbook_demo` durante esta demonstração.

1. No diretório `opsworks_cookbook_demo`, crie um arquivo chamado `metadata.rb` usando um editor de texto. Adicione o código a seguir para especificar o nome do livro de receitas. Para obter mais informações sobre `metadata.rb`, consulte [metadata.rb](https://docs.chef.io/config_rb_metadata.html) no site do Chef.

   ```
   name "opsworks_cookbook_demo"
   ```

1. No diretório `opsworks_cookbook_demo`, crie um subdiretório chamado `recipes`. Nesse subdiretório estarão todas as receitas que você criar para esse livro de receitas de demonstração.

1. No diretório `recipes`, crie um arquivo chamado `default.rb`. Esse arquivo contém uma receita com o mesmo nome do arquivo, mas sem a extensão de arquivo: `default`. Adicione a seguinte linha única de código para o arquivo `default.rb`. Esse código é uma receita de linha única que exibe uma mensagem simples no registro quando a receita executa:

   ```
   Chef::Log.info("********** Hello, World! **********")
   ```

1. No terminal ou no prompt de comando, use o comando **tar** para criar um arquivo chamado `opsworks_cookbook_demo.tar.gz`, que contém o diretório `opsworks_cookbook_demo` e o conteúdo nele inserido. Por exemplo:

   ```
   tar -czvf opsworks_cookbook_demo.tar.gz opsworks_cookbook_demo/
   ```

   É possível usar um nome de arquivo diferente, mas substitua-o por `opsworks_cookbook_demo.tar.gz` durante esta demonstração.
**nota**  
Ao criar o arquivo `tar` no Windows, o diretório principal deve ser o diretório pai do livro de receitas. Esta demonstração foi testada no Linux com o comando **tar** fornecido pelo pacote `tar`, e no Windows com o comando **tar** fornecido pelo [Git Bash](https://git-for-windows.github.io/). É possível que algo dê errado se outros comandos ou programas forem usados para criar um arquivo compactado TAR (.tar.gz).

1. Crie um bucket do S3 ou use um bucket existente. Para obter mais informações, acesse [Criar um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html).

1. Faça upload do arquivo `opsworks_cookbook_demo.tar.gz` no bucket do S3. Para obter mais informações, consulte [Adicionar um objeto a um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PuttingAnObjectInABucket.html).

Agora você tem um livro de receitas que será usado durante a demonstração.

Na [próxima etapa](gettingstarted-cookbooks-create-stack.md), você cria uma pilha de OpsWorks pilhas que usará posteriormente para carregar seu livro de receitas e executar as receitas do livro de receitas.