Anulación automática del registro de una instancia en las instalaciones - AWS CodeDeploy

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Anulación automática del registro de una instancia en las instalaciones

Por lo general, si ya no tiene pensado implementar la instancia on-premises, debe anular su registro. Al anular el registro de una instancia on-premises, dicha instancia deja de incluirse en cualquier implementación, incluso si forma parte de las etiquetas de instancias on-premises de un grupo de implementaciones. Puede utilizar la AWS CLI para anular el registro de las instancias on-premises.

nota

No es posible utilizar la consola de CodeDeploy para anular el registro de una instancia en las instalaciones. Además, la anulación del registro de una instancia en las instalaciones elimina aquellas etiquetas que estén asociadas a la instancia en las instalaciones. Tampoco desinstala el agente de CodeDeploy de la instancia en las instalaciones, ni elimina el archivo de configuración de instancia on-premises de dicha instancia.

Para realizar parte de las actividades descritas en esta sección (no todas) desde la consola de CodeDeploy, consulte la sección correspondiente a la consola de CodeDeploy en Anulación manual del registro de una instancia en las instalaciones.

Para desvincular etiquetas asociadas a una instancia on-premises manualmente, consulte Eliminar manualmente las etiquetas de instancias en las instalaciones de una instancia.

Para desinstalar el agente de CodeDeploy automáticamente y eliminar el archivo de configuración de la instancia en las instalaciones, consulte Desinstalación automática del agente de CodeDeploy y eliminación del archivo de configuración de la instancia en las instalaciones.

Para desinstalar manualmente solamente el agente de CodeDeploy de la instancia en las instalaciones, consulte Gestión de las operaciones del agente de CodeDeploy.

Utilice la AWS CLI para llamar al comando deregister especificando:

  • El nombre que identifica de manera única la instancia en las instalaciones a CodeDeploy (con la opción --instance-name).

  • De manera opcional, si desea eliminar el usuario de IAM asociado a la instancia en las instalaciones. El comportamiento predeterminado es eliminar al usuario de IAM. Si no desea eliminar el usuario de IAM asociado a la instancia on-premises, especifique la opción --no-delete-iam-user en el comando.

  • Opcionalmente, la región de AWS en la que se registró la instancia en las instalaciones en CodeDeploy (con la opción --region). Debe ser una de las regiones admitidas que se encuentran en la lista de Regiones y puntos de enlace de la Referencia general de AWS (como, por ejemplo, us-west-2). Si no se especifica esta opción, se utilizará la región predeterminada de AWS asociada al usuario de IAM que realiza la llamada.

Ejemplo que anula el registro de una instancia y elimina al usuario:

aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2

Ejemplo que anula el registro de una instancia y no elimina al usuario:

aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2

El comando deregister hace lo siguiente:

  1. Anula el registro de la instancia en las instalaciones con CodeDeploy.

  2. Si se especifica, elimina el usuario de IAM asociado a la instancia en las instalaciones.

Después de cancelar el registro de una instancia en las instalaciones:

  • Deja de aparecer en la consola inmediatamente.

  • Puede crear otra instancia con el mismo nombre inmediatamente.

Si este comando encuentra algún error, aparece un mensaje en el que se describe cómo realizar manualmente los pasos faltantes. En caso contrario, aparece un mensaje de confirmación en el que se describe cómo realizar una llamada al comando uninstall.