Tutorial: Utilice un clon completo con una fuente de GitHub canalización

1. Inicia sesión en tu GitHub repositorio y elige tu repositorio.

2. Para crear un nuevo archivo, seleccione Añadir archivo > Crear archivo nuevo. Asigne un nombre al archivo README.md. y añada el siguiente texto.

   This is a GitHub repository!

3. Seleccione Confirmar cambios.

   Asegúrese de que el archivo README.md está en el nivel raíz del repositorio.

Para crear una canalización con el asistente

1. Inicia sesión en la CodePipeline consola en https://console.aws.amazon.com/codepipeline/.

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

3. En Step 1: Choose pipeline settings (Paso 1: Elegir configuración de canalización), en Pipeline name (Nombre de canalización), escriba MyGitHubPipeline.

4. En Tipo de canalización, elija V1 para los fines de este tutorial. También puede elegir V2; sin embargo, tenga en cuenta que los tipos de canalización difieren en cuanto a características y precio. Para obtener más información, consulte Tipos de canalización.

5. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

   nota

   Si opta por utilizar su rol de CodePipeline servicio actual, asegúrese de haber agregado el codestar-connections:UseConnection IAM permiso a su política de rol de servicio. Para obtener instrucciones sobre la función de CodePipeline servicio, consulte Añadir permisos a la función CodePipeline de servicio.

6. Para Configuración avanzada deje los valores predeterminados. En Artifact store (Almacén de artefactos), elija Default location (Ubicación predeterminada) para utilizar el almacén de artefactos predeterminado, como el bucket de artefacto de Amazon S3 que se estableció como predeterminado, para la canalización en la región que seleccionó para esta.

   nota

   Este no es el bucket de origen para su código fuente. Este es el almacén de artefactos de la canalización. Cada canalización debe tener su propio almacén de artefactos independiente, como un bucket de S3.

   Elija Next (Siguiente).

7. En la página Step 2: Add source stage (Paso 2: Agregar etapa de origen), agregue una etapa de origen:

   1. En Proveedor de origen, elija GitHub (versión 2).

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

      Se instala una aplicación para todas las conexiones a un proveedor en particular. Si ya ha instalado el AWS conector para la GitHub aplicación, elíjalo y omita este paso.

      nota

      Si desea crear un token de acceso de usuario, asegúrese de que ya ha instalado el AWS Connector para la GitHub aplicación y, a continuación, deje el campo de instalación de la aplicación en blanco. CodeConnections utilizará el token de acceso de usuario para la conexión. Para obtener más información, consulte Acceder a su proveedor de origen en CodeBuild.

   3. En Nombre del repositorio, elige el nombre de tu GitHub repositorio.

   4. En Nombre de ramificación, elija la ramificación de repositorio que desea utilizar.

   5. Asegúrese de que la opción Start the pipeline on source code change (Iniciar la canalización en el cambio del código fuente) está seleccionada.

   6. En Formato de artefacto de salida, seleccione Clonación completa para habilitar la opción de clonación de Git para el repositorio de origen. Solo las acciones proporcionadas por CodeBuild pueden usar la opción de clonación de Git. Paso 3: Actualiza la política CodeBuild de roles de servicio para usar las conexionesEn este tutorial, utilizarás esta opción para actualizar los permisos de tu rol de servicio de CodeBuild proyectos.

   Elija Next (Siguiente).

8. En Add build stage (Añadir etapa de compilación), añada una etapa de compilación:

   1. En Build provider (Proveedor de compilación), elija AWS CodeBuild. En el campo Region (Región) conserve el valor predeterminado de la región de la canalización.

   2. Elija Crear proyecto.

   3. En Project name (Nombre de proyecto), escriba un nombre para este proyecto de compilación.

   4. En Environment image (Imagen de entorno), elija Managed image (Imagen administrada). En Operating system (Sistema operativo), elija Ubuntu.

   5. En Runtime, elija Standard (Estándar). En Imagen, elija aws/codebuild/standard:5.0.

   6. En Service role (Rol de servicio), elija New service role (Nuevo rol de servicio).

      nota

      Anote el nombre de su función CodeBuild de servicio. Necesitará el nombre del rol para el paso final de este tutorial.

   7. En Buildspec, para Build specifications (Especificaciones de la compilación), elija Insert build commands (Insertar comandos de compilación). Elija Cambiar a editor y pegue lo siguiente en Comandos de compilación:

      nota

      En la sección env de la especificación de compilación, asegúrese de que el ayudante de credenciales para los comandos de git esté habilitado, como se muestra en este ejemplo.

      version: 0.2
      
      env:
        git-credential-helper: yes
      phases:
        install:
          #If you use the Ubuntu standard image 2.0 or later, you must specify runtime-versions.
          #If you specify runtime-versions and use an image other than Ubuntu standard image 2.0, the build fails.
          runtime-versions:
            nodejs: 12
            # name: version
          #commands:
            # - command
            # - command
        pre_build:
          commands:
            - ls -lt
            - cat README.md
        build:
          commands:
            - git log | head -100
            - git status
            - ls
            - git archive --format=zip HEAD > application.zip
        #post_build:
          #commands:
            # - command
            # - command
      artifacts:
        files:
          - application.zip
          # - location
        #name: $(date +%Y-%m-%d)
        #discard-paths: yes
        #base-directory: location
      #cache:
        #paths:
          # - paths

   8. Selecciona Continuar a CodePipeline. Esto vuelve a la CodePipeline consola y crea un CodeBuild proyecto que utiliza los comandos de compilación para la configuración. El proyecto de compilación usa un rol de servicio para administrar Servicio de AWS los permisos. Es posible que este paso tarde un par de minutos.

   9. Elija Next (Siguiente).

9. En la página Step 4: Add deploy stage (Paso 4: Añadir etapa de implementación), elija Skip deploy stage (Omitir etapa de implementación) y, a continuación, acepte el mensaje de advertencia eligiendo Skip (Omitir) una vez más. Elija Next (Siguiente).

10. En Step 5: Review (Paso 5: Revisar), seleccione Create pipeline (Crear canalización).

1. Cuando su función de servicio se haya actualizado correctamente, seleccione Reintentar en la CodeBuild fase fallida.

2. Después de que la canalización se ejecute correctamente, en la etapa de implementación, elija Ver detalles.

   En la página de detalles, elija la pestaña Registros. Vea el resultado de la CodeBuild compilación. Los comandos muestran el valor de la variable introducida.

   Los comandos muestran el contenido del README.md archivo, enumeran los archivos en el directorio, clonan el repositorio, ven el registro y archivan el repositorio como un ZIP archivo.