Skip to main content

Utilizar los ejecutores hospedados en GitHub

Puede asignar un trabajo para que se ejecute en una máquina virtual hospedada por GitHub.

Usar un ejecutor hospedado en GitHub

Para usar un ejecutor hospedado en GitHub, crea un trabajo y usa runs-on para especificar el tipo de ejecutor que procesará el trabajo, como ubuntu-latest, windows-latesto macos-latest. Para obtener la lista completa de tipos de ejecutor, consulta Referencia de ejecutores hospedados en GitHub. Si tienes repo: write acceso a un repositorio, puedes ver una lista de los ejecutores disponibles para usarlos en los flujos de trabajo del repositorio. Para obtener más información, consulta Visualización de los ejecutores disponibles para un repositorio.

Cuando comienza el trabajo, GitHub aprovisiona automáticamente una nueva máquina virtual para ese trabajo. Todos los pasos del trabajo se ejecutan en la máquina virtual, lo que permite que los pasos de ese trabajo compartan información mediante el sistema de archivos del ejecutor. Puedes ejecutar flujos de trabajo directamente en la máquina virtual o en un contenedor de Docker. Una vez finalizado el trabajo, la máquina virtual se retira automáticamente.

En el diagrama siguiente se muestra cómo se ejecutan dos trabajos de un flujo de trabajo en dos ejecutores hospedados en GitHub diferentes.

Diagrama de un flujo de trabajo que consta de dos trabajos. Un trabajo se ejecuta en Ubuntu y el otro se ejecuta en Windows.

El siguiente flujo de trabajo de ejemplo tiene dos trabajos, denominados Run-npm-on-Ubuntu y Run-PSScriptAnalyzer-on-Windows. Cuando se desencadena este flujo de trabajo, GitHub aprovisiona una nueva máquina virtual para cada trabajo.

  • El trabajo denominado Run-npm-on-Ubuntu se ejecuta en una máquina virtual Linux, ya que el elemento runs-on: del trabajo especifica ubuntu-latest.
  • El trabajo denominado Run-PSScriptAnalyzer-on-Windows se ejecuta en una máquina virtual Windows, ya que el elemento runs-on: del trabajo especifica windows-latest.
YAML
name: Run commands on different operating systems
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  Run-npm-on-Ubuntu:
    name: Run npm on Ubuntu
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '14'
      - run: npm help

  Run-PSScriptAnalyzer-on-Windows:
    name: Run PSScriptAnalyzer on Windows
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install PSScriptAnalyzer module
        shell: pwsh
        run: |
          Set-PSRepository PSGallery -InstallationPolicy Trusted
          Install-Module PSScriptAnalyzer -ErrorAction Stop
      - name: Get list of rules
        shell: pwsh
        run: |
          Get-ScriptAnalyzerRule

Mientras se ejecuta el trabajo, los registros y la salida se pueden ver en la interfaz de usuario de GitHub:

Captura de pantalla de una ejecución de flujo de trabajo. Se muestran los pasos para el trabajo "Ejecutar PSScriptAnalyzer en Windows".

La aplicación ejecutora de GitHub Actions es de código abierto. Puede contribuir y presentar incidencias en el repositorio runner.

Visualización de ejecutores disponibles para un repositorio

Si tienes acceso repo: write a un repositorio, puedes ver una lista de los ejecutores disponibles para el repositorio.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En el nombre del repositorio, haz clic en Acciones.

    Captura de pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.

  3. En la barra lateral izquierda, en la sección "Administración", haz clic en Ejecutores.

  4. Revisa la lista de ejecutores hospedados en GitHub disponibles para el repositorio.

  5. Opcionalmente, para copiar la etiqueta de un ejecutor para usarla en un flujo de trabajo, haz clic en a la derecha del ejecutor y, a continuación, haz clic en Copiar etiqueta.

Nota:

Los propietarios de empresa y de la organización y los usuarios con el permiso "Manage organization runners and runner groups" pueden crear ejecutores desde esta página. Para crear un nuevo ejecutor, haz clic en Nuevo ejecutor en la parte superior derecha de la lista de ejecutores para agregar ejecutores al repositorio.

Para obtener más información, consulta Administración de ejecutores más grandes y Agrega ejecutores auto-hospedados. Para obtener más información sobre los roles de organización personalizados, consulta Acerca de los roles personalizados de organización.