Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Habilitar e programar o modo de manutenção

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

Sobre o modo de manutenção

Alguns tipos de operações requerem que a your GitHub Enterprise Server instance esteja 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á pausada. 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

Você pode executar a validação inicial da sua operação de manutenção configurando uma lista de exceção de IP para permitir acesso a your GitHub Enterprise Server instance apenas dos endereços IP e das faixas fornecidas. As tentativas de acessar your GitHub Enterprise Server instance de endereços IP não especificados na lista de exceções IP receverão uma resposta consistente com aquelas enviadas quando a instância estiver em modo de manutenção.

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

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  4. Na parte superior do Console de gerenciamento, clique em Maintenance (Manutenção). Guia de manutenção

  5. 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 Now (Agora). Menu suspenso com a opção para habilitar o modo de manutenção agora
    • 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
  6. Selecione Enable maintenance mode (Habilitar modo de manutenção). Caixa de seleção para habilitar ou programar o modo de manutenção

  7. Na barra lateral esquerda, clique Save settings (Salvar configurações).

    Screenshot of the save settings button in the Console de gerenciamento

    Note: Saving settings in the Console de gerenciamento restarts system services, which could result in user-visible downtime.

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

    Configurar a instância

Validando alterações no modo de manutenção usando a lista de exceção de IP

A lista de exceções de IP fornece acesso controlado e restrito a your GitHub Enterprise Server instance, o que é ideal para validação inicial de saúde do servidor após uma operação de manutenção. Uma vez habilitado, your GitHub Enterprise Server instance será retirado do modo de manutenção e disponibilizado apenas para os endereços IP configurados. A caixa de seleção do modo de manutenção será atualizada para refletir a alteração no estado.

Se você reabilitar o modo de manutenção, a lista de exceções de IP será desabilitada e your GitHub Enterprise Server instance retornará ao modo de manutenção. Se você desabilitar a lista de exceção de IP, your GitHub Enterprise Server instance retornará para a operação normal.

Você também pode usar um utilitário de linha de comando para configurar a lista de exceção de IP. Para obter mais informações, consulte "Utilitários de linha de comando" e "Acessando o shell administrativo (SSH)".

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  4. Na parte superior do Console de gerenciamento, clique em Manutenção e confirme que o modo de manutenção já está habilitado. Guia de manutenção

  5. Selecione Habilitar lista de exceção de IP. Caixa de seleção para habilitar lista de exceções de IP

  6. Na caixa de texto, digite uma lista válida de endereços IP separados por espaço ou blocos CIDR que devem ter permissão para acessar your GitHub Enterprise Server instance. campo concluído para endereços IP

  7. Clique em Salvar. após a lista de excetpion IP ter salvo

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

Você pode programar o modo de manutenção para horas ou datas diferentes na As APIs do GitHub Enterprise Server. Para obter mais informações, consulte "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 ou cancelar as definições do modo de manutenção para cada nó de um cluster.

$ ghe-cluster-maintenance -h
# Mostra opções
$ ghe-cluster-maintenance -q
# Consultas no modo atual
$ ghe-cluster-maintenance -s
# Define o modo de manutenção
$ ghe-cluster-maintenance -u
# Cancela a definição do modo de manutenção