Uso del comando “register-on-premises-instance” (ARN de un usuario de IAM) para registrar una instancia en las instalaciones

Para asignar permisos (CLI)

1. Cree un archivo con el siguiente contenido de política en la instancia de Amazon EC2 o en el dispositivo que va a utilizar para llamar a la AWS CLI. Asigne al archivo un nombre como CodeDeploy-OnPrem-Permissions.json y, a continuación, guárdelo.

   {
       "Version": "2012-10-17",		 	 	 
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

   nota

   Le recomendamos que restrinja esta política únicamente a los buckets de Amazon S3 a los que su instancia en las instalaciones necesite tener acceso. Si restringe esta política, asegúrese de conceder acceso también a los buckets de Amazon S3 que contienen el agente de AWS CodeDeploy. De lo contrario, podría producirse un error siempre que el agente de CodeDeploy se instale o actualice en la instancia en las instalaciones asociada.

   Por ejemplo:

   {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource": [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-north-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-2/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",        
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-2/*",
           "arn:aws:s3:::aws-codedeploy-me-central-1/*",
           "arn:aws:s3:::aws-codedeploy-me-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }
     ]
   }

2. Llame al comando put-user-policy, especificando el nombre del usuario de IAM (con la opción --user-name), un nombre para la política (con la opción --policy-name) y la ruta del documento de políticas recién creado (con la opción --policy-document). Por ejemplo, suponiendo que el archivo CodeDeploy-OnPrem-Permissions.json está en el mismo directorio (carpeta) desde el que llama a este comando:

   importante

   Asegúrese de incluir file:// antes del nombre de archivo. Es obligatorio en este comando.

   aws iam put-user-policy --user-name CodeDeployUser-OnPrem --policy-name CodeDeploy-OnPrem-Permissions --policy-document file://CodeDeploy-OnPrem-Permissions.json

Para asignar permisos (consola)

1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

2. En el panel de navegación, seleccione Policies y, a continuación, seleccione Create Policy. Si aparece el botón Empezar, selecciónelo y, a continuación, seleccione Crear política.

3. Junto a Create Your Own Policy, seleccione Select.

4. En el cuadro Policy Name (Nombre de la política), escriba un nombre para esta política (por ejemplo, CodeDeploy-OnPrem-Permissions).

5. En el cuadro Documento de política, escriba o pegue la siguiente expresión de permisos, que permite que AWS CodeDeploy implemente en la instancia en las instalaciones revisiones de aplicaciones desde cualquier bucket de Amazon S3 especificado en la política en nombre de la cuenta del usuario de IAM:

   {
       "Version": "2012-10-17",		 	 	 
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

6. Elija Crear política.

7. En el panel de navegación, seleccione Usuarios.

8. En la lista de usuarios, busque y elija el nombre del usuario de IAM que creó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones.

9. En la pestaña Permissions, en Managed Policies, seleccione Attach Policy.

10. Seleccione la política denominada CodeDeploy-OnPrem-Permissions y, a continuación, elija Attach Policy (Asociar política).

Para obtener las credenciales (CLI)

1. Llame al domando list-access-keys, especificando el nombre del usuario de IAM (con la opción --user-name) y consultando únicamente los ID de clave de acceso (con las opciones --query y --output). Por ejemplo:

   aws iam list-access-keys --user-name CodeDeployUser-OnPrem --query "AccessKeyMetadata[*].AccessKeyId" --output text

2. Si en la salida no aparece ninguna clave o aparece información acerca de una única clave, llame al comando create-access-key, especificando el nombre del usuario de IAM (con la opción --user-name):

   aws iam create-access-key --user-name CodeDeployUser-OnPrem

   En la salida de la llamada al comando create-access-key, anote el valor de los campos AccessKeyId y SecretAccessKey. Necesitará esta información en Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones.

   importante

   Esta será la única vez que tendrá acceso a la clave de acceso secreta. Si olvida o pierde el acceso a esta clave de acceso secreta, tendrá que generar una nueva siguiendo los pasos de Paso 3: Obtener las credenciales del usuario de IAM.

3. Si aparecen dos claves de acceso, debe eliminar una de ellas llamando al comando delete-access-key, especificando el nombre del usuario de IAM (con la opción --user-name) y el ID de la clave de acceso que desea eliminar (con la opción --access-key-id). A continuación, llame al comando create-access-key, como se ha descrito anteriormente en este paso. A continuación se muestra un ejemplo de cómo llamar al comando delete-access-key:

   aws iam delete-access-key --user-name CodeDeployUser-OnPrem --access-key-id access-key-ID

   importante

   Si llama al comando delete-access-key para eliminar una de estas claves de acceso, y una instancia en las instalaciones ya está utilizando esta clave de acceso como se describe en Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones, tendrá que volver a seguir las instrucciones de Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones para especificar otro ID de clave de acceso y otra clave de acceso secreta asociada a este usuario de IAM. De lo contrario, todas las implementaciones de esa instancia on-premises pueden quedarse bloqueadas en un estado pendiente perpetuo o producir errores.

Para obtener las credenciales (consola)

1. 1. Abra la consola de IAM en https://console.aws.amazon.com/iam/.

   2. Si la lista de usuarios no se muestra, en el panel de navegación, elija Users.

   3. En la lista de usuarios, busque y elija el nombre del usuario de IAM que creó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones.

2. En la pestaña Security credentials, si en la lista no figura ninguna clave o si figura una sola una clave, seleccione Create access key.

   Si se muestran dos claves de acceso, debe eliminar una de ellas. Elija Delete junto a una de las claves de acceso y luego seleccione Create access key.

   importante

   Si elige Eliminar junto a una de estas claves de acceso, y una instancia en las instalaciones ya está utilizando esta clave de acceso como se describe en Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones, tendrá que volver a seguir las instrucciones de Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones para especificar otro ID de clave de acceso y otra clave de acceso secreta asociada a este usuario de IAM. De lo contrario, las implementaciones de esa instancia on-premises pueden quedarse bloqueadas en un estado pendiente perpetuo o producir errores.

3. Elija Show y anote el ID de la clave de acceso y la clave de acceso secreta. Necesitará esta información para el siguiente paso. Como alternativa, puede elegir Download .csv file para guardar una copia del ID de la clave de acceso y la clave de acceso secreta.

   importante

   A menos que anote o descargue las credenciales, esta será la única vez que tendrá acceso a la clave de acceso secreta. Si olvida o pierde el acceso a esta clave de acceso secreta, tendrá que generar una nueva siguiendo los pasos de Paso 3: Obtener las credenciales del usuario de IAM.

4. Seleccione Close para volver a la página Users > IAM User Name.

1. Cree un archivo denominado codedeploy.onpremises.yml (si se trata de una instancia en las instalaciones de Ubuntu Server o RHEL) o conf.onpremises.yml (en el caso de una instancia en las instalaciones de Windows) en la siguiente ubicación de la instancia en las instalaciones:

   • Para Ubuntu Server: /etc/codedeploy-agent/conf

   • Para Windows Server: C:\ProgramData\Amazon\CodeDeploy

2. Utilice un editor de texto para añadir la siguiente información al archivo codedeploy.onpremises.yml o conf.onpremises.yml recién creado:

   ---
   aws_access_key_id: secret-key-id
   aws_secret_access_key: secret-access-key
   iam_user_arn: iam-user-arn
   region: supported-region

   Donde:

   • secret-key-id es el ID de la clave secreta del usuario de IAM correspondiente que anotó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones o Paso 3: Obtener las credenciales del usuario de IAM.

   • secret-access-key es la clave de acceso secreta del usuario de IAM correspondiente que anotó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones o Paso 3: Obtener las credenciales del usuario de IAM.

   • iam-user-arn es el ARN del usuario de IAM que anotó anteriormente en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones.

   • supported-region es el identificador de una región admitida por CodeDeploy en la que se encuentran sus aplicaciones, grupos de implementación y revisiones de aplicaciones (por ejemplo, us-west-2). Para obtener una lista de regiones, consulte Regiones y puntos de conexión en la Referencia general de AWS.

   importante

   Si eligió Delete junto a una de las claves de acceso en Paso 3: Obtener las credenciales del usuario de IAM, y su instancia en las instalaciones ya está utilizando el ID de la clave de acceso y la clave de acceso secreta asociados, tendrá que seguir las instrucciones de Paso 4: Añadir un archivo de configuración a la instancia en las instalaciones para especificar otro ID de clave de acceso y otra clave de acceso secreta asociados a este usuario de IAM. De lo contrario, todas las implementaciones de su instancia on-premises pueden quedarse bloqueadas en un estado pendiente perpetuo o producir errores.

1. Para instalar la AWS CLI en la instancia en las instalaciones, siga las instrucciones de Configuración inicial de la AWS CLI en la Guía del usuario de la AWS Command Line Interface.

   nota

   Los comandos de CodeDeploy para trabajar con instancias en las instalaciones están disponibles desde la versión 1.7.19 de la AWS CLI. Si ya tiene instalada una versión de la AWS CLI, puede llamar a aws --version para comprobar la versión.

2. Para configurar AWS CLI en la instancia en las instalaciones, siga las instrucciones de Configuración de la AWS CLI en la Guía del usuario de la AWS Command Line Interface.

   importante

   Al configurar la AWS CLI (por ejemplo, llamando al comando aws configure), asegúrese de especificar el ID de la clave secreta y la clave de acceso secreta de un usuario de IAM que tenga, como mínimo, los siguientes permisos de acceso de AWS, además de los permisos de acceso especificados en Requisitos previos para configurar una instancia en las instalaciones. Esto le permite descargar e instalar el agente de CodeDeploy en la instancia en las instalaciones:

   JSON

   {
     "Version":"2012-10-17",		 	 	 
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::amzn-s3-demo-bucket1/*"
         ]
       }     
     ]
   }
   

   JSON

   {
     "Version":"2012-10-17",		 	 	 
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "*"
         ]
       }     
     ]
   }
   

   Estos permisos de acceso se pueden asignar al usuario de IAM que creó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones o a otro usuario de IAM. Para asignar estos permisos a un usuario de IAM, siga las instrucciones de Paso 1: Crear un usuario de IAM para la instancia en las instalaciones, utilizando estos permisos de acceso en lugar de los indicados en ese paso.

1. Para poder utilizar la AWS CLI, necesitará el ARN del usuario de IAM que creó en el Paso 1: Crear un usuario de IAM para la instancia en las instalaciones. Si aún no tiene el ARN de usuario, llame al comando get-user, especificando el nombre del usuario de IAM (con la opción --user-name) y consultando únicamente el ARN de usuario (con las opciones --query y --output):

   aws iam get-user --user-name CodeDeployUser-OnPrem --query "User.Arn" --output text

2. Llame al comando register-on-premises-instance, especificando lo siguiente:

   • Un nombre que identifique de manera única la instancia en las instalaciones (con la opción --instance-name).

     importante

     Para ayudarle a identificar la instancia on-premises, especialmente a efectos de depuración, recomendamos encarecidamente que especifique un nombre que se asigne a algunas características exclusivas de la instancia on-premises (por ejemplo, el número de serie o un identificador de recurso interno, si procede). Si especifica una dirección MAC como nombre, debe tener en cuenta que las direcciones MAC contienen caracteres que CodeDeploy no permite, como los dos puntos (:). Para obtener una lista de los caracteres permitidos, consulte Cuotas de CodeDeploy.

   • El ARN del usuario de IAM que creó en Paso 1: Crear un usuario de IAM para la instancia en las instalaciones (con la opción --iam-user-arn).

     Por ejemplo:

     aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem

Para etiquetar la instancia en las instalaciones (CLI)

• Llame al comando add-tags-to-on-premises-instances, especificando lo siguiente:

  • El nombre que identifica de manera única la instancia on-premises (con la opción --instance-names).

  • El nombre de la clave de etiqueta y el valor de etiqueta de la instancia on-premises que desea utilizar (con la opción --tags). Debe especificar tanto un nombre como un valor. CodeDeploy no permite etiquetas de instancias en las instalaciones que solo tengan valores.

    Por ejemplo:

    aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem

Para etiquetar la instancia on-premises (consola)

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CodeDeploy en https://console.aws.amazon.com/codedeploy.

   nota

   Inicie sesión con el mismo usuario que configuró en Introducción a CodeDeploy.

2. En el menú de CodeDeploy, elija Instancias en las instalaciones.

3. En la lista de instancias on-premises, elija la flecha situada junto a la instancia on-premises que desea etiquetar.

4. En la lista de etiquetas, seleccione o introduzca la clave y el valor que desee para la etiqueta. Cuando introduzca la clave y el valor de la etiqueta, aparecerá otra fila. Puede repetir esta acción para un máximo de 10 etiquetas. Para quitar una etiqueta, elija el icono de eliminación ( ).

5. Después de añadir las etiquetas, seleccione Update Tags.