Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Cree una canalización que utilice CodeBuild (CodePipeline consola) 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, use el procedimiento [Añadir una acción CodeBuild de prueba a una canalización (CodePipeline consola)](how-to-create-pipeline-add-test.md) de este tema para añadir a la canalización una acción de prueba que use CodeBuild. + Utilice uno de los otros procedimientos de este tema para crear la canalización y, a continuación, use el procedimiento [Añadir una acción CodeBuild de prueba a una canalización (CodePipeline consola)](how-to-create-pipeline-add-test.md) de este tema para añadir a la canalización una acción de prueba que use CodeBuild. **Para usar el asistente de creación de canalizaciones CodePipeline para crear una canalización que utilice CodeBuild** 1. Inicie sesión en el Consola de administración de AWS mediante: + Tu cuenta AWS raíz. No se recomienda. Para obtener más información, consulte [El usuario raíz de la cuenta](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) 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 ``` 1. Abre la AWS CodePipeline consola en [https://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home). 1. 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](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region) en la *Referencia general de Amazon Web Services*. 1. 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)**. 1. 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. 1. 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 **Existing service role (Rol de servicio existente)**y elija después el rol de servicio de CodePipeline que creó o identificó en los requisitos previos de este tema. 1. 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 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. 1. Elija **Siguiente**. 1. 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 **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 **Siguiente**. + Si tu código fuente está almacenado en un GitHub repositorio, elige **GitHub**. Selecciona **Conectar a GitHub** y sigue las instrucciones para autenticarte con GitHub él. 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 **Siguiente**. 1. En la página **Step 3: Add build stage (Paso 3: Agregar una fase de compilación)**, para **Build provider (Proveedor de compilación)**, elija **CodeBuild**. 1. 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 que se indican en este procedimiento [Creación de un proyecto de compilación (consola)](create-project.md#create-project-console) y vuelva a realizarlo. 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)](change-project.md#change-project-console). **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 a través de los webhooks y la otra a través de 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 él. 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)](change-project.md#change-project-console). 1. 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 **Siguiente**. 1. En la página ** Review (Revisar)**, revise las opciones y seleccione **Create pipeline (Crear canalización)**. 1. 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)](view-build-details.md#view-build-details-console). 1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. 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`. Puedes usar el comando AWS CLI para ejecutar el CodePipeline **get-pipeline** comando y obtener el nombre del bucket, donde *my-pipeline-name* aparece el nombre visible 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. 1. 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. 1. Extraiga el contenido del archivo . Si hay varios archivos en esa carpeta, extraiga el contenido del archivo con la última marca temporal **Last Modified**. (Es posible que tenga que asignar al archivo la extensión `.zip` para que pueda trabajar con él en la utilidad ZIP del sistema). El artefacto de salida de la compilación está en el contenido extraído del archivo. 1. 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 despliegue.