

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
<a name="build-env-ref-env-vars"></a>

AWS CodeBuild proporciona varias variables de entorno que puedes usar en tus comandos de compilación:

AWS\$1DEFAULT\$1REGIÓN  
La AWS 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\$1REGION  
La AWS 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 SDKs.

CODEBUILD\$1BATCH\$1BUILD\$1IDENTIFIER  
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](batch-build-buildspec.md).

CODEBUILD\$1BUILD\$1ARN  
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\$1BUILD\$1ID  
El CodeBuild ID de la compilación (por ejemplo,`codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`).

CODEBUILD\$1BUILD\$1IMAGE  
El identificador de la imagen de CodeBuild compilación (por ejemplo,`aws/codebuild/standard:2.0`).

CODEBUILD\$1BUILD\$1NUMBER  
Número de compilación actual del proyecto.

CODEBUILD\$1BUILD\$1SUCCEEDING  
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\$1INITIATOR  
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 ha iniciado 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 cadena`CodeBuild-Jenkins-Plugin`.

CODEBUILD\$1KMS\$1KEY\$1ID  
El identificador de la AWS KMS clave que CodeBuild se 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\$1PROJECT\$1ARN  
Nombre de recurso de Amazon (ARN) del proyecto (por ejemplo, `arn:aws:codebuild:region-ID:account-ID:project/project-name`).

CODEBUILD\$1PUBLIC\$1BUILD\$1URL  
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](public-builds.md).

CODEBUILD\$1RESOLVED\$1SOURCE\$1VERSION  <a name="CODEBUILD_RESOLVED_SOURCE_VERSION"></a>
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.  
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\$1SOURCE\$1REPO\$1URL  
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, 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.  
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\$1SOURCE\$1VERSION  
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.
+  CodeCommitEn efecto, es el identificador de confirmación o el nombre de la rama asociados a la versión del código fuente que se va a compilar.
+  GitHubEn el caso de GitHub Enterprise Server y Bitbucket, es el ID de confirmación, el nombre de la rama o el nombre de la etiqueta asociados a la versión del código fuente que se va a crear.
**nota**  
En el caso de una GitHub compilación de GitHub Enterprise Server que se desencadena por un evento de solicitud de extracción de webhook, sí lo 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](sample-multi-in-out.md).

CODEBUILD\$1SRC\$1DIR  
La ruta del directorio que se 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](sample-multi-in-out.md).

CODEBUILD\$1START\$1TIME  
Hora de inicio de la compilación especificada como marca temporal de Unix en milisegundos.

CODEBUILD\$1WEBHOOK\$1ACTOR\$1ACCOUNT\$1ID  
ID de la cuenta del usuario que ha desencadenado el evento de webhook.

CODEBUILD\$1WEBHOOK\$1BASE\$1REF  
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\$1WEBHOOK\$1EVENT  
Evento de webhook que desencadena la compilación actual.

CODEBUILD\$1WEBHOOK\$1MERGE\$1COMMIT  <a name="CODEBUILD_WEBHOOK_MERGE_COMMIT"></a>
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\$1WEBHOOK\$1PREV\$1COMMIT  
ID de la confirmación más reciente antes del evento push del webhook que desencadena la compilación actual.

CODEBUILD\$1WEBHOOK\$1HEAD\$1REF  
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\$1WEBHOOK\$1TRIGGER  
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`. 

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

AWS CodeBuild también admite un conjunto de variables de entorno para compilaciones de ejecutores autohospedadas. Para obtener más información sobre el ejecutor CodeBuild autohospedado, consulte. [Tutorial: Configurar un ejecutor de CodeBuild Actions alojado GitHub](action-runner.md)

CODEBUILD\$1RUNNER\$1OWNER  
El propietario del repositorio que desencadena la compilación del ejecutor autoalojado.

CODEBUILD\$1RUNNER\$1REPO  
El nombre del repositorio que desencadena la compilación del ejecutor autoalojado.

CODEBUILD\$1RUNNER\$1REPO\$1DOMAIN  
El dominio del repositorio que desencadena la compilación del ejecutor autoalojado. Solo versiones GitHub empresariales especificadas.

CODEBUILD\$1WEBHOOK\$1LABEL  
La etiqueta que se utiliza para configurar las anulaciones de compilación y el ejecutor autoalojado durante la compilación.

CODEBUILD\$1WEBHOOK\$1RUN\$1ID  
El ID de ejecución del flujo de trabajo asociado a la compilación.

CODEBUILD\$1WEBHOOK\$1JOB\$1ID  
El ID del trabajo asociado a la compilación.

CODEBUILD\$1WEBHOOK\$1WORKFLOW\$1NAME  
El nombre del flujo de trabajo asociado a la compilación, si existe en la carga útil de solicitud de webhook.

CODEBUILD\$1RUNNER\$1WITH\$1BUILDSPEC  
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:
+ [Úselo CodeBuild con CodePipeline](how-to-create-pipeline.md)
+ [Creación de un proyecto de compilación](create-project.md)
+ [Cambio de la configuración del proyecto de compilación](change-project.md)
+ [Ejecución de compilaciones de forma manual](run-build.md)
+ [Referencia de la especificación de compilación](build-spec-ref.md)

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 con `CODEBUILD_` son para uso CodeBuild interno. No deben utilizarse en los comandos de compilación.

**importante**  
Se desaconseja encarecidamente el uso de variables de entorno para almacenar valores confidenciales, especialmente las claves IDs de AWS acceso. Las variables de entorno se pueden mostrar en texto plano mediante herramientas como la CodeBuild consola y el 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](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.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*. Para recuperarlos, consulte la asignación de `parameter-store` en [Sintaxis de buildspec](build-spec-ref.md#build-spec-ref-syntax).

CODEBUILD\$1BUILD\$1URL  
La URL de los resultados de compilación para esta compilación.