Gitea es un servidor Git gratuito, de código abierto, autoalojado y conocido, escrito en el lenguaje de programación Go. Es una plataforma de control de versiones similar a Github. Es robusto, escalable y ofrece muchas funciones, como el seguimiento de incidencias y tiempos, la ramificación de repositorios, el bloqueo y etiquetado de archivos, la fusión y muchas otras. Si buscas un servicio Git autoalojado, probablemente Gitea sea la mejor opción que puedes utilizar.
En este tutorial, te mostraré cómo instalar Gitea en Debian 11.
Requisitos previos
- Un servidor con Debian 11.
- Una contraseña de root configurada en el servidor.
Instalar y configurar la base de datos MariaDB
Gitea utiliza MariaDB/MySQL como base de datos. Por tanto, el servidor de la base de datos debe estar instalado en tu servidor. Si no está instalado, puedes instalarlo ejecutando el siguiente comando:
apt-get install mariadb-server -y
Una vez instalado el MariaDB, tendrás que establecer una contraseña para MariaDB y asegurar la instalación. Puedes hacerlo ejecutando el script mysql_secure_installation:
mysql_secure_installation
Responde a todas las preguntas como se muestra a continuación:
Enter current password for root (enter for none): OK, successfully used password, moving on... Set root password? [Y/n] Y Remove anonymous users? [Y/n] Y Disallow root login remotely? [Y/n] Y Remove test database and access to it? [Y/n] Y Reload privilege tables now? [Y/n] Y
A continuación, conéctate a la interfaz de MariaDB utilizando el siguiente comando:
mysql -u root -p
Una vez conectado, crea una base de datos y un usuario para Gitea con el siguiente comando:
MariaDB [(none)]> CREATE DATABASE gitea;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost' IDENTIFIED BY 'password';
A continuación, vacía los privilegios y sal de MariaDB con el siguiente comando:
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> QUIT;
Instalar Gitea
En primer lugar, tendrás que crear un usuario dedicado para ejecutar Gitea. Puedes crearlo con el siguiente comando:
adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /opt/git git
Deberías ver la siguiente salida:
Adding system user `git' (UID 109) ... Adding new group `git' (GID 115) ... Adding new user `git' (UID 109) with group `git' ... Creating home directory `/opt/git' ...
A continuación, descarga la última versión de Gitea con el siguiente comando:
curl -s https://api.github.com/repos/go-gitea/gitea/releases/latest |grep browser_download_url | cut -d '"' -f 4 | grep '\linux-amd64$' | wget -i -
A continuación, mueve el binario de Gitea a la ruta del sistema con el siguiente comando:
mv gitea-*-linux-amd64 /usr/local/bin/gitea
A continuación, establece el permiso de ejecución para el binario de Gitea:
chmod +x /usr/local/bin/gitea
A continuación, verifica la versión de Gitea con el siguiente comando:
gitea --version
Deberías ver la siguiente salida:
Gitea version 1.15.3 built with GNU Make 4.1, go1.16.8 : bindata, sqlite, sqlite_unlock_notify
A continuación, tendrás que crear una estructura de directorios para Gitea. Puedes crearla con el siguiente comando:
mkdir -p /etc/gitea /var/lib/gitea/{custom,data,indexers,public,log}
A continuación, establece el permiso y la propiedad adecuados con el siguiente comando:
chown git:git /var/lib/gitea/{data,indexers,log}
chmod 750 /var/lib/gitea/{data,indexers,log}
chown root:git /etc/gitea
chmod 770 /etc/gitea
Una vez que hayas terminado, puedes pasar al siguiente paso.
Crear un archivo de servicio Systemd para Gitea
A continuación, tendrás que crear un archivo de servicio systemd para Gitea. Puedes crearlo con el siguiente comando:
nano /etc/systemd/system/gitea.service
Añade las siguientes líneas:
[Unit] Description=Gitea (Git with a cup of tea) After=syslog.target After=network.target After=mysql.service [Service] LimitMEMLOCK=infinity LimitNOFILE=65535 RestartSec=2s Type=simple User=git Group=git WorkingDirectory=/var/lib/gitea/ ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini Restart=always Environment=USER=git HOME=/opt/git GITEA_WORK_DIR=/var/lib/gitea [Install] WantedBy=multi-user.target
Guarda y cierra el archivo y luego recarga el demonio systemd con el siguiente comando:
systemctl daemon-reload
A continuación, inicia y habilita el servicio Gitea con el siguiente comando:
systemctl start gitea
systemctl enable gitea
Para comprobar el servicio Gitea, ejecuta el siguiente comando:
systemctl status gitea
Deberías ver la siguiente salida:
? gitea.service - Gitea (Git with a cup of tea)
Loaded: loaded (/etc/systemd/system/gitea.service; disabled; vendor preset: enabled)
Active: active (running) since Sat 2021-10-02 12:59:27 UTC; 9s ago
Main PID: 19179 (gitea)
Tasks: 8 (limit: 4679)
Memory: 128.3M
CPU: 1.415s
CGroup: /system.slice/gitea.service
??19179 /usr/local/bin/gitea web -c /etc/gitea/app.ini
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 cmd/web.go:102:runWeb() [I] Starting Gitea on PID: 19179
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/setting/setting.go:569:NewContext() [W] Custom config '/etc/gitea/app.ini' not>
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:21:PreloadSettings() [I] AppPath: /usr/local/bin/gitea
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:22:PreloadSettings() [I] AppWorkPath: /var/lib/gitea
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:23:PreloadSettings() [I] Custom path: /var/lib/gitea/custom
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:24:PreloadSettings() [I] Log path: /var/lib/gitea/log
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:25:PreloadSettings() [I] Preparing to run install page
Oct 02 12:59:28 debian11 gitea[19179]: 2021/10/02 12:59:28 ...s/install/setting.go:28:PreloadSettings() [I] SQLite3 Supported
Oct 02 12:59:29 debian11 gitea[19179]: 2021/10/02 12:59:29 cmd/web.go:196:listen() [I] Listen: http://0.0.0.0:3000
Oct 02 12:59:29 debian11 gitea[19179]: 2021/10/02 12:59:29 ...s/graceful/server.go:62:NewServer() [I] Starting new Web server: tcp:0.0.0.0:300>
En este punto, Gitea está iniciado y escucha en el puerto 3000. Puedes comprobarlo con el siguiente comando:
ss -antpl | grep 3000
Deberías ver la siguiente salida:
LISTEN 0 4096 *:3000 *:* users:(("gitea",pid=19179,fd=6))
Una vez que hayas terminado, puedes pasar al siguiente paso.
Configurar Nginx para Gitea
A continuación, tendrás que instalar y configurar Nginx como proxy inverso para Gitea. Primero, instala Nginx con el siguiente comando:
apt-get install nginx -y
A continuación, crea un archivo de configuración del host virtual de Nginx con el siguiente comando:
nano /etc/nginx/conf.d/gitea.conf
Añade las siguientes líneas:
server {
listen 80;
server_name gitea.example.com;
access_log /var/log/nginx/gitea_access.log;
error_log /var/log/nginx/gitea_error.log;
location / {
proxy_pass http://localhost:3000;
}
}
Guarda y cierra el archivo y luego verifica que el Nginx no tenga ningún error de sintaxis:
nginx -t
Deberías ver la siguiente salida:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
A continuación, reinicia el servicio Nginx con el siguiente comando:
systemctl restart nginx
Para comprobar el estado de Nginx, ejecuta el siguiente comando:
systemctl status nginx
Deberías ver la siguiente salida:
? nginx.service - A high performance web server and a reverse proxy server
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2021-10-02 13:00:33 UTC; 4s ago
Docs: man:nginx(8)
Process: 19209 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Process: 19211 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
Main PID: 19212 (nginx)
Tasks: 3 (limit: 4679)
Memory: 3.2M
CPU: 50ms
CGroup: /system.slice/nginx.service
??19212 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
??19213 nginx: worker process
??19214 nginx: worker process
Oct 02 13:00:33 debian11 systemd[1]: Starting A high performance web server and a reverse proxy server...
Oct 02 13:00:33 debian11 systemd[1]: Started A high performance web server and a reverse proxy server.
A continuación, tendrás que editar el archivo Gitea app.ini y definir la información de tu dominio:
nano /etc/gitea/app.ini
Cambia las siguientes líneas:
DOMAIN = gitea.example.com ROOT_URL = http://gitea.example.com/
Guarda y cierra el archivo y reinicia el servicio Gitea para aplicar los cambios:
systemctl restart gitea
Una vez que hayas terminado, puedes pasar al siguiente paso.
Accede a la interfaz web de Gitea
Ahora, abre tu navegador web y accede a la interfaz web de Gitea utilizando la URL http://gitea.example.com. Serás redirigido a la siguiente página:
Proporciona la información de tu base de datos de Gitea, la URL, el nombre de usuario del administrador, la contraseña, el puerto y haz clic en el botón Instalar Gitea. Deberías ver el panel de control de Gitea en la siguiente página:
Conclusión
Enhorabuena! has instalado con éxito Gitea con Nginx como proxy inverso en Debian 11. Puedes implementar Gitea en tu entorno de desarrollo para seguir y gestionar tu proyecto.