Configurar e configurar uma instância GitLab CE no Lightsail - Amazon Lightsail
Etapa 1: ler a documentação da BitnamiEtapa 2: Obtenha a senha padrão do aplicativo para acessar a área administrativa do GitLab CEEtapa 3: anexar um endereço IP estático à instânciaEtapa 4: acessar a área de administração do site do GitLab CEEtapa 5: encaminhar o tráfego do seu nome de domínio registrado para o site da GitLab CEEtapa 6: Configurar HTTPS para seu site GitLab CEEtapa 7: Leia a documentação do GitLab CE e continue configurando seu siteEtapa 8: criar um snapshot da sua instância

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar e configurar uma instância GitLab CE no Lightsail

Aqui estão algumas etapas que você deve seguir para começar depois que sua instância GitLab CE estiver em execução no Amazon Lightsail:

Índice

Etapa 1: ler a documentação da Bitnami

Leia a documentação do Bitnami para saber como configurar seu aplicativo GitLab CE. Para obter mais informações, consulte o GitLab CE Packaged By Bitnami For. Nuvem AWS

Etapa 2: Obtenha a senha padrão do aplicativo para acessar a área administrativa do GitLab CE

Conclua o procedimento a seguir para obter a senha padrão do aplicativo necessária para acessar a área administrativa do seu site GitLab CE. Para obter mais informações, consulte Obter o nome de usuário e a senha do aplicativo para sua instância Bitnami no Amazon Lightsail.

  1. Na sua página de gerenciamento de instâncias, na guia Conectar, escolha Conectar usando SSH.

    Connect usando SSH no console Lightsail

  2. Após se conectar, insira o comando a seguir para obter a senha da aplicação:

    cat $HOME/bitnami_application_password

    Você verá uma resposta semelhante ao seguinte exemplo, que contém a senha padrão do aplicativo:

    Senha de aplicação padrão da Bitnami.

Etapa 3: anexar um endereço IP estático à instância

O endereço IP público atribuído a sua instância ao criá-la pela primeira vez será alterado a cada vez que você interrompe e inicia sua instância. Você deve criar e anexar um endereço IP estático a sua instância para garantir que seu endereço IP público não seja alterado. Posteriormente, ao usar um nome de domínio registradoexample.com, como com sua instância, você não precisa atualizar os DNS registros do seu domínio toda vez que parar e iniciar sua instância. É possível anexar um IP estático a uma instância.

Na página de gerenciamento de instâncias, na guia Redes, escolha Criar um IP estático ou Anexar IP estático (Se você criou um IP estático anteriormente que pode anexar a sua instância), e siga as instruções na página. Para obter mais informações, consulte Create a static IP and attach it to an instance.

Anexe um endereço IP estático no console do Lightsail

Depois que o novo endereço IP estático estiver anexado à sua instância, realize as etapas a seguir para tornar o aplicativo ciente do novo endereço IP estático.

  1. Anote o endereço IP estático da sua instância. Está listado na seção de cabeçalho da página de gerenciamento de instância.

    Endereço IP público ou estático de uma instância do Lightsail

  2. Na página de gerenciamento de instâncias, na guia Conectar, escolha Conectar usando SSH.

    Para se conectar à instância usando SSH

  3. Após se conectar, insira o comando a seguir. Substituir <StaticIP> com o novo endereço IP estático da sua instância.

    sudo /opt/bitnami/configure_app_domain --domain <StaticIP>

    Exemplo:

    sudo /opt/bitnami/configure_app_domain --domain 203.0.113.0

    Você verá um resultado semelhante ao seguinte exemplo. Agora o aplicativo em sua instância deve estar ciente do novo endereço IP estático.

    Resultado da ferramenta de configuração do domínio

Etapa 4: acessar a área de administração do site do GitLab CE

Agora que você tem a senha de usuário padrão, navegue até a página inicial do seu site GitLab CE e faça login na área administrativa. Após fazer login, você poderá começar a personalizar seu site e fazer alterações administrativas. Para obter mais informações sobre o que você pode fazer no GitLab CE, consulte a seção Etapa 7: Leia a documentação do GitLab CE e continue configurando seu site posteriormente neste guia.

  1. Na página de gerenciamento da sua instância, na guia Connect (Conectar), anote o endereço IP público da instância. O endereço IP público também é exibido na seção de cabeçalho da página de gerenciamento da instância.

    O endereço IP público de uma instância

  2. Acesse o endereço IP público da instância, por exemplo, acessando http://203.0.113.0.

    A página inicial do seu site do GitLab CE deverá ser exibida. Você pode ver um aviso do navegador avisando que sua conexão não é privada, não é segura ou que há um risco de segurança. Isso acontece porque sua instância GitLab CE ainda não tem um TLS certificadoSSL/aplicado a ela. Na janela do navegador, escolha Avançado, Detalhes ou Mais informações para visualizar as opções disponíveis. Opte por prosseguir para o site mesmo que ele não seja privado ou seguro.

  3. Acesse usando o nome de usuário padrão (root) e a senha padrão recuperada anteriormente neste guia.

    O painel de administração do GitLab CE será exibido.

    O painel de administração do GitLab CE

