Introducción
Gitea es un servidor git de código abierto autohospedado escrito en Go. Viene con un editor de archivos de repositorio, seguimiento de problemas de proyectos, administración de usuarios, notificaciones, wiki integrado y mucho más.
Gitea es una aplicación ligera y se puede instalar en sistemas menos potentes. Si está buscando una alternativa de Gitlab con un uso de memoria mucho menor, debe probar Gitea.
Este artículo muestra cómo instalar y configurar Gitea en CentOS 8.
Si desea instalar Gitea en un servidor remoto, continúe leyendo; de lo contrario, omita el primer párrafo "Conectando al servidor" y lea el siguiente.
Conexión al servidor
Para acceder al servidor, necesita conocer la dirección IP. También necesitará su nombre de usuario y contraseña para la autenticación. Para conectarse al servidor como root, escriba el siguiente comando:
ssh root@IP_DEL_SERVER
A continuación, deberá ingresar la contraseña del usuario root.
Si no está utilizando el usuario root, puede iniciar sesión con otro nombre de usuario utilizando el mismo comando, luego cambie root a su nombre de usuario:
ssh nome_utente@IP_DEL_SERVER
Luego se le pedirá que ingrese su contraseña de usuario.
El puerto estándar para conectarse a través de ssh es 22, si su servidor usa un puerto diferente, deberá especificarlo usando el parámetro -p, luego escriba el siguiente comando:
ssh nome_utente@IP_DEL_SERVER -p PORTA
Prerrequisitos
Gitea admite SQLite, PostgreSQL y MySQL, MariaDB como backend de base de datos.
Usaremos SQLite. Es una base de datos liviana que almacena datos dentro de un solo archivo. Si SQLite no está instalado en su máquina CentOS, puede instalarlo ejecutando el siguiente comando como usuario sudo:
sudo dnf install sqliteSupongamos que SELinux está deshabilitado o configurado en modo permisivo.
Instalamos otras herramientas que usaremos para completar este tutorial. Wget para descargar archivos del terminal y el editor de texto nano para crear y editar archivos desde el terminal:
sudo dnf install wget nanoInstalar Gitea
Gitea se puede instalar desde código fuente, binario y como paquete. También se puede implementar como una imagen de Docker. Instalaremos Gitea usando thr binary.
Instalar Git
El primer paso es instalar Git en su CentOS:
sudo dnf install gitVerifique la instalación viendo la versión de Git:
git --versiongit version 2.18.4
Crea un usuario de Git
Cree un nuevo usuario del sistema para ejecutar la aplicación Gitea:
sudo useradd \
--system \
--shell /bin/bash \
--comment 'Git Version Control' \
--create-home \
--home /home/git \
gitEl comando creará un nuevo usuario y grupo llamado git y establecerá el directorio de inicio en /home/git.
Descarga el archivo binario de Gitea
El último binario de Gitea se puede descargar desde la página de descarga de Gitea. Asegúrese de descargar el binario correcto para su arquitectura.
En el momento de escribir este tutorial, la última versión es la 1.12.3. Si hay una nueva versión disponible, cambie la VERSION en el siguiente comando.
Utilice wget para descargar el binario Gitea al directorio /tmp
VERSION=1.12.3sudo wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64Puede ejecutar la pista desde cualquier posición. Seguiremos la convención y trasladaremos el binario al /usr/local/bin:
sudo mv /tmp/gitea /usr/local/binHaga que el binario sea ejecutable:
sudo chmod +x /usr/local/bin/giteaLos siguientes comandos crearán los directorios necesarios y establecerán los permisos y la propiedad necesarios:
sudo mkdir -p /var/lib/gitea/{custom,data,indexers,public,log}sudo chown git: /var/lib/gitea/{data,indexers,log}sudo chmod 750 /var/lib/gitea/{data,indexers,log}sudo mkdir /etc/giteasudo chown root:git /etc/giteasudo chmod 770 /etc/giteaLa estructura de directorio anterior es recomendada por la documentación oficial de Gitea.
Los permisos del /etc/gitea se establecen con los permisos 770 para que el asistente de instalación pueda crear los archivos de configuración. Una vez que se complete la instalación, estableceremos permisos más restrictivos.
Cree un archivo de unidad Systemd
Gitea proporciona un archivo de unidad Systemd configurado para que coincida con nuestra configuración.
Descargue el archivo al directorio /etc/systemd/system/ escribiendo:
sudo wget https://raw.githubusercontent.com/go-gitea/gitea/master/contrib/systemd/gitea.service -P /etc/systemd/system/Cuando termine, habilite e inicie el servicio Gitea:
sudo systemctl daemon-reloadsudo systemctl enable --now giteaVerifique que el servicio se inicie correctamente:
sudo systemctl status gitea● gitea.service - Gitea (Git with a cup of tea)
Loaded: loaded (/etc/systemd/system/gitea.service; enabled; vendor preset: disabled)
Active: active (running) since Fri 2020-08-28 18:39:34 CEST; 3s ago
Main PID: 4889 (gitea)
Tasks: 7 (limit: 12210)
Memory: 150.3M
CGroup: /system.slice/gitea.service
└─4889 /usr/local/bin/gitea web --config /etc/gitea/app.ini
Configurar Gitea
Ahora que Gitea está en funcionamiento, es hora de finalizar la instalación a través de la interfaz web.
De forma predeterminada, Gitea escucha las conexiones en el puerto 3000 en todas las interfaces de red. Deberá configurar su firewall para permitir el acceso a la interfaz web de Gitea:
sudo firewall-cmd --permanent --zone=public --add-port=3000/tcpsudo firewall-cmd --reloadAbra el navegador, conectado a la dirección IP de su servidor o al nombre de su dominio: http://TUO_DOMINIO_O_IP:3000/install. Aparecerá la página de configuración inicial.
Configurar e instalar Gitea
Complete los campos obligatorios de la siguiente manera:
Configuración de la base de datos:
- Tipo de base de datos: SQLite3
- Ruta: use una ruta absoluta:
/var/lib/gitea/data/gitea.db
Configuración general de la aplicación:
- Título del sitio: ingrese el nombre de su organización.
- Ruta raíz del repositorio: deje el valor predeterminado:
/home/git/gitea-repositories. - Ruta raíz de Git LFS: deje el valor predeterminado:
/var/lib/gitea/data/lfs. - Ejecutar como nombre de usuario: git
- Dominio del servidor SSH: ingrese el dominio o la dirección IP del servidor.
- Puerto SSH: 22, cámbielo si SSH está escuchando en otro puerto.
- Puerto de escucha HTTP Gitea: 3000
- Gitea base de URL: use http y el dominio de su servidor o dirección IP.
- Ruta de registro: deje el valor predeterminado:
/var/lib/gitea/log
Más tarde, puede cambiar la configuración editando el archivo de configuración de Gitea.
Una vez hecho esto, pulsa el botón "Instalar Gitea". La instalación es instantánea. Al final, será redirigido a la página de inicio de sesión.
Haga clic en el enlace "Registrarse ahora ". El primer usuario registrado se agrega automáticamente al grupo Admin.
Para que la instalación sea más segura, cambie los permisos del archivo de configuración de Gitea a solo lectura usando:
sudo chmod 750 /etc/giteasudo chmod 640 /etc/gitea/app.iniEso es todo. Gitea se instaló en su máquina CentOS.
Configure Nginx como proxy inverso y configure SSL
Este paso es opcional, pero muy recomendable. Para usar Nginx como proxy inverso, debe tener un dominio o subdominio que apunte a la IP pública del servidor. En este tutorial, usaremos example.com.
Primero, instale Nginx y genere un certificado SSL Let's Encrypt gratuito utilizando las siguientes guías:
Cuando termine, abra su editor de texto y edite el archivo de bloqueo del servidor de dominio:
sudo nano /etc/nginx/conf.d/example.com.confserver {
listen 80;
server_name example.com;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
proxy_read_timeout 720s;
proxy_connect_timeout 720s;
proxy_send_timeout 720s;
client_max_body_size 50m;
# Proxy headers
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
# log files
access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;
# Handle /requests
location /{
proxy_redirect off;
proxy_pass http://127.0.0.1:3000;
}
}No olvide reemplazar example.com con su dominio Gitea y establecer la ruta correcta para los archivos del certificado SSL. El tráfico HTTP se redirige a HTTPS.
Cuando termine, reinicie el servicio Nginx para que los cambios surtan efecto:
sudo systemctl restart nginxA continuación, cambie el dominio de Gitea y la URL raíz. Para hacer esto, abra el archivo de configuración y edite las siguientes líneas:
sudo nano /etc/gitea/app.ini[server]
DOMAIN = example.com
ROOT_URL = https://example.com/Reinicie el servicio Gitea escribiendo:
sudo systemctl restart giteaEn este punto, el proxy de Gitea está configurado y puedes acceder a él desde: https://example.com
Configurar notificaciones por correo electrónico
Para enviar correos electrónicos de notificación, puede instalar Postfix o utilizar un servicio de correo transaccional como SendGrid, MailChimp, MailGun o SES.
Para habilitar las notificaciones por correo electrónico, abra el archivo de configuración y edite las siguientes líneas:
sudo nano /etc/gitea/app.ini[mailer]
ENABLED = true
HOST = SMTP_SERVER:SMTP_PORT
FROM = SENDER_EMAIL
USER = SMTP_USER
PASSWD = YOUR_SMTP_PASSWORD
Asegúrese de que está utilizando la información correcta del servidor SMTP.
Siempre que edite el app.ini, debe reiniciar el servicio Gitea para que los cambios surtan efecto:
sudo systemctl restart giteaPara verificar la configuración y enviar un correo electrónico de prueba, inicie sesión en Gitea, haga clic en el avatar de perfil en la parte superior derecha, se abrirá un menú. Haga clic en Administración del sitio> Configuración> Configuración de correo SMTP.
Gitea también te permite conectarte a Slack creando un webhook y enviando notificaciones a tus canales de Slack.
Actualizar Gitea
Actualizar a la última versión de Gitea es una operación simple. Solo necesita descargar y reemplazar el archivo binario.
Detenga el servicio de Gitea:
sudo systemctl stop giteaDescargue el último binario de Gitea y muévalo al /usr/local/bin:
VERSION=<THE_LATEST_GITEA_VERSION>wget -O /tmp/gitea https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64sudo mv /tmp/gitea /usr/local/binHaga que el binario sea ejecutable:
sudo chmod +x /usr/local/bin/giteaReinicie el servicio Gitea:
sudo systemctl restart giteaConclusión
Hemos visto cómo instalar y configurar Gitea en CentOS 8. Le recomendamos que visite la página de documentación de Gitea y aprenda cómo configurar su instalación y crear su primer proyecto.
