Eliminar ejecutores autoalojados

Puedes eliminar un ejecutor autohospedado permanentemente de un repositorio, una organización o una empresa.

En este artículo

Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.

Eliminar un ejecutor de un repositorio

Notas:

  • Este procedimiento eliminará el ejecutor auto-hospedado permanentemente. Si solo quiere detener de forma temporal la asignación de trabajos a un ejecutor, puede apagar la máquina o detener la aplicación run. El ejecutor permanecerá asignado en un estado "Sin conexión" y no ejecutará ningún trabajo hasta que lo reinicie mediante la aplicación run.
  • Un ejecutor autohospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions durante más de 14 días. Un ejecutor efímero auto-hospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions por más de 1 día.
  • Los ejecutores Just-In-Time (JIT) solo pueden ejecutar un único trabajo. Si los ejecutores JIT nunca ejecutan un trabajo, se quitarán automáticamente. Para quitar un ejecutor JIT antes de la eliminación automática, debe eliminar el ejecutor JIT en GitHub.

Para eliminar un ejecutor autoalojado de un repositorio de usuario, debes ser el propietario del repositorio. Los propietarios de la organización y los usuarios con el permiso "Administrar ejecutores de la organización y grupos de ejecutores" pueden quitar un ejecutor de un repositorio de la organización. Para obtener más información sobre los roles de organización personalizados, vea "Acerca de los roles personalizados de organización".

Te recomendamos que también tengas acceso a la máquina del ejecutor auto-hospedado.

Para obtener información sobre cómo quitar un ejecutor autohospedado con la API REST, consulta "Puntos de conexión de API de REST para ejecutores autohospedados".

Como alternativa, si no tienes acceso al repositorio, organización o empresa de GitHub Enterprise Server para eliminar un ejecutor, pero te gustaría volver a utilizar la máquina de ejecutor, puedes borrar el archivo .runner dentro del directorio de la aplicación de ejecutor autohospedado (esto es, el directorio en el que descargaste y desempaquetaste el software del ejecutor). Esto permite que el ejecutor se registre sin tener que volver a descargar la aplicación del ejecutor auto-hospedado.

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

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

    Captura de pantalla de un encabezado de repositorio en el que se muestran las pestañas. La pestaña "Configuración" está resaltada con un contorno naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.

  5. Haga clic en Quitar.

  6. Verás las instrucciones para eliminar el ejecutor auto-hospedado. Completa cualquiera de los siguientes pasos para eliminar el ejecutor, dependiendo de si aún se puede acceder a él:

    • Si tiene acceso a la máquina del ejecutor: siga las instrucciones en pantalla para que el sistema operativo de la máquina ejecute el comando de eliminación. Las instrucciones incluyen la URL solicitada y un token de tiempo limitado generado automáticamente.

      El comando de eliminación realiza las siguientes tareas:

      • Elimina el ejecutor de GitHub Enterprise Server.
      • Elimina cualquier archivo de configuración de la aplicación del ejecutor autoalojado en la máquina.
      • Elimina todos los servicios configurados si no se ejecuta en modo interactivo.

    • Si no tiene acceso a la máquina: haga clic en Forzar la eliminación de este ejecutor para forzar a GitHub Enterprise Server a que quite el ejecutor.

Eliminar el ejecutor de una organización

Notas:

  • Este procedimiento eliminará el ejecutor auto-hospedado permanentemente. Si solo quiere detener de forma temporal la asignación de trabajos a un ejecutor, puede apagar la máquina o detener la aplicación run. El ejecutor permanecerá asignado en un estado "Sin conexión" y no ejecutará ningún trabajo hasta que lo reinicie mediante la aplicación run.
  • Un ejecutor autohospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions durante más de 14 días. Un ejecutor efímero auto-hospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions por más de 1 día.
  • Los ejecutores Just-In-Time (JIT) solo pueden ejecutar un único trabajo. Si los ejecutores JIT nunca ejecutan un trabajo, se quitarán automáticamente. Para quitar un ejecutor JIT antes de la eliminación automática, debe eliminar el ejecutor JIT en GitHub.

Para quitar un ejecutor autohospedado de una organización, debe ser propietario de la organización o tener el permiso "Administrar ejecutores de la organización y grupos de ejecutores". Te recomendamos que también tengas acceso a la máquina del ejecutor auto-hospedado. Para obtener información sobre cómo quitar un ejecutor autohospedado con la API REST, consulta "Puntos de conexión de API de REST para ejecutores autohospedados".

Para obtener más información sobre los roles de organización personalizados, vea "Acerca de los roles personalizados de organización".

