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 muestra de insignias con CodeBuild
<a name="sample-build-badges"></a>

AWS CodeBuild ahora admite el uso de insignias de compilación, que proporcionan una imagen (*insignia*) integrable y generada dinámicamente que muestra el estado de la última compilación de un proyecto. Se puede acceder a esta imagen a través de una URL disponible públicamente generada para tu proyecto. CodeBuild Esto permite a cualquier persona ver el estado de un CodeBuild proyecto. Las insignias de compilación no contienen información de seguridad, por lo que no requieren autenticación.

**Topics**
+ [Creación de un proyecto de compilación con insignias de compilación](#sample-build-badges-request-running)
+ [Accede a las insignias de AWS CodeBuild compilación](access-badges.md)
+ [Publica insignias de CodeBuild construcción](publish-badges.md)
+ [CodeBuild estados de insignias](badge-statuses.md)

## Creación de un proyecto de compilación con insignias de compilación
<a name="sample-build-badges-request-running"></a>

Utilice uno de los siguientes procedimientos para crear un proyecto de compilación con insignias de compilación habilitadas. Puede utilizar AWS CLI o el Consola de administración de AWS.

**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)](create-project.md#create-project-cli). Para incluir las insignias de construcción en su AWS CodeBuild proyecto, debe especificarlas *badgeEnabled* con un valor de`true`.

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

1. Abre la AWS CodeBuild consola en [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Si aparece una página de CodeBuild información, 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**. 

1. En **Project name (Nombre de proyecto)**, escriba un nombre para este proyecto de compilación. Los nombres de los proyectos de compilación deben ser únicos en cada AWS cuenta. 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.

1. 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 código fuente de Amazon S3. Como AWS CodePipeline utiliza Amazon S3 para las transferencias de artefactos, las insignias de compilación no se admiten en proyectos de compilación que formen parte de una canalización creada en. CodePipeline 
   + Si eligió **CodeCommit**, en **Repository (Repositorio)**, elija el nombre del repositorio. Seleccione **Habilitar insignia de compilación** para convertir el estado de compilación del proyecto en visible e incrustable.
   + Si lo desea **GitHub**, siga las instrucciones para conectarse (o volver a conectarse) con. GitHub En la página GitHub **Autorizar la solicitud**, en **Acceso a la organización**, selecciona **Solicitar acceso** junto a cada repositorio AWS CodeBuild al que quieras acceder. 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**. Tras seleccionar **Conceder acceso**, en la AWS CodeBuild consola, en **Repositorio**, elige 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.

1. En **Environment (Entorno)**:

   En **Environment image (Imagen del entorno)**, realice alguna de las siguientes operaciones:
   + Para usar una imagen de Docker gestionada por AWS CodeBuild, selecciona **Imagen gestionada** y, a continuación, selecciona **Sistema operativo**, **Tiempo de ejecución**, **Imagen** y **Versión de la 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 elige **Amazon ECR**, utilice el **repositorio de Amazon ECR** y la imagen de **Amazon ECR para elegir la imagen** de Docker en su cuenta. 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](https://docs.aws.amazon.com/secretsmanager/latest/userguide/) en la *Guía del usuario de AWS Secrets Manager *.

1. En **Service role (Rol de servicio)**, realice una de las operaciones siguientes:
   + **Si no tiene un rol de CodeBuild servicio, elija Nuevo rol de servicio.** Escriba un nombre para el nuevo rol en el campo **Role Name**.
   + Si tiene un rol CodeBuild de servicio, elija el **rol de servicio existente**. En **ARN de rol**, seleccione el rol de servicio.
**nota**  
Cuando utilizas la consola para crear o actualizar un proyecto de compilación, puedes crear un rol de CodeBuild servicio 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.

1. 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](build-spec-ref.md).

1. 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](build-spec-ref.md#build-spec-ref-syntax).

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

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

# Accede a las insignias de AWS CodeBuild compilación
<a name="access-badges"></a>

Puedes usar la AWS CodeBuild consola o la AWS CLI para acceder a las insignias de construcción.
+ En la CodeBuild consola, en la lista de proyectos de construcción, en la columna **Nombre**, elija el enlace que corresponda al proyecto de construcción. En la *project-name* página **Crear proyecto:**, en **Configuración**, selecciona **Copiar la URL de la insignia**. Para obtener más información, consulte [Ver los detalles de un proyecto de compilación (consola)](view-project-details.md#view-project-details-console).
+ En AWS CLI, ejecute el `batch-get-projects` comando. La URL de insignia de compilación se incluye en la sección de salida de detalles del entorno del proyecto. Para obtener más información, consulte [Ver los detalles de un proyecto de compilación (AWS CLI)](view-project-details.md#view-project-details-cli).

La URL de la solicitud de la insignia de compilación se genera con una ramificación común predeterminada, pero es posible especificar cualquier ramificación del repositorio de fuentes que haya usado para ejecutar una compilación. Por ejemplo:

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&branch=<branch>
```

También es posible especificar una etiqueta del repositorio de origen sustituyendo el parámetro `branch` por el parámetro `tag` en la URL de la insignia. Por ejemplo: 

```
https://codebuild.us-east-1.amazon.com/badges?uuid=...&tag=<tag>
```

# Publica insignias de CodeBuild construcción
<a name="publish-badges"></a>

Es posible mostrar el estado de la última compilación en un archivo de marcado utilizando la URL de la insignia de compilación en una imagen de marcado. Esto resulta útil para mostrar el estado de la compilación más reciente del archivo readme.md del repositorio de código fuente (por ejemplo, o). GitHub CodeCommit Por ejemplo:

```
![](<build badge URL>)
```

# CodeBuild estados de insignias
<a name="badge-statuses"></a>

La insignia de CodeBuild construcción puede tener uno de los siguientes estados.
+ **PASSING** La compilación más reciente en la ramificación especificada se ha realizado correctamente. 
+ **FAILING** Se ha agotado el tiempo de espera, se ha producido un error o se ha detenido la compilación más reciente en la ramificación especificada.
+ **IN\$1PROGRESS** La compilación más reciente en la ramificación especificada está en curso.
+ **UNKNOWN** El proyecto aún no ha ejecutado una compilación en la ramificación especificada o en ninguna otra. Además, la característica de insignia de compilación podría estar deshabilitada.