Variables de Entorno en GitHub Actions

Resumen

Iniciamos nuestra exploración en el Marketplace de GitHub, donde descubrimos diferentes Actions. Para nuestro ejemplo, seleccionamos 'Deploy Docker to AWS'. Este Action toma una aplicación Docker y la despliega en una instancia S2 de AWS.

¿Qué pide este Action de AWS para funcionar?

El Action requiere que le configuremos varias variables. Por medio de Secrets, podemos configurar un access key ID, un secret access key, una default region y un .env. Esto es lo que necesita el Action para subir una aplicación de Docker a una instancia S2 de AWS.

Los valores de estas variables se obtienen de las credenciales de nuestra cuenta AWS. Se guardan en el repositorio de GitHub como secrets, protegiendo así su seguridad.

A partir de ahí, podemos copiar el Workflow que utiliza estos secrets en caso de necesidad si queremos subir una aplicación Docker a AWS.

¿Cómo podemos verificar y depurar un Workflow?

Una vez implementado el Workflow, es importante revisar los logs para verificar que está funcionando correctamente. En la pestaña de actions, se pueden ver los logs de cada ejecución del Workflow.

Por ejemplo, al explorar un Workflow fallido, podemos ver el error 'process completed with exit code 1', indicando que el proceso no se completó correctamente. Detallando cada uno de los jobs, podemos identificar el paso donde se produjo el fallo.

Aunque GitHub indica si un job ha sido exitoso o no, siempre es importante revisar los logs, ya que pueden existir errores no detectados por GitHub.

¿Cómo resolver problemas en los Workflows?

Al revisar los logs, observamos que el saludo del Workflow 'saludos y secretos' no se mostraba correctamente. El análisis de los logs reveló que la variable 'saludo' solo estaba configurada para el job 'saludo variables' y no para el job 'saludos y secretos'.

Para solucionar este problema, es necesario agregar la variable 'saludo' al job 'saludos y secretos'. Con este arreglo, el saludo se muestra correctamente en los logs, indicando que el Workflow está funcionando como se esperaba.

¿Cómo evitar errores al crear nuevos Workflows?

Cuando se crea un nuevo Workflow, es esencial probarlo varias veces y revisar cuidadosamente todos los logs. De esta manera, podemos estar seguros de que el Workflow funciona como se espera.

Diego Jose Chavez

student•

Sería bueno que el curso lo enfocaran a un nivel más realista o como realmente se pueda implementar, por ejemplo en una empresa o situaciones que se presenten el día a día, ya que en el curso tiene un enfoque muy teórico y la poca práctica que tiene no se centran en casos que se puedan implementar en un futuro.

Cristobal Nyram

student•

Hola, qué tal, Diego, si el curso de hecho tiene un enfoque muy práctico, solo que quizá no lo notas, todo esto son las bases para entender

Sebastián Franco

student•

name: Saludo usando variables
on:
  push
env:
  DIA_DE_SEMANA: Lunes
jobs:
  mostrar-variables:
    env:
      VARS: ${{ toJSON(vars) }}
    runs-on: ubuntu-latest
    steps:
      - name: imprimir variables
        run: echo $VARS
  saludo-variables:
    runs-on: ubuntu-latest
    env:
      SALUDO: Hola
    steps:
      - name: saludar
        run : echo $SALUDO, $NOMBRE y $NOMBRE2. Hoy es $DIA_DE_SEMANA
        env:
          NOMBRE2: Villanos
          NOMBRE: ${{ vars.NOMBRE }}

Diego Reyes Cabrera

student•

Recordatorio: para acceder a una variable dentro de una expresión, se debe hacer por medio del contexto env.

if: ${{ env.USERNAME == 'diego' }}
run: echo $USERNAME

Sebastian Martinez

student•

Siento la información desordenada, creo que lo que el profesor menciono sobre contextos aquí, debió haberlo mostrado antes del reto.

Sergio Lopez

student•

¿Hay alguna forma de definir todas las variables a la vez en una misma línea de código? Ahora mismo me estoy apañando con esto.

  - name: Definir nombre
    run: echo "USERNAME=${{ env.NOMBRE }}" >> $GITHUB_ENV
  - name: Definir edad
    run: echo "AGE=${{ env.EDAD }}" >> $GITHUB_ENV
  - name: Definir localidad
    run: echo "LOCATION=${{ env.LOCALIDAD }}" >> $GITHUB_ENV
  - name: Definir pais
    run: echo "COUNTRY=${{ env.PAIS }}" >> $GITHUB_ENV
  - name: Definir información
    run: echo "INFORMATION=${{ env.INFORMACION }}" >> $GITHUB_ENV

Juan José Torres

Team Platzi•

Sí es posible usando el operador | en la línea del run. Así:

run: |
	echo "USERNAME=${{ env.NOMBRE }}" >> $GITHUB_ENV
	echo "AGE=${{ env.EDAD }}" >> $GITHUB_ENV
	echo "LOCATION=${{ env.LOCALIDAD }}" >> $GITHUB_ENV
	echo "COUNTRY=${{ env.PAIS }}" >> $GITHUB_ENV
	echo "INFORMATION=${{ env.INFORMACION }}" >> $GITHUB_ENV

Platzi Team

student•

Uso de variables de entorno

GitHub Actions permite manejar información sensible y valores reutilizables mediante secretos y variables de entorno. Ambos se usan para mantener el flujo de trabajo seguro y organizado.

