Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Désenregistrer automatiquement une instance sur site
Généralement, vous annulez l'inscription d'une instance sur site une fois que vous n'avez plus l'intention d'y effectuer un déploiement. Lorsque vous annulez l'inscription d'une instance sur site, même si cette instance sur site fait éventuellement partie des balises d'instance sur site d'un groupe de déploiement, l'instance sur site ne sera incluse dans aucun déploiement. Vous pouvez utiliser le AWS CLI pour désenregistrer des instances locales.
Note
Vous ne pouvez pas utiliser la CodeDeploy console pour annuler l'enregistrement d'une instance locale. En outre, l'annulation de l'inscription d'une instance sur site supprime les balises d'instance sur site qui lui sont associées. Il ne désinstalle pas l' CodeDeploy agent de l'instance locale. Elle ne supprime pas le fichier de configuration de l'instance sur site de cette instance sur site.
Pour utiliser la CodeDeploy console afin d'effectuer certaines (mais pas toutes) des activités décrites dans cette section, consultez la section CodeDeploy console deDésenregistrer manuellement une instance sur site.
Pour dissocier manuellement des balises d'instance sur site associées quelconques, consultez la section Supprimer manuellement les balises d'instance sur site d'une instance sur site.
Pour désinstaller automatiquement l' CodeDeploy agent et supprimer le fichier de configuration de l'instance locale, consultezDésinstallez automatiquement l' CodeDeploy agent et supprimez le fichier de configuration d'une instance locale.
Pour désinstaller manuellement uniquement l' CodeDeploy agent de l'instance locale, consultezGestion des opérations des CodeDeploy agents.
Utilisez la commande AWS CLI pour appeler la commande de désenregistrement, en spécifiant :
-
Le nom qui identifie de manière unique l'instance locale à CodeDeploy (avec l'
--instance-nameoption). -
Facultativement, s'il faut supprimer l'utilisateur IAM associé à l'instance locale. Le comportement par défaut est de supprimer l'utilisateur IAM. Si vous ne souhaitez pas supprimer l'utilisateur IAM associé à l'instance sur site, spécifiez l'option
--no-delete-iam-userdans la commande. -
Facultativement, la AWS région dans laquelle l'instance locale a été enregistrée CodeDeploy (avec l'
--regionoption). Il doit s'agir de l'une des régions prises en charge répertoriées dans Région et des points de terminaison dans le Références générales AWS(par exemple,us-west-2). Si cette option n'est pas spécifiée, la AWS région par défaut associée à l'utilisateur IAM appelant sera utilisée.
Exemple qui annule l’enregistrement d’une instance et supprime l'utilisateur :
aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2
Exemple qui annule l’enregistrement d’une instance mais ne supprime pas l'utilisateur :
aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2
La commande deregister exécute les opérations suivantes :
-
Désenregistre l'instance locale auprès de. CodeDeploy
-
Si cela est spécifié, supprime l'utilisateur IAM associé à l'instance locale.
Après avoir annulé l'inscription d'une instance sur site :
-
Elle n'apparaît plus immédiatement dans la console.
-
Vous ne pouvez pas immédiatement créer une autre instance avec le même nom.
Si cette commande rencontre des erreurs, un message d'erreur s'affiche, qui décrit comment suivre manuellement les étapes restantes. Sinon, un message de réussite s'affiche, qui décrit comment appeler la commande uninstall.
