O Gitea é uma plataforma de hospedagem de repositórios Git simples e open-source. Ele é leve e ideal para aqueles que desejam configurar rapidamente um servidor Git para projetos pessoais ou pequenos times. Neste tutorial, você aprenderá a instalar o Gitea usando Docker no Ubuntu 22.04.
Requisitos
- Servidor rodando Ubuntu 22.04
- Usuário com privilégios sudo
- Docker e Docker Compose instalados
Passo 1: Atualizar o Sistema
Antes de começar a instalação, é importante garantir que o sistema esteja atualizado. Execute o seguinte comando para atualizar todos os pacotes:
sudo apt update && sudo apt upgrade -y
Passo 2: Instalar o Docker
Se o Docker não estiver instalado, você pode instalá-lo com os seguintes comandos:
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y
Verifique se o Docker foi instalado corretamente:
sudo docker --version
Passo 3: Instalar o Docker Compose
Agora, instale o Docker Compose, que será necessário para gerenciar o Gitea:
sudo apt install docker-compose -y
Passo 4: Configurar o Gitea com Docker
Agora, vamos configurar o Gitea usando Docker. Primeiro, crie um diretório para armazenar os arquivos do Gitea:
mkdir ~/gitea
cd ~/gitea
Em seguida, crie um arquivo docker-compose.yml no diretório:
nano docker-compose.yml
Adicione o seguinte conteúdo ao arquivo:
version: '3'
services:
server:
image: gitea/gitea:latest
container_name: gitea
environment:
- USER_UID=1000
- USER_GID=1000
- DB_TYPE=sqlite3
restart: always
ports:
- "3000:3000"
- "22:22"
volumes:
- ./gitea:/data
networks:
- gitea-net
networks:
gitea-net:
Esse arquivo define o serviço Docker para o Gitea, mapeando as portas 3000 (para a interface web) e 22 (para o SSH), além de usar o SQLite como banco de dados. As configurações de rede e volumes também são especificadas.
Passo 5: Iniciar o Gitea com Docker
Agora, execute o Docker Compose para iniciar o Gitea:
sudo docker-compose up -d
O Gitea será iniciado em segundo plano. Para verificar se o contêiner está rodando corretamente, use o seguinte comando:
sudo docker ps
Passo 6: Acessar a Interface Web do Gitea
Com o Gitea em execução, você pode acessar a interface web do Gitea através do navegador. Abra o navegador e vá para o endereço http://seu-dominio-ou-ip:3000.
Na primeira vez que acessar, será exibido o assistente de configuração do Gitea. Siga os passos para configurar o banco de dados (use o SQLite, já configurado), nome do repositório e outras opções.
Passo 7: Configurar SSL com Let’s Encrypt (Opcional)
Se você quiser adicionar SSL ao seu Gitea, pode usar o Let’s Encrypt para garantir uma conexão segura. Primeiro, instale o Certbot:
sudo apt install certbot python3-certbot-nginx -y
Em seguida, configure o Certbot para obter e configurar automaticamente o certificado SSL para o seu domínio:
sudo certbot --nginx -d seu-dominio.com
Isso protegerá o acesso ao Gitea com SSL.
Servidor VPS
Se precisar de um servidor VPS confiável para hospedar o Gitea e seus repositórios de forma segura, veja as opções disponíveis aqui.