diff --git a/gitea-rc4/gitea-rc4.md b/gitea-rc4/gitea-rc4.md index d864779..bd50420 100644 --- a/gitea-rc4/gitea-rc4.md +++ b/gitea-rc4/gitea-rc4.md @@ -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. diff --git a/gitea/gitea.md b/gitea/gitea.md index b8eecf9..87a8024 100644 --- a/gitea/gitea.md +++ b/gitea/gitea.md @@ -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.