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.
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
-
LaAWS región en la que se ejecuta la compilación (por ejemplo,
us-east-1). Esta variable de entorno se utiliza principalmente en la AWS CLI. - AWS_REGION
-
LaAWS región en la que 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
-
El identificador de la compilación en una compilación por lotes. Esto se especifica en la especificación de compilación por lotes. Para obtener más información, consulte Referencia de especificaciones de compilación de compilación por Batch.
- CODEBUILD_BUILD_ARN
-
Nombre de Amazon (ARN) de la compilación (ARN) de la compilación (ARN) de la compilación (ARN) de la compilación (ARN
arn:aws:codebuild:).region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE - CODEBUILD_BUILD_ID
-
El CodeBuild ID de la compilación (por ejemplo,
codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE). - CODEBUILD_BUILD_IMAGE
-
El identificador de la imagen de CodeBuild compilación (por ejemplo,
aws/codebuild/standard:2.0). - CODEBUILD_BUILD_NUMBER
-
El número de compilación actual para el proyecto.
- CODEBUILD_BUILD_SUCCEEDING
-
Si la construcción actual se está realizando correctamente. Se establece en
0si la compilación ha producido un error o en1si la compilación se ha realizado correctamente. - INICIADOR DE CÓDIGO DE CONSTRUCCIÓN
-
La entidad que inició la compilación. Si se CodePipeline inició la compilación, este es el nombre de la canalización (por ejemplo,
codepipeline/my-demo-pipeline). Si un usuario inició la compilación, este es el nombre del usuario (por ejemplo,MyUserName). Si el complemento de Jenkins para CodeBuild iniciar la compilación, esta es la cadenaCodeBuild-Jenkins-Plugin. - CODEBUILD_KMS_KEY_ID
-
El identificador de laAWS KMS clave que CodeBuild se utiliza para cifrar el artefacto de salida de la compilación (por ejemplo,
arn:aws:kms:oregion-ID:account-ID:key/key-IDalias/).key-alias - CODEBUILD_LOG_PATH
-
El nombre del flujo de registro en CloudWatch Logs for the build.
- CODEBUILD_PUBLIC_BUILD_URL
-
La URL de los resultados de compilación de esta compilación en el sitio web público de compilaciones. Esta variable solo se establece si el proyecto de compilación tiene habilitadas las compilaciones públicas. Para obtener más información, consulte Proyectos de compilación pública enAWS CodeBuild.
- CODEBUILD_RESOLVED_SOURCE_VERSION
-
El 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 origen 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 habilitado el control de versiones, esta variable de entorno no está configurada.
- Simple Storage Service (Amazon S3)
-
Esta variable no está configurada.
Cuando corresponda, la
CODEBUILD_RESOLVED_SOURCE_VERSIONvariable solo estará disponible después de laDOWNLOAD_SOURCEfase. - CODEBUILD_SOURCE_REPO_URL
-
La URL del repositorio de código fuente o artefacto de entrada. Para Amazon S3, va
s3://seguido del nombre del bucket y la ruta al artefacto de entrada. Para CodeCommit y GitHub, esta es la URL de clonación del repositorio. Si una compilación se origina en CodePipeline, esta variable de entorno puede estar vacía.Para las fuentes secundarias, la variable de entorno de la URL del repositorio de origen secundario es
CODEBUILD_SOURCE_REPO_URL_, donde<sourceIdentifier><sourceIdentifier> - CODEBUILD_SOURCE_VERSION
-
El formato del valor depende del repositorio de origen.
-
Para Amazon S3, es el ID de versión asociado al artefacto de entrada.
-
En CodeCommit efecto, es el ID de confirmación o el nombre de la rama asociado a la versión del código fuente que se va a crear.
-
Para GitHub GitHub Enterprise Server y Bitbucket, es 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.
nota Para una compilación de servidor GitHub empresarial GitHub o empresarial que se desencadena por un evento de solicitud de extracción de webhook, es
pr/.pull-request-number
Para las fuentes secundarias, la variable de entorno de la versión de la fuente secundaria es
CODEBUILD_SOURCE_VERSION_, donde<sourceIdentifier><sourceIdentifier> -
- CODEBUILD_SRC_DIR
-
La ruta del directorio que se CodeBuild utiliza para la compilación (por ejemplo,
/tmp/src123456789/src).Para las fuentes secundarias, la variable de entorno para la ruta del directorio de origen secundario es
CODEBUILD_SRC_DIR_, donde<sourceIdentifier><sourceIdentifier> - CODEBUILD_START_TIME
-
La hora de inicio de la compilación especificada como marca de tiempo de Unix en milisegundos.
- CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID
-
El ID de cuenta del usuario que activó el evento webhook.
- CODEBUILD_WEBHOOK_BASE_REF
-
El nombre de referencia base del evento webhook que activa la compilación actual. En las solicitudes de extracción, se trata de la referencia de ramificación.
- CODEBUILD_WEBHOOK_EVENT
-
El evento webhook que activa 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 una solicitud de extracción de Bitbucket se fusiona con la estrategia de extracción y se cierra la rama de solicitud de extracción. En este caso, la confirmación de solicitud de extracción original ya no existe, por lo que esta variable de entorno contiene el identificador de la confirmación de fusión anulada.
- CODEBUILD_WEBHOOK_PREV_COMMIT
-
El ID de la confirmación más reciente antes del evento push de webhook que activa la compilación actual.
- CODEBUILD_WEBHOOK_HEAD_REF
-
El nombre de referencia principal del evento webhook que activa 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 a partir de la carga útil enviada CodeBuild por GitHub GitHub Enterprise Server o Bitbucket. 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
-
- HOGAR
-
Esta variable de entorno siempre se establece en
/root.
También puede proporcionar entornos de compilación con sus propias variables de entorno. Para obtener más información, consulte los siguientes temas:
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 enumeradas anteriormente, las variables de entorno que comienzan conCODEBUILD_ son para uso CodeBuild interno. No deben utilizarse en los comandos de compilación.
Desaconsejamos encarecidamente el uso de variables de entorno para almacenar valores confidenciales, especialmente los identificadores de las claves deAWS acceso. Las variables de entorno se pueden mostrar en texto plano mediante herramientas como la CodeBuild consola y elAWS CLI.
Le recomendamos que almacene los valores confidenciales en el almacén de parámetros de Amazon EC2 Systems Manager y, a continuación, los recupere de su buildspec. Para almacenar valores confidenciales, consulte el almacén de parámetros de Systems Manager y el tutorial: creación y prueba de un parámetro de cadena (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.
