Visão geral do processo de atualização

GitHub Enterprise Server está constantemente melhorando, com novas funcionalidades e correções de erros introduzidas por meio de recursos e versões de patch. Você é responsável por atualizações para sua instância. Confira Sobre atualizações para novas versões.

Para fazer upgrade de uma instância, você deve:

Planeje sua estratégia de atualização escolhendo sua versão de atualização e o pacote de atualização apropriado e agendando uma janela de manutenção.
Comunique a atualização antes e durante o processo de atualização.
Prepare sua estratégia de backup criando um backup e tirando um instantâneo da máquina virtual.
Instale o pacote de atualização usando o pacote e o método apropriados.
Conclua as tarefas pós-atualização.

O processo que você deve seguir para aplicar um pacote de atualização depende de quantos nós estão em sua topologia de implantação. Este artigo fornece informações gerais para atualizar instâncias somente em uma configuração independente ou de alta disponibilidade.

Planejar sua estratégia de atualização

Planejar a atualização

Revise as notas de versão e os problemas conhecidos documentados antes de executar uma atualização. Confira Notas de versão e Problemas conhecidos com atualizações das suas instâncias.
Revise Requisitos de atualização para garantir que você entenda os requisitos e recomendações para atualização.
Verifique se o disco de dados de sua instância do GitHub Enterprise Server está com pelo menos 15% de espaço livre. GitHub recomenda garantir que haja armazenamento gratuito adicional no disco. Em alguns casos raros, para clientes com grandes volumes de dados, esse limite pode ser diferente. Confira Aumentar a capacidade de armazenamento.
Verifique se você tem recursos de hardware suficientes para GitHub Enterprise Server. 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.
Verifique se você tem uma cópia de todas as regras de firewall personalizadas, sua instância do GitHub Enterprise Serverpois as regras personalizadas não persistirão após a atualização. Você deve reaplicar todas as regras personalizadas após a atualização. Confira Configurar regras de firewall integrado.
Para instâncias em uma configuração de alta disponibilidade, certifique-se de que o status da replicação informe OK antes do upgrade. Confira Monitorar uma configuração de alta disponibilidade.
Considere configurar a lista de exceções de IP para o modo de manutenção, para que você possa limitar temporariamente o acesso a sua instância do GitHub Enterprise Server para validar a integridade do seu servidor após uma atualização. Confira Habilitar e programar o modo de manutenção.

Escolha sua versão de atualização e pacote

Determine uma estratégia de atualização e escolha uma versão para atualizar.
- Você pode atualizar uma GitHub Enterprise Server instância para uma nova versão de patch ou para uma nova versão do recurso.
- Consulte o Assistente de atualização para encontrar o caminho de atualização da sua versão atual para uma nova versão de patch ou de recurso.
Escolha um pacote de atualização (hotpatch ou pacote de atualização).
- No caso da atualização para uma versão de patch, é possível usar um patch dinâmico ou um pacote de atualização. Para atualizar para uma versão de funcionalidade, você deve usar um pacote de upgrade.
- Se você usar um pacote de atualização, agende uma janela de manutenção para GitHub Enterprise Server usuários finais. Se estiver usando um hotpatch, não será necessário recorrer ao modo de manutenção.
- Se você tiver habilitado as verificações automáticas de atualização, os administradores do site serão notificados de que um pacote de atualização foi baixado e está disponível. Confira Ativar verificações automáticas de atualizações.
- Os builds de versões Release Candidate destinam-se exclusivamente ao uso em um ambiente de teste. Não instale um build de versão Release Candidate em um ambiente de produção. Não atualize da versão Release Candidate para versões posteriores, incluindo as versões com disponibilidade geral.

Considere se outras atualizações de aplicativos são necessárias

Verifique se você precisa atualizar os seguintes aplicativos:

