AWS CodeBuild referencia de acciones de construcción y prueba - AWS CodePipeline

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.

AWS CodeBuild referencia de acciones de construcción y prueba

Le permite ejecutar compilaciones y pruebas como parte de la canalización. Cuando ejecutas una acción de CodeBuild compilación o prueba, los comandos especificados en la especificación de compilación se ejecutan dentro de un CodeBuild contenedor. Todos los artefactos que se especifican como artefactos de entrada para una CodeBuild acción están disponibles dentro del contenedor en el que se ejecutan los comandos. CodeBuild puede proporcionar una acción de construcción o de prueba. Para obtener más información, consulte la AWS CodeBuild Guía del usuario de .

Cuando utilizas el CodePipeline asistente de la consola para crear un proyecto de compilación, el proyecto de CodeBuild compilación muestra que el proveedor de origen es CodePipeline. Cuando creas un proyecto de compilación en la CodeBuild consola, no puedes especificarlo CodePipeline como proveedor de origen, pero si agregas la acción de compilación a tu canalización, se ajusta la fuente en la CodeBuild consola. Para obtener más información, consulta ProjectSourcela AWS CodeBuild APIReferencia.

Tipo de acción

  • Categoría: Build o Test

  • Propietario: AWS

  • Proveedor: CodeBuild

  • Versión: 1

Parámetros de configuración

ProjectName

Obligatorio: sí

ProjectNamees el nombre del proyecto de construcción en CodeBuild.

PrimarySource

Obligatorio: condicional

El valor del PrimarySource parámetro debe ser el nombre de uno de los artefactos de entrada a la acción. CodeBuild busca el archivo de especificaciones de compilación y ejecuta los comandos de especificaciones de compilación en el directorio que contiene la versión descomprimida de este artefacto.

Este parámetro es obligatorio si se especifican varios artefactos de entrada para una acción. CodeBuild Cuando solo hay un artefacto de origen para la acción, el artefacto PrimarySource se establece como valor predeterminado de dicho artefacto.

BatchEnabled

Obligatorio: no

El valor booleano del parámetro BatchEnabled permite que la acción ejecute varias compilaciones en la misma ejecución de compilación.

Cuando esta opción está habilitada, la opción CombineArtifacts está disponible.

Para ver ejemplos de canalizaciones con compilaciones por lotes habilitadas, consulte CodePipeline Integración CodeBuild y compilaciones por lotes.

CombineArtifacts

Obligatorio: no

El valor booleano del parámetro CombineArtifacts combina todos los artefactos de compilación de una compilación por lotes en un único archivo de artefactos para la acción de compilación.

Para utilizar esta opción, el parámetro BatchEnabled debe estar activado.

EnvironmentVariables

Obligatorio: no

El valor de este parámetro se usa para establecer las variables de entorno para la CodeBuild acción en tu canalización. El valor del EnvironmentVariables parámetro adopta la forma de una JSON matriz de objetos variables de entorno. Consulte el parámetro de ejemplo en Declaración de acciones (ejemplo de CodeBuild).

Cada objeto tiene tres partes, todas las cuales son cadenas:

  • name: el nombre o la clave de la variable de entorno.

  • value: el valor de la variable de entorno. Si utiliza el SECRETS_MANAGER tipo PARAMETER_STORE o, este valor debe ser el nombre de un parámetro que ya haya almacenado en el Almacén de parámetros de AWS Systems Manager o un secreto que ya haya guardado en AWS Secrets Manager, respectivamente.

    nota

    Se desaconseja usar variables de entorno para almacenar valores confidenciales, especialmente las credenciales de AWS . Al utilizar la CodeBuild consola o AWS CLI, las variables de entorno se muestran en texto plano. Para valores confidenciales, se recomienda utilizar el tipo SECRETS_MANAGERen su lugar.

  • type: (opcional) el tipo de la variable de entorno. Los valores válidos son PARAMETER_STORE, SECRETS_MANAGER o PLAINTEXT. Si no se especifica, toma el valor predeterminado PLAINTEXT.

nota

Al introducir namevalue, y type para la configuración de las variables de entorno, especialmente si la variable de entorno contiene la sintaxis de la variable de CodePipeline salida, no supere el límite de 1000 caracteres del campo de valor de la configuración. Cuando se supera este límite, se devuelve un error de validación.

