====== Gitea ======

Un servicio de [[informatica:software:git|Git]] autoalojado. Similar a GitHub, Bitbucket y GitLab. Es un proyecto derivado de [[https://gogs.io/|Gogs]]

  * [[https://gitea.io/en-us/|Web oficial]]

{{ https://upload.wikimedia.org/wikipedia/commons/5/58/Gitea_screenshot.png |}}
===== Instalación =====

==== Docker ====

Como base de datos, se puede usar SQLite, MySQL/MariaDB, SQLServer o PostgreSQL.

''docker-compose.yml'':

<code yaml>
version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:1.20.5
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - gitea
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "222:22"
</code>

Para la versión con MariaDB/MySQL:

<code yaml>
version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: gitea/gitea:1.20.5
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - DB_TYPE=mysql
      - DB_HOST=servidor_base_datos[:puerto]
      - DB_NAME=gitea
      - DB_USER=gitea
      - DB_PASSWD=contraseña
    restart: always
    networks:
      - gitea
    volumes:
      - ./data:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "222:22"
</code>

<WRAP center round info 60%>
Las variables de entorno se las pasamos al instalador para que las coja automáticamente y no tengamos que cubrirlas nosotros.
</WRAP>


Tras crear el contenedor, accedemos vía web y nos registramos para poder empezar a usarlo: http://ip.del.contenedor:3000/install

===== Configuración =====

Los cambios se realizan en el fichero ''app.ini''. Si estamos usando el ''docker-compose.yml'' de más arriba, estará en ''./data/gitea/conf/app.ini''.

Tras cualquier cambio, para que se aplique, hay que reiniciar Gitea.

  * [[https://docs.gitea.io/en-us/config-cheat-sheet/|Configuration Cheat Sheet]]

==== E-mail ====

Si usamos SMTP:

<code ini>
[mailer]
ENABLED = true
HOST    = smtp.sendgrid.net:587
FROM    = usuario@ejemplo.com
USER    = apikey
PASSWD  = SG.D5fntD7ySoaqpwef123ñlkj123afsdf_.2asdflkjhASD31231K
</code>

===== Actualización =====

Si hemos instalado Gitea mediante [[informatica:sistemas_operativos:virtualizacion:docker:docker_compose|Docker Compose]], cada vez que queramos actualizarlo, primero editaremos el fichero ''docker-compose.yml'' para ajustarlo a la versión de la imagen que queremos subir. Tras guardar, obtendremos la nueva imagen:

<code>
docker compose pull
</code>

Arrancamos el nuevo contenedor que automáticamente eliminará el antiguo:

<code>
docker compose up -d
</code>

===== Configuración =====

==== Deshabilitar registros =====

Por defecto cualquiera puede registrarse en una instancia de Gitea. Si queremos cambiar este comportamiento, vamos al fichero ''app.ini'' y:

<code ini>
[service]
DISABLE_REGISTRATION = true
</code>

Para aplicar los cambios debe reiniciarse Gitea.

A partir de ese momento, solo el administrador podrá crear cuentas de usuario.

==== E-mail ====

SMTP fichero ''app.ini'':

<code ini>
[mailer]
ENABLED        = true
FROM           = gitea@midominio.com
PROTOCOL       = smtp+starttls
SMTP_ADDR      = smtp.midominio.com
SMTP_PORT      = 587
USER           = usuario
PASSWD         = contraseña
</code>

Para aplicar los cambios debe reiniciarse Gitea. 
===== Recursos =====

  * [[https://blog.gitea.com/welcome-to-gitea/|Welcome to Gitea]]: publicación del creador de Gitea sobre el propósito del proyecto.