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-latest
o 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.
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 elementoruns-on:
del trabajo especificaubuntu-latest
. - El trabajo denominado
Run-PSScriptAnalyzer-on-Windows
se ejecuta en una máquina virtual Windows, ya que el elementoruns-on:
del trabajo especificawindows-latest
.
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
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:
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.
-
En GitHub, navegue hasta la página principal del repositorio.
-
En el nombre del repositorio, haz clic en Acciones.
-
En la barra lateral izquierda, en la sección "Administración", haz clic en Ejecutores.
-
Revisa la lista de ejecutores hospedados en GitHub disponibles para el repositorio.
-
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.