Actualizar con un hotpatch
You can upgrade GitHub Enterprise Server to the latest patch release using a hotpatch.
You can use hotpatching to upgrade to a newer patch release, but not a feature release. For example, you can upgrade from 2.10.1
to 2.10.5
because they are in the same feature series, but not from 2.10.9
to 2.11.0
because they are in a different feature series.
Hotpatches do not generally require a reboot. If a hotpatch does require a reboot, the GitHub Enterprise Server release notes will indicate the requirement.
Hotpatches require a configuration run, which can cause a brief period of errors or unresponsiveness for some or all services on your GitHub Enterprise Server instance. You are not required to enable maintenance mode during installation of a hotpatch, but doing so will guarantee that users see a maintenance page instead of errors or timeouts. For more information, see "Enabling and scheduling maintenance mode."El script de instalación de hotpatch instala el hotpatch en cada nodo de la agrupación y reinicia los servicios en su secuencia adecuada para evitar el tiempo de inactividad.
- Copia de seguridad de los datos con GitHub Enterprise Server Backup Utilities.
- Desde el shell administrativo de cualquier nodo, use el comando
ghe-cluster-hotpatch
para instalar la última revisión en caliente. Puedes proporcionar una URL para un hotpatch, o descargar manualmente el hotpatch y especificar un nombre de archivo local.$ ghe-cluster-hotpatch https://HOTPATCH-URL/FILENAME.hpkg
Actualizar con un paquete de actualización
Usa un paquete de actualización para actualizar una agrupación de GitHub Enterprise Server a la última característica de lanzamiento. Por ejemplo, puede actualizar de 2.11
a 2.13
.
Preparar para una actualización
- Revise Configuración de red de clúster para la versión a la que vaya a actualizar y actualice la configuración según sea necesario.
- Copia de seguridad de los datos con GitHub Enterprise Server Backup Utilities.
- Planifica una ventana de mantenimiento para los usuarios finales de tu agrupación de GitHub Enterprise Server, dado que no estará disponible para usar normalmente durante la actualización. El modo de mantenimiento bloquea el acceso de los usuarios e impide que se realicen cambios en los datos mientras la actualización de la agrupación está en curso.
- En la página de descargas de GitHub Enterprise Server, copie la dirección URL del archivo .pkg de actualización en el Portapapeles.
- Desde el shell administrativo de cualquier nodo, use el comando
ghe-cluster-each
combinado concurl
a fin de descargar el paquete de versión para cada nodo en un solo paso. Usa la URL que copiaste en el paso anterior como argumento.$ ghe-cluster-each -- "cd /home/admin && curl -L -O https://PACKAGE-URL.pkg" > ghe-app-node-1: % Total % Received % Xferd Average Speed Time Time Time Current > ghe-app-node-1: Dload Upload Total Spent Left Speed > 100 496M 100 496M 0 0 24.2M 0 0:00:20 0:00:20 --:--:-- 27.4M > ghe-data-node-2: % Total % Received % Xferd Average Speed Time Time Time Current > ghe-data-node-2: Dload Upload Total Spent Left Speed > 100 496M 100 496M 0 0 21.3M 0 0:00:23 0:00:23 --:--:-- 25.8M > ghe-data-node-1: % Total % Received % Xferd Average Speed Time Time Time Current > ghe-data-node-1: Dload Upload Total Spent Left Speed > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.6M > ghe-app-node-2: % Total % Received % Xferd Average Speed Time Time Time Current > ghe-app-node-2: Dload Upload Total Spent Left Speed > 100 496M 100 496M 0 0 19.8M 0 0:00:25 0:00:25 --:--:-- 17.6M > ghe-data-node-3: % Total % Received % Xferd Average Speed Time Time Time Current > ghe-data-node-3: Dload Upload Total Spent Left Speed > 100 496M 100 496M 0 0 19.7M 0 0:00:25 0:00:25 --:--:-- 25.5M
- Identifique el nodo MySQL principal, que se define como
mysql-master = <hostname>
encluster.conf
. Este será el último nodo que se actualizará.
Actualizar los nodos de la agrupación
- Para habilitar el modo de mantenimiento en función de la ventana de programación, conéctese al shell administrativo de cualquier nodo de clúster y ejecute
ghe-cluster-maintenance -s
. - Con la excepción del nodo MySQL primario, conéctese al shell administrativo de cada uno de los nodos de GitHub Enterprise Server.
Ejecute el comando
ghe-upgrade
y proporcione el nombre del archivo de paquete que ha descargado en el paso� 4 de Preparación para la actualización:$ ghe-upgrade PACKAGE-FILENAME.pkg > *** verifying upgrade package signature... > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A > gpg: checking the trustdb > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) >
" - El proceso de actualización reiniciará el nodo MySQL principal una vez que esté completo. Compruebe que puede usar
ping
en cada nodo después de reiniciarlo. - Conecta con el shell administrativo del nodo MySQL principal. Ejecute el comando
ghe-upgrade
y proporcione el nombre del archivo de paquete que ha descargado en el paso� 4 de Preparación para la actualización:$ ghe-upgrade PACKAGE-FILENAME.pkg > *** verifying upgrade package signature... > 497MB 0:00:04 [ 117MB/s] [==========================================>] 100% > gpg: Signature made Fri 19 Feb 2016 02:33:50 PM UTC using RSA key ID 0D65D57A > gpg: checking the trustdb > gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model > gpg: depth: 0 valid: 1 signed: 0 trust: 0-, 0q, 0n, 0m, 0f, 1u > gpg: Good signature from "GitHub Enterprise (Upgrade Package Key) >
" - El proceso de actualización reiniciará el nodo MySQL principal una vez que esté completo. Compruebe que puede ejecutar
ping
en cada nodo después de reiniciarlo. - Conéctese al shell administrativo del nodo MySQL principal y ejecute el comando
ghe-cluster-config-apply
. - Cuando termine
ghe-cluster-config-apply
, ejecuteghe-cluster-status
para comprobar que los servicios están en un estado correcto. - Ejecute
ghe-cluster-maintenance -u
para salir del modo de mantenimiento del shell administrativo de cualquier nodo.