Utilisation de la commande register

Important

Le AWS OpsWorks Stacks service a atteint sa fin de vie le 26 mai 2024 et a été désactivé tant pour les nouveaux clients que pour les clients existants. Nous recommandons vivement aux clients de migrer leurs charges de travail vers d'autres solutions dès que possible. Si vous avez des questions sur la migration, contactez l' AWS Support équipe sur AWS Re:Post ou via le AWS Support Premium.

Note

Cette fonctionnalité est prise en charge uniquement pour les piles Linux.

Pour enregistrer une instance, assurez-vous que vous exécutez au moins la version 1.16.180 de AWS CLI. Ce qui suit montre la syntaxe générale de la commande 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]

Les arguments suivants sont communs à toutes les AWS CLI commandes.

--profile

(Facultatif) Nom de profil des informations d'identification. Si vous omettez cet argument, la commande s'exécute avec vos informations d'identification par défaut. Pour plus d'informations sur la façon dont les AWS CLI informations d'identification par défaut sont déterminées, consultez Configuration de l'interface de ligne de commande AWS.

--region

(Facultatif) Région du point de terminaison du service AWS OpsWorks Stacks. Ne définissez pas --region la région de la pile. AWS OpsWorks Stacks détermine automatiquement la région de la pile à partir de l'ID de la pile.

Note

Si votre région par défaut est déjà définie, vous pouvez omettre cet argument. Pour plus d'informations sur la manière de spécifier une région par défaut, consultez Configuration de l'interface de ligne de commande AWS.

Utilisez les arguments suivants pour les instances Amazon EC2 et sur site.

--infrastructure-class

(Obligatoire) Ce paramètre doit être défini sur ec2 ou on-premises pour indiquer si vous enregistrez une instance Amazon EC2 ou sur site, respectivement.

--stack-id

(Obligatoire) ID de la pile auprès de laquelle l'instance doit être enregistrée.

Note

Pour trouver un ID de pile, sur la page Pile, choisissez Paramètres. L'ID de pile est étiqueté OpsWorks ID. Il s'agit d'un GUID qui ressemble à quelque chose commead21bce6-7623-47f1-bf9d-af2affad8907.

Arguments de connexion SSH

Utilisez les arguments suivants pour spécifier comment register doit se connecter à l'instance.

--local

(Facultatif) Utilisez cet argument pour enregistrer l'instance sur laquelle vous exécutez la commande.

Dans ce cas, register n'a pas besoin de se connecter à l'instance.

--ssh-private-key et --ssh-username

(Facultatif) Utilisez ces arguments si vous enregistrez l'instance à partir d'une station de travail distincte et que vous voulez spécifier explicitement le nom d'utilisateur ou le fichier de clé privée.

• --ssh-username— Utilisez cet argument pour spécifier un nom d'utilisateur SSH.

  Si vous omettez --ssh-username, ssh utilise le nom d'utilisateur par défaut.

• --ssh-private-key— Utilisez cet argument pour spécifier explicitement un fichier de clé privée.

  Si vous omettez --ssh-private-key, ssh tente de se connecter à l'aide des techniques d'authentification ne nécessitant pas un mot de passe, y compris l'utilisation de la clé privée par défaut. Si aucune de ces techniques n'est prise en charge, ssh interroge votre mot de passe. Pour plus d'informations sur la façon dont ssh gère l'authentification, consultez The Secure Shell (SSH) Authentication Protocol.

--override-ssh

(Facultatif) Utilisez cet argument si vous enregistrez l'instance à partir d'une station de travail distincte et que vous souhaitez spécifier une chaîne de commande ssh personnalisée. La commande register utilise cette chaîne de commande pour se connecter à l'instance enregistrée.

Pour plus d'informations sur ssh, consultez SSH.

--override-hostname

(Facultatif) Spécifie un nom d'hôte pour l'instance, qui est utilisé uniquement par AWS OpsWorks Stacks. La valeur par défaut est le nom d'hôte de l'instance.

--debug

(Facultatif) Fournit les informations de débogage en cas d'échec du processus d'enregistrement. Pour plus d’informations sur le dépannage, consultez Dépannage de l'enregistrement des instances.

--use-instance-profile

(Facultatif, mais vivement recommandé pour les instances Amazon EC2) Permet à la register commande d'utiliser un profil d'instance attaché, au lieu de créer un utilisateur IAM. L'ajout de ce paramètre permet d'éviter que des erreurs ne se produisent si vous essayez de gérer une instance enregistrée lorsque l'utilisateur IAM a été supprimé accidentellement.

Important

L'utilisateur IAM créé lors du processus d'enregistrement est requis pendant toute la durée de vie d'une instance enregistrée. La suppression de l'utilisateur empêche l'agent AWS OpsWorks Stacks de communiquer avec le service. Pour éviter les problèmes liés à la gestion des instances enregistrées en cas de suppression accidentelle de l'utilisateur, ajoutez le --use-instance-profile paramètre à votre register commande pour utiliser le profil d'instance intégré de l'instance à la place. L'ajout du --use-instance-profile paramètre empêche également les erreurs de se produire lorsque vous alternez les clés d'accès au AWS compte tous les 90 jours (une bonne pratique recommandée), car cela permet d'éviter les incohérences entre les clés d'accès disponibles pour l' AWS OpsWorks agent et celles de l'utilisateur requis.

Cible

(Conditionnel) Si vous exécutez cette commande à partir d'une station de travail, la valeur finale de la chaîne de commande spécifie la cible d'enregistrement de l'une des façons suivantes.

• Adresse IP publique de l'instance.

• Nom d'hôte de l'instance.

• Pour les instances Amazon EC2, l'ID de l'instance.

  AWS OpsWorks Stacks utilise l'ID de l'instance pour obtenir la configuration de l'instance, y compris l'adresse IP publique de l'instance. Par défaut, AWS OpsWorks Stacks utilise cette adresse pour créer la chaîne de ssh commande qu'il utilise pour se connecter à l'instance. Si vous avez besoin de vous connecter à une adresse IP privée, vous devez utiliser --override-ssh pour fournir une chaîne de commande personnalisée. Pour obtenir un exemple, consultez Enregistrer une instance locale à partir d'une station de travail.

Note

Si vous spécifiez un nom d'hôte, ssh dépend du serveur DNS pour résoudre le nom en une instance particulière. Si vous n'êtes pas certain que le nom d'hôte soit unique, utilisez ssh pour vérifier que le nom d'hôte se résout en l'instance correcte.

Si vous exécutez cette commande à partir de l'instance à enregistrer, omettez l'identifiant d'instance et utilisez à la place l'argument --local.

Les arguments suivants concernent uniquement les instances locales.

--override-public-ip

(Facultatif) AWS OpsWorks Stacks affiche l'adresse spécifiée en tant qu'adresse IP publique de l'instance. Il ne change pas l'adresse IP publique de l'instance. Toutefois, si un utilisateur utilise la console pour se connecter à l'instance, par exemple en choisissant l'adresse sur la page Instances, AWS OpsWorks Stacks utilise l'adresse spécifiée. AWS OpsWorks Stacks détermine automatiquement la valeur par défaut de l'argument.

--override-private-ip

(Facultatif) AWS OpsWorks Stacks affiche l'adresse spécifiée comme adresse IP privée de l'instance. Cela ne modifie pas l'adresse IP privée de l'instance. AWS OpsWorks Stacks détermine automatiquement la valeur par défaut de l'argument.