Etapa 5: encaminhar o tráfego do seu nome de domínio registrado para o site da GitLab CE

Para direcionar o tráfego do seu nome de domínio registradoexample.com, como, para o site da GitLab CE, você adiciona um registro ao sistema de nomes de domínio (DNS) do seu domínio. DNSos registros geralmente são gerenciados e hospedados no registrador em que você registrou seu domínio. No entanto, recomendamos que você transfira o gerenciamento dos DNS registros do seu domínio para o Lightsail para poder administrá-lo usando o console do Lightsail.

Na página inicial do console Lightsail, na guia Rede, escolha DNS Criar zona e siga as instruções na página. Para obter mais informações, consulte Criar uma DNS zona para gerenciar os DNS registros do seu domínio.

Crie uma DNS zona no console do Lightsail

Depois que seu nome de domínio estiver roteando o tráfego para sua instância, você deverá concluir o procedimento a seguir para informar o GitLab CE sobre o nome de domínio.

  1. Na página de gerenciamento de instâncias, na guia Conectar, escolha Conectar usando SSH.

    Para se conectar à instância usando SSH

  2. Após se conectar, insira o comando a seguir. Substituir <DomainName> com o nome de domínio que está roteando o tráfego para sua instância.

    sudo /opt/bitnami/configure_app_domain --domain <DomainName>

    Exemplo:

    sudo /opt/bitnami/configure_app_domain --domain example.com

    Você verá um resultado semelhante ao seguinte exemplo. Sua instância GitLab CE agora deve estar ciente do nome do domínio.

    Resultado da ferramenta de configuração do domínio

    Se esse comando falhar, você pode estar usando uma versão mais antiga da instância GitLab CE. Como alternativa, tente executar o comando a seguir. Substituir <DomainName> com o nome de domínio que está roteando o tráfego para sua instância.

    cd /opt/bitnami/apps/gitlab
sudo ./bnconfig --machine_hostname <DomainName>

    Após executar esses comandos, insira o comando a seguir para evitar que a ferramenta bnconfig seja executada automaticamente sempre que o servidor for reiniciado.

    sudo mv bnconfig bnconfig.disabled

Em seguida, você deve gerar e configurar um TLS certificadoSSL/para habilitar HTTPS conexões para seu site GitLab CE. Para obter mais informações, vá para a próxima seção Etapa 6: Configurar HTTPS para seu site GitLab CE deste guia.

Etapa 6: Configurar HTTPS para seu site GitLab CE

Conclua o procedimento a seguir para configurar HTTPS em seu site da GitLab CE. Essas etapas mostram como usar o cliente Lego, que é uma ferramenta de linha de comando para solicitar certificados Let's EncryptSSL//TLS.

Importante

Antes de começar com esse procedimento, verifique se você configurou seu domínio para rotear o tráfego para sua instância GitLab CE. Caso contrário, o processo de validação do TLS certificadoSSL/falhará. Para direcionar o tráfego para seu nome de domínio registrado, você adiciona um registro ao DNS do seu domínio. DNSos registros geralmente são gerenciados e hospedados no registrador em que você registrou seu domínio. No entanto, recomendamos que você transfira o gerenciamento dos DNS registros do seu domínio para o Lightsail para poder administrá-lo usando o console do Lightsail.

Na página inicial do console Lightsail, na guia Domínios DNS e, escolha DNS Criar zona e siga as instruções na página. Para obter mais informações, consulte Criação de uma DNS zona para gerenciar os DNS registros do seu domínio no Lightsail.

  1. Na sua página de gerenciamento de instâncias, na guia Conectar, escolha Conectar usando SSH.

    Connect usando SSH no console Lightsail

  2. Após estabelecer conexão, insira o comando a seguir para alterar o diretório para o diretório temporário (/tmp).

    cd /tmp

  3. Digite o seguinte comando para baixar a versão mais recente do cliente Lego. Esse comando baixa um arquivo tar.

    curl -Ls https://api.github.com/repos/xenolf/lego/releases/latest | grep browser_download_url | grep linux_amd64 | cut -d '"' -f 4 | wget -i -

  4. Digite o seguinte comando para extrair os arquivos do arquivo tar. Substituir X.Y.Z com a versão do cliente Lego que você baixou.

    tar xf lego_vX.Y.Z_linux_amd64.tar.gz

    Exemplo:

    tar xf lego_v4.7.0_linux_amd64.tar.gz

  5. Digite o comando a seguir para criar o diretório /opt/bitnami/letsencrypt para o qual você moverá os arquivos do cliente Lego.

    sudo mkdir -p /opt/bitnami/letsencrypt

  6. Digite o comando a seguir para mover os arquivos do cliente Lego para o diretório que você criou.

    sudo mv lego /opt/bitnami/letsencrypt/lego

  7. Insira cada um dos comandos a seguir para interromper os serviços de aplicativos que estão sendo executados na instância.

    sudo service bitnami stop