Secretos (secrets)Los secretos son valores sensibles, como contraseñas, tokens de acceso o claves API, que se almacenan de forma segura en GitHub y no se muestran en los registros de ejecución.**¿Cómo definir un secreto?Uso de secretos en un workflow:**name: Uso de Secretos

on: [push]

jobs: usar-secreto: runs-on: ubuntu-latest

steps: - name: Mostrar secreto de ejemplo run: echo "El token es: ${{ secrets.MI_TOKEN }}" <aside> ‼️Nota: Los secretos nunca se muestran en los registros por razones de seguridad. Si intentas imprimirlos directamente, se ocultarán automáticamente.</aside>
- Ve a tu repositorio en GitHub.
- Haz clic en Settings → Secrets and variables → Actions → New repository secret.
- Asigna un nombre (en mayúsculas, por convención) y su valor.
Variables de entorno (env)Las variables de entorno son valores reutilizables que no son necesariamente sensibles. Sirven para almacenar configuraciones que se repiten a lo largo del workflow.name: Uso de Variables de Entorno

on: [push]

jobs: variables-ejemplo: runs-on: ubuntu-latest env: ENTORNO: produccion VERSIÓN_APP: 1.0.0

steps: - name: Mostrar variables run: | echo "Entorno actual: ${{ env.ENTORNO }}" echo "Versión de la app: ${{ env.VERSIÓN_APP }}"
Secretos y variables a nivel de organizaciónSi trabajas en múltiples repositorios, puedes definir secretos y variables a nivel de organización:
1. Ve a Settings → Secrets and variables → Actions → New organization secret.
2. Define el alcance (todos los repositorios o solo algunos).

Andres Trujillo

student•

name: Using variables
on: push
env:
  environment_var: development
  token: ${{ secrets.TOKEN_TEST }}

jobs:
  deploy_to_environment:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to environment
        run: echo "Deploying to ${{ env.environment_var }} environment with token ${{ env.token }}"

Haward Rafael Tillero Jimenez

student•

Reto 5

name: Reto 5 - Aprende a usar las Variables de Entorno
on: [push, pull_request]
env:
  fruta1: Manzana
  fruta2: Pera
  fruta3: Frutilla
jobs:
  Variables:
    runs-on: ubuntu-latest
    steps:
      - name: echo frutas
        run: echo "La $fruta1 es roja, la $fruta2 es verde, la $fruta3 es roja y el ${{ vars.FRUTA4 }} es amarillo"

name: Saludo usando variables
on:
  push
env:
  DIA_DE_SEMANA: Lunes
jobs:
  mostrar-variables:
    env:
      VARS: ${{ toJSON(vars) }}
    runs-on: ubuntu-latest
    steps:
      - name: imprimir variables
        run: echo $VARS
  saludo-variables:
    runs-on: ubuntu-latest
    env:
      SALUDO: Hola
    steps:
      - name: saludar
        run : echo $SALUDO, $NOMBRE y $NOMBRE2. Hoy es $DIA_DE_SEMANA
        env:
          NOMBRE2: Villanos
          NOMBRE: ${{ vars.NOMBRE }}

  - name: Definir nombre
    run: echo "USERNAME=${{ env.NOMBRE }}" >> $GITHUB_ENV
  - name: Definir edad
    run: echo "AGE=${{ env.EDAD }}" >> $GITHUB_ENV
  - name: Definir localidad
    run: echo "LOCATION=${{ env.LOCALIDAD }}" >> $GITHUB_ENV
  - name: Definir pais
    run: echo "COUNTRY=${{ env.PAIS }}" >> $GITHUB_ENV
  - name: Definir información
    run: echo "INFORMATION=${{ env.INFORMACION }}" >> $GITHUB_ENV

run: |
	echo "USERNAME=${{ env.NOMBRE }}" >> $GITHUB_ENV
	echo "AGE=${{ env.EDAD }}" >> $GITHUB_ENV
	echo "LOCATION=${{ env.LOCALIDAD }}" >> $GITHUB_ENV
	echo "COUNTRY=${{ env.PAIS }}" >> $GITHUB_ENV
	echo "INFORMATION=${{ env.INFORMACION }}" >> $GITHUB_ENV

name: Using variables
on: push
env:
  environment_var: development
  token: ${{ secrets.TOKEN_TEST }}

jobs:
  deploy_to_environment:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy to environment
        run: echo "Deploying to ${{ env.environment_var }} environment with token ${{ env.token }}"

name: Reto 5 - Aprende a usar las Variables de Entorno
on: [push, pull_request]
env:
  fruta1: Manzana
  fruta2: Pera
  fruta3: Frutilla
jobs:
  Variables:
    runs-on: ubuntu-latest
    steps:
      - name: echo frutas
        run: echo "La $fruta1 es roja, la $fruta2 es verde, la $fruta3 es roja y el ${{ vars.FRUTA4 }} es amarillo"

Variables de Entorno en GitHub Actions

Conoce Github Actions

Automatización e Integración Continua con GitHub Actions

Git y GitHub: Diferencias y Uso de GitHub Actions

Conceptos Esenciales de GitHub Actions

Creación de Workflow Files

Creación de un Workflow Básico con GitHub Actions

Creación de un Workflow File con GitHub Actions

Triggers comunes en GitHub Actions: push, pull request, issues y más

Uso de Triggers y Expresiones en GitHub Actions

Contextos en GitHub Actions: Acceso y Uso Práctico