Ejemplo de insignias de compilación con CodeBuild

Para crear un proyecto de compilación con insignias de compilación habilitadas (AWS CLI)

• Para obtener información acerca de cómo crear un proyecto de compilación, consulte Crear un proyecto de compilación (AWS CLI). Para incluir insignias de compilación con su proyecto de AWS CodeBuild, debe especificar badgeEnabled con un valor de true.

Para crear un proyecto de compilación con insignias de compilación habilitadas (consola)

1. Abra la consola de AWS CodeBuild en https://console.aws.amazon.com/codesuite/codebuild/home.

2. Si se muestra una página de información de CodeBuild, elija Crear proyecto de compilación. De lo contrario, en el panel de navegación, expanda Compilar, elija Proyectos de compilación y, a continuación, elija Crear proyecto de compilación.

3. En Project name (Nombre de proyecto), escriba un nombre para este proyecto de compilación. Los nombres de los proyectos de compilación debe ser únicos en cada cuenta de AWS. También puede introducir una descripción opcional del proyecto de compilación para ayudar a otros usuarios a entender para qué se utiliza el proyecto.

4. En Source (Código fuente), para Source provider (Proveedor de código fuente), elija el tipo de proveedor de código fuente y, a continuación, realice alguna de las siguientes operaciones:

   nota

   CodeBuild no admite insignias de compilación con el proveedor de origen de Amazon S3. Como AWS CodePipeline usa Amazon S3 para transferir artefactos, las insignias de compilación no son compatibles con proyectos de compilación que forman parte de una canalización de CodePipeline.

   • Si ha seleccionado CodeCommit, elija el nombre del repositorio en Repositorio. Seleccione Habilitar insignia de compilación para convertir el estado de compilación del proyecto en visible e incrustable.

   • Si eligió GitHub, siga las instrucciones para conectarse (o volver a conectarse) a GitHub. En la página Autorizar aplicación de GitHub, para Acceso de organización, elija Solicitar acceso junto a cada repositorio al que desee que AWS CodeBuild pueda obtener acceso. Después de elegir Authorize application (Autorizar aplicación), de vuelta en la consola de AWS CodeBuild, para Repository (Repositorio), elija el nombre del repositorio que contiene el código fuente. Seleccione Habilitar insignia de compilación para convertir el estado de compilación del proyecto en visible e incrustable.

   • Si eligió Bitbucket, siga las instrucciones para conectarse (o volver a conectarse) a Bitbucket. En la página Confirm access to your account de Bitbucket, para Organization access, elija Grant access. Después de elegir Grant access (Conceder acceso), de vuelta en la consola de AWS CodeBuild, para Repository (Repositorio), elija el nombre del repositorio que contiene el código fuente. Seleccione Habilitar insignia de compilación para convertir el estado de compilación del proyecto en visible e incrustable.

     importante

     La actualización del código fuente del proyecto podría afectar a la precisión de las insignias de compilación del proyecto.

5. En Environment (Entorno):

   En Environment image (Imagen del entorno), realice alguna de las siguientes operaciones:

   • Para usar una imagen de Docker administrada por AWS CodeBuild, elija Managed image (Imagen administrada) y después elija una opción en Operating system (Sistema operativo), Runtime (Tiempo de ejecución), Image (Imagen) e Image version (Versión de imagen). Realice una selección en Environment type (Tipo de entorno) si está disponible.

   • Para usar otra imagen de Docker, elija Custom image (Imagen personalizada). En Tipo de entorno, elija ARM, Linux, GPU de Linux o Windows. Si elige Otro registro, en URL de registro externo, introduzca el nombre y etiqueta de la imagen de Docker en Docker Hub, usando el formato docker repository/docker image name. Si ha seleccionado Amazon ECR, use Repositorio de Amazon ECR e Imagen de Amazon ECR para elegir la imagen de Docker en su cuenta de AWS.

   • Para usar una imagen de Docker privada, elija Imagen personalizada. En Tipo de entorno, elija ARM, Linux, GPU de Linux o Windows. En Image registry (Registro de imagen), elija Other registry (Otro registro) y, a continuación, introduzca el ARN de las credenciales para su imagen de Docker privada. Es necesario crear las credenciales con Secrets Manager. Para obtener más información, consulte AWS Secrets Manager en la Guía del usuario de AWS Secrets Manager.

6. En Service role (Rol de servicio), realice una de las operaciones siguientes:

   • Si no tiene un rol de servicio de CodeBuild, elija Nuevo rol de servicio. Escriba un nombre para el nuevo rol en el campo Role Name.

   • Si tiene un rol de servicio de CodeBuild, elija Rol de servicio existente. En ARN de rol, seleccione el rol de servicio.

   nota

   Si utiliza la consola para crear o actualizar un proyecto de compilación, puede crear un rol de servicio de CodeBuild al mismo tiempo. De forma predeterminada, el rol funciona solamente con ese proyecto de compilación. Si utiliza la consola para asociar este rol de servicio a otro proyecto de compilación, el rol se actualizará para que funcione con el otro proyecto de compilación. Un rol de servicio puede funcionar con hasta diez proyectos de compilación.

7. En Archivo de especificación de compilación, realice alguna de las operaciones siguientes:

   • Seleccione Usar un archivo de especificaciones de compilación para utilizar el archivo buyildspec.yml que figura en el directorio raíz del código fuente.

   • Elija Insertar comandos de compilación para usar la consola para insertar comandos de compilación.

   Para obtener más información, consulte la Referencia de la especificación de compilación.

8. En Artifacts (Artefactos), en Type (Tipo), realice una de las siguientes operaciones:

   • Si no desea crear ningún artefacto de salida de la compilación, elija No artifacts (Sin artefactos).

   • Para almacenar la salida de la compilación en un bucket de S3, seleccione Amazon S3 y, a continuación, haga lo siguiente:

     • Si desea utilizar su nombre de proyecto para el archivo ZIP o carpeta de salida de la compilación, deje en blanco Nombre. De lo contrario, escriba el nombre. De forma predeterminada, el nombre del artefacto es el nombre del proyecto. Si desea usar otro nombre, escríbalo en el cuadro de nombre de artefactos. Si desea producir un archivo ZIP, incluya la extensión zip.

     • En Bucket name (Nombre del bucket), seleccione el nombre del bucket de salida.

     • Si eligió Insert build commands (Insertar comandos de compilación) anteriormente en este procedimiento, en Output files (Archivos de salida), escriba las ubicaciones de los archivos de la compilación que desea incluir en el archivo ZIP o carpeta de salida de la compilación. Si hay varias ubicaciones, separe cada una de las ubicaciones con una coma (por ejemplo, appspec.yml, target/my-app.jar). Para obtener más información, consulte la descripción de files en Sintaxis de buildspec.

9. Expanda Additional configuration (Configuración adicional) y elija las opciones que correspondan.

10. Elija Crear el proyecto de compilación. En la página Review (Revisar), elija Start build (Comenzar compilación) para ejecutar la compilación.