Como instalar o Gitlab?

Passo 1: Atualizar o Sistema

Comece por atualizar o sistema para garantir que tem as versões mais recentes dos pacotes:

Passo 2: Instalar as Dependências

Instale as dependências necessárias, como o servidor web Nginx, o servidor de base de dados PostgreSQL e outros pacotes auxiliares:

Passo 3: Instalar o GitLab CE

Utilize um script de instalação fornecido pelo GitLab para configurar e instalar o GitLab CE:

Este script adiciona o repositório GitLab ao seu sistema e instala o GitLab CE.

Passo 4: Configurar o GitLab

Após a instalação, é necessário configurar o GitLab. Execute o comando de configuração:

Este comando configurará o GitLab com as opções padrão.

Passo 5: Aceder ao GitLab

Após a configuração, o GitLab estará disponível no seu servidor Ubuntu. Pode aceder através de um navegador da web, inserindo o endereço IP ou nome de domínio do seu servidor. Por padrão, o GitLab usa a porta 80 para HTTP. Se tiver um nome de domínio configurado, basta inseri-lo no navegador. Caso contrário, use o endereço IP do servidor.

Na primeira vez que aceder, ser-lhe-á solicitado que defina a senha da conta de administrador.

Passo 6: Configurar o GitLab

Após configurar a senha, pode iniciar sessão como administrador e começar a configurar o seu projeto e adicionar membros da equipa conforme necessário.

Lembre-se de que esta é apenas uma instalação básica do GitLab CE. Se precisar de recursos adicionais ou personalizações avançadas, consulte a documentação oficial do GitLab para mais informações.

Certifique-se de que o seu servidor tem recursos adequados (CPU, RAM, espaço em disco) para satisfazer as necessidades da sua equipa e faça cópias de segurança regulares dos dados do GitLab para evitar perda de dados.

Certificados SSL:

máquina gitlab, 
gitlabctl-stop para desligar o servidor web
depois usou-se o certbot

mover para trusted-certs?

COMO GERAR UMA CHAVE SSH?

Para adicionar uma chave SSH ao seu servidor e utilizá-la para autenticação no GitLab (ou qualquer outro serviço de hospedagem Git), você precisa seguir alguns passos. Aqui está um guia passo a passo:

### 1. Criar a Chave SSH

No seu servidor, crie uma nova chave SSH usando o comando `ssh-keygen`. Se você já tem uma chave SSH e prefere usá-la, pode pular esta etapa.

```bash
ssh-keygen -t rsa -b 4096 -C "seu_email@example.com"
```

Quando solicitado, você pode pressionar Enter para usar o caminho padrão ou especificar um caminho diferente para o arquivo da chave. Você também terá a opção de definir uma senha para a chave (recomendado por razões de segurança, mas opcional).

### 2. Localize a Chave SSH

Após criar a chave, você precisa localizá-la. Por padrão, a chave é salva em `~/.ssh/id_rsa.pub` (a menos que você tenha especificado um caminho diferente). Você precisa copiar o conteúdo desta chave. Pode fazer isso com:

```bash
cat ~/.ssh/id_rsa.pub
```

Isso exibirá o conteúdo da chave pública. Copie todo o texto exibido.

### 3. Adicione a Chave SSH ao GitLab

1. Acesse a sua conta no GitLab.
2. Vá para as configurações do seu perfil, geralmente acessíveis clicando na sua imagem de perfil no canto superior direito e selecionando "Settings".
3. No menu lateral, procure por "SSH Keys" ou "Chaves SSH".
4. Cole a chave pública (o texto que você copiou) no campo apropriado.
5. Forneça um título descritivo para a chave, algo que ajude você a identificar para qual máquina ou uso a chave pertence.
6. Salve ou adicione a chave.

### 4. Teste a Conexão SSH

Depois de adicionar a chave ao GitLab, você pode testar a conexão SSH. No terminal do seu servidor, digite:

```bash
ssh -T git@gitlab.com
```

Substitua `gitlab.com` pelo domínio do seu GitLab, se estiver usando um GitLab auto-hospedado. Se tudo estiver configurado corretamente, você receberá uma mensagem de boas-vindas.

### 5. Usar SSH no Git

Se você quer começar a usar SSH para se comunicar com o repositório Git, você precisa mudar a URL do repositório no seu projeto para o formato SSH. Você pode fazer isso com:

```bash
git remote set-url origin git@gitlab.com:username/repo.git
```

Substitua `gitlab.com:username/repo.git` pelo caminho correto do seu repositório no GitLab.

### Notas Adicionais

- **Segurança**: A chave SSH deve ser mantida em segredo. Nunca compartilhe sua chave privada (`id_rsa` sem o `.pub` no final).
- **Uso da Senha da Chave SSH**: Se você definiu uma senha para a sua chave SSH, será solicitado que a insira sempre que usar a chave.
- **Permissões do Arquivo**: Certifique-se de que as permissões do arquivo da chave privada são seguras (geralmente `600`).

Agora você deve ser capaz de usar SSH para interagir com o GitLab de forma segura e eficiente.