GitHub Actions os executores deverão ser atualizados se sua instância do GitHub Enterprise Server usarem executores GitHub Actions auto-hospedados e as atualizações automáticas estiverem desabilitadas. Atualize os executores para a versão mínima do aplicativo exigida pela instância atualizada antes de executar a atualização. Para encontrar a versão mínima necessária para seu lançamento, consulte Lançamentos do GitHub Enterprise Server.
GitHub Enterprise Server Backup Utilities. Sua versão GitHub Enterprise Server Backup Utilities deve ser a mesma versão que a de sua instância do GitHub Enterprise Server ou, no máximo, estar até duas versões à frente.
- Talvez seja necessário atualizar GitHub Enterprise Server Backup Utilities para uma versão mais recente antes de atualizar sua instância.
- Talvez você também queira planejar a atualização GitHub Enterprise Server Backup Utilities para uma versão mais recente depois de atualizar sua instância.
Consulte Como configurar backups em sua instância usando Utilitários de Backup e o README na documentação do GitHub Enterprise Server Backup Utilities projeto.

Planejar uma janela de manutenção

Dependendo da sua estratégia de atualização, pode ser necessário um tempo de inatividade significativo.
A melhor maneira de determinar a duração esperada do tempo de inatividade é testar primeiro a atualização em um ambiente de preparo. Confira Configurar uma instância de testes.
A janela de manutenção da atualização depende do tipo de atualização a ser feita.
- Atualizações utilizando hotpatch normalmente não exigem período de manutenção. Às vezes, é necessário reiniciar, o que pode ser feito em outro momento.
  
  Observação
  
  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.
- Versões de patch usando um pacote de atualização normalmente requerem menos de cinco minutos de tempo de inatividade.
- A atualização para uma nova versão de recursos que inclui migrações de dados pode causar algumas horas de tempo de inatividade, dependendo do desempenho do armazenamento e da quantidade de dados migrados. Durante esse tempo, nenhum dos usuários poderá usar a empresa. Você pode notar que as atualizações para uma nova versão de recurso levam menos tempo. Isso ocorre porque as transições seletivas do banco de dados agora serão executadas em paralelo, com o número de workers simultâneos sendo, por padrão, igual ao número de núcleos da CPU, até um máximo de 16.

Comunicando sua atualização

Antes da atualização, você pode publicar um banner de anúncio global para destacar informações importantes para seus usuários, como alterações recebidas ou possível tempo de inatividade. Confira Personalizar mensagens de usuário para sua empresa.
No momento da atualização, você pode ativar o modo de manutenção e definir uma mensagem personalizada para informar aos usuários que a instância está temporariamente indisponível. Confira Habilitar e programar o modo de manutenção.

Preparar a estratégia de backup

Criar um instantâneo de backup

Certifique-se de ter um instantâneo de backup recente e bem-sucedido do nó primário da instância antes de iniciar o processo de upgrade. Consulte Como configurar backups em sua instância usando Utilitários de Backup e o README na documentação do GitHub Enterprise Server Backup Utilities projeto.

Verifique o status dos trabalhos em segundo plano e examine o log de atualização em busca de erros.
Verifique a funcionalidade básica GitHub Enterprise Server . Por exemplo, confira se você pode entrar por meio da interface do usuário e verifique se várias de suas organizações, repositórios e problemas podem ser alcançados conforme o esperado. Também é uma boa ideia executar manualmente várias buscas, clones e pushes do Git usando SSH e/ou HTTPS e verificar se as solicitações de API e as entregas de webhook foram concluídas com êxito.
Reaplique todas as regras de firewall personalizadas. Confira Configurar regras de firewall integrado.
Exclua todos os instantâneos de VM tirados antes da atualização. Confira Capturar um instantâneo.
Desative o modo de manutenção e atualize todas as comunicações de pré-atualização, como banners de anúncio. Confira Personalizar mensagens de usuário para sua empresa e Habilitar e programar o modo de manutenção.
Monitore todos os trabalhos em segundo plano enfileirados em sua instância para garantir que eles sejam concluídos com êxito. Confira Utilitários de linha de comando.

Neste artigo