Tutorial: Crear una canalización sencilla (repositorio de CodeCommit)

Para crear un CodeCommit repositorio

1. Abra la CodeCommit consola en https://console.aws.amazon.com/codecommit/.

2. En el selector de regiones, elige Región de AWS dónde quieres crear el repositorio y la canalización. Para obtener más información, consulte Puntos de conexión y Regiones de AWS.

3. En la página Repositorios, seleccione Crear repositorio.

4. En la página Create repository (Crear repositorio), en Repository name (Nombre del repositorio), escriba un nombre para el repositorio (por ejemplo, MyDemoRepo).

5. Seleccione Crear.

Para configurar un repositorio local

En este paso, configurará un repositorio local para conectarse a su repositorio remoto de CodeCommit.

1. Con el nuevo repositorio abierto en la consola, elija Clone URL (Clonar URL) en la parte superior derecha de la página y, a continuación, elija Clone SSH (Clonar SSH). La dirección para clonar el repositorio Git se copia en el portapapeles.

2. En el terminal o en la línea de comandos, acceda a un directorio local en el que desea que se almacene el repositorio local. En este tutorial, utilizamos /tmp.

3. Ejecute el siguiente comando para clonar el repositorio, sustituyendo la dirección SSH por la que ha copiado en el paso anterior. Este comando crea un directorio denominado MyDemoRepo. Copie una aplicación de ejemplo en este directorio.

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. A continuación, descargue un ejemplo y guárdelo en una carpeta o directorio del equipo local.

   1. Elija una de las siguientes opciones. Elija SampleApp_Linux.zip si desea seguir los pasos de este tutorial en instancias de Linux.

      • Si desea realizar la implementación en instancias de Amazon Linux mediante CodeDeploy, descargue la aplicación de muestra aquí: SampleApp_Linux.zip.

      • Si desea realizar la implementación en instancias de Windows Server mediante CodeDeploy, descargue la aplicación de muestra aquí: SampleApp_Windows.zip.

      La aplicación de ejemplo contiene los siguientes archivos para realizar la implementación con CodeDeploy:

      • appspec.yml— El archivo de especificaciones de la aplicación (AppSpecarchivo) es un archivo con formato YAML que se utiliza CodeDeploy para gestionar una implementación. Para obtener más información sobre el AppSpec archivo, consulte la referencia al CodeDeploy AppSpec archivo en la Guía del AWS CodeDeploy usuario.

      • index.html: el archivo de índice contiene la página de inicio de la aplicación de ejemplo implementada.

      • LICENSE.txt: el archivo de licencia contiene la información de licencia de la aplicación de ejemplo.

      • Archivos para scripts: la aplicación de ejemplo usa scripts para escribir archivos de texto en una ubicación de la instancia. Se escribe un archivo para cada uno de los diversos eventos del ciclo de vida de la CodeDeploy implementación, de la siguiente manera:

        • (Solo ejemplos de Linux) Carpeta scripts: la carpeta contiene los siguientes scripts de intérprete de comandos para instalar las dependencias e iniciar y detener la aplicación de ejemplo para la implementación automatizada: install_dependencies, start_server y stop_server.

        • (Solo ejemplo de Windows) before-install.bat: se trata de un script por lotes para el evento de ciclo de vida de implementación, que se ejecutará para eliminar los archivos antiguos escritos durante implementaciones anteriores de este ejemplo y crear una ubicación en su instancia en la que escribir los archivos nuevos.

   2. Descargue el archivo comprimido (en zip).

2. Descomprima los archivos de SampleApp_Linux.zip en el directorio local que creó anteriormente (por ejemplo, /tmp/MyDemoRepo oc:\temp\MyDemoRepo).

   Asegúrese de colocar los archivos directamente en su repositorio local. No incluya una carpeta SampleApp_Linux. En la máquina Linux, macOS o Unix local, por ejemplo, su directorio y la jerarquía de archivos deberían verse así:

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. Para cargar archivos en el repositorio, utilice alguno de los métodos siguientes.

   1. Para usar la CodeCommit consola para cargar los archivos:

      1. Abre la CodeCommit consola y elige tu repositorio en la lista de repositorios.

      2. Elija Add file (Añadir archivo) y, a continuación, Upload file (Cargar archivo).

      3. Seleccione Choose file (Elegir archivo) y, a continuación, busque el archivo. Para añadir un archivo a una carpeta, seleccione Crear archivo y, a continuación, introduce el nombre de la carpeta con el nombre del archivo, por ejemplo scripts/install_dependencies. Pegue los siguientes contenidos en el nuevo archivo.

         Para confirmar el cambio, introduzca su nombre de usuario y la dirección de correo electrónico.

         Seleccione Confirmar cambios.

      4. Repita este paso para cada archivo.

         El contenido del repositorio debería ser similar al siguiente:

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. Para usar los comandos de git para cargar sus archivos:

      1. Cambiar los directorios a su repositorio local:

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

      2. Ejecute el siguiente comando para preparar todos los archivos de una vez:

         git add -A

      3. Ejecute el siguiente comando para confirmar los archivos con un mensaje de confirmación:

         git commit -m "Add sample application files"

      4. Ejecute el siguiente comando para enviar los archivos de su repositorio local al repositorio de CodeCommit:

         git push

