Acerca de los comandos de flujo
Las acciones pueden comunicarse con la máquina del ejecutor para establecer variables de entorno, valores de salida utilizados por otras acciones, agregar mensajes de depuración a los registros de salida y otras tareas.
La mayoría de los comandos de flujo de trabajo usan el comando echo en un formato específico, mientras que otros se pueden invocar escribiendo en un archivo. Para más información, vea Archivos de entorno.
Ejemplo de un comando de flujo de trabajo
echo "::workflow-command parameter1={data},parameter2={data}::{command value}"
echo "::workflow-command parameter1={data},parameter2={data}::{command value}"
Write-Output "::workflow-command parameter1={data},parameter2={data}::{command value}"
Write-Output "::workflow-command parameter1={data},parameter2={data}::{command value}"
Nota:
Los nombres de parámetros y comandos de flujo de trabajo no distinguen mayúsculas de minúsculas.
Advertencia
Si va a utilizar el símbolo del sistema, omita los caracteres de comillas dobles (") al usar comandos de flujo de trabajo.
Utilizar comandos de flujo de trabajo para acceder a las funciones de toolkit
En actions/toolkit se incluye una serie de funciones que se pueden ejecutar como comandos de flujo de trabajo. Use la sintaxis :: para ejecutar los comandos de flujo de trabajo dentro del archivo YAML; estos comandos se envían al ejecutor por medio de stdout.
Por ejemplo, en lugar de usar código para crear una anotación de error, como se muestra a continuación:
core.error('Missing semicolon', {file: 'app.js', startLine: 1})
core.error('Missing semicolon', {file: 'app.js', startLine: 1})
Ejemplo: Crear una anotación de un error
Puedes usar el comando error en tu flujo de trabajo para crear la misma anotación de error:
- name: Create annotation for build error
run: echo "::error file=app.js,line=1::Missing semicolon"
- name: Create annotation for build error
run: echo "::error file=app.js,line=1::Missing semicolon"
- name: Create annotation for build error
run: Write-Output "::error file=app.js,line=1::Missing semicolon"
- name: Create annotation for build error
run: Write-Output "::error file=app.js,line=1::Missing semicolon"
La siguiente tabla muestra qué funciones del toolkit se encuentran disponibles dentro de un flujo de trabajo:
| Funcion del Toolkit | Comando equivalente del flujo de trabajo |
|---|---|
core.addPath | Accesible mediante el archivo de entorno GITHUB_PATH |
core.debug | debug |
core.notice | notice |
core.error | error |
core.endGroup | endgroup |
core.export | Accesible mediante el archivo de entorno GITHUB_ENV |
core.getInput | Accesible mediante la variable de entorno INPUT_{NAME} |
core.getState | Accesible mediante la variable de entorno STATE_{NAME} |
core.isDebug | Accesible mediante la variable de entorno RUNNER_DEBUG |
core.summary | Accesible mediante el archivo de entorno GITHUB_STEP_SUMMARY |
core.saveState | Accesible mediante el archivo de entorno GITHUB_STATE |
core.set | echo |