Variables de entorno en los entornos de compilación - AWS CodeBuild

Variables de entorno en los entornos de compilación

AWS CodeBuild proporciona varias variables de entorno que puede utilizar en los comandos de compilación:

AWS_DEFAULT_REGION

La región de AWS donde se ejecuta la compilación (por ejemplo, us-east-1). Esta variable de entorno se utiliza principalmente en la AWS CLI.

AWS_REGION

La región de AWS donde se ejecuta la compilación (por ejemplo, us-east-1). Esta variable de entorno se utiliza principalmente en los SDK de AWS.

CODEBUILD_BATCH_BUILD_IDENTIFIER

Identificador de la compilación en una compilación por lotes. Se indica en la especificación de compilación del lote. Para obtener más información, consulte Referencia de especificaciones de compilación para compilación por lotes.

CODEBUILD_BUILD_ARN

Nombre de recurso de Amazon (ARN) de la compilación (por ejemplo, arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE).

CODEBUILD_BUILD_ID

ID de CodeBuild de la compilación (por ejemplo, codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE).

CODEBUILD_BUILD_IMAGE

Identificador de la imagen de compilación de CodeBuild (por ejemplo, aws/codebuild/standard:2.0).

CODEBUILD_BUILD_NUMBER

Número de compilación actual del proyecto.

CODEBUILD_BUILD_SUCCEEDING

Indica si la compilación actual se ha realizado correctamente. Se establece en 0 si la compilación ha producido un error o en 1 si la compilación se ha realizado correctamente.

CODEBUILD_INITIATOR

Entidad que inició la compilación. Si CodePipeline ha iniciado la compilación, este es el nombre de la canalización (por ejemplo codepipeline/my-demo-pipeline). Si un usuario ha iniciado la compilación, este es el nombre del usuario (por ejemplo, MyUserName). Si el complemento Jenkins para CodeBuild ha iniciado la compilación, esta es la cadena CodeBuild-Jenkins-Plugin.

CODEBUILD_KMS_KEY_ID

Identificador de la clave de AWS KMS que CodeBuild utiliza para cifrar el artefacto de salida de la compilación (por ejemplo, arn:aws:kms:region-ID:account-ID:key/key-ID o alias/key-alias).

CODEBUILD_LOG_PATH

Nombre del flujo de registro de los Registros de CloudWatch para la compilación.

CODEBUILD_PUBLIC_BUILD_URL

La URL de los resultados de compilación de esta compilación se encuentra en el sitio web de compilaciones públicas. Esta variable solo se establece si el proyecto de compilación tiene activadas las compilaciones públicas. Para obtener más información, consulte Obtención de direcciones URL de proyectos de compilación públicos.

CODEBUILD_RESOLVED_SOURCE_VERSION

Identificador de versión del código fuente de una compilación. El contenido depende del repositorio de código fuente:

CodeCommit, GitHub, GitHub Enterprise Server y Bitbucket

Esta variable contiene el ID de confirmación.

CodePipeline

Esta variable contiene la revisión de la fuente proporcionada por CodePipeline.

Si CodePipeline no puede resolver la revisión de la fuente, por ejemplo, cuando la fuente es un bucket de Amazon S3 que no tiene el control de versiones activado, esta variable de entorno no está establecida.

Amazon S3

Esta variable no está establecida.

Cuando proceda, la variable CODEBUILD_RESOLVED_SOURCE_VERSION solo está disponible después de la fase DOWNLOAD_SOURCE.

CODEBUILD_SOURCE_REPO_URL

Dirección URL del artefacto de entrada o el repositorio de código fuente. En el caso de Amazon S3, este valor es s3:// seguido del nombre del bucket y la ruta del artefacto de entrada. Para CodeCommit y GitHub, es la dirección URL del clon del repositorio. Si una compilación se origina en CodePipeline, esta variable de entorno puede estar vacía.

En el caso de las fuentes secundarias, la variable de entorno de la URL del repositorio de fuentes secundarias es CODEBUILD_SOURCE_REPO_URL_<sourceIdentifier>, donde <sourceIdentifier> es el identificador de fuente que se crea.

CODEBUILD_SOURCE_VERSION

El formato del valor depende del repositorio del código fuente.

  • Para Amazon S3, es el ID de versión asociado con el artefacto de entrada.

  • Para CodeCommit, es el ID de confirmación o el nombre de ramificación asociado con la versión del código fuente que se va a compilar.

  • Para GitHub, GitHub Enterprise Server y Bitbucket es el ID de confirmación, el nombre de ramificación o el nombre de etiqueta asociado con la versión del código fuente que se va a compilar.

    nota

    Para una compilación de GitHub o GitHub Enterprise Server activada por un evento de solicitud de extracción de webhook, es pr/pull-request-number.

En el caso de las fuentes secundarias, la variable de entorno de la versión de la fuente secundaria es CODEBUILD_SOURCE_VERSION_<sourceIdentifier>, donde <sourceIdentifier> es el identificador de fuente que se crea. Para obtener más información, consulte Ejemplo de varios orígenes de entrada y varios artefactos de salida.

CODEBUILD_SRC_DIR

