Administración del acceso a los runners autohospedados mediante grupos

Crear un grupo de runners self-hosted para una organización

Crear un grupo de runners autohospedados para una organización empresarial

Cambiar qué organizaciones pueden acceder a un grupo de ejecutores

Para los grupos de ejecutores en una empresa, puedes modificar qué organizaciones dentro de la empresa pueden acceder a un grupo de ejecutores.

1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.

2. En la parte superior de la página, haz clic en Policies.

3. En " Policies", haz clic en Actions.

4. Haga clic en la pestaña Runner groups.

5. En "Acceso a la organización", usa el menú desplegable para hacer clic en Organizaciones seleccionadas.

   1. A la derecha del menú desplegable, haz clic en .
   2. En el elemento emergente, usa las casillas para seleccionar organizaciones que puedan usar este grupo de ejecutores.

6. Haga clic en Guardar grupo.

Cambiar qué repositorios pueden acceder a un grupo de ejecución

En el caso de los grupos de ejecutores de una organización, puedes cambiar qué repositorios de la organización pueden acceder a un grupo de ejecutores.

1. Ve a la página principal de la organización donde se encuentran tus grupos de ejecutores.

2. Haz clic en Settings.

3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runner groups.

4. En la lista de grupos, haz clic en el grupo de ejecutores que te gustaría configurar.

5. En "Acceso al repositorio", use el menú desplegable para hacer clic en Repositorios seleccionados.

   1. A la derecha del menú desplegable, haz clic en .
   2. En el elemento emergente, usa las casillas para seleccionar repositorios que puedan acceder a este grupo de ejecutores.

6. Haga clic en Guardar grupo.

Cambio de los flujos de trabajo que pueden acceder un grupo de ejecutores

Puedes configurar un grupo de ejecutores para que ejecute ya sea flujos selectos o todos ellos. Por ejemplo, podrías utilizar este ajuste para proteger secretos almacenados en los ejecutores o estandarizar los flujos de trabajo de despliegue restringiendo un grupo de ellos para que ejecute solo un flujo de trabajo reutilizable específico. Este ajuste no se puede anular si estás configurando un grupo de ejecutores de una organización que haya compartido una empresa.

