Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Usar variables de entorno

GitHub establece variables de entorno predeterminadas para cada ejecución de flujo de trabajo de GitHub Actions. También puedes establecer variables de entorno personalizadas en tu archivo de flujo de trabajo.

GitHub Actions se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, y GitHub One. GitHub Actions no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Para obtener más información, consulta la sección "Productos de GitHub".

En este artículo

Acerca de las variables de entorno

GitHub establece las variables de entorno predeterminadas que están disponibles para cada paso en una ejecución de flujo de trabajo. Las variables de entorno distinguen mayúsculas de minúsculas. Los comandos que se ejecutan en acciones o pasos pueden crear, leer y modificar variables de entorno.

Para establecer variables de entorno personalizadas, debes especificar las variables en el archivo de flujo de trabajo. Puedes definir variables de entorno para un paso, trabajo o flujo de trabajo completo utilizando las palabras clave jobs.<job_id>. steps.env, jobs.<job_id>. env y env. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub".

steps:
  - name: Hello world
    run: echo Hello world $FIRST_NAME $middle_name $Last_Name!
    env:
      FIRST_NAME: Mona
      middle_name: The
      Last_Name: Octocat

También puedes usar el comando de flujo de trabajo Set-env para establecer una variable de entorno que pueden usar los pasos posteriores en un flujo de trabajo. El comando set-env puede ser usado directamente por una acción o se puede usar un comando de shell en un archivo de flujo de trabajo mediante la palabra clave run (ejecutar). Para obtener más información, consulta "Comandos de flujo de trabajo para las GitHub Actions."

Variables de entorno predeterminadas

Te recomendamos firmemente que las acciones usen variables de entorno para acceder al sistema de archivos en lugar de usar rutas de archivo codificadas de forma rígida. GitHub establece variables de entorno para que las acciones se utilicen en todos los entornos del ejecutador.

Variable de entornoDescripción
CISiempre configurar en true.
HOMELa ruta al directorio de inicio GitHub utilizado para almacenar datos de usuario. Por ejemplo, /github/home.
GITHUB_WORKFLOWEl nombre del flujo de trabajo.
GITHUB_RUN_IDUn número único para cada ejecución dentro de un repositorio. Este número no cambia si vuelves a ejecutar el flujo de trabajo.
GITHUB_RUN_NUMBERUn número único para cada ejecución de un flujo de trabajo particular en un repositorio. Este número comienza en 1 para los flujos de trabajo que se ejecutan primero, e incrementa con cada ejecución nueva. Este número no cambia si vuelves a ejecutar el flujo de trabajo.
GITHUB_ACTIONEl único identificador (id) de la acción.
GITHUB_ACTIONSSiempre establecido en true cuando GitHub Actions está ejecutando el flujo de trabajo. Puedes usar esta variable para diferenciar cuando las pruebas se ejecutan de forma local o mediante GitHub Actions.
GITHUB_ACTOREl nombre de la persona o de la app que inició el flujo de trabajo. Por ejemplo, octocat.
GITHUB_REPOSITORYEl nombre del repositorio y del propietario. Por ejemplo, octocat/Hello-World.
GITHUB_EVENT_NAMEEl nombre del evento webhook que activó el flujo de trabajo
GITHUB_EVENT_PATHLa ruta del archivo con la carga completa del evento webhook. Por ejemplo, /github/workflow/event.json.
GITHUB_WORKSPACELa ruta del directorio del espacio de trabajo GitHub. El directorio del espacio de trabajo contiene un subdirectorio con una copia de tu repositorio si tu flujo de trabajo usa la acción actions/checkout. Si no usas la acción actions/checkout, el directorio estará vacío. Por ejemplo, /home/runner/work/my-repo-name/my-repo-name.
GITHUB_SHAEl SHA de confirmación que activó el flujo de trabajo. Por ejemplo, ffac537e6cbbf934b08745a378932722df287a53.
GITHUB_REFLa rama o ref de etiqueta que activó el flujo de trabajo. Por ejemplo, refs/heads/feature-branch-1. Si no hay una rama o etiqueta disponible para el tipo de evento, la variable no existirá.
GITHUB_HEAD_REFSolo establecida para los repositorios bifurcados. La rama del repositorio encabezado.
GITHUB_BASE_REFSolo establecida para los repositorios bifurcados. La rama del repositorio base.
GITHUB_SERVER_URLDevuelve la URL del servidor de GitHub. Por ejemplo: https://github.com.
GITHUB_API_URLDevuelve la URL de la API. Por ejemplo: https://api.github.com.
GITHUB_GRAPHQL_URLDevuelve la URL de la API de GraphQL. Por ejemplo: https://api.github.com/graphql.

Convenciones de nomenclatura para las variables de entorno

Nota:GitHub reserva el prefijo de la variable de ambiente GITHUB_ para uso interno de GitHub. Configurar una variable de entorno o secreto con el prefijo GITHUB_ dará como resultado un error.

Toda variable de entorno nueva que configures que apunte a una ubicación en el sistema de archivos debe tener un sufijo _PATH. Las variables predeterminadas HOME y GITHUB_WORKSPACE son excepciones a esta convención, porque las palabras "home" y "workspace" ya implican una ubicación.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos