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á. # Usar o comando `register` **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. Para registrar uma instância, verifique se você está executando pelo menos a versão 1.16.180 da AWS CLI. Veja a seguir a sintaxe geral do comando `register`. ``` aws opsworks register \ [--profile profile_name] \ [--region region_name] \ --infrastructure-class instance_type \ --stack-id stack ID \ [--local] | [--ssh-private-key key_file --ssh-username username] | [--override-ssh command_string] \ [--override-hostname hostname] \ [--debug] \ [--override-public-ip public IP] \ [--override-private-ip private IP] \ ..[--use-instance-profile] \ [ [IP address] | [hostname] | [instance ID] ``` Os argumentos a seguir são comuns a todos os AWS CLI comandos. **`--profile`** (Opcional) O nome do perfil de credencial. Se você omitir esse argumento, o comando será executado com as credenciais padrão. Para obter mais informações sobre como o AWS CLI determina as credenciais padrão, consulte [Configurando a interface de linha de comando da AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html). **`--region`** (Opcional) A região do endpoint do serviço OpsWorks Stacks. Não `--region` defina para a região da pilha. OpsWorks As pilhas determinam automaticamente a região da pilha a partir do ID da pilha. Se a região padrão já estiver definida, é possível omitir esse argumento. Para obter mais informações sobre como especificar uma região padrão, consulte [Configurar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html). Use os argumentos a seguir para instâncias da Amazon EC2 e locais. **`--infrastructure-class`** (Obrigatório) Esse parâmetro deve ser definido como `ec2` ou`on-premises`, para indicar se você está registrando uma instância Amazon EC2 ou local, respectivamente. **`--stack-id`** (Obrigatório) O ID da pilha com a qual a instância será registrada. Para encontrar o ID de uma pilha, na página **Stack**, escolha **Settings (Configurações)**. O ID da pilha é rotulado como **OpsWorks ID** e é um GUID parecido com. `ad21bce6-7623-47f1-bf9d-af2affad8907` **Argumentos de login de SSH** Use os seguintes argumentos para especificar como `register` deve efetuar o login na instância. **`--local`** (Opcional) Use este argumento para registrar a instância na qual você executa o comando. Neste caso, `register` não precisa fazer login na instância. **`--ssh-private-key` e `--ssh-username`** (Opcional) Use esses argumentos se você estiver registrando a instância de uma estação de trabalho separada e deseja especificar explicitamente o nome de usuário ou o arquivo de chave privada. + `--ssh-username`: use esse argumento para especificar um nome de usuário de SSH. Se você omitir `--ssh-username`, `ssh` usa o nome do usuário padrão. + `--ssh-private-key`: use esse argumento para especificar explicitamente um arquivo de chave privada. Se você omitir `--ssh-private-key`, `ssh` tentará fazer login utilizando técnicas de autenticação que não exigem uma senha, incluindo o uso da chave privada. Se não houver suporte para nenhuma dessas técnicas, o `ssh` faz a consulta pela senha. Para obter mais informações sobre como o `ssh` processa a autenticação, consulte [O protocolo de autenticação de Secure Shell (SSH)](https://www.ietf.org/rfc/rfc4252.txt). **`--override-ssh`** (Opcional) Use esse argumento se você estiver registrando a instância de uma estação de trabalho separada e deseja especificar uma string de comando [http://linux.about.com/od/commands/l/blcmdl1_ssh.htm](http://linux.about.com/od/commands/l/blcmdl1_ssh.htm) personalizada. O comando `register` usa essa string de comando para fazer login na instância registrada. Para obter mais informações sobre `ssh`, consulte [SSH](http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man1/slogin.1). **`--override-hostname`** (Opcional) Especifica um nome de host para a instância, que é usado somente pelo OpsWorks Stacks. O valor padrão é o nome do host da instância. **`--debug`** (Opcional) Fornece informações de depuração se houver falha no processo de registro. Para obter informações sobre a solução de problemas, consulte [Solução de problemas do registro da instância](common-issues.md#common-issues-instance-registration). **`--use-instance-profile`** (Opcional, mas altamente recomendado para EC2 instâncias da Amazon) Permite que o `register` comando use um perfil de instância anexado, em vez de criar um usuário do IAM. Adicionar este parâmetro pode ajudar a evitar erros que ocorrem se você tentar gerenciar uma instância registrada quando o usuário do IAM é excluído acidentalmente. 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 necessário. **Destino** (Condicional) Se você executar esse comando a partir de uma estação de trabalho, o valor final na string de comando especifica o destino de registro em uma das seguintes formas. + O endereço IP público da instância. + O nome de host da instância. + Para EC2 instâncias da Amazon, o ID da instância. OpsWorks O Stacks usa o ID da instância para obter a configuração da instância, incluindo o endereço IP público da instância. Por padrão, o OpsWorks Stacks usa esse endereço para criar a cadeia de `ssh` comando usada para fazer login na instância. Se for necessário conectar a um endereço IP privado, é necessário usar `--override-ssh` para fornecer uma string de comando personalizada. Para ver um exemplo, consulte [Registrar uma instância on-premises a partir de uma estação de trabalho](registered-instances-register-registering-examples.md#registered-instances-register-registering-examples-workstation-onprem). Se você especificar um nome de host, `ssh` depende do servidor DNS para resolver o nome para uma instância específica. Caso não tenha certeza se o nome do host é exclusivo, use `ssh` para verificar se o nome do host é resolvido de acordo com a instância correta. Se você executar esse comando a partir da instância que será registrada, omita o identificador da instância e use o argumento `--local`. Os seguintes argumentos são apenas para instâncias on-premises. **`--override-public-ip`** (Opcional) O OpsWorks Stacks exibe o endereço especificado como o endereço IP público da instância. Ele não altera o endereço IP público da instância. No entanto, se um usuário usa o console para se conectar à instância, por exemplo, escolhendo o endereço na página **Instâncias**, o OpsWorks Stacks usa o endereço especificado. OpsWorks As pilhas determinam automaticamente o valor padrão do argumento. **`--override-private-ip`** (Opcional) O OpsWorks Stacks exibe o endereço especificado como o endereço IP privado da instância. Isso não altera o endereço IP privado da instância. OpsWorks As pilhas determinam automaticamente o valor padrão do argumento.