update gitea*.md

This commit is contained in:
dzamo (from g470) 2024-11-22 04:54:52 +01:00
parent 6a41b6fe8e
commit adc901bdc7
2 changed files with 12 additions and 119 deletions

View File

@ -111,22 +111,3 @@ En las siguientes capturas se muestran ejemplo como copiar/clonar dos repositori
docker-compose logs -f
```
## Resumen: explicación de la configuración
- .env
- Centraliza las credenciales y configuraciones sensibles.
- `docker-compose.yml`
- Define los servicios principales, como Postgres y Gitea (Nginx), con configuraciones básicas, en contenedores separados.
- `docker-compose.override.yml`
- Extiende o reemplaza configuraciones para propósitos específicos, como desarrollo o debug.
- Volúmenes
- La base de datos de Postgres en ubica en `...data/postgres`.
- El servicio o aplicación Gitea se persiste en `...data/gitea`.
- También se utilizan otros volumenes, como el de las credenciales.

View File

@ -8,92 +8,24 @@ gitea $ tree -a
└── .env
```
_Nota autor:_ algunos de los datos quizas son ofuscados/ocultos en este reporte. Este documento es solo a modo de referencia para despliegue de esta aplicación docker aquí compartida.
_Nota autor:_ algunos de los datos quizas son ofuscados/ocultos en este reporte. Este documento es solo a modo de referencia para principalmente despliegue y/o configuración del entorno para desplegar esta aplicación docker aquí compartida.
## Definicion de los contenedores Docker
En este despliegue se utiliza junto a la definición del `docker-compose.yml`, el fichero `.env` y `docker-compose.override.yml` para que se permita el despliegue de la misma aplicación en diferentes entornos (ejemplo: entorno desarrollo, pruebas, producción, etc).
En este despliegue se utiliza junto a la definición del `docker-compose.yml`, el fichero `.env` y `docker-compose.override.yml` para eventulemete pueda ser utilizado en el despliegue en diferentes entornos (ejemplo: entorno desarrollo, pruebas, producción, etc), o utilizando sobre carga de la propia inicialización de la aplicación.
## Archivo .env
## Responsabilidad de los archivos
Variables de entorno referenciadas en los archivos YAML.
Archivo: .env
- `.env`: variables de entorno referenciadas en los archivos YAML.
- `docker-compose.yml`: archivo principal para definir los servicios de la aplicación. En este caso de uso, define los servicios principales, como Postgres y Gitea (Nginx), con configuraciones básicas, en contenedores separados.
- `docker-compose.override.yml`: extiende o reemplaza configuraciones para propósitos específicos, como desarrollo o debug, etc.
```bash
VAR=VALUE
...
```
## Archivo docker-compose.yml
Archivo principal para definir los servicios de tu aplicación.
Archivo: docker-compose.yml
```yaml
---
## version: '3.9'
networks:
my_net:
external: false
services:
my_service:
image: ${GITEA_IMAGE}
container_name: ${CONTAINER_NAME}
restart: always
networks:
- my_net
volumes:
- ${TIMEZONE_FILE}:${TIMEZONE_FILE_CONTAINER}
- ${LOCALTIME_FILE}:${LOCALTIME_FILE_CONTAINER}
ports:
- "${GITEA_HTTP_EXPOSE}:${GITEA_HTTP_CONTAINER}"
depends_on:
- my_db
my_db:
image: ${RDBMS_IMAGE}
restart: always
networks:
- my_net
```
## Archivo docker-compose.override.yml
Útil para ajustar configuraciones según el entorno (desarrollo, prueba, producción).
Archivo: docker-compose.override.yml
```yaml
---
## version: '3.9'
services:
my_service:
environment:
- USER_UID=${GITEA_UID}
- USER_GID=${GITEA_GID}
- GITEA__database__DB_TYPE=${RDBMS}
- GITEA__database__HOST=my_db:${RDBMS_PORT}
- GITEA__database__NAME=${DB_NAME}
- GITEA__database__USER=${DB_USER}
- GITEA__database__PASSWD=${DB_PASSWD}
volumes:
- ${GITEA_PATH_HOST}:${GITEA_PATH_CONTAINER}
- .../.ssh/:${GITEA_SSH_PATH_CONTAINER}
ports:
- "${GITEA_SSH_EXPOSE}:${GITEA_SSH_CONTAINER}"
- "${GITEA_IP_SSH_EXPOSE}:${GITEA_SSH_CONTAINER}"
my_db:
environment:
- POSTGRES_USER=${DB_USER}
- POSTGRES_PASSWORD=${DB_PASSWD}
- POSTGRES_DB=${DB_NAME}
volumes:
- ${POSTGRES_VOL_PATH_HOST}:${POSTGRES_PATH_CONTAINER}
```
### Volúmenes que define/utiliza esta aplicación
- La base de datos de Postgres se persiste en `.../postgres` (según inicialización en el `.env`).
- El servicio o aplicación Gitea se persiste en `.../gitea` (según inicialización en el `.env`).
- También se utilizan otros volumenes, como el de las credenciales para la autenticación por `ssh`, este también es persistido en un volumen desde el host anfitrión (host motor de Docker).
# Ejecución y configuración
@ -105,7 +37,7 @@ _Referencia principal:_ [Installation with Docker](https://docs.gitea.com/instal
En el host motor de Docker se realizan las siguientes tareas de configuración. Estas son:
```
```bash
source .env
export CONTAINER_NAME GITEA_ACCOUNT GITEA_UID GITEA_GID
sudo groupadd -g ${GITEA_UID} ${GITEA_ACCOUNT}
@ -197,23 +129,3 @@ En las siguientes capturas se muestran ejemplo como copiar/clonar dos repositori
```bash
docker-compose logs -f
```
## Resumen: explicación de la configuración
- .env
- Centraliza las credenciales y configuraciones sensibles.
- `docker-compose.yml`
- Define los servicios principales, como Postgres y Gitea (Nginx), con configuraciones básicas, en contenedores separados.
- `docker-compose.override.yml`
- Extiende o reemplaza configuraciones para propósitos específicos, como desarrollo o debug.
- Volúmenes
- La base de datos de Postgres en ubica en `...data/postgres`.
- El servicio o aplicación Gitea se persiste en `...data/gitea`.
- También se utilizan otros volumenes, como el de las credenciales.