Cree una canalización que utilice CodeBuild (CodePipelineconsola)

Utilice el siguiente procedimiento para crear una canalización que se utilice CodeBuild para compilar e implementar el código fuente.

Para crear una canalización que solo pruebe el código fuente:

• Utilice el siguiente procedimiento para crear la canalización y, a continuación, elimine las fases Build y Beta de la compilación. A continuación, utilice el Añadir una acción CodeBuild de prueba a una canalización (CodePipeline consola) procedimiento de este tema para añadir a la canalización una acción de prueba que utilice CodeBuild.

• Utilice uno de los demás procedimientos de este tema para crear la canalización y, a continuación, utilice el Añadir una acción CodeBuild de prueba a una canalización (CodePipeline consola) procedimiento de este tema para añadir a la canalización una acción de prueba que utilice CodeBuild.

Para utilizar el asistente de creación de canalizaciones CodePipeline para crear una canalización que utilice CodeBuild

1. Inicie sesión en el AWS Management Console mediante:

   • Tu cuenta AWS raíz. No se recomienda. Para obtener más información, consulte El usuario raíz de la cuenta en la Guía del usuario.

   • Un usuario administrador de tu AWS cuenta. Para obtener más información, consulte Creación del primer usuario y grupo Cuenta de AWS raíz en la Guía del usuario.

   • Un usuario de tu AWS cuenta con permiso para usar el siguiente conjunto mínimo de acciones:

     codepipeline:*
     iam:ListRoles
     iam:PassRole
     s3:CreateBucket
     s3:GetBucketPolicy
     s3:GetObject
     s3:ListAllMyBuckets
     s3:ListBucket
     s3:PutBucketPolicy
     codecommit:ListBranches
     codecommit:ListRepositories
     codedeploy:GetApplication
     codedeploy:GetDeploymentGroup
     codedeploy:ListApplications
     codedeploy:ListDeploymentGroups
     elasticbeanstalk:DescribeApplications
     elasticbeanstalk:DescribeEnvironments
     lambda:GetFunctionConfiguration
     lambda:ListFunctions
     opsworks:DescribeStacks
     opsworks:DescribeApps
     opsworks:DescribeLayers

2. Abre la AWS CodePipeline consola en https://console.aws.amazon.com/codesuite/codepipeline/home.

3. En el selector de regiones, elige la AWS región en la que se AWS encuentran los recursos de tu proyecto AWS de construcción. Debe ser una AWS región que CodeBuild sea compatible. Para obtener más información, consulte AWS CodeBuild en la Referencia general de Amazon Web Services.

4. Crear una canalización. Si se muestra una página de CodePipeline información, elija Crear canalización. Si aparece la página Pipelines (Canalizaciones), seleccione Create pipeline (Crear canalización).

5. En la página Step 1: Choose pipeline settings (Paso 1: Elegir configuración de canalización), en Pipeline name (Nombre de canalización), escriba un nombre para la canalización (por ejemplo, CodeBuildDemoPipeline). Si elige otro nombre, asegúrese de utilizarlo durante todo este procedimiento.

6. En Role name (Nombre de la función), realice una de las operaciones siguientes:

   Seleccione New service role (Nueva función de servicio) y, en Role Name (Nombre de la función), especifique un nombre para la nueva función de servicio.

   Elija el rol de servicio existente y, a continuación, el rol de CodePipeline servicio que creó o identificó como parte de los requisitos previos de este tema.

7. En Artifact store (Almacén de artefactos), haga lo siguiente:

   • Elige la ubicación predeterminada para usar el almacén de artefactos predeterminado, como el depósito de artefactos de S3 designado como predeterminado, para tu canalización en la AWS región que hayas seleccionado para la canalización.

   • Elige una ubicación personalizada si ya tienes un almacén de artefactos que hayas creado, como un depósito de artefactos de S3, en la misma AWS región que tu canalización.

   nota

   Esto no es el bucket de código fuente del código fuente de la canalización. Este es el almacén de artefactos de la canalización. Se necesita un almacén de artefactos independiente, como un depósito de S3, para cada canalización, en la misma AWS región que la canalización.

8. Elija Next (Siguiente).

