Habilitar e programar o modo de manutenção

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.

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.

Você pode executar a validação inicial de sua operação de manutenção configurando uma lista de exceções de IP para permitir o acesso ao your GitHub Enterprise Server instance somente dos endereços IP e intervalos fornecidos. As tentativas de acessar o your GitHub Enterprise Server instance de endereços IP não especificados na lista de exceções de IP receberão uma resposta consistente com as enviadas quando a instância estiver no 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 .

   

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

   1. Na barra lateral à esquerda, clique em Management Console .

3. Na parte superior do Management Console, clique em 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.
   • 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.

5. Selecione Habilitar modo de manutenção. 1. Na barra lateral esquerda, clique em Salvar configurações.

   

   Observação: se você salvar as configurações no Management Console, 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.

   

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

A lista de exceções de IP fornece acesso controlado e restrito ao your GitHub Enterprise Server instance, ideal para validação inicial da integridade do servidor após uma operação de manutenção. Depois de habilitada, a your GitHub Enterprise Server instance será retirada do modo de manutenção e ficará disponível somente 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 a your GitHub Enterprise Server instance retornará ao modo de manutenção. Se você simplesmente desabilitar a lista de exceções de IP, a your GitHub Enterprise Server instance retornará à operação normal.

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

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

   

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

   1. Na barra lateral à esquerda, clique em Management Console .

3. Na parte superior do Management Console, clique em Manutenção e confirme se o modo de manutenção já está habilitado.

4. Selecione Habilitar lista de exceções de IP.

5. 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 a your GitHub Enterprise Server instance.

6. Clique em Salvar.

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

Você pode programar o modo de manutenção para horas ou datas diferentes na 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