Gitea es una plataforma ligera y de código abierto para el alojamiento de repositorios Git. Al utilizar Docker, podemos simplificar el proceso de instalación y gestión de Gitea. En este artículo, te mostraremos cómo instalar Gitea con Docker en Debian 12 paso a paso. Este tutorial está diseñado para ser técnico pero accesible para los recién llegados.

Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

  • Un servidor con Debian 12 instalado.
  • Acceso a una cuenta con privilegios de superusuario (root) o acceso a sudo.

Paso 1: Actualizar el Sistema

Es importante asegurarse de que tu sistema esté actualizado. Abre una terminal y ejecuta los siguientes comandos:

sudo apt update
sudo apt upgrade -y

Paso 2: Instalar Docker y Docker Compose

Docker y Docker Compose son herramientas esenciales para la creación y gestión de contenedores. Instálalas con los siguientes comandos:

Instalar Docker

sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/debian/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/debian $(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

Verifica que Docker esté instalado correctamente ejecutando:

sudo systemctl status docker

Instalar Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/v2.5.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Paso 3: Configurar Gitea con Docker Compose

Crear el Directorio de Gitea

Crea un directorio para Gitea y navega a él:

sudo mkdir -p /srv/gitea
cd /srv/gitea

Crear el Archivo Docker Compose

Crea un archivo docker-compose.yml con la siguiente configuración:

version: '3'

services:
  server:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    volumes:
      - gitea:/data
    ports:
      - "3000:3000"
      - "222:22"
    networks:
      - gitea-net

volumes:
  gitea:
    driver: local

networks:
  gitea-net:
    driver: bridge

Este archivo define el contenedor de Gitea, sus variables de entorno, volúmenes y puertos.

Paso 4: Iniciar Gitea

Inicia Gitea con Docker Compose:

sudo docker-compose up -d

Verifica que el contenedor de Gitea esté en funcionamiento:

sudo docker-compose ps

Deberías ver una salida indicando que el contenedor de Gitea está up.

Paso 5: Acceder a Gitea

Abre tu navegador web y navega a http://tu_dominio_o_IP:3000. Serás recibido por la pantalla de configuración inicial de Gitea.

Configurar Gitea

  1. Base URL: Configura la URL base para tu instalación de Gitea, por ejemplo, http://tu_dominio_o_IP:3000.
  2. Database Settings: Selecciona SQLite como base de datos para simplificar la configuración inicial. Puedes cambiar a MySQL o PostgreSQL más adelante si es necesario.
  3. Administrator Account: Crea una cuenta de administrador para gestionar tu instancia de Gitea.

Haz clic en “Instalar Gitea” para completar la configuración.

Para mejorar el rendimiento y la gestión de tu instalación de Gitea, considera utilizar los servicios de Shape.host. Ofrecen soluciones de Linux SSD VPS que proporcionan escalabilidad, alta disponibilidad y un rendimiento superior para tus aplicaciones DevOps. Con Shape.host, puedes asegurarte de que tu infraestructura esté siempre disponible y funcionando de manera óptima.