Utilidades de la línea de comando
Servidor de GitHub Enterprise incluye una gama de utilidades para ayudar a resolver problemas particulares o realizar tareas específicas.
En este artículo
- General
- ghe-announce
- ghe-check-disk-usage
- ghe-cleanup-caches
- ghe-cleanup-settings
- ghe-config
- ghe-config-apply
- ghe-console
- ghe-dbconsole
- ghe-es-index-status
- git-import
- ghe-legacy-github-services-report
- ghe-logs-tail
- ghe-maintenance
- ghe-nwo
- ghe-org-admin-promote
- ghe-reactivate-admin-login
- ghe-resque-info
- ghe-service-list
- ghe-set-password
- ghe-ssh-check-host-keys
- ghe-ssh-roll-host-keys
- ghe-ssh-weak-fingerprints
- ghe-ssl-acme
- ghe-ssl-ca-certificate-install
- ghe-ssl-generate-csr
- ghe-storage-extend
- ghe-version
- ghe-webhook-logs
- Agrupación
- ghe-cluster-support-bundle
- ghe-dpages
- ghe-spokes
- Git
- ghe-btop
- ghe-repo
- ghe-repo-gc
- Importar y exportar
- ghe-migrator
- Asistencia
- ghe-diagnostics
- ghe-support-bundle
- ghe-support-upload
- Actualizar Servidor de GitHub Enterprise
- ghe-upgrade
- ghe-upgrade-scheduler
- ghe-update-check
- Gestión de usuarios
- ghe-org-membership-update
- ghe-user-csv
- ghe-user-demote
- ghe-user-promote
- ghe-user-suspend
- ghe-user-unsuspend
Puedes ejecutar estos comandos desde cualquier lugar en la VM después de iniciar sesión como usuario administrador de SSH. Para obtener más información, consulta "Acceder al shell administrativo (SSH)."
General
- ghe-announce
- ghe-check-disk-usage
- ghe-cleanup-caches
- ghe-cleanup-settings
- ghe-config
- ghe-config-apply
- ghe-console
- ghe-dbconsole
- ghe-es-index-status
- git-import
- ghe-legacy-github-services-report
- ghe-logs-tail
- ghe-maintenance
- ghe-nwo
- ghe-org-admin-promote
- ghe-reactivate-admin-login
- ghe-resque-info
- ghe-service-list
- ghe-set-password
- ghe-ssh-check-host-keys
- ghe-ssh-roll-host-keys
- ghe-ssh-weak-fingerprints
- ghe-ssl-acme
- ghe-ssl-ca-certificate-install
- ghe-ssl-generate-csr
- ghe-storage-extend
- ghe-version
- ghe-webhook-logs
Agrupación
Git
Importar y exportar
Asistencia
Actualizar Servidor de GitHub Enterprise
Gestión de usuarios
- ghe-org-membership-update
- ghe-user-csv
- ghe-user-demote
- ghe-user-promote
- ghe-user-suspend
- ghe-user-unsuspend
General
ghe-announce
Esta utilidad establece un mensaje emergente en la parte superior de cada página GitHub Enterprise. Puedes usarlo para difundir un mensaje entre tus usuarios.
Uso:
# Establece un mensaje que es visible para todos
$ ghe-announce -s MESSAGE
> Mensaje de anuncio establecido.
# Elimina un mensaje establecido previamente
$ ghe-announce -u
> Eliminó el mensaje de anuncio
ghe-check-disk-usage
Esta utilidad busca en el disco los archivos grandes o los archivos que se han eliminado, pero siguen teniendo identificadores de archivo abiertos. Esto se debería ejecutar cuando intentes liberar espacio en la partición raíz.
Uso:
ghe-check-disk-usage
ghe-cleanup-caches
Esta utilidad borra una variedad de cachés que podrían ocupar espacio extra del disco en el volumen raíz. Si notas que el uso del espacio de disco del volumen raíz aumenta de manera considerable, sería buena idea ejecutar esta utilidad para ver si ayuda a reducir el uso general.
Uso:
ghe-cleanup-caches
ghe-cleanup-settings
Esta utilidad borra todas las configuraciones Consola de administración existentes.
Consejo: Por lo general, solo harás esto si te has contactado con el equipo de soporte, y se te ha solicitado que lo hagas.
Uso:
ghe-cleanup-settings
ghe-config
Con esta utilidad, puedes recuperar y modificar los ajustes de configuración de tu instancia de servidor de GitHub Enterprise.
Uso:
$ ghe-config core.github-hostname
# Obtiene el valor de configuración de `core.github-hostname`
$ ghe-config core.github-hostname 'example.com'
# Establece el valor de configuración de `core.github-hostname` en `example.com`
$ ghe-config -l
# Detalla todos los valores de configuración
ghe-config-apply
Esta utilidad aplica configuraciones Consola de administración, vuelve a cargar servicios del sistema, prepara un dispositivo de almacenamiento y ejecuta cualquier migración de base de datos pendiente. Equivale a hacer clic en Save settings (Guardar configuraciones) en la UI web de Consola de administración enviando una solicitud de POST al punto final /setup/api/configure
.
Probablemente, nunca la debas ejecutar en forma manual, pero está disponible si quieres automatizar el proceso de guardar tus configuraciones a través de SSH.
Uso:
ghe-config-apply
ghe-console
Esta utilidad abre la consola GitHub Rails en tu aparato GitHub Enterprise. No uses este comando sin indicación del Soporte para GitHub Enterprise. El uso incorrecto podría causar daño o pérdida de datos.
Uso:
ghe-console
ghe-dbconsole
Esta utilidad abre una sesión de base de datos de MySQL en tu aparato GitHub Enterprise. No uses este comando sin indicación del Soporte para GitHub Enterprise. El uso incorrecto podría causar daño o pérdida de datos.
Uso:
ghe-dbconsole
ghe-es-index-status
Esta utilidad genera un resumen de los índices de Elasticsearch en formato CSV.
Uso:
Imprime un resumen de los índices con un encabezado para STDOUT
:
$ ghe-es-index-status -do
> advertencia: parser/current está cargando parser/ruby23, que reconoce
> advertencia: 2.3.3-compliant syntax, pero estás ejecutando 2.3.4.
> advertencia: consulta https://github.com/whitequark/parser#compatibility-with-ruby-mri.
> Name,Primary,Searchable,Writable,UpToDate,RepairProgress,Version
> code-search-1,true,true,true,true,100.0,72e27df7c631b45e026b42bfef059328fa040e17
> commits-5,true,true,true,true,100.0,7ed28813100c47813ef654c0ee2bb9abf21ab744
> gists-4,true,true,true,true,100.0,cf8e7d04fcf2564c902e2873c424a279cc41079d
> issues-4,false,false,false,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76
> issues-5,true,true,true,true,100.0,d0bb08f71eebf6e7b070572aa399b185dbdc8a76
> projects-2,true,true,true,true,100.0,c5cac1c4b3c66d42e609d088d174dbc3dd44469a
> pull-requests-6,true,true,true,true,100.0,6a466ad6b896a3499509990979bf9a18d7d41de3
> repos-6,true,true,true,true,100.0,6c8b5fbba0fc1e409558db411d05e092c1387082
> users-5,true,true,true,true,100.0,38984875552bb826c9ec42999f409cb2e95556eb
> wikis-4,true,true,true,true,100.0,2613dec44bd14e14577803ac1f9e4b7e07a7c234
Imprime un resumen de los índices y canaliza los resultados en columnas
para mejor legibilidad:
$ ghe-es-index-status -do | column -ts,
> advertencia: parser/current está cargando parser/ruby23, que reconoce
> advertencia: 2.3.3-compliant syntax, pero estás ejecutando 2.3.4.
> advertencia: consulta https://github.com/whitequark/parser#compatibility-with-ruby-mri.
> Nombre Principal Se puede buscar Editable Actualizado Avance reparación Versión
> code-search-1 true true true true 100.0 72e27df7c631b45e026b42bfef059328fa040e17
> commits-5 true true true true 100.0 7ed28813100c47813ef654c0ee2bb9abf21ab744
> gists-4 true true true true 100.0 cf8e7d04fcf2564c902e2873c424a279cc41079d
> issues-4 falso falso falso true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76
> issues-5 true true true true 100.0 d0bb08f71eebf6e7b070572aa399b185dbdc8a76
> projects-2 true true true true 100.0 c5cac1c4b3c66d42e609d088d174dbc3dd44469a
> pull-requests-6 true true true true 100.0 6a466ad6b896a3499509990979bf9a18d7d41de3
> repos-6 true true true true 100.0 6c8b5fbba0fc1e409558db411d05e092c1387082
> users-5 true true true true 100.0 38984875552bb826c9ec42999f409cb2e95556eb
> wikis-4 true true true true 100.0 2613dec44bd14e14577803ac1f9e4b7e07a7c234
git-import
Estas utilidades son un paquete de herramientas que se pueden importar desde Subversion, Mercurial y Team Foundation Version Control a los repositorios de Git. Para obtener más información, consulta Importar datos desde sistemas de control de versión de terceros.
Comandos individuales para git-import
- git-import-detect
- Con una URL, detecta qué tipo de sistema de administración de control de fuente hay en el otro extremo. Durante una importación manual, probablemente ya lo sepas, pero puede ser muy útil en scripts automáticos.
- git-import-hg-raw
- Importa un repositorio de Mercurial a este repositorio de Git.
- git-import-svn-raw
- Importa el historial de Subversion y los datos del archivo a una rama de Git. Es una copia exacta del árbol, que ignora cualquier distinción de tronco o rama.
- git-import-tfs-raw
- Importa desde Team Foundation Version Control.
- git-import-rewrite
- El último paso de la importación es rescribir el repositorio. Esto te da la oportunidad de renombrar autores y genera ramas de Git en función de las carpetas (para Subversion y TFS).
ghe-legacy-github-services-report
Esta utilidad enumera los repositorios de tu aparato que usan Servicios GitHub, un método de integración que se interrumpirá el 1 de octubre de 2018. Los usuarios de tu aparato pueden tener configurados servicios GitHub para crear notificaciones de subidas a determinados repositorios. Para obtener más información, consulta "Anuncio de desuso de servicios GitHub " en el blog de GitHub o "Reemplazar servicios GitHub" en la documentación del programador de GitHub. Para obtener más información acerca de este comando o para conocer otras opciones, utiliza la marca -h
.
Uso:
ghe-legacy-github-services-report
ghe-logs-tail
Esta utilidad te permite hacer un registro final de todos los archivos de registro relevantes desde tu instalación. Puedes aprobar opciones para limitar los registros a conjuntos específicos. Utiliza la marca -h para más opciones.
Uso:
ghe-logs-tail
ghe-maintenance
Esta utilidad te permite controlar el estado del modo de mantenimiento de la instalación. Está diseñada para que la use principalmente la Consola de administración en segundo plano, pero también se puede usar directamente.
Uso:
ghe-maintenance -h
ghe-nwo
Esta utilidad genera un nombre y propietario de repositorio en función del Id. del repositorio.
Uso:
ghe-nwo REPOSITORY_ID
ghe-org-admin-promote
Usa este comando para otorgarles privilegios de propietario de la organización a los usuarios con privilegios de administrador del sitio sobre el aparato o para otorgarle privilegios de propietario de la organización a cualquier usuario único de una organización única. Debes especificar un usuario o una organización. El comando ghe-org-admin-promote
siempre pedirá confirmación antes de ejecutarse, a menos que uses la marca -y
para omitir la confirmación.
Puedes usar las siguientes opciones con la utilidad:
- La marca
-u
especifica un nombre de usuario. Usa esta marca para otorgarle privilegios de propietario de la organización a un usuario específico. Omite la marca-u
para promover todos los administradores del sitio a la organización específica. - La marca
-o
especifica una organización. Usa esta marca para otorgar privilegios de propietario en una organización específica. Omite la marca-o
para otorgarle permisos de propietario en todas las organizaciones al administrador del sitio especificado. - La marca
-a
otorga privilegios de propietario en todas las organizaciones a todos los administradores del sitio. - La marca
-y
omite la confirmación manual.
Esta utilidad no puede promover una cuenta de usuario que no sea administrador del sitio a propietario de todas las organizaciones. Puedes promover una cuenta de usuario común a administrador del sitio con ghe-user-promote.
Uso:
Otorga privilegios de propietario de la organización en una organización específica a un usuario único
ghe-org-admin-promote -u USERNAME -o ORGANIZATION
Otorga privilegios de propietario de la organización en todas las organizaciones a un administrador del sitio específico
ghe-org-admin-promote -u USERNAME
Otorga privilegios de propietario de la organización en una organización específica a todos los administradores del sitio
ghe-org-admin-promote -o ORGANIZATION
Otorga privilegios de propietario de la organización en todas las organizaciones a todos los administradores del sitio
ghe-org-admin-promote -a
ghe-reactivate-admin-login
Usa este comando para desbloquear de inmediato la Consola de administración después de 10 intentos fallidos de inicio de sesión en el transcurso de 10 minutos.
Uso:
$ ghe-reactivate-admin-login
ghe-resque-info
Esta utilidad muestra información sobre los trabajos en segundo plano, tanto activos como en cola. Proporciona las mismas cantidades de recuento de trabajos que la barra de estado del administrador que aparece en la parte superior de cada página.
Esta utilidad puede ayudar a identificar si el servidor Resque está teniendo problemas para procesar los trabajos de segundo plano. Cualquiera de los siguientes escenarios puede ser indicativo de un problema con Reque:
- Aumenta la cantidad de trabajos de segundo plano, pero los trabajos activos siguen siendo los mismos.
- Las fuentes de eventos no se actualizan.
- Los enlaces de servicio no se disparan.
- La interfaz web no se actualiza después de una subida de Git.
Si sospechas que Resque está fallando, contáctate con GitHub Enterprise Support](https://enterprise.github.com/support) o GitHub Premium Support para obtener ayuda.
Con este comando, también puedes detener o reanudar los trabajos en cola.
Uso:
$ ghe-resque-info
# detalla las colas y la cantidad de trabajos actualmente en cola
$ ghe-resque-info -p QUEUE
# detiene la cola especificada
$ ghe-resque-info -r QUEUE
# reanuda la cola especificada
ghe-service-list
Esta utilidad enumera todos los servicios que se han iniciado o detenido (en ejecución o en espera) en tu aparato.
Uso:
$ ghe-service-list
start/running
- github-resqued, process 12711
- github-unicorn, process 12726
- github-gitauth, process 12743
- git-daemon, process 12755
- babeld, process 12771
- github-svn-proxy, process 12802
- gist-unicorn, process 12832
- gist-resqued, process 12881
- render-unicorn, process 12939
- hookshot-unicorn, process 13076
- nodeload2, process 13192
- slumlord-unicorn, process 13304
- ghe-storage, process 2012
- enterprise-manage-unicorn, process 2024
- enterprise-manage-resque, process 2053
stop/waiting
- ghe-replica-mode
Los nombres de servicio que se generan a partir de este comando se pueden utilizar con los comandos 'Upstart' para detener, iniciar, o reiniciar estos servicios en forma manual, de ser necesario. Por ejemplo:
$ sudo restart github-resqued
Detener los servicios generará un tiempo de inactividad en tu instalación, así que recomendamos que te contactes con GitHub Enterprise Support](https://enterprise.github.com/support) o GitHub Premium Support antes de detener o reiniciar cualquier servicio.
ghe-set-password
Con ghe-set-password
, puedes establecer una contraseña nueva para autenticarla en la Consola de administración.
Uso:
ghe-set-password
ghe-ssh-check-host-keys
Esta utilidad compara las claves del host de SSH existentes con la lista de claves del host de SHH filtradas conocidas.
Uso:
$ ghe-ssh-check-host-keys
Si se encuentra una clave del host filtrada, se cierra la utilidad en un estado 1
y con un mensaje:
> Una o más de tus claves del host de SHH aparecen en la lista negra.
> Restablece tus claves del host usando ghe-ssh-roll-host-keys.
Si no se encontró una clave del host filtrada, se cierra la utilidad en un estado 0
y con un mensaje:
> Las claves del host de SSH no se encontraron en la lista negra de claves del host de SSH.
> No se requieren/recomiendan más pasos en este momento.
ghe-ssh-roll-host-keys
Esta utilidad rota las claves del host de SSH y las reemplaza con claves que se generan nuevas.
Uso:
$ sudo ghe-ssh-roll-host-keys
¿Quieres proceder con la rotación de claves del host de SSH? Esto eliminará las
las claves existentes en /etc/ssh/ssh_host_* y generará nuevas. [y/N]
# Presiona 'Y' para confirmar la eliminación o utiliza el modificador -y para omitir esta pregunta
> Las claves del host de SSH se han rotado con éxito.
ghe-ssh-weak-fingerprints
Esta utilidad genera un informe de claves de SSH débiles conocidas que están almacenadas en el aparato GitHub Enterprise. Opcionalmente, puedes revocar las claves de usuario como acción masiva. La utilidad informará las claves de sistema débiles que puedes revocar en forma manual en la Consola de administración.
Uso:
# Imprime un informe de usuario y claves SSH del sistema débiles
$ ghe-ssh-weak-fingerprints
# Revoca todas las claves de usuario débiles
$ ghe-ssh-weak-fingerprints --revoke
ghe-ssl-acme
Esta utilidad te permite instalar un certificado de Let's Encrypt en tu aparato GitHub Enterprise. Para obtener más información, consulta "Configurar TLS."
Puedes usar estas opciones adicionales con la utilidad:
- La marca
-x
elimina la configuración ACME.
Uso:
ghe-ssl-acme -e
ghe-ssl-ca-certificate-install
Esta utilidad te termine instalar un certificado CA de raíz personalizado en tu servidor GitHub Enterprise. El certificado debe tener un formato PEM. Además, si tu proveedor de certificación incluye varios certificados CA en un único archivo, debes separarlos en archivos individuales que luego pasarás a ghe-ssl-ca-certificate-install
de a uno por vez.
Ejecuta esta utilidad para agregar una cadena de certificación para la verificación de firma de confirmación S/MIME. Para obtener más información, consulta "Acerca de la verificación de firma de confirmación".
Ejecuta esta utilidad cuando tu instancia de servidor de GitHub Enterprise no pueda conectarse con otro servidor porque el segundo está usando un certificado SSL autofirmado o un certificado SSL para el cual no proporciona el paquete de soporte CA necesario. Una manera de confirmar esto es ejecutar openssl s_client -connect host:port -verify 0 -CApath /etc/ssl/certs
desde tu instancia de servidor de GitHub Enterprise. Si el certificado SSL del servidor remoto se puede verificar, tu SSL-Session
debe tener un código de retorno de 0, como se muestra a continuación.
SSL-Session:
Protocol : TLSv1
Cipher : AES128-SHA
Session-ID: C794EBCC3CBC10F747C9AFC029C03C1048FC99CFC34D13D7444E0F267C58DF4C
Session-ID-ctx:
Master-Key: 02A7C47CFD6EEC87D3C710E9DD87390E04EF82DDD7514AE03127D5DC1945FC0CAEFB5395791AEA598667EFA61B9EA8C5
Key-Arg : None
Start Time: 1394581597
Timeout : 300 (sec)
Verify return code: 0 (ok)
Si, de lo contrario, el certificado SSL del servidor remoto no se puede verificar, tu SSL-Session
debería tener un código de retorno distinto de cero:
SSL-Session:
Protocol : TLSv1
Cipher : AES128-SHA
Session-ID: 82CB288051A6DB66094C50A69CF1292AEE7E54C6B01B659B98AB336F8C33863E
Session-ID-ctx:
Master-Key: 01B025B2F764043A27919A8D1355AAECD8844FF0831B1D664042334790574A6F4025BAB085D4ED71D71AAB3091B849E5
Key-Arg : None
Start Time: 1394581782
Timeout : 300 (sec)
Verify return code: 27 (certificate not trusted)
Puedes usar estas opciones adicionales con la utilidad:
- La marca
-r
te permite desinstalar un certificado CA. - La marca
-h
muestra más información de uso.
Uso:
ghe-ssl-ca-certificate-install -c /path/to/certificate
ghe-ssl-generate-csr
Esta utilidad te permite generar una clave privada y una solicitud de firma de certificado (CSR), que puedes compartir con una autoridad de certificación comercial o privada para obtener un certificado válido para utilizar con tu instancia. Para obtener más información, consulta "Configurar TLS."
Para obtener más información acerca de este comando o para conocer otras opciones, utiliza la marca -h
.
Uso:
ghe-ssl-generate-csr
ghe-storage-extend
Algunas plataformas exigen este script para ampliar el volumen de usuarios. Para obtener más información, consulta "Aumentar la capacidad de almacenamiento".
Uso:
$ ghe-storage-extend
ghe-version
Esta utilidad imprime la versión, la plataforma y la compilación de tu instancia de servidor de GitHub Enterprise.
Uso:
$ ghe-version
ghe-webhook-logs
Esta utilidad genera registros de entregas de webhooks para que los administradores los revisen e identifiquen cualquier problema.
Uso:
ghe-webhook-logs
Muestra todas las entregas de enlaces fallidas del último día
ghe-webhook-logs -f -a YYYYMMDD
Muestra toda la carga de enlaces, el resultado y cualquier excepción en la entrega
ghe-webhook-logs -g delivery-guid -v
Muestra las entregas de webhooks generales
ghe-webhook-logs --global
Agrupación
ghe-cluster-support-bundle
Esta utilidad crea un tarball de paquetes de soporte que contiene registros importantes de cada nodo, tanto en la configuración de Replicación geográfica como de Agrupación.
Por defecto, el comando crea el tarball en /tmp, pero también puedes tener cat
el tarball en STDOUT
para una fácil transmisión por SSH. Esto es útil en caso de que la UI web no responda o que no funcione descargar un paquete de soporte desde /setup/support. Debes usar este comando si quieres generar un paquete ampliado que contenga registros antiguos. También puedes usar este comando para cargar el paquete de soporte de agrupación directamente para GitHub Enterprise recibir asistencia.
Uso:
Paquete estándar
$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -o' > cluster-support-bundle.tgz
Paquete ampliado
$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -x -o' > cluster-support-bundle.tgz
Enviar un paquete para recibir asistencia
$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -u'
Enviar un paquete para recibir asistencia y asociarlo con un ticket
$ ssh -p 122 admin@hostname -- 'ghe-cluster-support-bundle -t ticket-id'
ghe-dpages
Esta utilidad te permite administrar el servidor de páginas distribuido.
Uso:
ghe-dpages
Muestra un resumen de la ubicación y el estado del repositorio
estado ghe-dpages
ghe-spokes
Esta utilidad te permite administrar las tres copias de cada repositorio en los servidores de git distribuidos.
Uso:
ghe-spokes
Muestra un resumen de la ubicación y el estado del repositorio
estado ghe-spokes
Muestra los servidores en los cuales se almacena el repositorio
ruta ghe-spokes
Git
ghe-btop
Una interfaz del tipo top
para las operaciones actuales de Git.
Uso:
ghe-btop [ | --help | --usage ]
ghe-repo
Esta utilidad te permite cambiar a un directorio del repositorio y abrir un shell interactivo como el de usuario de git
. Puedes realizar inspecciones o mantenimientos manuales de un repositorio a través de comandos como git-*
o git-nw-*
.
Uso:
ghe-repo username/reponame
ghe-repo-gc
Esta utilidad reempaqueta de forma manual una red de repositorios para optimizar el almacenamiento de paquetes. Si tienes un repositorio grande, ejecutar este comando puede ayudar a reducir su tamaño general. GitHub Enterprise ejecuta de forma automática este comando durante toda tu interacción con una red de repositorios.
Puedes agregar el argumento opcional --prune
para eliminar los objetos de Git inaccesibles que no están referenciados desde una rama, una etiqueta o cualquier otra referencia. Esto es útil, en especial, para eliminar de inmediato información sensible previamente suprimida.
Uso:
ghe-repo-gc username/reponame
Importar y exportar
ghe-migrator
ghe-migrator
es una herramienta de alta fidelidad que te ayuda a realizar migraciones desde una instancia de GitHub a otra. Puedes consolidar tus instancias o mover tu organización, usuarios, equipos y repositorios desde GitHub.com a GitHub Enterprise.
Para obtener más información, consulta nuestra guía sobre migrar datos de usuarios, organizaciones y repositorios.
Asistencia
ghe-diagnostics
Esta utilidad realiza múltiples verificaciones y reúne información acerca de tu instalación que puedes enviar para recibir asistencia para diagnosticar los problemas que tienes.
Actualmente, el resultado de esta utilidad es similar a descargar la información de diagnóstico en la Consola de administración, pero con el tiempo se pueden agregar otras mejoras que no están disponibles en la UI web. Para obtener más información, consulta "Crear y compartir archivos de diagnóstico".
Uso:
ghe-diagnostics
ghe-support-bundle
Nota: Si vas a usar una configuración de Replicación geográfica o una Agrupación de GitHub Enterprise, debes usar el comando ghe-cluster-support-bundle
para recuperar el paquete de soporte. Para obtener más información, consulta "Utilidades de la línea de comandos".
Esta utilidad crea un tarball de paquetes de soporte que contiene registros importantes de tu instancia.
Por defecto, el comando crea el tarball en /tmp, pero también puedes tener cat
el tarball en STDOUT
para una fácil transmisión por SSH. Esto es útil en caso de que la UI web no responda o que no funcione descargar un paquete de soporte desde /setup/support. Debes usar este comando si quieres generar un paquete ampliado que contenga registros antiguos. También puedes usar este comando para cargar el paquete de soporte directamente en la asistencia de GitHub Enterprise.
Uso:
Paquete estándar
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz
Paquete ampliado
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -x -o' > support-bundle.tgz
Enviar un paquete para recibir asistencia
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -u'
Enviar un paquete para recibir asistencia y asociarlo con un ticket
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -t ticket-id'
ghe-support-upload
Esta utilidad envía información desde tu aparato a la asistencia de GitHub Enterprise. Puedes especificar un archivo local u ofrecer una transmisión de hasta 100MB de datos a través de STDIN
. Opcionalmente, los datos cargados se pueden asociar a un ticket de asistencia.
Uso:
Enviar un archivo para recibir asistencia y asociarlo con un ticket
ghe-support-upload -f path/to/your/file -t ticket-id
Cargar datos a través de STDIN
y asociarlos con un ticket
ghe-repl-status -vv | ghe-support-upload -t ticket-id -d "Verbose Replication Status"
- En este ejemplo,
ghe-repl-status -vv
envía información de estado detallada desde un aparato réplica. Debes reemplazarghe-repl-status -vv
con los datos específicos que quieras transmitir aSTDIN
yVerbose Replication Status
(Estado de replicación detallado) con una breve descripción de los datos. Por lo general, solo harás esto si te has contactado con el equipo de soporte, y se te ha solicitado que lo hagas.
Actualizar Servidor de GitHub Enterprise
ghe-upgrade
Esta utilidad instala o verifica un paquete actualizado. También puedes usar esta utilidad para revertir un lanzamiento de patch si falla o se interrumpe una actualización. Para obtener más información, consulta "Actualizar Servidor de GitHub Enterprise".
Uso:
Verificar un paquete de actualización
ghe-upgrade --verify UPGRADE-PACKAGE-FILENAME
Instalar un paquete de actualización
ghe-upgrade UPGRADE-PACKAGE-FILENAME
Revertir un lanzamiento de patch
When rolling back an upgrade, you must use an upgrade package file with the .pkg extension. Hotpatch package files with the .hpkg extension are not supported.
ghe-upgrade --allow-patch-rollback EARLIER-RELEASE-UPGRADE-PACKAGE.pkg
Se debe reiniciar después de ejecutar el comando. Rolling back does not affect the data partition, as migrations are not run on patch releases.
ghe-upgrade-scheduler
Esta utilidad administra la instalación programada de paquetes de actualización. Puedes mostrar, crear nuevas o eliminar las actualizaciones programadas. Debes crear cronogramas usando expresiones cron. Para obtener más información, consulta Entrada de Cron en Wikipedia.
Uso:
Nueva instalación programada para un paquete
$ ghe-upgrade-scheduler -c "0 2 15 12 *" UPGRADE-PACKAGE-FILENAME
Muestra las instalaciones programadas para un paquete
$ ghe-upgrade-scheduler -s UPGRADE PACKAGE FILENAME
> 0 2 15 12 * /usr/local/bin/ghe-upgrade -y -s UPGRADE-PACKAGE-FILENAME > /data/user/common/UPGRADE-PACKAGE-FILENAME.log 2>&1
Elimina las instalaciones programadas para un paquete
$ ghe-upgrade-scheduler -r UPGRADE PACKAGE FILENAME
ghe-update-check
Esta utilidad buscará si hay disponible un nuevo lanzamiento de patch de GitHub Enterprise. Si lo hay, y si hay espacio disponible en tu instancia, descargará el paquete. Por defecto, se guarda en /var/lib/ghe-updates. Luego, un administrador puede realizar la actualización.
En /var/lib/ghe-updates/ghe-update-check.status puedes acceder a un archivo que contiene el estado de la descarga.
Para buscar el último lanzamiento de GitHub Enterprise, usa el modificador -i
.
Uso:
$ ssh -p 122 admin@hostname -- 'ghe-update-check'
Gestión de usuarios
ghe-org-membership-update
Esta utilidad aplicará la visibilidad de la membresía a la organización predeterminada mostrando todos los miembros de tu instancia. Para obtener más información, consulta "Configurar la visibilidad de la membresía a la organización". Las opciones de configuración son público
o privado
.
Uso:
ghe-org-membership-update --visibility=SETTING
ghe-user-csv
Esta utilidad vierte una lista de todos los usuarios de la instalación a un formato CSV. El archivo CSV incluye las direcciones de correo electrónico, el tipo de usuario que son (p. ej., administrador, usuario), cuántos repositorios tienen, cuántas claves SSH tienen, la cantidad de membresías a la organización, la última dirección IP que inició sesión, etc. Usa la marca -h
para obtener más opciones.
Uso:
ghe-user-csv -o > users.csv
ghe-user-demote
Esta utilidad baja de categoría al usuario especificado del estado de administrador al de usuario normal. Recomendamos usar la UI web para realizar esta acción, pero proporcionamos esta utilidad en caso de que la utilidad ghe-user-promote
se ejecute con error, y debas volver a bajar de categoría a un usuario desde la CLI (interfaz de línea de comandos).
Uso:
ghe-user-demote some-user-name
ghe-user-promote
Esta utilidad promueve la cuenta de usuario especificada a administrador del sitio.
Uso:
ghe-user-promote some-user-name
ghe-user-suspend
Esta utilidad suspende el usuario especificado, evitando que inicie sesión, suba o extraiga datos de tu repositorio.
Uso:
ghe-user-suspend some-user-name
ghe-user-unsuspend
Esta utilidad anula la suspensión del usuario especificado, otorgándole acceso para iniciar sesión, subir o extraer datos de tu repositorio.
Uso:
ghe-user-unsuspend some-user-name