9. En la página Step 2: Add source stage (Paso 2: Agregar una fase de origen), para Source provider (Proveedor de código fuente), proceda del modo siguiente:

   • Si el código fuente está almacenado en un bucket de S3, elija Amazon S3. En Bucket, seleccione el bucket de S3 que contiene el código fuente. En S3 object key (Clave de objeto de S3), escriba el nombre del archivo que contiene el código fuente (por ejemplo, file-name.zip). Elija Next (Siguiente).

   • Si tu código fuente está almacenado en un AWS CodeCommit repositorio, elige CodeCommit. En Repository name, elija el nombre del repositorio que contiene el código fuente. En Branch name (Nombre de la ramificación), elija el nombre de la ramificación que contiene la versión del código fuente que desea compilar. Elija Next (Siguiente).

   • Si tu código fuente está almacenado en un GitHub repositorio, elige GitHub. Selecciona Conectar a GitHub y sigue las instrucciones para autenticarte. GitHub En Repository, elija el nombre del repositorio que contiene el código fuente. En Branch (Ramificación), elija el nombre de la ramificación que contiene la versión del código fuente que desea compilar.

   Elija Next (Siguiente).

10. En la página Paso 3: Añadir una fase de compilación, en Build provider, selecciona CodeBuild.

11. Si ya tiene un proyecto de compilación que desee utilizar, en Nombre del proyecto, seleccione el nombre del proyecto de compilación y vaya directamente al paso siguiente de este procedimiento.

    Si necesita crear un nuevo proyecto de CodeBuild compilación, siga las instrucciones Creación de un proyecto de compilación (consola) y vuelva a este procedimiento.

    Si elige un proyecto de construcción existente, debe tener la configuración de los artefactos de salida de la construcción ya definida (aunque la CodePipeline anule). Para obtener más información, consulte Cambiar la configuración de un proyecto de compilación (consola).

    importante

    Si habilitas los webhooks para un CodeBuild proyecto y el proyecto se utiliza como paso de compilación CodePipeline, se crearán dos compilaciones idénticas para cada confirmación. Una compilación se activa mediante webhooks y otra mediante webhooks. CodePipeline Como se factura por compilación, se le cobrarán ambas compilaciones. Por lo tanto, si los estás utilizando CodePipeline, te recomendamos que inhabilites los webhooks en. CodeBuild En la consola de AWS CodeBuild , desactive la casilla Webhook. Para obtener más información, consulte Cambiar la configuración de un proyecto de compilación (consola).

12. En la página Step 4: Add deploy stage (Paso 4: Agregar una fase de implementación), realice una de las siguientes operaciones:

    • Si no desea implementar el artefacto de salida de la compilación, elija Skip (Omitir) y confirme esta opción cuando se lo soliciten.

    • Si desea implementar el artefacto de salida de la compilación, en Deploy provider (Proveedor de implementación), elija un proveedor de implementación y especifique la configuración cuando se lo soliciten.

    Elija Next (Siguiente).

13. En la página Review (Revisar), revise las opciones y seleccione Create pipeline (Crear canalización).

14. Una vez que la canalización se ejecute correctamente, podrá obtener el artefacto de salida de la compilación. Con la canalización mostrada en la CodePipeline consola, en la acción Construir, selecciona la información sobre herramientas. Anote el valor del artefacto de salida (por ejemplo, MyAppBuild).

    nota

    También puedes obtener el artefacto de salida de la compilación seleccionando el enlace Construir artefactos en la página de detalles de la compilación de la CodeBuild consola. Para ir a esta página, omita el resto de los pasos de este procedimiento y consulte Ver detalles de las compilaciones (consola).

15. Abra la consola Amazon S3 en https://console.aws.amazon.com/s3/.

16. En la lista de buckets, abra el bucket utilizado por la canalización. El nombre del bucket debe seguir el formato codepipeline-region-ID-random-number. Puede usar AWS CLI para ejecutar el CodePipeline get-pipeline comando y obtener el nombre del bucket, donde my-pipeline-name es el nombre para mostrar de tu canalización:

    aws codepipeline get-pipeline --name my-pipeline-name

    En el resultado, el objeto pipeline contiene un objeto artifactStore, que a su vez contiene un valor location con el nombre del bucket.

17. Abra la carpeta que tiene el mismo nombre que la canalización (en función de la longitud del nombre de la canalización, el nombre de la carpeta podría aparecer truncado) y después abra la carpeta que tiene el mismo nombre que el valor de Output artifact (Artefacto de salida) que anotó anteriormente.

18. Extraiga el contenido del archivo . Si hay varios archivos en esa carpeta, extraiga el contenido del archivo con la última marca temporal Last Modified. (Puede que tengas que darle la .zip extensión al archivo para poder trabajar con él en la ZIP utilidad del sistema). El artefacto de salida de la compilación está en el contenido extraído del archivo.

19. Si has indicado CodePipeline que despliegues el artefacto de salida de la compilación, sigue las instrucciones del proveedor de la implementación para llegar al artefacto de salida de la compilación en los objetivos de la implementación.