Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2022-09-28. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Habilitar e programar o modo de manutenção

Alguns procedimentos de manutenção padrão, como atualizar your GitHub Enterprise Server instance ou restaurar backups, exigem que a instância seja colocada offline para uso normal.

Sobre o modo de manutenção

Alguns tipos de operações exigem que você coloque o your GitHub Enterprise Server instance offline e no modo de manutenção:

  • Atualizar para uma nova versão do GitHub Enterprise Server;
  • Aumentar a capacidade dos recursos de CPU, memória ou armazenamento alocados na máquina virtual;
  • Migrar dados de uma máquina virtual para outra;
  • Restaurar dados de um instantâneo do GitHub Enterprise Server Backup Utilities;
  • Solucionar determinados tipos de problemas graves no aplicativo.

É recomendável programar um período de manutenção de no mínimo 30 minutos para que os usuários tenham tempo de se preparar. Quando houver um período de manutenção programado, todos os usuários verão um banner ao acessar o site.

Banner para usuário final sobre manutenção programada

Quando a instância estiver em modo de manutenção, todos os acessos regulares por HTTP e Git serão recusados. Operações de fetch, clonagem e push também são rejeitadas, e uma mensagem de erro indicará que o site está temporariamente indisponível. Em configurações de alta disponibilidade, a replicação do Git será colocada em pausa. Os trabalhos com GitHub Actions não serão executados. O acesso ao site por navegador levará a uma página de manutenção.

Tela inicial do modo de manutenção

Habilitar o modo de manutenção imediatamente ou programar um período de manutenção mais tarde

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Console de Gerenciamento . Guia Console de Gerenciamento na barra lateral esquerda

  3. Na parte superior do Console de Gerenciamento, clique em Manutenção. Guia Manutenção

  4. Em "Enable and schedule" (Habilitar e programar), decida se você quer habilitar o modo de manutenção imediatamente ou programar um período de manutenção depois.

    • Para habilitar o modo de manutenção imediatamente, use o menu suspenso e clique em Agora. Menu suspenso com a opção para habilitar o modo de manutenção agora selecionado
    • Para programar um período de manutenção depois, use o menu suspenso e clique no horário em que você pretende iniciar o período de manutenção. Menu suspenso com a opção para habilitar o modo de manutenção em duas horas selecionado
  5. Selecione Habilitar modo de manutenção. Caixa de seleção usada para habilitar ou agendar o modo de manutenção 1. Na barra lateral esquerda, clique em Salvar configurações.

    Captura de tela do botão Salvar configurações no Console de Gerenciamento

    Observação: se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  6. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

Programar o modo de manutenção com a the GitHub Enterprise Server APIs

Você pode programar o modo de manutenção para horas ou datas diferentes na the GitHub Enterprise Server APIs. Para obter mais informações, confira "Console de Gerenciamento".

Habilitar ou desabilitar o modo de manutenção para todos os nós do cluster

Com o utilitário ghe-cluster-maintenance, você pode definir o modo de manutenção para cada nó em um cluster ou cancelar a definição dele.

$ ghe-cluster-maintenance -h
# Shows options
$ ghe-cluster-maintenance -q
# Queries the current mode
$ ghe-cluster-maintenance -s
# Sets maintenance mode
$ ghe-cluster-maintenance -u
# Unsets maintenance mode