Requisitos de atualização

Recomendações

• Inclua o mínimo possível de atualizações no seu processo. Por exemplo, em vez de atualizar de GitHub Enterprise3.19 para 3.203.21, você pode atualizar de GitHub Enterprise3.19 para .3.21 Use o Assistente de atualização para encontrar o caminho de atualização da versão da sua release atual.
• Se você estiver com várias versões atrasadas, atualize sua instância do GitHub Enterprise Server o mais adiante possível com cada etapa do processo de atualização. Ao usar a versão mais recente em cada atualização, você pode aproveitar as melhorias de desempenho e as correções de erros. Por exemplo, você pode atualizar da GitHub Enterprise 2.7 para a 2.8 para a 2.10, mas a atualização da GitHub Enterprise 2.7 para a 2.9 para a 2.10 usa uma versão posterior na segunda etapa.
• Ao atualizar, use a versão mais recente do patch. Navegue até a página Versões do GitHub Enterprise Server. Ao lado da versão para a qual você está atualizando, clique em Baixar e clique na guia Upgrade.
• Use uma instância de preparo para testar as etapas da atualização. Para saber mais, confira Configurar uma instância de testes.
• Ao executar múltiplas atualizações, certifique-se de que as migrações de dados e as tarefas de atualização em execução em segundo plano estejam totalmente concluídas antes de prosseguir para a próxima atualização de recurso. Para verificar o status desses processos, é possível usar os utilitários de linha de comando ghe-migrations e ghe-check-background-upgrade-jobs. Para saber mais, confira Utilitários de linha de comando.
• Tire um instantâneo antes de atualizar sua máquina virtual. Para saber mais, confira Capturar um instantâneo. Depois que o instantâneo for feito, desative os instantâneos automáticos para evitar possíveis impactos sobre o desempenho durante a atualização.
• Certifique-se de que você tem um backup recente e bem-sucedido da sua instância. Para obter mais informações, consulte o GitHub Enterprise Server Backup Utilities arquivo README.md.

Requisitos

• Você deve realizar uma verificação de capacidade. Para saber mais, confira Verificar a capacidade do sistema antes de atualizar.
• Você precisa fazer upgrade de uma versão de recurso que esteja no máximo duas versões atrás. Por exemplo, para atualizar para GitHub Enterprise3.21, você deve estar ligado GitHub Enterprise3.20 ou 3.19.
• Ao atualizar usando um pacote de atualização, agende uma janela de manutenção para GitHub Enterprise Server usuários finais.
• Você pode atualizar GitHub Enterprise Server para a versão mais recente do patch usando um hotpatch.

Você pode usar hotpatching para atualizar para uma versão de patch mais recente, mas não uma versão de recursos. Por exemplo, é possível atualizar da 2.10.1 para a 2.10.5 porque elas estão na mesma série de recursos, mas não da 2.10.9 para a 2.11.0 porque elas estão em séries de recursos diferentes.

Os hotpatches geralmente não exigem reinicialização. Ao instalar o hotpatch, você verá uma mensagem no terminal se algum dos pacotes precisar de uma reinicialização para concluir a atualização. Você pode agendar essa reinicialização em um horário conveniente, mas recomendamos reinicializar assim que possível, especialmente se houver alguma correção de segurança.

Os hotpatches exigem uma execução da configuração, o que pode causar um breve período de erros ou indisponibilidade em alguns ou todos os serviços em sua instância do GitHub Enterprise Server. Você não precisa habilitar o modo de manutenção durante a instalação de um hotpatch, mas isso garantirá que os usuários vejam uma página de manutenção em vez de erros ou tempos limite. Confira Habilitar e programar o modo de manutenção.

• Um hotpatch pode causar tempo de inatividade se os serviços afetados (como kernel, MySQL ou Elasticsearch) exigirem reinicialização da VM ou do serviço. Você receberá uma notificação quando/se a reinicialização for necessária. Será possível reinicializar em outro momento.
• Procure disponibilizar um armazenamento adicional na raiz durante a atualização, já que o hotpatching instala várias versões de alguns serviços até a conclusão da atualização. As verificações antes do voo irão notificá-lo se você não tiver espaço suficiente de armazenamento no disco raiz.
• Ao atualizar pelo hotpatching, sua instância não pode ficar carregada demais (isso pode afetar o processo).
• A atualização para GitHub Enterprise Server 2.17 migra os logs de auditoria do Elasticsearch para o MySQL. Além disso, essa migração aumenta a quantidade de tempo e espaço em disco necessários para restaurar um instantâneo. Antes de migrar, verifique o número de bytes nos índices de log de auditoria do Elasticsearch com este comando:

curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes

Use o número para estimar o espaço em disco necessário para os logs de auditoria do MySQL. O script também monitora seu espaço livre em disco durante o andamento da importação. Monitorar esse número é importante, principalmente se o espaço livre em disco estiver próximo da quantidade de espaço em disco necessária para a migração.

Ao atualizar, verificações prévias avaliam se os requisitos mínimos de recursos de hardware do sistema, como memória, núcleos de CPU e armazenamento no disco raiz e no disco de usuário, estão disponíveis para a instância. Se as verificações prévias determinarem que não há recursos suficientes ou qualquer outra falha, você será notificado e a atualização será cancelada.

Próximas etapas

Depois de examinar essas recomendações e requisitos, você pode atualizar GitHub Enterprise Server. Para saber mais, confira Visão geral do processo de atualização.