sudo service gitlab-runsvdir stop

  8. Digite o comando a seguir para usar o cliente Lego para solicitar um TLS certificado Let's EncryptSSL//.

    sudo /opt/bitnami/letsencrypt/lego --tls --email="EmailAddress" --domains="RootDomain" --domains="WwwSubDomain" --path="/opt/bitnami/letsencrypt" run

    No comando, substitua o seguinte exemplo de valores pelos seus próprios valores:

    • EmailAddress: seu endereço de e-mail para notificações de registro.

    • RootDomain— O domínio raiz principal que está roteando o tráfego para seu site GitLab CE (por exemplo,example.com).

    • WwwSubDomain— O www subdomínio do domínio raiz primário que está roteando o tráfego para seu site GitLab CE (por exemplo,www.example.com).

      Você pode atribuir vários domínios para seu certificado especificando parâmetros --domains adicionais em seu comando. Quando você especifica vários domínios, a Lego cria um certificado de nomes alternativos de assunto (SAN) que resulta em apenas um certificado válido para todos os domínios que você especificou. O primeiro domínio em sua lista é adicionado como o “CommonName” do certificado e o restante é adicionado como “DNSNames” à SAN extensão dentro do certificado.

    Exemplo:

    sudo /opt/bitnami/letsencrypt/lego --tls --email="user@example.com" --domains="example.com" --domains="www.example.com" --path="/opt/bitnami/letsencrypt" run

  9. Pressione Y e Enter para aceitar os termos de serviço quando solicitado.

    Você verá um resultado semelhante ao seguinte exemplo.

    Resposta bem-sucedida do cliente Lego à solicitação de certificado

    Uma operação bem-sucedida resultará no salvamento de um conjunto de certificados no diretório /opt/bitnami/letsencrypt/certificates. Esse conjunto inclui o arquivo de certificado do servidor (por exemplo, example.com.crt) e o arquivo de chave de certificado do servidor (exemplo, example.com.key).

  10. Insira cada um dos comandos a seguir para renomear os certificados existentes na instância. Posteriormente, você substituirá esses certificados existentes por seus novos certificados Let's Encrypt.

    sudo mv /etc/gitlab/ssl/server.crt /etc/gitlab/ssl/server.crt.old
sudo mv /etc/gitlab/ssl/server.key /etc/gitlab/ssl/server.key.old
sudo mv /etc/gitlab/ssl/server.csr /etc/gitlab/ssl/server.csr.old

  11. Insira os comandos a seguir, um por um, para criar links simbólicos para seus novos certificados do Let's Encript no /etc/gitlab/ssl diretório, que é o diretório de certificados padrão na sua instância GitLab CE.

    sudo ln -sf /opt/bitnami/letsencrypt/certificates/Domain.key /etc/gitlab/ssl/server.key
sudo ln -sf /opt/bitnami/letsencrypt/certificates/Domain.crt /etc/gitlab/ssl/server.crt

    No comando, substitua Domain com o domínio raiz principal que você especificou ao solicitar seus certificados Let's Encrypt.

    Exemplo:

    sudo ln -sf /opt/bitnami/letsencrypt/certificates/example.com.key /etc/gitlab/ssl/server.key
sudo ln -sf /opt/bitnami/letsencrypt/certificates/example.com.crt /etc/gitlab/ssl/server.crt

  12. Insira cada um dos comandos a seguir para alterar as permissões dos novos certificados Let's Encrypt no diretório para o qual você os moveu.

    sudo chown root:root /etc/gitlab/ssl/server*
sudo chmod 600 /etc/gitlab/ssl/server*

  13. Digite o comando a seguir para reiniciar os serviços de aplicativos em sua instância GitLab CE.

    sudo service bitnami start

Da próxima vez que você navegar até o site do GitLab CE usando o domínio que você configurou, você verá que ele redireciona para a HTTPS conexão. Observe que pode levar até uma hora para que a instância GitLab CE reconheça os novos certificados. Se o site da GitLab CE recusar sua conexão, pare e inicie a instância e tente novamente.

Etapa 7: Leia a documentação do GitLab CE e continue configurando seu site

Leia a documentação da GitLab CE para saber como administrar e personalizar seu site. Para obter mais informações, consulte a GitLab documentação.

Etapa 8: criar um snapshot da sua instância

Depois de configurar o site do GitLab CE da maneira que quiser, crie instantâneos periódicos da sua instância para fazer backup. Você pode criar instantâneos manualmente ou ativar instantâneos automáticos para que o Lightsail crie instantâneos diários para você. Se algo de errado acontecer com sua instância, crie uma nova instância de substituição usando o snapshot. Para obter mais informações, consulte Snapshots.

Na página de gerenciamento de instâncias, na guia Snapshot, escolha Criar um snapshot ou escolha habilitar snapshots automáticos.

Crie um instantâneo da instância no console do Lightsail

Para obter mais informações, consulte Criação de um snapshot de sua instância Linux ou Unix no Amazon Lightsail ou Ativação ou desativação de snapshots automáticos para instâncias ou discos no Amazon Lightsail.