Skip to main content

Establecimiento de códigos de salida para acciones

Puedes usar códigos de salida para establecer el estado de una acción. GitHub muestra los estados para indicar las acciones que se pasan o fallan.

Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.

Acerca de los códigos de salida

GitHub usa el código de salida para establecer el estado de la ejecución de comprobación de la acción, que puede ser success o failure.

Estado de salidaEstado de ejecución de verificaciónDescripción
0successLa acción se completó correctamente y pueden comenzar otras tareas que dependen de ella.
Valor diferente a zero (cualquier número entero que no sea 0)failureCualquier otro código de salida indica que la acción fracasó. Cuando una acción falla, todas las acciones simultáneas se cancelan y las acciones futuras se omiten. La ejecución de comprobación y el conjunto de comprobaciones obtienen un estado failure.

Establecer un código de salida fallida en una acción JavaScript

Si va a crear una acción de JavaScript, puede usar el paquete @actions/core del kit de herramientas de acciones para registrar un mensaje y establecer un código de salida de error. Por ejemplo:

try {
  // something
} catch (error) {
  core.setFailed(error.message);
}

Para obtener más información, vea «Creación de una acción de JavaScript».

Establecer un código de salida fallida en una acción de contenedor Docker

Si va a crear una acción de contenedor de Docker, puede establecer un código de salida de error en el script entrypoint.sh. Por ejemplo:

if <condition> ; then
  echo "Game over!"
  exit 1
fi

Para obtener más información, vea «Creación de una acción de contenedor de Docker».