Ruta del directorio que CodeBuild utiliza para la compilación (por ejemplo, /tmp/src123456789/src).

En el caso de las fuentes secundarias, la variable de entorno de la versión de la fuente secundaria es CODEBUILD_SRC_DIR_<sourceIdentifier>, donde <sourceIdentifier> es el identificador de fuente que se crea. Para obtener más información, consulte Ejemplo de varios orígenes de entrada y varios artefactos de salida.

CODEBUILD_START_TIME

Hora de inicio de la compilación especificada como marca temporal de Unix en milisegundos.

CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID

ID de la cuenta del usuario que ha desencadenado el evento de webhook.

CODEBUILD_WEBHOOK_BASE_REF

Nombre de referencia de base del evento de webhook que desencadena la compilación actual. En las solicitudes de extracción, se trata de la referencia de ramificación.

CODEBUILD_WEBHOOK_EVENT

Evento de webhook que desencadena la compilación actual.

CODEBUILD_WEBHOOK_MERGE_COMMIT

El identificador de la confirmación de fusión utilizada para la compilación. Esta variable se establece cuando se fusiona una solicitud de extracción de Bitbucket con la estrategia de agrupación y se cierra la rama de la solicitud de extracción. En este caso, la confirmación original de la solicitud de extracción deja de existir, por lo que esta variable de entorno contiene el identificador de la confirmación de fusión anulada.

CODEBUILD_WEBHOOK_PREV_COMMIT

ID de la confirmación más reciente antes del evento push del webhook que desencadena la compilación actual.

CODEBUILD_WEBHOOK_HEAD_REF

Nombre de referencia de encabezado del evento de webhook que desencadena la compilación actual. Puede ser una referencia de ramificación o de etiqueta.

CODEBUILD_WEBHOOK_TRIGGER

Muestra el evento webhook que activó la compilación. Esta variable solo está disponible para compilaciones activadas por un webhook. El valor se analiza desde la carga de contenido enviada por GitHub, GitHub Enterprise Server o Bitbucket a CodeBuild. El formato del valor depende del tipo de evento que desencadenó la compilación.

  • Para las compilaciones desencadenadas por una solicitud de extracción, es pr/pull-request-number.

  • Para las compilaciones desencadenadas por la creación de una nueva rama o la inserción de una confirmación en una rama, es branch/branch-name.

  • Para compilaciones activadas por el envío de una etiqueta a un repositorio, es tag/tag-name.

HOME

Esta variable de entorno siempre está establecida en /root.

AWS CodeBuild también admite un conjunto de variables de entorno para las compilaciones de ejecutores autoalojados. Para obtener más información sobre el ejecutor autoalojado de CodeBuild, consulte Tutorial: Configuración de un ejecutor de GitHub Actions alojado en CodeBuild.

CODEBUILD_RUNNER_OWNER

El propietario del repositorio que desencadena la compilación del ejecutor autoalojado.

CODEBUILD_RUNNER_REPO

El nombre del repositorio que desencadena la compilación del ejecutor autoalojado.

CODEBUILD_RUNNER_REPO_DOMAIN

El dominio del repositorio que desencadena la compilación del ejecutor autoalojado. Solo las compilaciones de GitHub Enterprise especificadas.

CODEBUILD_WEBHOOK_LABEL

La etiqueta que se utiliza para configurar las anulaciones de compilación y el ejecutor autoalojado durante la compilación.

CODEBUILD_WEBHOOK_RUN_ID

El ID de ejecución del flujo de trabajo asociado a la compilación.

CODEBUILD_WEBHOOK_JOB_ID

El ID del trabajo asociado a la compilación.

CODEBUILD_WEBHOOK_WORKFLOW_NAME

El nombre del flujo de trabajo asociado a la compilación, si existe en la carga útil de solicitud de webhook.

CODEBUILD_RUNNER_WITH_BUILDSPEC

Si se configura una anulación de especificación de compilación en las etiquetas de solicitud del ejecutor autoalojado, se establece en true.

También puede proporcionar entornos de compilación con sus propias variables de entorno. Para obtener más información, consulte los temas siguientes:

Para enumerar todas las variables de entorno disponibles en un entorno de compilación, puede ejecutar el comando printenv (para un entorno de compilación basado en Linux) o "Get-ChildItem Env:" (para entornos de compilación basados en Windows) durante una compilación. A excepción de las indicadas anteriormente, las variables de entorno que comienzan por CODEBUILD_ son para uso interno de CodeBuild. No deben utilizarse en los comandos de compilación.

importante

Se desaconseja usar variables de entorno para almacenar valores confidenciales, especialmente los identificadores de clave de acceso de AWS. Las variables de entorno se pueden mostrar en texto sin formato con herramientas como la consola de CodeBuild y la AWS CLI.

Le recomendamos que almacene los valores confidenciales en el almacén de parámetros de Amazon EC2 Systems Manager y que después los recupere de la especificación de compilación. Para almacenar valores confidenciales, consulte Almacén de parámetros de Systems Manager y Tutorial: Crear y probar un parámetro de cadena de caracteres (consola) en la Guía del usuario de Amazon EC2 Systems Manager. Para recuperarlos, consulte la asignación de parameter-store en Sintaxis de buildspec.