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.

Using environment variables

GitHub sets default environment variables for each GitHub Actions workflow run. You can also set custom environment variables in your workflow file.

GitHub Actions is available with GitHub Free, GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub One. GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans. For more information, see "GitHub's products."

En este artículo

About environment variables

GitHub sets default environment variables that are available to every step in a workflow run. Environment variables are case-sensitive. Commands run in actions or steps can create, read, and modify environment variables.

To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps.env, jobs.<job_id>.env, and env keywords. 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

You can also use the set-env workflow command to set an environment variable that the following steps in a workflow can use. The set-env command can be used directly by an action or as a shell command in a workflow file using the run keyword. For more information, see "Workflow commands for GitHub Actions."

Variables de entorno predeterminadas

We strongly recommend that actions use environment variables to access the filesystem rather than using hardcoded file paths. GitHub sets environment variables for actions to use in all runner environments.

Variable de entornoDescripción
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_IDA unique number for each run within a repository. This number does not change if you re-run the workflow run.
GITHUB_RUN_NUMBERA unique number for each run of a particular workflow in a repository. This number begins at 1 for the workflow's first run, and increments with each new run. This number does not change if you re-run the workflow run.
GITHUB_ACTIONEl único identificador (id) de la acción.
GITHUB_ACTIONSAlways set to true when GitHub Actions is running the workflow. You can use this variable to differentiate when tests are being run locally or by 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.

Naming conventions for environment variables

Note: GitHub reserves the GITHUB_ environment variable prefix for internal use by 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