4. Los archivos que descargaste y agregaste a tu repositorio local ya se han agregado a la main rama de tu CodeCommit MyDemoRepo repositorio y están listos para ser incluidos en una canalización.

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. Elija Crear rol.

4. En Seleccionar el tipo de entidad de confianza, seleccione Servicio de AWS. En Elija un caso de uso, seleccione EC2. En Selecciona tu caso de uso, elige EC2. Elija Siguiente: permisos.

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

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.

   Elija Crear rol.

Lanzamiento de una instancia de

1. Abre la EC2 consola de Amazon 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 MyCodePipelineDemo. Esto asigna a la instancia una clave de etiqueta Name y un valor de etiqueta MyCodePipelineDemo. Más adelante, se crea una CodeDeploy aplicación que despliega la aplicación de muestra en esta instancia. CodeDeployselecciona las instancias que se van a implementar en función de las etiquetas.

4. En Imágenes de aplicaciones y sistemas operativos (Amazon Machine Image), busque la opción AMI de Amazon Linux con el AWS logotipo 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.

   Puede elegir Continuar sin un par de claves.

   nota

   A efectos de este tutorial, puede continuar sin utilizar un par de claves. Si desea usar SSH para conectarse a sus instancias, cree o use un par de claves.

7. En Configuración de red, haga lo siguiente:

   En Asignar automáticamente IP pública, asegúrese de que el estado sea Activar.

   Para el grupo de seguridad creado, elija HTTP y, a continuación, en Tipo de fuente, elija Mi IP.

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).

9. En Resumen, en Número de instancias, introduzca 1.

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.)

Para crear un rol de CodeDeploy servicio

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

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

3. Elija Crear rol.

4. En Seleccionar entidad de confianza, elija Servicio de AWS. En Use case (Caso de uso), elija CodeDeploy. Elija una CodeDeployde las opciones que aparecen en la lista. Elija Next (Siguiente). La política administrada AWSCodeDeployRole ya está asociada al rol.

5. Elija Next (Siguiente).

6. Especifique un nombre para el rol (por ejemplo, CodeDeployRole) y elija Create role (Crear rol).

Para crear una aplicación en CodeDeploy

1. Abra la CodeDeploy consola en https://console.aws.amazon.com/codedeploy.

2. Si la página Aplicaciones no aparece, en el menú, elija Aplicaciones.

3. Elija Creación de aplicación.

4. En Application name (Nombre de aplicación), escriba MyDemoApplication.

5. En Compute Platform, elige EC2 /On-premises.

6. Elija Creación de aplicación.

Para crear un grupo de implementación en CodeDeploy

Un grupo de implementación es un recurso que define la configuración relacionada con la implementación, como las instancias que implementar y con qué rapidez implementarlas.

1. En la página que muestra su aplicación, elija Create deployment group (Crear grupo de implementaciones).

2. En Nombre de grupo de implementación, escriba MyDemoDeploymentGroup.

3. En Rol de servicio, elija el ARN del rol de servicio que creó anteriormente (por ejemplo, arn:aws:iam::account_ID:role/CodeDeployRole).

4. En Deployment type (Tipo de implementación), elija In-place (In situ).

5. En Configuración del entorno, elija Amazon EC2 Instances. En el campo Clave, introduzca Name. En el campo Valor, escriba el nombre que utilizó para etiquetar la instancia (por ejemplo, MyCodePipelineDemo).

6. En Configuración del agente con AWS Systems Manager, seleccione Ahora y programe las actualizaciones. Primero, instale el agente en la instancia. La instancia de Linux ya está configurada con el agente SSM y ahora se actualizará con el CodeDeploy agente.

7. En Deployment configuration (Configuración de implementación), elija CodeDeployDefault.OneAtaTime.

8. En Equilibrador de carga, asegúrese de que no esté seleccionada la opción Habilitar equilibrio de carga. No es necesario configurar un balanceador de carga ni elegir un grupo de destino para este ejemplo.

9. Elija Crear grupo de implementación.

Para crear una CodePipeline canalización

1. Inicie sesión en la CodePipeline consola AWS Management Console y ábrala en http://console.aws.amazon. com/codesuite/codepipeline/home.

   Abre la CodePipeline consola 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 Next (Siguiente).

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

5. En Tipo de canalización, seleccione V2. Para obtener más información, consulte Tipos de canalización. Elija Next (Siguiente).

