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.
# Incorpora AWS CodeBuild
-a
```
Para ejecutar una compilación de ARM, utilice el comando siguiente:
```
$ ./codebuild_build.sh -i -a -l public.ecr.aws/codebuild/local-builds:aarch64
```
**Sustitúyalo por el nombre de la imagen del contenedor, como `aws/codebuild/standard:5.0` o`public.ecr.aws/codebuild/amazonlinux-x86_64-standard:4.0`.
El script lanza la imagen de compilación y ejecuta la compilación en el proyecto en el directorio actual. Para especificar la ubicación del proyecto de compilación, añada la opción `-s ` al comando del script.
## Reciba notificaciones sobre las nuevas versiones CodeBuild del agente
```
Utilice esta opción si desea ejecutar una compilación que utilice la última versión del artefacto de entrada de la compilación y la configuración existente del proyecto de compilación.
```
aws codebuild start-build --generate-cli-skeleton
```
Utilice esta opción si desea ejecutar una versión de compilación con una versión anterior del artefacto de entrada de compilación o si desea anular la configuración de los artefactos de salida de compilación, variables de entorno, especificación de compilación o período de tiempo de espera de compilación predeterminado.
1. Si ejecuta el comando **start-build** con la opción `--project-name`, sustituya ** por el nombre del proyecto de compilación y vaya al paso 6 de este procedimiento. Para obtener una lista de proyectos de compilación, consulte [Visualización de los nombres de los proyectos de compilación](view-project-list.md).
1. Si ejecuta el comando **start-build** con la opción `--idempotency-token`, se incluye un identificador único en el que se distingue entre mayúsculas y minúsculas, o token, con la solicitud de `start-build`. El token es válido durante 5 minutos después de la solicitud. Si repite la solicitud `start-build` con el mismo token, pero cambia un parámetro, CodeBuild devuelve un error de coincidencia de parámetros.
1. Si ejecuta el comando **start-build** con la opción `--generate-cli-skeleton`, se mostrarán en el resultado datos con formato JSON. Copie los datos en un archivo (por ejemplo, `start-build.json`) en la ubicación del equipo o instancia local en la que haya instalado la AWS CLI. Modifique los datos copiados para que coincidan con el siguiente formato y guarde los resultados:
```
{
"projectName": "projectName",
"sourceVersion": "sourceVersion",
"artifactsOverride": {
"type": "type",
"location": "location",
"path": "path",
"namespaceType": "namespaceType",
"name": "artifactsOverride-name",
"packaging": "packaging"
},
"buildspecOverride": "buildspecOverride",
"cacheOverride": {
"location": "cacheOverride-location",
"type": "cacheOverride-type"
},
"certificateOverride": "certificateOverride",
"computeTypeOverride": "computeTypeOverride",
"environmentTypeOverride": "environmentTypeOverride",
"environmentVariablesOverride": {
"name": "environmentVariablesOverride-name",
"value": "environmentVariablesValue",
"type": "environmentVariablesOverride-type"
},
"gitCloneDepthOverride": "gitCloneDepthOverride",
"imageOverride": "imageOverride",
"idempotencyToken": "idempotencyToken",
"insecureSslOverride": "insecureSslOverride",
"privilegedModeOverride": "privilegedModeOverride",
"queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
"reportBuildStatusOverride": "reportBuildStatusOverride",
"timeoutInMinutesOverride": "timeoutInMinutesOverride",
"sourceAuthOverride": "sourceAuthOverride",
"sourceLocationOverride": "sourceLocationOverride",
"serviceRoleOverride": "serviceRoleOverride",
"sourceTypeOverride": "sourceTypeOverride"
}
```
Reemplace los siguientes marcadores de posición:
+ *projectName*: cadena necesaria. El nombre del proyecto de compilación que desea usar para esta compilación.
+ *sourceVersion*: cadena opcional. Una versión del código fuente que se va a compilar, como la siguiente:
+ Para Amazon S3, el ID de versión correspondiente a la versión del archivo ZIP de entrada que desea compilar. Si no se especifica *sourceVersion*, se usa la versión más reciente.
+ Para CodeCommit, el ID de confirmación correspondiente a la versión del código fuente que desea compilar. Si no se especifica *sourceVersion*, se usa el ID de confirmación HEAD de la ramificación personalizada. (No puede especificar un nombre de etiqueta para *sourceVersion*, pero puede especificar el ID de confirmación de la etiqueta).
+ Para GitHub, el ID de confirmación, el ID de solicitud de inserción, el nombre de ramificación o el nombre de etiqueta correspondiente a la versión de código fuente que desea compilar. Si se especifica un ID de solicitud de inserción, este debe tener el formato `pr/pull-request-ID` (por ejemplo, `pr/25`). Si se especifica un nombre de ramificación, se usa el ID de confirmación HEAD de la ramificación. Si no se especifica *sourceVersion*, se usa el ID de confirmación HEAD de la ramificación personalizada.
+ Para Bitbucket, el ID de confirmación, el nombre de ramificación o el nombre de etiqueta correspondiente a la versión de código fuente que desea compilar. Si se especifica un nombre de ramificación, se usa el ID de confirmación HEAD de la ramificación. Si no se especifica *sourceVersion*, se usa el ID de confirmación HEAD de la ramificación personalizada.
+ Los siguientes marcadores de posición son para `artifactsOverride`.
+ *type*: opcional. El tipo de artefacto de salida de la compilación que invalida el definido en el proyecto de compilación para esta compilación.
+ *location*: opcional. La ubicación del artefacto de salida de la compilación que invalida la definida en el proyecto de compilación para esta compilación.
+ *path*: opcional. La ruta del artefacto de salida de la compilación que invalida la definida en el proyecto de compilación para esta compilación.
+ *namespaceType*: opcional. El tipo de ruta del artefacto de salida de la compilación que invalida el definido en el proyecto de compilación para esta compilación.
+ *name*: opcional. El nombre del artefacto de salida de la compilación que invalida el definido en el proyecto de compilación para esta compilación.
+ *packaging*: opcional. El tipo de empaquetado del artefacto de salida de la compilación que invalida el definido en el proyecto de compilación para esta compilación.
+ *buildspecOverride*: opcional. Declaración de buildspec que invalida la declaración definida en el proyecto de esta compilación. Si se establece este valor, puede ser una definición de buildspec en línea, la ruta a un archivo de buildspec alternativo en relación con el valor de la variable de entorno `CODEBUILD_SRC_DIR` incorporada, o la ruta a un bucket de S3. El bucket de S3 debe estar en la misma región de AWS que el proyecto de compilación. Especifique el archivo buildspec utilizando su ARN (por ejemplo, `arn:aws:s3:::/buildspec.yml`). Si este valor no se proporciona o se establece en una cadena vacía, el código fuente debe contener un archivo `buildspec.yml` en su directorio raíz. Para obtener más información, consulte [Nombre de archivo y ubicación de almacenamiento de buildspec](build-spec-ref.md#build-spec-ref-name-storage).
+ Los siguientes marcadores de posición son para `cacheOverride`.
+ *cacheOverride-location*: opcional. La ubicación de un objeto `ProjectCache` para esta compilación que anula el objeto `ProjectCache` especificado en el proyecto de compilación. `cacheOverride` es opcional y toma un objeto `ProjectCache`. `location` es obligatorio en un objeto `ProjectCache`.
+ *cacheOverride-type*: opcional. El tipo de un objeto `ProjectCache` para esta compilación que anula el objeto `ProjectCache` especificado en el proyecto de compilación. `cacheOverride` es opcional y toma un objeto `ProjectCache`. `type` es obligatorio en un objeto `ProjectCache`.
+ *certificateOverride*: opcional. El nombre de un certificado para esta compilación que sustituye el especificado en el proyecto de compilación.
+ *environmentTypeOverride*: opcional. Un tipo de contenedor para esta compilación que sustituye el especificado en el proyecto de compilación. La cadena válida actual es `LINUX_CONTAINER`.
+ Los siguientes marcadores de posición son para `environmentVariablesOverride`.
+ *environmentVariablesOverride-name*: opcional. El nombre de una variable de entorno del proyecto de compilación cuyo valor desea invalidar para esta compilación.
+ *environmentVariablesOverride-type*: opcional. El tipo de variable de entorno del proyecto de compilación cuyo valor desea invalidar para esta compilación.
+ *environmentVariablesValue*: opcional. El valor de la variable de entorno definida en el proyecto de compilación que desea invalidar para esta compilación.
+ *gitCloneDepthOverride*: opcional. El valor de **Git clone depth** en el proyecto de compilación cuyo valor desea invalidar para esta compilación. Si el tipo de origen es Amazon S3, este valor no se admite.
+ *imageOverride*: opcional. El nombre de una imagen para esta compilación que sustituye el especificado en el proyecto de compilación.
+ *idempotencyToken*: opcional. Una cadena que sirve de token para especificar que la solicitud de compilación es idempotente. Puede elegir cualquier cadena de 64 caracteres o menos. El token es válido durante 5 minutos después de la solicitud de inicio de la compilación. Si se repite la solicitud de inicio de compilación con el mismo token, pero se cambia un parámetro, CodeBuild devuelve un error de coincidencia de parámetros.
+ *insecureSslOverride*: valor booleano opcional que especifica si la configuración TLS no segura especificada se va a invalidar en el proyecto de compilación. La configuración de TLS no segura determina si deben omitirse las advertencias de TLS al conectarse al código fuente del proyecto. Esta sustitución se aplica únicamente si el origen de la compilación es GitHub Enterprise Server.
+ *privilegedModeOverride*: valor booleano opcional. Si se establece en true, la compilación sustituye el modo privilegiado en el proyecto de compilación.
+ *queuedTimeoutInMinutesOverride*: Número entero opcional que especifica el número de minutos que se permite en cola una compilación antes de que transcurra el tiempo de espera. Su valor mínimo es de cinco minutos y su valor máximo es 480 minutos (ocho horas).
+ *reportBuildStatusOverride*: valor booleano opcional que especifica si se debe enviar al proveedor de código fuente el estado de inicio y finalización de una compilación. Si define este valor con un proveedor de código fuente distinto de GitHub, GitHub Enterprise Server o Bitbucket, se genera una excepción invalidInputException.
+ *sourceAuthOverride*: cadena opcional. Un tipo de autorización para esta compilación que sustituye la definida en el proyecto de compilación. Esta sustitución se aplica únicamente si el origen del proyecto de compilación es Bitbucket o GitHub.
+ *sourceLocationOverride*: cadena opcional. Una ubicación que sustituye la ubicación de código fuente de este proyecto por la definida en el proyecto de compilación.
+ *serviceRoleOverride*: cadena opcional. El nombre de un rol de servicio para esta compilación que sustituye el especificado en el proyecto de compilación.
+ *sourceTypeOverride*: cadena opcional. Un tipo de entrada de código fuente para esta compilación que sustituye la entrada de código fuente definida en el proyecto de compilación. Las cadenas válidas son `NO_SOURCE`, `CODECOMMIT`, `CODEPIPELINE`, `GITHUB`, `S3`, `BITBUCKET` y `GITHUB_ENTERPRISE`.
+ *timeoutInMinutesOverride*: número opcional. El número de minutos de tiempo de espera de la compilación que invalida el definido en el proyecto de compilación para esta compilación.
Le recomendamos que almacene una variable de entorno con un valor confidencial, como un ID de clave de acceso de AWS, una clave de acceso secreta de AWS o una contraseña, como un parámetro en el almacén de parámetros de Amazon EC2 Systems Manager. CodeBuild puede utilizar un parámetro almacenado en el almacén de parámetros de Amazon EC2 Systems Manager solo si el nombre del parámetro comienza por `/CodeBuild/` (por ejemplo, `/CodeBuild/dockerLoginPassword`). Puede utilizar la consola de CodeBuild para crear un parámetro en Amazon EC2 Systems Manager. Elija **Crear un parámetro** y siga las instrucciones. (En ese cuadro de diálogo, en **Clave de KMS**, puede especificar si lo desea el ARN de una clave de AWS KMS de su cuenta. Amazon EC2 Systems Manager utiliza esta clave para cifrar el valor del parámetro durante el almacenamiento y descifrarlo durante la recuperación). Si usa la consola de CodeBuild para crear un parámetro, la consola asigna `/CodeBuild/` al principio del parámetro cuando lo almacena. Sin embargo, si utiliza la consola del almacén de parámetros de Amazon EC2 Systems Manager para crear un parámetro, el nombre del parámetro debe comenzar por `/CodeBuild/` y debe establecer **Tipo** en **Cadena segura**. Para obtener más información, consulte [Almacenamiento de parámetros de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) y [Tutorial : Crear y probar un parámetro de cadena de caracteres (consola)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html) en la *Guía del usuario de Amazon EC2 Systems Manager*.
Si el proyecto de compilación hace referencia a parámetros almacenados en el almacén de parámetros de Amazon EC2 Systems Manager, el rol de servicio del proyecto de compilación debe permitir la acción `ssm:GetParameters`. Si se ha seleccionado **Crear un nuevo rol de servicio en su cuenta** anteriormente, CodeBuild incluye esta acción en el rol de servicio predeterminado del proyecto de compilación automáticamente. Sin embargo, si se ha seleccionado **Seleccionar un rol de servicio existente de su cuenta**, debe incluir esta acción en su rol de servicio por separado.
Las variables de entorno que defina reemplazan las variables de entorno existentes. Por ejemplo, si la imagen de Docker ya contiene una variable de entorno denominada `MY_VAR` con un valor de `my_value` y establece una variable de entorno denominada `MY_VAR` con un valor de `other_value`, `my_value` se reemplaza por `other_value`. Asimismo, si la imagen de Docker ya contiene una variable de entorno denominada `PATH` con un valor de `/usr/local/sbin:/usr/local/bin` y establece una variable de entorno denominada `PATH` con un valor de `$PATH:/usr/share/ant/bin`, `/usr/local/sbin:/usr/local/bin` se reemplaza por el valor literal `$PATH:/usr/share/ant/bin`.
No establezca variables de entorno con un nombre que empiece por `CODEBUILD_`. Este prefijo se reserva para uso interno.
Si se define una variable de entorno con el mismo nombre en varios lugares, el valor de la variable de entorno se determina de la siguiente manera:
+ El valor de la llamada a la operación de inicio de la compilación tiene la máxima prioridad.
+ El valor de la definición del proyecto de compilación es el siguiente en orden de prioridad.
+ El valor en la declaración del archivo buildspec tiene la prioridad más baja.
Para obtener información sobre los valores válidos para estos marcadores de posición, consulte [Crear un proyecto de compilación (AWS CLI)](create-project.md#create-project-cli). Para obtener una lista de las últimas opciones de configuración de un proyecto de compilación, consulte [Visualización de los detalles de un proyecto de compilación](view-project-details.md).
1. Cambie al directorio que contiene el archivo que acaba de guardar y ejecute de nuevo el comando `start-build`.
```
aws codebuild start-build --cli-input-json file://start-build.json
```
1. Si el comando se ejecuta correctamente, aparecerán datos similares a los que se describen en el procedimiento [Para ejecutar la compilación](getting-started-overview.md#getting-started-run-build-cli) en el resultado.
Para trabajar con información detallada acerca de esta compilación, anote el valor de `id` en la salida y después consulte [Ver detalles de las compilaciones (AWS CLI)](view-build-details.md#view-build-details-cli).
# Ejecutar una compilación por lotes (AWS CLI)
```
Utilice esta opción si desea ejecutar una compilación que utilice la última versión del artefacto de entrada de la compilación y la configuración existente del proyecto de compilación.
```
aws codebuild start-build-batch --generate-cli-skeleton >
```
Utilice esta opción si desea ejecutar una versión de compilación con una versión anterior del artefacto de entrada de compilación o si desea anular la configuración de los artefactos de salida de compilación, variables de entorno, especificación de compilación o período de tiempo de espera de compilación predeterminado.
1. Si ejecuta el comando **start-build-batch** con la opción `--project-name`, sustituya ** por el nombre del proyecto de compilación y vaya al paso 6 de este procedimiento. Para obtener una lista de proyectos de compilación, consulte [Visualización de los nombres de los proyectos de compilación](view-project-list.md).
1. Si ejecuta el comando **start-build-batch** con la opción `--idempotency-token`, se incluye un identificador único en el que se distingue entre mayúsculas y minúsculas, o token, con la solicitud de `start-build-batch`. El token es válido durante 5 minutos después de la solicitud. Si repite la solicitud `start-build-batch` con el mismo token, pero cambia un parámetro, CodeBuild devuelve un error de coincidencia de parámetros.
1. Si ejecuta el comando **start-build-batch** con la opción `--generate-cli-skeleton`, se envían datos en formato JSON al archivo **. Este archivo es similar al esqueleto producido por el comando **start-build**, con la incorporación del objeto siguiente. Para obtener más información acerca de los objetos comunes, consulte [Ejecutar una compilación (AWS CLI)](run-build-cli.md).
Modifique este archivo para añadir cualquier modificación a la compilación y guarde los resultados.
```
"buildBatchConfigOverride": {
"combineArtifacts": combineArtifacts,
"restrictions": {
"computeTypesAllowed": [
allowedComputeTypes
],
"maximumBuildsAllowed": maximumBuildsAllowed
},
"serviceRole": "batchServiceRole",
"timeoutInMins": batchTimeout
}
```
El objeto `buildBatchConfigOverride` es una estructura [ProjectBuildBatchConfig](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectBuildBatchConfig.html) que contiene las modificaciones a la configuración de compilación por lotes para esta compilación.
*combineArtifacts*
Especifica si los artefactos de compilación para la compilación por lotes se deben combinar en una única ubicación de artefactos.
*allowedComputeTypes*
Una matriz de cadenas que especifican los tipos de computación permitidos para la compilación por lotes. Consulte los valores en [Tipos de computación del entorno de compilación](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html).
*maximumBuildsAllowed*
Especifica el número máximo de compilaciones permitidas.
*batchServiceRole*
Especifica el ARN del rol de servicio para el proyecto de compilación por lotes.
*batchTimeout*
Especifica la cantidad máxima de tiempo, en minutos, en que se debe completar la compilación por lotes.
1. Cambie al directorio que contiene el archivo que acaba de guardar y ejecute de nuevo el comando `start-build-batch`.
```
aws codebuild start-build-batch --cli-input-json file://start-build.json
```
1. Si se ejecuta correctamente, la salida de la consola muestra la representación en JSON de un objeto [BuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_BuildBatch.html). Consulte [Sintaxis de respuesta de StartBuildBatch](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_ResponseSyntax) para ver un ejemplo de estos datos.
# Iniciar la ejecución de compilaciones automáticamente (AWS CLI)
```
**es el nombre del proyecto de compilación que contiene el código fuente que se va a reconstruir.
Pues GitHub, en el resultado aparece información similar a la siguiente:
```
{
"webhook": {
"url": ""
}
}
```
**es la URL del GitHub webhook.
En el GitHub caso de Enterprise Server, en el resultado aparece información similar a la siguiente:
![\[Información de la salida del ejemplo.\]](http://docs.aws.amazon.com/es_es/codebuild/latest/userguide/images/create-webhook-ghe.png)
1. Copie la URL de carga y la clave secreta de la salida. Los necesita para añadir un webhook en GitHub Enterprise Server.
1. En GitHub Enterprise Server, elige el repositorio en el que está almacenado tu CodeBuild proyecto. Elija **Settings (Configuración)**, elija **Hooks & services (Enlaces y servicios)** y, a continuación, elija **Add webhook (Añadir webhook)**.
1. Introduzca la URL de carga y la clave secreta, acepte los valores predeterminados para el resto de los campos y elija **Add webhook**.
# Detener la ejecución de compilaciones automáticamente (AWS CLI)
```
+ donde ** es el nombre del proyecto de compilación que contiene el código fuente que se va a reconstruir.
Si este comando se ejecuta correctamente, no aparecerá información ni errores en el resultado.
**nota**
Esto elimina el webhook únicamente de tu CodeBuild proyecto. También debes eliminar el webhook de tu repositorio GitHub o de GitHub Enterprise Server.
# Ejecutar una compilación (AWS SDKs)
```
1. Cargue la carpeta AWS SAM del proyecto en un repositorio de código fuente compatible. Para obtener una lista de los tipos de fuentes compatibles, consulte [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Creación de un CodeBuild proyecto Java Lambda
` en su máquina local para crear una aplicación React sencilla.
1. Cargue la carpeta del proyecto de la aplicación React en un repositorio de origen admitido. Para obtener una lista de los tipos de fuentes compatibles, consulte [ProjectSource](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ProjectSource.html).
## Crear un proyecto CodeBuild Lambda Node.js
"
LAMBDA_ENV_VARIABLE: "FEATURE_ENABLED"
LAMBDA_ENV_VARIABLE_VALUE: "true"
phases:
install:
commands:
- pip3 install boto3
build:
commands:
- python3 update_lambda_environment_variables.py
```
1. Seleccione **Update buildspec (Actualizar buildspec)**.
## Actualización de la configuración de Lambda
[ ...]
```
+ ``, ``, etc.: uno o más patrones globales para compararlos con los archivos del directorio de trabajo.
+ `*`: coincide con cualquier secuencia de caracteres (excepto los separadores de ruta).
+ `**`: coincide con cualquier secuencia de caracteres (incluidos los separadores de ruta).
**nota**
Asegúrese de que la cadena global vaya entre comillas. Para comprobar los resultados de la coincidencia de patrones, utilice el comando `echo`.
```
version: 0.2
phases:
build:
commands:
- echo $(codebuild-glob-search '**/__tests__/*.js')
- codebuild-glob-search '**/__tests__/*.js' | xargs -n 1 echo
```
## Output
`, donde el `shard_number` representa el número de partición en el que se crea el grupo de informes. Esta organización le permite realizar un seguimiento y analizar tendencias tanto en el nivel de compilación consolidada como individual, lo que proporciona flexibilidad a la hora de monitorear y evaluar sus procesos de compilación.
El informe de creación por lotes sigue la misma estructura que los [informes de compilación individuales](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_Report.html). Los siguientes campos clave de la pestaña **Informe** son específicos de los informes de compilación por lotes:
**Estado de informe de compilación por lotes**
El estado de los informes de creación por lotes sigue reglas específicas según el tipo de informe:
+ Informes de pruebas:
+ Correcto: el estado se establece como correcto cuando todos los informes de compilación individuales se han realizado correctamente.
+ Error: el estado se establece como fallido si ha fallado algún informe de compilación individual.
+ Incompleto: el estado se marca como incompleto si falta algún informe de compilación individual o tiene un estado incompleto.
+ Informes de cobertura de código:
+ Completo: el estado se establece como completo cuando se han completado todos los informes de compilación individuales.
+ Error: el estado se establece como fallido si ha fallado algún informe de compilación individual.
+ Incompleto: el estado se marca como incompleto si falta algún informe de compilación individual o tiene un estado incompleto.
**Resumen de pruebas**
El informe de prueba combinado consolida los siguientes campos de todos los informes de compilación individuales:
+ duration-in-nano-seconds: Tiempo máximo de duración de la prueba en nanosegundos entre todos los informes de compilación individuales.
+ total: recuento combinado de todos los casos de prueba, sumando el número total de pruebas de cada compilación.
+ status-counts: proporciona una vista consolidada de estados de las pruebas, como superadas, fallidas u omitidas, que se calcula sumando el recuento de cada tipo de estado en todas las compilaciones individuales.
**Resumen de cobertura de código**
El informe combinado de cobertura de código combina campos de todas las compilaciones individuales utilizando los siguientes cálculos:
+ branches-covered: suma de todas las ramificaciones cubiertas de informes individuales.
+ branches-missed: suma de todas las ramificaciones omitidas de informes individuales.
+ branch-coverage-percentage: `(Total covered branches / Total branches) * 100`
+ lines-covered: suma de todas las líneas cubiertas de informes individuales.
+ lines-missed: suma de todas las líneas omitidas de informes individuales.
+ lines-coverage-percentage: `(Total covered lines / Total lines) * 100`
**ID de ejecución**
ARN de compilación por lotes.
**Casos de prueba**
El informe combinado contiene una lista consolidada de todos los casos de prueba de compilaciones individuales, a la que se puede acceder a través de la [DescribeTestCases](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeTestCases.html)API y del informe de compilación por lotes de la consola.
**Coberturas de código**
El informe de cobertura de código combinado proporciona información consolidada sobre la cobertura de líneas y sucursales de cada archivo en todas las compilaciones individuales, a la que se puede acceder a través de la [DescribeCodeCoverages](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DescribeCodeCoverages.html)API y del informe de compilación por lotes de la consola. Nota: En el caso de los archivos cubiertos por varios archivos de prueba distribuidos en diferentes particiones, el informe combinado sigue estos criterios de selección:
1. La selección principal se basa en la cobertura de línea más alta entre las particiones.
1. Si la cobertura de línea es igual en varias particiones, se seleccione la partición con mayor cobertura de ramificación.
# Ejemplo de ejecución de pruebas paralelas para varios marcos de prueba
...
```
Algunos ejemplos de uso de `codebuild-hash-files`:
```
codebuild-hash-files package-lock.json
codebuild-hash-files '**/*.md'
```
## Versión de caché
Artifacts:
Type: S3
Location:
Name: myArtifact
EncryptionDisabled: true
OverrideArtifactName: true
Environment:
Type: LINUX_CONTAINER
ComputeType: BUILD_GENERAL1_SMALL
Image: aws/codebuild/standard:5.0
Certificate:
# PrivilegedMode must be true if you specify LOCAL_DOCKER_LAYER_CACHE
PrivilegedMode: true
Source:
Type: GITHUB
Location:
InsecureSsl: true
GitCloneDepth: 1
ReportBuildStatus: false
TimeoutInMinutes: 10
Cache:
Type: LOCAL
Modes: # You can specify one or more cache mode,
- LOCAL_CUSTOM_CACHE
- LOCAL_DOCKER_LAYER_CACHE
- LOCAL_SOURCE_CACHE
```
**nota**
De forma predeterminada, el daemon de Docker está habilitado para compilaciones sin VPC. Si quiere usar contenedores de Docker para las compilaciones de VPC, consulte [Runtime Privilege and Linux Capabilities](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities) en el sitio web de Docker Docs y habilite el modo privilegiado. Además, Windows no admite el modo privilegiado.
Para obtener más información, consulte [Crear un proyecto de compilación (CloudFormation)](create-project.md#create-project-cloud-formation).
# Depurar compilaciones AWS CodeBuild
:`
Por ejemplo, `project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
+ ARN de sandbox: arn:aws:codebuild: ::sandbox/**: ** ** **
Por ejemplo, `arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name:d25be134-05cb-404a-85da-ac5f85d2d72c`.
------
#### [ Sample response ]
```
{
"sandboxes": [{
"id": "project-name",
"arn": "arn:aws:codebuild:us-west-2:962803963624:sandbox/project-name",
"projectName": "project-name",
"requestTime": "2025-02-06T11:24:15.560000-08:00",
"endTime": "2025-02-06T11:39:21.587000-08:00",
"status": "STOPPED",
"source": {
"type": "S3",
"location": "arn:aws:s3:::cofa-e2e-test-1-us-west-2-beta-default-build-sources/eb-sample-jetty-v4.zip",
"insecureSsl": false
},
"environment": {
"type": "LINUX_CONTAINER",
"image": "aws/codebuild/standard:6.0",
"computeType": "BUILD_GENERAL1_SMALL",
"environmentVariables": [{
"name": "foo",
"value": "bar",
"type": "PLAINTEXT"
},
{
"name": "bar",
"value": "baz",
"type": "PLAINTEXT"
}
],
"privilegedMode": false,
"imagePullCredentialsType": "CODEBUILD"
},
"timeoutInMinutes": 10,
"queuedTimeoutInMinutes": 480,
"logConfig": {
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
},
"encryptionKey": "arn:aws:kms:us-west-2:962803963624:alias/SampleEncryptionKey",
"serviceRole": "arn:aws:iam::962803963624:role/BuildExecutionServiceRole",
"currentSession": {
"id": "0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"currentPhase": "COMPLETED",
"status": "STOPPED",
"startTime": "2025-02-06T11:24:15.626000-08:00",
"endTime": "2025-02-06T11:39:21.600000-08:00",
"phases": [{
"phaseType": "SUBMITTED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.577000-08:00",
"endTime": "2025-02-06T11:24:15.606000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "QUEUED",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:15.606000-08:00",
"endTime": "2025-02-06T11:24:16.067000-08:00",
"durationInSeconds": 0
},
{
"phaseType": "PROVISIONING",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:16.067000-08:00",
"endTime": "2025-02-06T11:24:20.519000-08:00",
"durationInSeconds": 4,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "DOWNLOAD_SOURCE",
"phaseStatus": "SUCCEEDED",
"startTime": "2025-02-06T11:24:20.519000-08:00",
"endTime": "2025-02-06T11:24:22.238000-08:00",
"durationInSeconds": 1,
"contexts": [{
"statusCode": "",
"message": ""
}]
},
{
"phaseType": "RUNNING_SANDBOX",
"phaseStatus": "TIMED_OUT",
"startTime": "2025-02-06T11:24:22.238000-08:00",
"endTime": "2025-02-06T11:39:21.560000-08:00",
"durationInSeconds": 899,
"contexts": [{
"statusCode": "BUILD_TIMED_OUT",
"message": "Build has timed out. "
}]
},
{
"phaseType": "COMPLETED",
"startTime": "2025-02-06T11:39:21.560000-08:00"
}
],
"logs": {
"groupName": "group",
"streamName": "stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"deepLink": "https://console.aws.amazon.com/cloudwatch/home?region=us-west-2#logsV2:log-groups/log-group/group/log-events/stream$252F0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3DeepLink": "https://s3.console.aws.amazon.com/s3/object/codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz?region=us-west-2",
"cloudWatchLogsArn": "arn:aws:logs:us-west-2:962803963624:log-group:group:log-stream:stream/0103e0e7-52aa-4a3d-81dd-bfc27226fa54",
"s3LogsArn": "arn:aws:s3:::codefactory-test-pool-1-us-west-2-beta-default-build-logs/0103e0e7-52aa-4a3d-81dd-bfc27226fa54.gz",
"cloudWatchLogs": {
"status": "ENABLED",
"groupName": "group",
"streamName": "stream"
},
"s3Logs": {
"status": "ENABLED",
"location": "codefactory-test-pool-1-us-west-2-beta-default-build-logs",
"encryptionDisabled": false
}
}
}
}],
"sandboxesNotFound": []
}
```
------
### Detención de un entorno de pruebas (AWS CLI)
:sandbox/
```
**nota**
Para solucionar problemas de conexión, use la marca `-v` para habilitar la salida detallada. Por ejemplo, `ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1::sandbox/`.
Para obtener sugerencias adicionales para la solución de problemas, consulte [Solución de problemas AWS CodeBuild de conexión SSH en entornos aislados](sandbox-troubleshooting.md).
## Paso 4: Revise los resultados
`, es posible que se produzca un `InvalidInputException` error como el siguiente:
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts:::assumed-role//AWSCodeBuild-
is not authorized to perform: ssm:StartSession on resource.
```
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for
sandbox : codebuild: is not connected.
```
**Causa posible:**
+ Falta el agente de Systems Manager de Amazon EC2: la imagen de compilación no tiene el agente de SSM instalado o configurado correctamente.
+ Permisos insuficientes: el rol de servicio CodeBuild del proyecto carece de los permisos de SSM necesarios.
**Solución recomendada:** si utiliza una imagen personalizada para la compilación, haga lo siguiente.
1. Instalar el SSM Agent de . Para obtener más información, consulte [Instalación y desinstalación manual de SSM Agent en instancias de Amazon EC2 para Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) en **. La versión de SSM Agent debe ser `3.0.1295.0` o posterior.
1. Copie el archivo [ https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json) en el directorio de la imagen. `/etc/amazon/ssm/` De este modo se habilita **Modo de contenedor** en SSM Agent.
1. Asegúrese de que el rol de servicio de su CodeBuild proyecto tenga los siguientes permisos y, a continuación, reinicie el entorno sandbox:
```
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:StartSession"
],
"Resource": [
"arn:aws:codebuild:region:account-id:build/*",
"arn:aws:ssm:region::document/AWS-StartSSHSession"
]
}
```
## Error: «No se encuentran las credenciales» cuando se utiliza SSH en CodeBuild un entorno sandbox
`, es posible que aparezca el siguiente error de credenciales:
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Causa posible:** AWS las credenciales no se configuraron correctamente en su entorno local.
**Solución recomendada:** configure sus AWS CLI credenciales siguiendo la documentación oficial: [Configuración de los ajustes de la Guía del AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) *usuario de la interfaz de línea de AWS comandos para la versión 2*.
## `StartSandboxConnection``AccessDeniedException`error al usar SSH en un CodeBuild entorno sandbox
`, puede aparecer el siguiente error de permiso:
```
An error occurred (AccessDeniedException) when calling the StartSandboxConnection
operation:
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource:
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action
```
**Causa posible:** sus AWS credenciales carecen de los CodeBuild permisos necesarios para realizar esta operación.
**Solución recomendada:** asegúrese de que el usuario o rol de IAM asociado a sus AWS CLI credenciales tenga los siguientes permisos:
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Error: «ssh: no se ha podido resolver el nombre de host» cuando se utiliza SSH en un entorno aislado CodeBuild
`, aparece el siguiente error de resolución del nombre de host:
```
ssh: Could not resolve hostname
```
**Causa posible:** este error suele producirse cuando el script de conexión de CodeBuild espacio aislado requerido no se ha ejecutado correctamente en el entorno local.
**Solución recomendada:**
1. Descargue el script de conexión CodeBuild de sandbox.
1. Ejecute el script en el terminal para establecer la configuración de SSH necesaria.
1. Vuelva a intentar la conexión de SSH con el entorno de pruebas.
# Depuración de compilaciones con Administrador de sesiones
",
"arn:aws:s3:::/*"
]
}
]
}
```
Para obtener más información, consulte [Actividad de auditoría y registro de sesión](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-logging-auditing.html) en la *Guía del usuario de AWS Systems Manager *.
## Pausar la compilación
--region --output json
```
1. Copie el valor de la propiedad `sessionTarget`. El nombre de la propiedad `sessionTarget` puede variar en función del tipo de salida del comando `aws`. Por eso se añade `--output json` al comando en el paso anterior.
1. Utilice el comando siguiente para conectarse al contenedor de compilación.
```
aws ssm start-session --target --region
```
Para este ejemplo, comprueba que el archivo `/tmp/hello-world` exista y contiene el texto `Hello World`.
## Reanudar la compilación
--idempotency-token
```
En el comando anterior, sustituya el siguiente marcador de posición:
+ **: cadena requerida. ID de la compilación o compilación por lotes que se desea volver a intentar. Para obtener una lista de las IDs compilaciones, consulte los siguientes temas:
+ [Ver una lista de build () IDs AWS CLI](view-build-list.md#view-build-list-cli)
+ [Ver una lista de build IDs (AWS CLI) por lotes](view-build-list.md#view-batch-build-list-cli)
+ [Ver una lista de compilaciones IDs para un proyecto de compilación (AWS CLI)](view-builds-for-project.md#view-builds-for-project-cli)
+ [Ver una lista de compilaciones por lotes IDs para un proyecto de compilación (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
+ `--idempotency-token`: opcional. Si ejecuta el comando **retry-build** con la opción, se incluye un identificador único en el que se distingue entre mayúsculas y minúsculas, o token, con la solicitud de `retry-build`. El token es válido durante 5 minutos después de la solicitud. Si repites la `retry-build` solicitud con el mismo token, pero cambias un parámetro, se produce un error de CodeBuild discordancia entre los parámetros.
## Cómo reintentar hacer una compilación de forma manual (AWS SDKs)
" \
--auto-retry-limit \
--source "" \
--artifacts {} \
--environment "{\"type\": \"environment-type>\",\"image\": \"image-type>\",\"computeType\": \"compute-type>\"}" \
--service-role "service-role>"
```
En el comando anterior, sustituya los siguientes marcadores de posición:
+ **: establezca el límite de reintentos automáticos en el número máximo de reintentos automáticos deseado tras una compilación con errores.
+ **, **, **, *environment-type>*, *image-type>*, *compute-type>* y *service-role>*: establezca la configuración de proyecto deseada.
## Cómo reintentar hacer una compilación de forma automática (SDK de AWS)
```
En el comando anterior, sustituya el siguiente marcador de posición:
+ **: cadena obligatoria. Identificador del lote que se desea detener. Para obtener una lista de identificadores de compilación por lotes, consulte los temas siguientes:
+ [Ver una lista de build IDs (AWS CLI) por lotes](view-build-list.md#view-batch-build-list-cli)
+ [Ver una lista de compilaciones por lotes IDs para un proyecto de compilación (AWS CLI)](view-builds-for-project.md#view-batch-builds-for-project-cli)
## Detener una compilación por lotes (SDK de AWS)