Esta versão do GitHub Enterprise foi descontinuada em 2021-06-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Requisitos de atualização

Antes de atualizar o GitHub Enterprise Server, veja as recomendações e requisitos a seguir para planejar sua estratégia de atualização.

Notas:

  • Para atualizar do GitHub Enterprise 11.10.348 até o 11.10.354, você deve migrar para o GitHub Enterprise 2.1.23. Para obter mais informações, consulte "Migrar do GitHub Enterprise 11.10.x para o 2.1.23".
  • Nas versões com suporte, há pacotes de atualização disponíveis em enterprise.github.com. Verifique a disponibilidade dos pacotes de atualização necessários para concluir a atualização. Se um pacote não estiver disponível, entre em contato com o Suporte do GitHub Enterprise ou Suporte do GitHub Premium para obter assistência.
  • Se estiver usando o clustering do GitHub Enterprise Server, consulte "Atualizar cluster" no guia de clustering do GitHub Enterprise Server para obter instruções específicas.
  • As notas de versão do GitHub Enterprise Server mostram uma lista abrangente dos novos recursos de cada versão do GitHub Enterprise Server. Para obter mais informações, consulte a página de versões.

Recomendações

  • Inclua o mínimo possível de atualizações no seu processo. Por exemplo, em vez de atualizar do GitHub Enterprise 2.22 para o 3.0 e depois para o 3.1, atualize do GitHub Enterprise 2.22 para o 3.1.
  • Se a sua versão estiver muito defasada, atualize a sua instância do GitHub Enterprise Server para a versão mais atual disponível a cada etapa do processo. 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ê poderia atualizar do GitHub Enterprise 2.7 para o 2.8 e depois para o 2.10. No entanto, atualizar do GitHub Enterprise 2.7 para o 2.9 e depois para o 2.10 usa uma versão mais recente na segunda etapa.
  • Ao atualizar, use a versão mais recente do patch. Navegue até GitHub Enterprise Server Releases page. Ao lado da versão para a qual você está atualizando, clique em Download e depois clique na aba Upgrading.
  • Use uma instância de preparo para testar as etapas da atualização. Para obter mais informações, consulte "Configurar instância de preparo".
  • Ao executar várias atualizações, espere pelo menos 24 horas entre atualizações de recursos para permitir que as migrações de dados e as tarefas de atualização executadas em segundo plano sejam totalmente concluídas.

Requisitos

  • Você deve atualizar quando a versão do recurso estiver defasada por no máximo duas versões. Por exemplo, ao atualizar para o GitHub Enterprise 3.1, você deve estar nas versões GitHub Enterprise 3.0 ou 2.22.
  • Você pode atualizar GitHub Enterprise Server para a versão mais recente do patch usando um hotpatch, que não requer uma janela de manutenção e geralmente não requer reinicialização. Você pode usar hotpatching para atualizar para uma versão de patch mais recente, mas não uma versão de recursos. Por exemplo, você pode atualizar 2.10.1 para 2.10.5 porque eles estão na mesma série de recursos, mas não de 2.10.9 para 2.11.0 porque eles estão em uma série de recursos diferentes.
  • 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. Caso não haja espaço suficiente, você receberá uma notificação das verificações preliminares.
  • Ao atualizar pelo hotpatching, sua instância não pode ficar carregada demais (isso pode afetar o processo). As verificações preliminares avaliarão se a média de carga e a atualização irão falhar se a média de carga for muito alta. - Atualizar para GitHub Enterprise Server 2.17 migra seus logs de auditoria do Elasticsearch para 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 é útil principalmente se o espaço livre em disco estiver próximo da quantidade de espaço em disco necessária para a migração.

Sobre os requisitos mínimos para GitHub Enterprise Server 3.0 ou posterior

Antes de atualizar para GitHub Enterprise Server 3.0 ou posterior, revise os recursos de hardware que você forneceu para sua instância. GitHub Enterprise Server 3.0 introduz novas funcionalidades, como GitHub Actions e GitHub Package Registry, e exige mais recursos do que as versões 2.22 e anteriores. Para obter mais informações, consulte as observações sobre a versão GitHub Enterprise Server 3.0.

Os requisitos aumentados para GitHub Enterprise Server 3.0 e posterior estão em negrito na tabela a seguir.

Licenças de usuáriovCPUsMemóriaArmazenamento anexadoArmazenamento raiz
Teste, demonstração ou 10 usuários leves4
Up from 2
32 GB
Up de 16 GB
150 GB
Up de 100 GB
200 GB
10-30008
Up de 4
48 GB
Up de 32 GB
300 GB
Up de 250 GB
200 GB
3000-500012
Up de 8
64 GB500 GB200 GB
5000-800016
Up de 12
96 GB750 GB200 GB
8000-10000+20
Up de 16
160 GB
Up de 128 GB
1000 GB200 GB

Para obter mais informações sobre o ajuste de recursos para uma instância existente, consulte "aumentar a capacidade de armazenamento" e "aumentar recursos de CPU ou memória".

Próximas etapas

Após ler essas recomendações e requisitos, você poderá atualizar para o GitHub Enterprise Server. Para obter mais informações, consulte "Atualizar o GitHub Enterprise Server".