Configurar uma instância de testes

Sobre instâncias de preparo

O GitHub recomenda que você configure um ambiente separado para testar backups, atualizações ou alterações na configuração do sua instância do GitHub Enterprise Server. Esse ambiente, que você deve isolar de seus sistemas de produção, é chamado de ambiente de preparo.

Por exemplo, para proteger contra perda de dados, você pode validar regularmente o backup da sua instância de produção. Você pode restaurar regularmente o backup de seus dados de produção em uma instância separada do GitHub Enterprise Server em um ambiente de testes. Nessa instância de staging, também é possível testar o upgrade para a versão de recurso mais recente do GitHub Enterprise Server.

Dica

Você pode reutilizar seu arquivo de licença GitHub Enterprise existente, desde que a instância de teste não seja usada em um ambiente de produção.

Considerações sobre um ambiente de teste

Para testar completamente o GitHub Enterprise Server e recriar um ambiente o mais semelhante possível ao ambiente de produção, considere os sistemas externos que interagem com a instância. Por exemplo, você pode querer testar o seguinte em seu ambiente de teste.

Autenticação, principalmente se você usa um provedor de autenticação externo, como o SAML
Integração com um sistema externo de geração de tíquetes;
Integração com um servidor de integração contínua;
Scripts ou software externos que utilizam a GitHub Enterprise Server APIs
Servidor externo SMTP para notificações de e-mail.

Você pode instalar uma instância de preparo do zero e configurá-la como quiser. Para saber mais, confira Configurando uma instância do GitHub Enterprise Server e Configurando GitHub Enterprise.

