MasterpieceDockerCompose/gitea/README.md

134 lines
3.2 KiB
Markdown
Raw Normal View History

2021-05-17 09:57:45 +02:00
# Gitea in docker
<div align="center">
<img src="https://gitea.io/images/screenshot.png" />
</div>
# Descrizione
* [Sito ufficiale](https://gitea.io/)
* [Repo (Github)](https://github.com/go-gitea/gitea)
2021-05-17 12:45:18 +02:00
* [Demo](https://try.gitea.io/)
* [Documentazione](https://docs.gitea.io/)
2021-05-17 09:57:45 +02:00
2021-05-17 12:45:18 +02:00
Gitea è un simil-github veloce, semplice e facile da configurare:
2021-05-17 09:57:45 +02:00
- Scritto in Go (Golang)
2021-05-17 12:45:18 +02:00
- Il progetto che si avvicina maggiormente a GitHub (esteticamente)
2021-05-17 09:57:45 +02:00
- Supporta i maggiori database (SQLite, MySQL/MariaDB e PostgreSQL)
# Struttura file e cartelle
```
/home/
└── docker/
└── gitea/
├── data/
├── db/
├── .env
└── docker-compose.yml
2021-05-17 09:57:45 +02:00
```
2021-05-17 12:45:18 +02:00
* `data/` - cartella dove i dati di gitea vengono salvati
* `db/` - cartella dove i dati del database vengono salvati
* `.env` - file contenenti le variabili environment per il docker compose
* `docker-compose.yml` - file usato per creare il container
2021-05-17 09:57:45 +02:00
Tutti i file e le cartelle devono essere creati a mano.</br>
# docker-compose
`docker-compose.yml`
```yml
version: "3.8"
services:
db:
container_name: gitea-db
image: postgres:13-alpine
restart: always
env_file: .env
volumes:
- ${POSTGRES_DATA:-/home/docker/gitea/db}:/var/lib/postgresql/data
- /etc/localtime:/etc/localtime:ro
healthcheck:
test: ["CMD", "pg_isready", "-U", "gitea"]
interval: 1m30s
timeout: 10s
retries: 3
start_period: 10s
git:
container_name: gitea
image: gitea/gitea:1.14.2
restart: unless-stopped
depends_on:
- db
ports:
2021-05-17 12:45:18 +02:00
- ${GITEA_WEBUI_PORT:-3000}:3000
2021-05-17 09:57:45 +02:00
- ${GITEA_SSH_PORT:-221}:22
env_file: .env
volumes:
- ${POSTGRES_DATA:-/home/docker/gitea/data}:/data
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
2021-05-17 12:45:18 +02:00
healthcheck: # se modificate la porta dell'interfaccia web, ricordatevi di cambiarla anche qua sotto
test: ["CMD", "curl", "-Ssf", http://localhost:3000"]
interval: 1m30s
2021-05-17 09:57:45 +02:00
timeout: 10s
retries: 3
2021-05-17 12:45:18 +02:00
start_period: 1m
2021-05-17 09:57:45 +02:00
```
`.env`
```bash
# Generale
2021-05-17 11:57:31 +02:00
POSTGRES_DATA=/home/docker/gitea/db
GITEA_DATA=/home/docker/gitea/data
2021-05-17 12:45:18 +02:00
GITEA_WEBUI_PORT=3000
2021-05-17 11:57:31 +02:00
GITEA_SSH_PORT=221
2021-05-17 09:57:45 +02:00
# Postgres
2021-05-17 12:45:18 +02:00
POSTGRES_DB=gitea
2021-05-17 09:57:45 +02:00
POSTGRES_USER=gitea
POSTGRES_PASSWORD=gitea
# Gitea
GITEA__database__DB_TYPE=postgres
GITEA__database__HOST=db:5432
GITEA__database__NAME=gitea
GITEA__database__USER=gitea
GITEA__database__PASSWD=gitea
```
# Reverse proxy
Ancora non ho previsto l'uso di un reverse proxy. (Vedi [Todo](#Todo))
# Aggiornamenti
[Watchtower](../watchtower) aggiorna l'immagine automaticamente.
2021-05-17 09:57:45 +02:00
Aggiornamento manuale:
- `docker-compose pull`
- `docker-compose up -d`
2021-05-17 09:57:45 +02:00
- `docker image prune`
# Backup e ripristino
#### Backup
Usare [borg](../borg_backup) per fare i backup giornalieri dell'intera cartella ``.
2021-05-17 09:57:45 +02:00
#### Ripristino
* spegnere il container `docker-compose down`
* cancellare l'intera cartella `gitea`
* dal backup copiare la cartella `gitea`
* far ripartire il container `docker-compose up -d`
2021-05-17 09:57:45 +02:00
# Todo
Implementare:
- reverse proxy: **[caddy](https://caddyserver.com/) o [traefik](https://doc.traefik.io/traefik/).**