•         [Cambio de los flujos de trabajo que pueden acceder a un grupo de ejecutores de organización](#changing-which-workflows-can-access-an-organization-runner-group)
  

•         [Cambio de los flujos de trabajo que pueden acceder a un grupo de ejecutores de empresa](#changing-which-workflows-can-access-an-enterprise-runner-group)
  

Cambio de los flujos de trabajo que pueden acceder a un grupo de corredores de la organización

1. Ve a la página principal de la organización donde se encuentran tus grupos de ejecutores.

2. Haz clic en Settings.

3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runner groups.

4. En la lista de grupos, haz clic en el grupo de ejecutores que te gustaría configurar.

5. En Workflow access, seleccione el menú desplegable y haga clic en Selected workflows.

6. Haga clic en .

7. Ingresa una lista separada por comas de los flujos de trabajo que pueden acceder al grupo de ejecutores. Utiliza la ruta completa, incluyendo el nombre y propietario del repositorio. Fija el flujo de trabajo a una rama, etiqueta o SHA completo. Por ejemplo: octo-org/octo-repo/.github/workflows/build.yml@v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@main.

   Solo los jobs que se definan directamente dentro de los flujos de trabajo seleccionados tendrán acceso al grupo de ejecutores.

   Los grupos de ejecutores que pertenecen a la organización no pueden acceder a los flujos de trabajo de otra organización de la empresa; en vez de esto, debes crear un grupo de ejecutores que pertenezca a la empresa.

8. Haga clic en Save(Guardar).

Cambiar qué flujos de trabajo pueden acceder a un grupo de ejecutores empresariales.

1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.

2. En la parte superior de la página, haz clic en Policies.

3. En " Policies", haz clic en Actions.

4. Haga clic en la pestaña Runner groups.

5. En la lista de grupos, haz clic en el grupo de ejecutores que te gustaría configurar.

6. En Workflow access, seleccione el menú desplegable y haga clic en Selected workflows.

7. Haga clic en .

8. Ingresa una lista separada por comas de los flujos de trabajo que pueden acceder al grupo de ejecutores. Utiliza la ruta completa, incluyendo el nombre y propietario del repositorio. Fija el flujo de trabajo a una rama, etiqueta o SHA completo. Por ejemplo: octo-org/octo-repo/.github/workflows/build.yml@v2, octo-org/octo-repo/.github/workflows/deploy.yml@d6dc6c96df4f32fa27b039f2084f576ed2c5c2a5, monalisa/octo-test/.github/workflows/test.yml@main.

   Solo los jobs que se definan directamente dentro de los flujos de trabajo seleccionados tendrán acceso al grupo de ejecutores.

   Los grupos de ejecutores que pertenecen a la organización no pueden acceder a los flujos de trabajo de otra organización de la empresa; en vez de esto, debes crear un grupo de ejecutores que pertenezca a la empresa.

9. Haga clic en Save(Guardar).

Cambiar el nombre de un grupo de ejecutores

Puedes editar el nombre de los grupos de ejecución a nivel de empresa y organización.

•         [Cambio del nombre de un grupo de ejecutores de organización](#changing-the-name-of-an-organization-runner-group)
  

•         [Cambiar el nombre de un grupo de corredores empresariales](#changing-the-name-of-an-enterprise-runner-group)
  

Cambio del nombre de un grupo de agentes organizacionales

1. Ve a la página principal de la organización donde se encuentran tus grupos de ejecutores.
2. Haz clic en Settings.
3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runner groups.
4. En la lista de grupos, haz clic en el grupo de ejecutores que te gustaría configurar.
5. Escriba el nuevo nombre del grupo de ejecutores en el campo de texto en "Nombre del grupo".
6. Haga clic en Save(Guardar).

Cambio del nombre de un grupo de ejecutores de empresa

1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.
2. En la parte superior de la página, haz clic en Policies.
3. En " Policies", haz clic en Actions.
4. Haga clic en la pestaña Runner groups.
5. En la lista de grupos, haz clic en el grupo de ejecutores que te gustaría configurar.
6. Escriba el nuevo nombre del grupo de ejecutores en el campo de texto en "Nombre del grupo".
7. Haga clic en Save(Guardar).

Agregar ejecutores autohospedados a un grupo automáticamente

Mover un agente auto-hospedado a un grupo

Si no especificas un grupo de ejecutores durante el proceso de registro, tus nuevos ejecutores se asignarán automáticamente al grupo predeterminado y después se moverán a otro grupo.

•         [Traslado de un ejecutor de organización a un grupo](#moving-an-organization-runner-to-a-group)
  

•         [Trasladar un ejecutor empresarial a un grupo](#moving-an-enterprise-runner-to-a-group)
  

Traslado de un ejecutor de organización a un grupo

1. En GitHub, navega a la página principal de tu organización.

2. Debajo del nombre de la organización, haz clic en Settings. Si no puedes ver la pestaña "Configuración", selecciona el menú desplegable y, a continuación, haz clic en Configuración.

   

3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runners.

4. En la lista de "Ejecutores", haz clic en aquél que quieras configurar.

5. Seleccione la lista desplegable Runner group.

6. En "Mover el ejecutor al grupo", elige un grupo destino para el ejecutor.

Traslado de un ejecutor de empresa a un grupo

1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.
2. En la parte superior de la página, haz clic en Policies.
3. En " Policies", haz clic en Actions.
4. Haz clic en la pestaña Ejecutores.
5. En la lista de "Ejecutores", haz clic en aquél que quieras configurar.
6. Seleccione la lista desplegable Runner group.
7. En "Mover el ejecutor al grupo", elige un grupo destino para el ejecutor.

Eliminar un grupo de agentes autohospedados

es-ES:

•         [Eliminación de un grupo de ejecutores de una organización](#removing-a-runner-group-from-an-organization)
  

•         [Eliminación de un grupo de corredores de una empresa](#removing-a-runner-group-from-an-enterprise)
  

Eliminación de un grupo de ejecutores de una organización

1. Ve a la página principal de la organización donde se encuentran tus grupos de ejecutores.
2. Haz clic en Settings.
3. En la barra lateral de la izquierda, haz clic en Actions y luego en Runner groups.

Eliminación de un grupo de runners de una organización

Uso de nombres únicos para grupos de ejecutores

GitHub Actions requiere que los nombres del grupo de ejecutores sean únicos a nivel de organización. Esto significa que una organización ya no podrá crear un grupo de ejecutores con el mismo nombre que uno de la empresa. Además, los usuarios verán un banner de advertencia en cualquier grupo de ejecutores que comparta el mismo nombre que un grupo de la empresa, que sugiere que se debe cambiar el nombre del grupo de la organización.

Para evitar ambigüedad, se producirá un error en un flujo de trabajo si hay grupos de ejecutores duplicados en la organización y en la empresa. Para solucionarlo, puedes cambiar el nombre de uno de los grupos de ejecutores de la organización o de la empresa, o bien actualizar el archivo de flujo de trabajo para agregar un prefijo al nombre del grupo de ejecutores:

• org/ o organization/
• ent/ o enterprise/

Ejemplo: Uso de prefijos para diferenciar grupos de ejecutores

Por ejemplo, si tienes un grupo de ejecutores denominado my-group en la organización y otro denominado my-group en la empresa, puedes actualizar el archivo de flujo de trabajo para usar org/my-group o ent/my-group para diferenciar entre los dos.

Usar org/:

runs-on:
  group: org/my-group
  labels: [ self-hosted, label-1 ]

Usar ent/:

runs-on:
  group: ent/my-group
  labels: [ self-hosted, label-1 ]