Introducción
Puede escribir una acción para ofrecer una forma de que los usuarios accedan a sus servidores mediante un entorno de CLI configurado en los ejecutores GitHub Actions.
Tu acción debería:
- Facilitar que los usuarios especifiquen la versión del CLI a instalar
- Ser compatible con sistemas operativos múltiples
- Ejecutarse de manera eficiente para minimizar el tiempo de ejecución y los costos asociados.
- Trabaje con ejecutores GitHubalojados y autoalojados
- Apoyar las herramientas de la comunidad en medida de lo posible
Este artículo te demostrará cómo escribir una acción que recupere una versión específica de tu CLI, la instale, la agregue a la ruta y la guarde en caché (opcionalmente). Este tipo de acción (una acción que configura una herramienta) a menudo se denomina setup-$TOOL.
Prerrequisitos
Deberás de entender cómo escribir una acción personalizada. Para más información, consulta Administración de acciones personalizadas.
Ejemplo
El siguiente script demuestra cómo puedes obtener una versión especificada por un usuario como entrada, descargar y extraer esta versión específica de tu CLI y luego agregar el CLI a la ruta.
GitHub proporciona actions/toolkit, que es un conjunto de paquetes que le ayuda a crear acciones. En este ejemplo se usan los paquetes actions/core y actions/tool-cache.
const core = require('@actions/core');
const tc = require('@actions/tool-cache');
async function setup() {
// Get version of tool to be installed
const version = core.getInput('version');
// Download the specific version of the tool, e.g. as a tarball
const pathToTarball = await tc.downloadTool(getDownloadURL());
// Extract the tarball onto the runner
const pathToCLI = await tc.extractTar(pathToTarball);
// Expose the tool by adding it to the PATH
core.addPath(pathToCLI)
}
module.exports = setup
const core = require('@actions/core');
const tc = require('@actions/tool-cache');
async function setup() {
// Get version of tool to be installed
const version = core.getInput('version');
// Download the specific version of the tool, e.g. as a tarball
const pathToTarball = await tc.downloadTool(getDownloadURL());
// Extract the tarball onto the runner
const pathToCLI = await tc.extractTar(pathToTarball);
// Expose the tool by adding it to the PATH
core.addPath(pathToCLI)
}
module.exports = setup
Para usar este script, reemplace getDownloadURL por una función que descargue la CLI. También tendrá que crear un archivo de metadatos de acciones (action.yml) que acepte una entrada version y que ejecute este script. Para obtener información completa sobre cómo crear una acción, consulta Creación de una acción de JavaScript.
Información adicional
Este patrón se emplea en varias acciones. Para ver más ejemplos, consulta: