Removing self-hosted runners

You can permanently remove a self-hosted runner from a repository or organization.

En este artículo

Removing a runner from a repository

Nota:

  • 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 auto-hospedado se eliminará automáticamente de GitHub si no se ha conectado a GitHub Actions durante más de 14 días. Un ejecutor auto-hospedado efímero se eliminará automáticamente de GitHub si no se ha conectado a GitHub Actions durante 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.

To remove a self-hosted runner from a user repository you must be the repository owner. Organization owners can remove a runner from a repository in the organization.

We recommend that you also have access to the self-hosted runner machine.

For information about how to remove a self-hosted runner with the REST API, see Puntos de conexión de API de REST para ejecutores autohospedados.

Como alternativa, si no tienes acceso al repositorio u organización en 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 tienes acceso a la máquina: haz clic en Forzar la eliminación de este ejecutor para forzar a GitHub a que quite el ejecutor.

Removing a runner from an organization

Nota:

  • 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 auto-hospedado se eliminará automáticamente de GitHub si no se ha conectado a GitHub Actions durante más de 14 días. Un ejecutor auto-hospedado efímero se eliminará automáticamente de GitHub si no se ha conectado a GitHub Actions durante 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.

To remove a self-hosted runner from an organization, you must be an organization owner. We recommend that you also have access to the self-hosted runner machine. For information about how to remove a self-hosted runner with the REST API, see Puntos de conexión de API de REST para ejecutores autohospedados.

Como alternativa, si no tienes acceso al repositorio u organización en 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 tienes acceso a la máquina: haz clic en Forzar la eliminación de este ejecutor para forzar a GitHub a que quite el ejecutor.

Removing a runner from an enterprise

If you use GitHub Enterprise Cloud, you can also remove runners from an enterprise. For more information, see the GitHub Enterprise Cloud documentation.