6. En Función de servicio, elija Nueva función de servicio CodePipeline para permitir la creación de una función de servicio en IAM.

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

8. En Paso 3: agregar la etapa de origen, en Proveedor de origen, elija CodeCommit. En Nombre del repositorio, elija el nombre del CodeCommit repositorio en Paso 1: Crea un CodeCommit repositorio el que lo creó. En Branch name (Nombre de la ramificación), elija main y, a continuación, elija Next step (Paso siguiente).

   Tras seleccionar el nombre y la sucursal del repositorio, aparecerá un mensaje con la regla de Amazon CloudWatch Events que se va a crear para esta canalización.

   En Change detection options, deje los valores predeterminados. Esto permite CodePipeline utilizar Amazon CloudWatch Events para detectar cambios en el repositorio de origen.

   Elija Next (Siguiente).

9. En Paso 4: agregar la etapa de compilación, elija Omitir la etapa de compilación y, a continuación, acepte el mensaje de advertencia eligiendo Omitir una vez más. Elija Next (Siguiente).

   nota

   En este tutorial, va a implementar código que no requiere ningún servicio de compilación, por lo que puede omitir este paso. Sin embargo, si es necesario compilar el código fuente antes de implementarlo en instancias, puede configurar CodeBuild en este paso.

10. En el paso 5: Añadir la etapa de prueba, elija Omitir la etapa de prueba y, a continuación, acepte el mensaje de advertencia seleccionando Omitir de nuevo.

    Elija Next (Siguiente).

11. En el paso 6: Añadir la fase de despliegue, en Proveedor de despliegue, seleccione CodeDeploy. En Application name (Nombre de aplicación), escriba MyDemoApplication. En Deployment group (Grupo de implementación), elija MyDemoDeploymentGroup y, a continuación, elija Next step (Paso siguiente).

12. En el paso 7: Revisar, revise la información y, a continuación, seleccione Crear canalización.

13. La canalización comienza a ejecutarse después de crearla. Descarga el código del CodeCommit repositorio y crea una CodeDeploy implementación en la EC2 instancia. Puede ver los mensajes de progreso y de éxito y error a medida que en el CodePipeline ejemplo se despliega la página web en la EC2 instancia de Amazon de la CodeDeploy implementación.

    

Para comprobar que la canalización se ha ejecutado correctamente

1. Vea el progreso inicial de la canalización. El estado de cada etapa cambia de No executions yet (Sin ejecuciones) a In Progress (En curso) y después a Succeeded (Realizado correctamente) o Failed (Error). La canalización debería completar la primera ejecución en unos minutos.

2. Una vez que aparezca Sucedido en el estado de la canalización, en el área de estado de la etapa de implementación, seleccione CodeDeploy. Esto abre la CodeDeploy consola. Si no se muestra Succeeded (Correcto) consulte Solución de problemas CodePipeline.

3. En la pestaña Implementaciones, elija el ID de la implementación. En la página de la implementación, en la sección Eventos del ciclo de vida de la implementación, elija el ID de la instancia. Esto abre la EC2 consola.

4. En la pestaña Description (Descripción), en Public DNS (DNS público), copie la dirección (por ejemplo, ec2-192-0-2-1.us-west-2.compute.amazonaws.com) y después péguela en la barra de direcciones de su explorador web.

   Aparece la página web de la aplicación de muestra que descargaste e insertaste en tu CodeCommit repositorio.

1. Cambiar los directorios a su repositorio local:

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. Use un editor de texto para modificar el archivo index.html:

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. Revise el contenido del archivo index.html para cambiar el color de fondo y parte del texto de la página web y, a continuación, guarde el archivo.

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. Confirme e inserte los cambios en su CodeCommit repositorio ejecutando los siguientes comandos, uno a la vez:

   git commit -am "Updated sample application files"

   git push

Para comprobar que la canalización se ha ejecutado correctamente

1. Vea el progreso inicial de la canalización. El estado de cada etapa cambia de No executions yet (Sin ejecuciones) a In Progress (En curso) y después a Succeeded (Realizado correctamente) o Failed (Error). La ejecución de la canalización debería completarse en unos minutos.

2. Cuando aparezca Succeeded (Correcto) en el estado de la acción, actualice la página de demostración a la que ha accedido anteriormente en el navegador.

   En la página web actualizada se mostrará:

Para limpiar los recursos usados en este tutorial

1. Para limpiar tus CodePipeline recursos, sigue las instrucciones de Eliminar una canalización en AWS CodePipeline.

2. Para limpiar sus CodeDeploy recursos, siga las instrucciones del tutorial sobre cómo limpiar los recursos de Deployment.

3. Para eliminar el CodeCommit repositorio, siga las instrucciones de Eliminar un CodeCommit repositorio.