Ejecutar una compilación por lotes (AWS CLI)

1. Ejecute el comando start-build-batch de una de las siguientes formas:

   aws codebuild start-build-batch --project-name <project-name>

   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 > <json-file>

   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.

2. Si ejecuta el comando start-build-batch con la opción --project-name, sustituya <project-name> 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.

3. 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.

4. Si ejecuta el comando start-build-batch con la opción --generate-cli-skeleton, se envían datos en formato JSON al archivo <json-file>. 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).

   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 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.

   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.

5. 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

6. Si se ejecuta correctamente, la salida de la consola muestra la representación en JSON de un objeto BuildBatch. Consulte Sintaxis de respuesta de StartBuildBatch para ver un ejemplo de estos datos.