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 ou por meio do Premium AWS 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 AWS CLI determina as credenciais padrão, consulte Configurando a interface de linha de comando da AWS.

--region

(Opcional) A região do endpoint do serviço AWS OpsWorks Stacks. Não --region defina para a região da pilha. AWS OpsWorks As pilhas determinam automaticamente a região da pilha a partir do ID da pilha.

nota

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.

Use os seguintes argumentos para instâncias Amazon EC2 e on-premises.

--infrastructure-class

(Obrigatório) Este parâmetro deve ser definido como ec2 ou on-premises para indicar se você está registrando uma instância Amazon EC2 ou on-premises, respectivamente.

--stack-id

(Obrigatório) O ID da pilha com a qual a instância será registrada.

nota

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).

--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 ssh 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.

--override-hostname

(Opcional) Especifica um nome de host para a instância, que é usado somente pelo AWS 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.

--use-instance-profile

(Opcional, mas altamente recomendado para instâncias Amazon EC2) Permite que o comando register 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.

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 AWS 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 AWS 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 ID da instância Amazon EC2, o ID da instância.

  AWS 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 AWS 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.

nota

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 AWS 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 AWS OpsWorks Stacks usa o endereço especificado. AWS OpsWorks As pilhas determinam automaticamente o valor padrão do argumento.

--override-private-ip

(Opcional) O AWS 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. AWS OpsWorks As pilhas determinam automaticamente o valor padrão do argumento.