Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Utilizar las extensiones del CLI de GitHub

Aprende cómo utilizar extensiones personalizadas que escriben otros usuarios de CLI de GitHub.

Acerca de las extensiones del CLI de GitHub

Nota: Las extensiones fuera de GitHub Enterprise Server y CLI de GitHub no están certificadas por GitHub Enterprise Server y se rigen por términos de servicio, políticas de privacidad y documentación de soporte distintas. Para mitigar el riesgo al utilizar extensiones de terceros, audita el código fuente de la extensión antes de instalarla o actualizarla.

Las extensiones del CLI de GitHub son comandos personalizados del CLI de GitHub que cualquiera puede crear y utilizar. Para obtener más información sobre cómo crear extensiones de CLI de GitHub, consulta la sección "Crear extensiones de CLI de GitHub".

Las extensiones se instalan localmente y se les da el alcance del usuario. Por lo tanto, si accedes al CLI de GitHub desde una máquina diferente o si otro usuario accede al CLI de GitHub desde la misma máquina, la extensión no estará disponible.

Encontrar extensiones

Puedes encontrar extensiones si buscas los repositorios con el tema gh-extension.

Instalar extensiones

Para instalar una extensión, utiliza el subcomando extensions install. Reemplaza el parámetro repo con el repositorio de la extensión. Puedes utilizar la URL completa, tal como https://github.com/octocat/gh-whoami, o solo el propietario y repositorio, tal como octocat/gh-whoami.

Si se utiliza el propietario y repositorio, gh instalará la extensión utilizando el nombre de host en el cual está autenticado gh. El formato de URL completa es útil cuando se instalan extensiones desde un host diferente. Por ejemplo, los usuarios de GitHub Enterprise Server deben utilizar la URL completa del repositorio para instalar extensiones de GitHub.com o de cualquier otro host.

Para instalar una extensión en desarrollo desde el directorio actual, utiliza . como el valor para el parámetro repo.

gh extension install repo

Si ya tienes una extensión con el mismo nombre instalada, el comando fallará. Por ejemplo, si instalaste octocat/gh-whoami, debes desinstalarlo antes de instalar hubot/gh-whoami.

Ver las extensiones instaladas

Para ver las extensiones instaladas, utiliza el subcomando extensions list. La salida también te dirá qué extensiones tienen actualizaciones disponibles.

gh extension list

Actualizar las extensiones

Para actualizar una extensión, utiliza el subcomando extensions upgrade. Reemplaza el parámetro extension con el nombre de la extensión.

gh extension upgrade extension

Para actualizar todas las extensiones instaladas, utiliza el marcador --all.

gh extension upgrade --all

Desinstalar las extensiones

Para desinstalar una extensión, utiliza el subcomando extensions remove. Reemplaza al parámetro extension con el nombre de la extensión.

gh extension remove extension