Skip to main content

Utilizar condiciones para controlar la ejecución de jobs

Prevenir que un job se ejecute a menos de que tus condiciones se cumplan.

Puede usar el condicional jobs.<job_id>.if para impedir que se ejecute una tarea si no se cumple una condición. Puedes usar cualquier contexto y expresión admitidos para crear un condicional. Para más información sobre los contextos que se admiten en esta clave, consulta Referencia de contextos.

Ejemplo: Solo ejecutar un trabajo para un repositorio específico

En este ejemplo se usa if para controlar cuándo se puede ejecutar el trabajo production-deploy. Solo se ejecutará si el repositorio se denomina octo-repo-prod y está dentro de la organización octo-org. De lo contrario, el trabajo se marcará como omitido.

YAML
name: example-workflow
on: [push]
jobs:
  production-deploy:
    if: ${{ github.repository == 'octo-org/octo-repo-prod' }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm install -g bats

Los trabajos omitidos muestran el mensaje "Se omitió esta comprobación".

Nota:

Si se omite un trabajo, se notificará su estado como "Success". No impedirá que una solicitud de incorporación de cambios se combine, incluso si es una comprobación necesaria.

Para depurar por qué se omitió o se ejecutó inesperadamente un trabajo, puede ver los registros de expresiones de condición del trabajo. Para más información, consulta Visualización de registros de expresiones de condición de trabajo.