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á. # Registrar a instância **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). **nota** Este recurso é suportado somente para pilhas do Linux. Você registra uma instância ao executar o comando AWS CLI `register` a partir da estação de trabalho ou da instância. A maneira mais simples de processar a operação é usar o assistente de registro do [console do OpsWorks Stacks](https://console.aws.amazon.com/opsworks/), que simplifica o processo de construção da string de comando. Depois que estiver familiarizado com o procedimento de registro, você poderá ignorar o assistente se preferir e executar o comando `register`. Veja a seguir como usar o assistente de registro para registrar uma instância com uma pilha existente. **nota** Para registrar uma instância com uma nova pilha, você pode fazer isso escolhendo **Registrar instâncias** no painel de OpsWorks pilhas. Isso inicia um assistente idêntico a das pilhas existentes, exceto pela página adicional que configura a nova pilha. **Para usar o assistente de registro e registrar uma instância** 1. No [console do OpsWorks Stacks](https://console.aws.amazon.com/opsworks/), crie uma pilha ou abra uma existente. 1. Escolha **Instances** no painel de navegação e, em seguida, **register an instance**. 1. Na página **Choose an Instance Type**, especifique se você deseja registrar uma Amazon EC2 ou uma instância local: + Se você estiver registrando uma EC2 instância da Amazon, escolha **Avançar: Selecionar instâncias**. + Se você estiver registrando uma instância on-premises, selecione **Próximo: instalar CLI da AWS** e vá para a Etapa 5. 1. Se você estiver registrando uma EC2 instância da Amazon, abra a página **Selecionar instâncias** para selecionar a instância a ser registrada. OpsWorks O Stacks coleta as informações necessárias para criar o comando. Quando terminar, escolha **Next:Install AWS CLI (Próximo: Instalar a CLI da AWS)**. 1. A instância na qual você planeja executar `register` deve estar executando a versão 1.16.180 AWS CLI ou mais recente. Para instalar ou atualizar a AWS CLI, a página do assistente de instalação fornece links para instruções de instalação e configuração. Depois de verificar a instalação da AWS CLI , especifique se você está executando o comando na instância a ser registrada ou em uma estação de trabalho separada e depois escolha **Next: Register Instances (Próximo: Registrar instâncias)**. 1. A página **Register Instances (Registrar instâncias)** exibe um modelo para uma string de comando `register` que incorpora as opções selecionadas. Por exemplo, se você estiver registrando uma EC2 instância da Amazon em uma estação de trabalho separada, o modelo padrão se assemelha ao seguinte. ``` aws opsworks register --infrastructure-class ec2 --region us-west-2 --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username [username] i-f1245d10 ``` **Importante** O usuário do IAM; criado durante o processo de registro é necessário durante a vida de uma instância registrada. A exclusão do usuário faz com que o agente do OpsWorks Stacks não consiga se comunicar com o serviço. Para ajudar a evitar problemas de gerenciamento de instâncias registrada caso o usuário do seja excluído, adicione o parâmetro `--use-instance-profile` ao comando `register` para usar o perfil de instância interno da instância. A adição do `--use-instance-profile` parâmetro também evita que ocorram erros ao alternar as chaves de acesso da AWS conta a cada 90 dias (uma prática recomendada), pois evita incompatibilidades entre as chaves de acesso disponíveis para o OpsWorks agente e o usuário do IAM necessário. Se você definir **Eu uso chaves SSH** como **Sim**, o OpsWorks Stacks adiciona o `--ssh-private-key` argumento à string, que você pode usar para especificar um arquivo de chave SSH privado. **nota** Se você quiser `register` fazer login com uma senha, defina **Eu uso chaves SSH** como **Não**. Ao executar `register`, a senha será solicitada. Copie essa string em um editor de texto e edite-o conforme necessário. Observe o seguinte. + O texto entre parênteses representa informações que você deve fornecer, como a localização do arquivo chave de SSH. + O modelo presume que você esteja executando o `register` com as credenciais padrão da AWS. Caso contrário, adicione um argumento `--profile` à string de comando e especifique o nome do perfil da credencial que você deseja usar. Para outros cenários, pode ser necessário alterar o comando ainda mais. Para obter uma explicação sobre os argumentos `register` disponíveis e formas alternativas de construir a string de comando, consulte [Usar o comando `register`](registered-instances-register-registering-command.md). Você também pode exibir a documentação do comando ao executar `aws opsworks help register` na linha de comando. Para obter alguns exemplos de strings de comando, consulte [Exemplos de comandos de registro](registered-instances-register-registering-examples.md). 1. Depois de terminar de editar a string de comando, abra uma janela no terminal na estação de trabalho ou use o SSH para fazer login na instância e executar o comando. A operação inteira demora em geral cinco minutos, durante os quais a instância fica no estado **Registering**. 1. Quando a operação é concluída, selecione **Done**. Agora, a instância está com o estado **Registered** e aparece listada como uma instância não atribuída na página **Instances** da pilha. O comando `register` faz o seguinte. 1. Se `register` estiver funcionando em uma estação de trabalho, o comando primeiro usa SSH para fazer login na instância que será registrada. O restante do processo ocorre na instância e é o mesmo independentemente de onde o comando é executado. 1. Faz o download do pacote do agente OpsWorks Stacks do Amazon S3. 1. Desempacota e instala o agente e suas dependências, como o [AWS SDK para Ruby](https://aws.amazon.com/documentation/sdk-for-ruby/). 1. Cria o seguinte: + Um usuário do IAM que inicializa o agente com o serviço OpsWorks Stacks para fornecer comunicação segura. As permissões do usuário permitem somente a ação `opsworks:RegisterInstance` e expiram após 15 minutos. + Um grupo do IAM da pilha, que contém os usuários das instâncias registradas. 1. Cria um par de chaves RSA e envia a chave pública para o OpsWorks Stacks. Este par de chaves é usado para criptografar as comunicações entre o agente e o OpsWorks Stacks. 1. Registra a instância com OpsWorks Stacks. Em seguida, a pilha executa um conjunto de receitas de instalação inicial para configurar a instância, que inclui o seguinte. + Substituir o arquivo de hosts da instância. Ao registrar a instância, você transferiu o gerenciamento de usuários para o OpsWorks Stacks, que deve ter seu próprio arquivo de hosts para controlar as permissões de login SSH. + Para EC2 instâncias da Amazon, a configuração inicial também inclui o registro de todos os volumes anexados do Amazon EBS ou endereços IP elásticos com a pilha. Você deve garantir que os volumes do Amazon EBS não são montados em pontos de montagem reservados, incluindo `/var/www` e qualquer ponto de montagem reservado pelas camadas da instância. Para obter mais informações sobre o gerenciamento de recursos da pilha, consulte [Gerenciamento de recursos](resources.md). Para obter mais informações sobre pontos de montagem de camada, consulte [OpsWorks Referência de camadas de pilhas](layers.md). Para obter uma descrição completa das alterações da configuração inicial, consulte [Alterações de configuração inicial](registered-instances-lifecycle.md#registered-instances-lifecycle-setup-config). **nota** A configuração inicial não atualiza o sistema operacional de uma instância registrada; você deve processar essa tarefa por conta própria. Para obter mais informações, consulte [Gerenciamento de atualizações de segurança](workingsecurity-updates.md).