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 Acciones de GitHub workflow run, but you can also set custom environment variables in your workflow file.

Acciones de GitHub is available with GitHub gratis, GitHub Pro, Equipo de GitHub, and Nube de GitHub Enterprise. Acciones de GitHub is unavailable for per-repository plans, which are legacy billing 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

Variables de entorno predeterminadas

We strongly recommend that actions use environment variables to access the filesystem rather than using hardcoded file paths. GitHub establece variables de entorno para las acciones que se usarán en todos los entornos virtuales.

Variable de entorno Descripción
HOME La ruta al directorio de inicio GitHub utilizado para almacenar datos de usuario. Por ejemplo, /github/home.
GITHUB_WORKFLOW El nombre del flujo de trabajo.
GITHUB_ACTION El único identificador (id) de la acción.
GITHUB_ACTIONS Always set to true when Acciones de GitHub is running the workflow. You can use this variable to differentiate when tests are being run locally or by Acciones de GitHub.
GITHUB_ACTOR El nombre de la persona o de la app que inició el flujo de trabajo. Por ejemplo, octocat.
GITHUB_REPOSITORY El nombre del repositorio y del propietario Por ejemplo, octocat/Hello-World.
GITHUB_EVENT_NAME El nombre del evento webhook que activó el flujo de trabajo
GITHUB_EVENT_PATH La ruta del archivo con la carga completa del evento webhook. Por ejemplo, /github/workflow/event.json.
GITHUB_WORKSPACE La 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_SHA El SHA de confirmación que activó el flujo de trabajo. Por ejemplo, ffac537e6cbbf934b08745a378932722df287a53.
GITHUB_REF La 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_REF Solo establecida para los repositorios bifurcados. La rama del repositorio encabezado.
GITHUB_BASE_REF Solo establecida para los repositorios bifurcados. La rama del repositorio base.

Naming conventions for environment variables

Nota: GitHub se reserva el prefijo de variable de entorno 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" (inicio) y "workspace" (espacio de trabajo) ya implican una ubicación.

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos