Eliminar ejecutores autoalojados

Puedes eliminar un ejecutor autohospedado permanentemente de un repositorio u organización.

En este artículo

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 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 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 pueden quitar un ejecutor de un repositorio de la 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 u organización de GitHub 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.
      • 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 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 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 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. 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 u organización de GitHub 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.
      • 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 a que quite el ejecutor.

Eliminar un ejecutor de una empresa

Si usa GitHub Enterprise Cloud, también puede quitar ejecutores de una empresa. Para más información, vea la documentación de GitHub Enterprise Cloud.