Tutorial: implementación en instancias de Amazon EC2 con CodePipeline

Para crear un rol de instancia

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

2. En el panel de la consola, elija Roles.

3. Seleccione Crear rol.

4. En Seleccionar el tipo de entidad de confianza, seleccione Servicio de AWS. En Elegir un caso de uso, seleccione EC2. En Select your use case (Seleccionar su caso de uso), elija EC2. Elija Siguiente.

5. Busque y seleccione la política denominada AmazonSSMManagedEC2InstanceDefaultPolicy.

6. Busque y seleccione la política denominada AmazonSSMManagedInstanceCore. Elija Siguiente: Etiquetas.

7. Elija Siguiente: Revisar. Escriba el nombre del rol (por ejemplo, EC2InstanceRole).

   nota

   Anote el nombre del rol para utilizarlo en el siguiente paso. Tendrá que elegir este rol cuando cree la instancia.

   nota

   Agregará permisos a este rol para permitir el acceso al bucket de artefactos de S3 para su canalización una vez creada la canalización.

   Seleccione Crear rol.

Para lanzar las instancias

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En la barra de navegación lateral, elija Instancias y seleccione Lanzar instancias en la parte superior de la página.

3. En Name (Nombre), escriba MyInstances. Esto asigna a la instancia una clave de etiqueta Name y un valor de etiqueta MyInstances.

4. En Imágenes de aplicaciones y sistemas operativos (Amazon Machine Image) , busque la opción AMI de Amazon Linux con el logotipo AWS y asegúrese de que esté seleccionada. (Esta AMI se describe como AMI de Amazon Linux 2 (HVM) y se denomina "Free tier eligible" (Apta para capa gratuita).)

5. En Tipo de instancia, elija el tipo t2.micro apto para la capa gratuita como configuración de hardware de la instancia.

6. En Par de claves (inicio de sesión), seleccione un par de claves o cree uno.

7. En Configuración de red, asegúrese de que el estado sea Habilitar.

8. Amplíe Advanced details (Detalles avanzados). En Perfil de instancia de IAM, elija el rol de IAM que creó en el procedimiento anterior (por ejemplo, EC2InstanceRole).

   nota

   No deje el rol de instancia en blanco, ya que esto crea un rol predeterminado y no selecciona el rol que ha creado.

9. En Resumen, en Número de instancias, especifique 2.

10. Seleccione Iniciar instancia.

11. Puede ver el estado del lanzamiento en la página Instances. Al lanzar una instancia, su estado inicial es pending. Una vez iniciada la instancia, el estado cambia a running y recibe un nombre de DNS público. (Si la columna Public DNS no se muestra, haga clic en el icono Show/Hide y después seleccione Public DNS.)

1. Vaya a su canalización en la consola de CodePipeline. Seleccione Configuración. Vea el nombre y la ubicación del almacén de artefactos de una canalización existente. Anote el nombre de recurso de Amazon (ARN) del bucket de artefactos y cópielo.

2. Vaya a la consola de IAM y elija Roles (Roles). Elija el rol de instancia que creó en el paso 1 de este tutorial.

3. En la pestaña Permisos, elija Añadir política en línea.

4. Agregue el siguiente JSON al documento de política y sustituya el valor del campo Resource por el ARN del bucket.

   {
       "Effect": "Allow",
       "Principal": "*",
       "Action": "s3:GetObject",
       "Resource": "arn:aws:s3:::BucketName"
   }

5. Elija Actualizar.

Para añadir un archivo script.sh a su repositorio de código fuente

1. Abra un editor de texto y luego copie y pegue el archivo anterior en un nuevo archivo.

2. Confirme la operación e inserte el archivo script.sh en el repositorio de código fuente.

   1. Añada el archivo.

      git add .

   2. Valide el cambio con.

      git commit -m "Adding script.sh."

   3. Envíe la confirmación.

      git push

   Anote la ruta en su repositorio.

   /MyDemoRepo/test/script.sh

Para crear la canalización

1. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

2. En la página Bienvenido, Introducción o Canalizaciones, elija Crear canalización.

3. En la página Paso 1: elección de la opción de creación, en Opciones de creación, seleccione la opción Crear una canalización personalizada. Elija Siguiente.

4. En Paso 2: elegir la configuración de la canalización, en Nombre de la canalización, escriba MyPipeline.

5. CodePipeline proporciona canalizaciones de tipo V1 y V2, que difieren en características y precio. El tipo V2 es el único tipo que puede elegir en la consola. Para obtener más información, consulte Tipos de canalización. Para obtener más información acerca de los precios de CodePipeline, consulte Precios.

6. En Rol de servicio, elija Usar el rol de servicio existente y, a continuación, elija el rol de servicio de CodePipeline que se ha actualizado con los permisos necesarios para esta acción. Para configurar el rol de servicio de CodePipeline para esta acción, consulte Permisos de política de roles de servicio para la acción de EC2 despliegue.

7. En Advanced settings (Configuración avanzada), deje los valores predeterminados y elija Next (Siguiente).

8. En la página Paso 3: agregar la etapa de origen, agregue una etapa de origen:

   1. En Proveedor de origen, elija GitHub (mediante la aplicación de GitHub).

   2. En Conexión, seleccione una conexión existente o cree una nueva. Para crear o administrar una conexión para su acción de origen de GitHub, consulte GitHub conexiones.

   3. En Nombre de repositorio, elija el nombre de su repositorio de GitHub.

   Elija Siguiente.

9. En la página Paso 4: agregación de la etapa de compilación, seleccione Omitir.

10. En la página Paso 5: agregación de la etapa de implementación, elija EC2.

    

    1. En el directorio de destino, especifique el directorio de la instancia en la que desee realizar la implementación, por ejemplo /home/ec2-user/testhelloworld.

       nota

       Especifique el directorio de implementación que desea que utilice la acción en la instancia. La acción automatizará la creación del directorio especificado en la instancia como parte de la implementación.

    2. En el caso de PostScript, especifique la ruta y el nombre del archivo del script, por ejemplo test/script.sh.

    3. Elija Siguiente.

11. En la página Step 6: Review, revise la configuración de la canalización y elija Create pipeline para crear la canalización.

    

12. Cuando la canalización se haya ejecutado correctamente, elija Ver detalles para consultar los registros de la acción y ver la salida de la acción de computación administrada.

    
    

Para probar la canalización

1. Realice una modificación del código en el repositorio de código fuente configurado, valide y envíe el cambio.

2. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

3. Seleccione su canalización de la lista.

4. Vea el progreso en la canalización a través de sus etapas. La canalización debería completarse y la acción implementar el script en las instancias.

5. Para obtener más información sobre la solución de problemas, consulte EC2 La acción de despliegue falla y muestra un mensaje de error No such file.