Como alternativa, você pode criar uma instância de teste que reflita a configuração de produção ao restaurar um backup da instância de produção para a instância de teste.

       [Faça backup da instância de produção](#1-back-up-your-production-instance).

       [Configure uma instância de teste](#2-set-up-a-staging-instance).

       [Configure o GitHub Actions](#3-configure-github-actions).

       [Configure GitHub Packages](#4-configure-github-packages).

       [Restaure o backup de produção](#5-restore-your-production-backup).

       [Examine a configuração da instância](#6-review-the-instances-configuration).

       [Aplique a configuração da instância](#7-apply-the-instances-configuration).

1. Fazer backup da instância de produção

Se você quiser testar alterações em uma instância que contenha os mesmos dados e configuração que a instância de produção, faça backup dos dados e da configuração da instância de produção usando GitHub Enterprise Server Backup Utilities. Para saber mais, confira Como configurar backups em sua instância usando Utilitários de Backup.

Aviso

Se você usa o GitHub Actions ou o GitHub Packages em produção, o backup incluirá a configuração de produção do armazenamento externo. Para evitar uma possível perda de dados gravando no armazenamento de produção da instância de preparo, configure cada recurso nas etapas 3 e 4 antes de restaurar o backup.

2. Configurar uma instância de preparo

Configure uma nova instância para funcionar como ambiente de preparo. Ao seguir o processo de instalação, selecione a opção Nova Instalação. Isso garantirá que o ambiente de preparo seja inicializado corretamente e esteja pronto para restaurar um backup, se necessário.

Você pode usar os mesmos guias para provisionar e instalar sua instância de preparo, assim como fez na instância de produção. Para saber mais, confira Configurando uma instância do GitHub Enterprise Server.

Se você planeja restaurar um backup da instância de produção, prossiga para a próxima etapa. Como alternativa, você pode configurar a instância manualmente e ignorar as etapas a seguir.

Aviso

Restaurar backups com o GitHub Actions não terá êxito em uma instância não configurada. Para habilitar o GitHub Actions, uma instância com um nome de host configurado é necessária. Para saber mais, confira Configurando o nome do host para sua instância.

3. Configurar o GitHub Actions

Opcionalmente, se você usa o GitHub Actions na instância de produção, configure o recurso na instância de preparo antes de restaurar o backup de produção. Se você não usa o GitHub Actions, pule para Configurar o GitHub Packages.

Para configurar o GitHub Actions em sua instância de preparo, use o Console de Gerenciamento.

O Console de Gerenciamento fornece uma interface segura baseada em navegador para configuração de baixo nível de sua instância do GitHub Enterprise Server, incluindo GitHub Actions. Todas as alterações de configuração são auditadas e o acesso é protegido por meio de credenciais dedicadas e controles de rede.

Aviso

Se você não configurar o GitHub Actions na Instância de staging antes de restaurar o backup de produção, a Instância de staging usará o armazenamento externo da instância de produção, o que poderá resultar na perda de dados. É altamente recomendável que você use um armazenamento externo diferente para a instância de preparo. Para saber mais, confira Usar um ambiente de teste.

Acesse o Console de Gerenciamento Confira Acessando o Console de Gerenciamento.
Na barra lateral, abra a guia Ações.
Habilitar GitHub Actions marcando Habilitar GitHub Actions.
Selecione seu provedor de armazenamento externo para artefatos e armazenamento de logs.
Insira os detalhes de armazenamento e autenticação necessários para o provedor escolhido.
Teste a configuração clicando em Testar configurações de armazenamento e, em seguida, clique em Salvar configurações.

Depois de configurar e habilitar o GitHub Actions, prossiga para a próxima etapa.

4. Configurar o GitHub Packages

Opcionalmente, se você usa o GitHub Packages na instância de produção, configure o recurso na instância de preparo antes de restaurar o backup de produção. Se você não usa o GitHub Packages, pule para Restaurar o backup de produção.

Aviso

Se você não configurar o GitHub Packages na Instância de staging antes de restaurar o backup de produção, a Instância de staging usará o armazenamento externo da instância de produção, o que poderá resultar na perda de dados. É altamente recomendável que você use um armazenamento externo diferente para a instância de preparo. Para saber mais, confira Usar um ambiente de teste.

Para configurar o GitHub Packages para sua instância de teste:

Acesse o Console de Gerenciamento Consulte Acessar o Console de Gerenciamento.
Na barra lateral, abra a guia Pacotes.
Ative o GitHub Pacotes marcando a caixa Habilitar GitHub Pacotes.
Em Configurações de Armazenamento de Pacotes, selecione seu provedor de armazenamento externo.
Teste sua configuração de armazenamento clicando em Testar configurações de armazenamento.
Clique em Salvar configurações para aplicar a configuração.

Observação

Você pode usar interruptores do ecossistema para habilitar, desabilitar ou definir tipos de pacotes individuais como somente leitura para sua instância, conforme necessário.

5. Restaurar o backup de produção

Use o comando ghe-restore para restaurar o restante dos dados do backup. Para saber mais, confira Como configurar backups em sua instância usando Utilitários de Backup.

Se a instância de preparo já estiver configurada e você quiser substituir as configurações, o certificado e os dados de licença, adicione a opção -c ao comando. Para obter mais informações sobre a opção, confira Como usar os comandos de backup e restauração na documentação do GitHub Enterprise Server Backup Utilities.

6. Examinar a configuração da instância

Para acessar a instância de preparo usando o mesmo nome de host, atualize o arquivo de hosts local para resolver o nome do host da instância de preparo por endereço IP editando o arquivo /etc/hosts no macOS ou Linux ou o arquivo C:\Windows\system32\drivers\etc no Windows.

Observação

A instância de staging precisa estar acessível por meio do mesmo hostname da instância de produção. Não há suporte para a alteração do nome do host de sua instância do GitHub Enterprise Server. Para saber mais, confira Configurando o nome do host para sua instância.

Depois, examine a configuração da instância de teste no Console de Gerenciamento. Para saber mais, confira Administrar sua instância por meio da interface do usuário da Web.

Aviso

Se você configurou o GitHub Actions ou o GitHub Packages na instância de staging, para evitar a substituição de dados de produção, garanta que a configuração de armazenamento externo no Console de Gerenciamento não corresponda à instância de produção.

7. Aplicar a configuração da instância

Para aplicar a configuração do Console de Gerenciamento, clique em Salvar configurações.

Colocar uma instância de teste online novamente

Talvez você queira desligar uma instância de preparo para reduzir os custos e ligá-la novamente quando necessário.

Uma instância pode ficar offline por 60 dias.

Se você colocar a instância online novamente dentro do período de tempo offline permitido, o GitHub Enterprise Server será instanciado com sucesso. Se a instância permanecer offline por mais tempo do que o período permitido, o GitHub Enterprise Server falha em instanciar com sucesso, e uma mensagem de erro com o texto server has been offline for more than the configured server_rejoin_age_max pode aparecer nos logs do sistema. Confira Sobre os logs do sistema.

Se a instância estiver presa no estado de erro, você poderá executar esses comandos para recuperá-la.

sudo mv /data/user/consul/server_metadata.json /data/user/consul/server_metadata.json.bak
ghe-config-apply

Leitura adicional

        [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases)

Configurar uma instância de testes

Neste artigo