Eliminar ejecutores autoalojados

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

En este artículo

Eliminar un ejecutor de un repositorio

Note

  • 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 Cloud 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 Cloud 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, consulta 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 de 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 Cloud 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 Cloud.
      • 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 Cloud a que quite el ejecutor.

Eliminar el ejecutor de una organización

Note

  • 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 Cloud 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 Cloud 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 de 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, consulta Acerca de los roles personalizados de organización.

Como alternativa, si no tienes acceso al repositorio, organización o empresa de GitHub Enterprise Cloud 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 Cloud.
      • 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 Cloud a que quite el ejecutor.

Eliminar un ejecutor de una empresa

Note

  • 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 Cloud 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 Cloud 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 Cloud 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, haz clic en la fotografía del perfil.

  2. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver.

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

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

  5. Haz clic en la pestaña Ejecutores.

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

  7. Haga clic en Quitar.

  8. 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 Cloud.
      • 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 Cloud a que quite el ejecutor.