Como alternativa, si no tienes acceso al repositorio, organización o empresa de GitHub Enterprise Server para eliminar un ejecutor, pero te gustaría volver a utilizar la máquina de ejecutor, puedes borrar el archivo .runner dentro del directorio de la aplicación de ejecutor autohospedado (esto es, el directorio en el que descargaste y desempaquetaste el software del ejecutor). Esto permite que el ejecutor se registre sin tener que volver a descargar la aplicación del ejecutor auto-hospedado.

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

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

    Captura de pantalla de las pestañas en el perfil de una organización. La pestaña "Configuración" se destaca en naranja oscuro.

  3. En la barra lateral izquierda, haz clic en Acciones y, después, en Ejecutores.

  4. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.

  5. Haga clic en Quitar.

  6. Verás las instrucciones para eliminar el ejecutor auto-hospedado. Completa cualquiera de los siguientes pasos para eliminar el ejecutor, dependiendo de si aún se puede acceder a él:

    • Si tiene acceso a la máquina del ejecutor: siga las instrucciones en pantalla para que el sistema operativo de la máquina ejecute el comando de eliminación. Las instrucciones incluyen la URL solicitada y un token de tiempo limitado generado automáticamente.

      El comando de eliminación realiza las siguientes tareas:

      • Elimina el ejecutor de GitHub Enterprise Server.
      • Elimina cualquier archivo de configuración de la aplicación del ejecutor autoalojado en la máquina.
      • Elimina todos los servicios configurados si no se ejecuta en modo interactivo.

    • Si no tiene acceso a la máquina: haga clic en Forzar la eliminación de este ejecutor para forzar a GitHub Enterprise Server a que quite el ejecutor.

Eliminar un ejecutor de una empresa

Notas:

  • Este procedimiento eliminará el ejecutor auto-hospedado permanentemente. Si solo quiere detener de forma temporal la asignación de trabajos a un ejecutor, puede apagar la máquina o detener la aplicación run. El ejecutor permanecerá asignado en un estado "Sin conexión" y no ejecutará ningún trabajo hasta que lo reinicie mediante la aplicación run.
  • Un ejecutor autohospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions durante más de 14 días. Un ejecutor efímero auto-hospedado se eliminará automáticamente de GitHub Enterprise Server si no se ha conectado a GitHub Actions por más de 1 día.
  • Los ejecutores Just-In-Time (JIT) solo pueden ejecutar un único trabajo. Si los ejecutores JIT nunca ejecutan un trabajo, se quitarán automáticamente. Para quitar un ejecutor JIT antes de la eliminación automática, debe eliminar el ejecutor JIT en GitHub.

Para eliminar a un ejecutor auto-hospedado de una empresa, debes ser un propietario de esta. Te recomendamos que también tengas acceso a la máquina del ejecutor auto-hospedado. Para más información sobre cómo agregar un ejecutor autohospedado con la API REST, vea los puntos de conexión de empresa en la API REST de GitHub Actions.

Como alternativa, si no tienes acceso al repositorio, organización o empresa de GitHub Enterprise Server para eliminar un ejecutor, pero te gustaría volver a utilizar la máquina de ejecutor, puedes borrar el archivo .runner dentro del directorio de la aplicación de ejecutor autohospedado (esto es, el directorio en el que descargaste y desempaquetaste el software del ejecutor). Esto permite que el ejecutor se registre sin tener que volver a descargar la aplicación del ejecutor auto-hospedado.

  1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.

    Captura de pantalla del menú desplegable que aparece al hacer clic en la foto de perfil en GitHub Enterprise Server. La opción "Configuración de Enterprise" está resaltada en un contorno naranja oscuro.

  2. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Directivas.

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

  4. Haz clic en la pestaña Ejecutores.

  5. En la lista de ejecutores, haz clic en el nombre del ejecutor que te gustaría configurar.

  6. Haga clic en Quitar.

  7. Verás las instrucciones para eliminar el ejecutor auto-hospedado. Completa cualquiera de los siguientes pasos para eliminar el ejecutor, dependiendo de si aún se puede acceder a él:

    • Si tiene acceso a la máquina del ejecutor: siga las instrucciones en pantalla para que el sistema operativo de la máquina ejecute el comando de eliminación. Las instrucciones incluyen la URL solicitada y un token de tiempo limitado generado automáticamente.

      El comando de eliminación realiza las siguientes tareas:

      • Elimina el ejecutor de GitHub Enterprise Server.
      • Elimina cualquier archivo de configuración de la aplicación del ejecutor autoalojado en la máquina.
      • Elimina todos los servicios configurados si no se ejecuta en modo interactivo.

    • Si no tiene acceso a la máquina: haga clic en Forzar la eliminación de este ejecutor para forzar a GitHub Enterprise Server a que quite el ejecutor.