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á. # Instalação de livros de receitas personalizados **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). Para fazer com que uma pilha instale e use livros de receitas personalizados, você deve configurar a pilha para permitir os livros de receitas personalizados, se isso ainda não estiver configurado. Você deve fornecer o URL do repositório e quaisquer informações relacionadas, como uma senha. **Importante** Depois de configurar a pilha para oferecer suporte a livros de receitas personalizados, o OpsWorks Stacks instala automaticamente seus livros de receitas em todas as novas instâncias na inicialização. No entanto, você deve orientar explicitamente o OpsWorks Stacks a instalar livros de receitas novos ou atualizados em qualquer instância existente executando o comando [**Atualizar pilha de livros de receitas personalizados**](workingstacks-commands.md). Para obter mais informações, consulte [Atualizar livros de receitas personalizadas](workingcookbook-installingcustom-enable-update.md). Antes de permitir **Use custom Chef cookbooks (Usar livros de receitas do Chef personalizados)** na sua pilha, certifique-se de que os livros de receitas personalizados e de comunidade que você executa têm suporte para a versão do Chef que sua pilha utiliza. **Para configurar uma pilha para livros de receitas personalizados** 1. Na página da pilha, clique em **Stack Settings** para exibir a página **Settings**. Clique em **Edit** para editar as configurações. 1. Alterne **Use custom Chef cookbooks** para **Yes**. ![\[Edição da página de configurações de pilha\]](http://docs.aws.amazon.com/pt_br/opsworks/latest/userguide/images/stack_settings_edit.png) 1. Configuração dos livros de receitas. Quando terminar, clique em **Save** para salvar a pilha atualizada. ## Especificação de um repositório de livro de receitas personalizado As pilhas do Linux podem instalar livros de receitas personalizados de qualquer um dos seguintes tipos de repositório: + Arquivos HTTP ou Amazon S3. Eles podem ser públicos ou privados, mas o Amazon S3 costuma ser a opção preferida para um arquivo privado. + Os repositórios Git e Subversion fornecem controle de origem e a capacidade de ter várias versões. As pilhas do Windows podem instalar livros de receitas personalizados de arquivos do Amazon S3 e de repositórios Git. Todos os tipos de repositório têm os seguintes campos obrigatórios. + **Tipo de repositório**: o tipo de repositório + **URL de repositório**: o URL do repositório OpsWorks O Stacks oferece suporte a sites de repositórios Git hospedados publicamente, como o Bitbucket, [GitHub](https://github.com/)bem como a [servidores](https://bitbucket.org) Git hospedados de forma privada. Para os repositórios Git, você deve usar um dos seguintes formatos de URL, dependendo se o repositório é público ou privado. Siga as mesmas diretrizes de URL para os submódulos do Git. Para um repositório público Git, use os protocolos HTTPS ou somente leitura do Git: + Somente leitura do Git: `git://github.com/amazonwebservices/opsworks-example-cookbooks.git`. + HTTPS: `https://github.com/amazonwebservices/opsworks-example-cookbooks.git`. Para um repositório Git privado, você deve usar o read/write formato SSH, conforme mostrado nos exemplos a seguir: + Repositórios Github: `git@github.com:project/repository`. + Repositórios em um servidor Git: `user@server:project/repository` As configurações restantes variam de acordo com o tipo de repositório e estão descritas nas seções a seguir. ### Arquivo HTTP Selecionar **Http Archive** para **Repository type** exibe duas configurações adicionais, que você deve completar se o arquivo for protegido por senha. + **Nome de usuário**: seu nome de usuário + **Senha**: sua senha ### Arquivo do Amazon S3 Selecionar **S3 Archive (Arquivamento do S3)** para **Repository type (Tipo de repositório)** exibe as seguintes configurações adicionais e opcionais. OpsWorks As pilhas podem acessar seu repositório usando as EC2 funções da Amazon (autenticação do gerenciador do sistema operacional do host), independentemente de você usar a API do OpsWorks Stacks ou o console. + **ID da chave de acesso** — uma ID da chave de acesso da AWS, comoAKIAIOSFODNN7EXAMPLE. + **Chave de acesso secreta** — A chave de acesso secreta correspondente da AWS, comowJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY. ### Repositório Git Ao selecionar **Git** em **Source Control**, estas configurações opcionais adicionais são exibidas: **Chave SSH de repositório** Você deve especificar uma chave SSH de implantação para acessar os repositórios Git privados. Para submódulos do Git, a chave especificada deve ter acesso a esses submódulos. Para obter mais informações, consulte [Utilização de chaves SSH de repositório Git](workingapps-deploykeys.md). A chave SSH de implantação não pode exigir uma senha; o OpsWorks Stacks não tem como passá-la. **Ramificação/Revisão** Se o repositório tiver várias ramificações, o OpsWorks Stacks baixa a ramificação master por padrão. Para especificar uma ramificação específica, insira o nome da ramificação, o SHA1 hash ou o nome da tag. Para especificar uma determinada confirmação, insira o ID completo de confirmação com 40 dígitos hexadecimais. ### Repositório Subversion Ao selecionar **Subversion** em **Source Control**, estas configurações adicionais são exibidas: + **Nome de usuário**: seu nome de usuário, para repositórios privados. + **Senha**: sua senha, para repositórios privados. + **Revisão**: [opcional] o nome da revisão, se você tiver várias revisões. Para especificar uma ramificação ou uma tag, você deve modificar o URL do repositório, por exemplo: **http://repository\$1domain/repos/myapp/branches/my-apps-branch** ou **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag**.