Para obtener más información, consulte EnvironmentVariablela AWS CodeBuild API Referencia. Para ver un ejemplo de CodeBuild acción con una variable de entorno que se resuelve en el nombre de la GitHub rama, consulteEjemplo: utilice una BranchName variable con CodeBuild variables de entorno.

Artefactos de entrada

  • Número de artefactos: 1 to 5

  • Descripción: CodeBuild busca el archivo de especificaciones de compilación y ejecuta los comandos de especificaciones de compilación desde el directorio del artefacto fuente principal. Si se especifica más de una fuente de entrada para la CodeBuild acción, este artefacto debe configurarse mediante el parámetro de configuración de la PrimarySource acción en. CodePipeline

    Cada artefacto de entrada se extrae en su propio directorio, cuyas ubicaciones se almacenan en variables de entorno. El directorio del artefacto de origen principal está disponible con $CODEBUILD_SRC_DIR. Los directorios del resto de artefactos de entrada están disponibles con $CODEBUILD_SRC_DIR_yourInputArtifactName.

    nota

    El artefacto configurado en tu CodeBuild proyecto se convierte en el artefacto de entrada utilizado por la CodeBuild acción en tu proceso.

Artefactos de salida

  • Número de artefactos: 0 to 5

  • Descripción: Se pueden usar para hacer que los artefactos que se definen en el archivo de especificaciones de CodeBuild compilación estén disponibles para acciones posteriores en proceso. Cuando solo se define un artefacto de salida, este artefacto se puede definir directamente en la sección artifacts del archivo de especificación de compilación. Cuando se especifica más de un artefacto de salida, todos los artefactos a los que se hace referencia deben definirse como artefactos secundarios en el archivo de especificación de compilación. Los nombres de los artefactos de salida CodePipeline deben coincidir con los identificadores de artefactos del archivo de especificaciones de compilación.

    nota

    El artefacto configurado en el CodeBuild proyecto se convierte en el artefacto de CodePipeline entrada de la acción de la canalización.

    Si se selecciona el parámetro CombineArtifacts para compilaciones por lotes, la ubicación del artefacto de salida contiene los artefactos combinados de varias compilaciones que se ejecutaron en la misma ejecución.

Variables de salida

Esta acción producirá como variables todas las variables de entorno que se exportaron como parte de la compilación. Para obtener más información sobre cómo exportar variables de entorno, consulta EnvironmentVariablela AWS CodeBuild API Guía.

Para obtener más información sobre el uso de variables de CodeBuild entorno en CodePipeline, consulte los ejemplos deCodeBuild variables de salida de una acción. Para obtener una lista de las variables de entorno que puede utilizar CodeBuild, consulte Variables de entorno en entornos de compilación en la Guía del AWS CodeBuild usuario.

Declaración de acciones (ejemplo de CodeBuild)

YAML
Name: Build Actions: - Name: PackageExport ActionTypeId: Category: Build Owner: AWS Provider: CodeBuild Version: '1' RunOrder: 1 Configuration: BatchEnabled: 'true' CombineArtifacts: 'true' ProjectName: my-build-project PrimarySource: MyApplicationSource1 EnvironmentVariables: '[{"name":"TEST_VARIABLE","value":"TEST_VALUE","type":"PLAINTEXT"},{"name":"ParamStoreTest","value":"PARAMETER_NAME","type":"PARAMETER_STORE"}]' OutputArtifacts: - Name: MyPipeline-BuildArtifact InputArtifacts: - Name: MyApplicationSource1 - Name: MyApplicationSource2
JSON
{ "Name": "Build", "Actions": [ { "Name": "PackageExport", "ActionTypeId": { "Category": "Build", "Owner": "AWS", "Provider": "CodeBuild", "Version": "1" }, "RunOrder": 1, "Configuration": { "BatchEnabled": "true", "CombineArtifacts": "true", "ProjectName": "my-build-project", "PrimarySource": "MyApplicationSource1", "EnvironmentVariables": "[{\"name\":\"TEST_VARIABLE\",\"value\":\"TEST_VALUE\",\"type\":\"PLAINTEXT\"},{\"name\":\"ParamStoreTest\",\"value\":\"PARAMETER_NAME\",\"type\":\"PARAMETER_STORE\"}]" }, "OutputArtifacts": [ { "Name": "MyPipeline-BuildArtifact" } ], "InputArtifacts": [ { "Name": "MyApplicationSource1" }, { "Name": "MyApplicationSource2" } ] } ] }

Los recursos relacionados siguientes pueden serle de ayuda cuando trabaje con esta acción.