|
|
|
@ -122,7 +122,7 @@ docker-compose run --rm gancio "gancio setup --docker --db=sqlite"
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Instalacion Automatica ( en desarrollo, ver TODOs ) |
|
|
|
|
## Instalacion Automatica |
|
|
|
|
|
|
|
|
|
En este caso, nos interesa desplegar Gancio sin intervencion de una usuaria. |
|
|
|
|
Queremos: |
|
|
|
@ -147,6 +147,8 @@ Al editar el archvio, los datos que nos interesa cambiar en este archivo son
|
|
|
|
|
nuevo con `cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w ${1:-24} | head -n 1` |
|
|
|
|
- `admin_email`, email de la cuenta de administradora (se usa para acceder al |
|
|
|
|
gestionar el servicio) |
|
|
|
|
- `admin_pass`, clave de acceso para la cuenta de administradora. _SE ELIMINA |
|
|
|
|
AUTOMATICAMENTE DEL FICHERO AL CREAR LA CUENTA_ |
|
|
|
|
- `smtp`, si se desea enviar correos, modificar a los datos de vuestro |
|
|
|
|
servidor de SMPT |
|
|
|
|
|
|
|
|
@ -159,26 +161,15 @@ segura de lo que haces ;)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Cuenta de administradora |
|
|
|
|
La mayoria de los datos que necesita la instancia de Gancio se encuentran en |
|
|
|
|
el `config.json`, a excepcion de la clave de la cuenta de administradora. |
|
|
|
|
|
|
|
|
|
Esta clave solo sera necesaria en el caso de iniciar una nueva instancia de |
|
|
|
|
Esta cuenta solo se creara en el caso de iniciar una nueva instancia de |
|
|
|
|
Gancio, sin datos. |
|
|
|
|
|
|
|
|
|
Si estamos re-iniciando una instancia existente, o migrando una instancia que |
|
|
|
|
ya cuenta con su propia base de datos, esta variable 'clave de administradora' |
|
|
|
|
sera ignorada y se deberan conocer los datos de la cuenta de administradora |
|
|
|
|
originales. |
|
|
|
|
Si estamos re-iniciando una instancia existente, estos datos seran ignorados |
|
|
|
|
y se deberan conocer los datos de la cuenta de administradora originales. |
|
|
|
|
|
|
|
|
|
Entonces, en una instancia nueva iniciada sin datos, la administradora podra |
|
|
|
|
loguearse utilizando el dato `admin_email` informado en el `config.json` y la |
|
|
|
|
clave que especifiquemos en la variable de entorno `GANCIO_ADMIN_PASS` |
|
|
|
|
|
|
|
|
|
_TODO cuando iniciemos con una base de datos vacia, crear la usuaria admin con |
|
|
|
|
los datos del config.json y un password pasado por entorno |
|
|
|
|
idea: crear script node que apalanque las funciones existentes para ejecutar las |
|
|
|
|
migraciones en la base de datos, y para crear la usuaria administradora_ |
|
|
|
|
|
|
|
|
|
loguearse utilizando el dato `admin_email` y `admin_pass` informado en el |
|
|
|
|
`config.json` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Autenticacion para SMTP |
|
|
|
@ -197,6 +188,7 @@ informacion en la seccion `smtp` del fichero `config.json`
|
|
|
|
|
... |
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Configuracion del servicio |
|
|
|
|
Dado que utilizamos `docker-compose` para ejecutar Gancio, aprovecharemos la |
|
|
|
|
posibilidad de definir nuestras variables de entorno en un archivo `.env` que |
|
|
|
@ -209,26 +201,13 @@ cp .env.sample .env
|
|
|
|
|
``` |
|
|
|
|
|
|
|
|
|
### Variables de Despliegue (necesarias en todos los casos) |
|
|
|
|
- `GANCIO_DATA_PATH`, ruta en el host que contiene los datos de Gancio _(valor por |
|
|
|
|
defecto `./data` = subcarpeta `data` en la misma carpeta que |
|
|
|
|
`docker-compose.yml`)_ |
|
|
|
|
- `GANCIO_DATA_PATH`, ruta en el host que contiene los datos de Gancio |
|
|
|
|
_(valor por defecto `./data` = subcarpeta `data` en la misma carpeta que |
|
|
|
|
`docker-compose.yml`)_ |
|
|
|
|
- `GANCIO_PORT`, puerto del host en el que se expondra el servicio de Gancio |
|
|
|
|
_(valor por defecto `13120`)_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Variables de Instalacion Automatica (solo para Instalaciones Automaticas) |
|
|
|
|
Estas variables solo son necesarias en los procesos de instalacion automatica |
|
|
|
|
de nuevas instancias. |
|
|
|
|
Se pueden pasar como variables de entorno al docker durante su primera |
|
|
|
|
ejecucion, ej `docker-compose run -e MI_VAR=valor gancio ...` |
|
|
|
|
Como alternativa, se pueden informar estas variables en el fichero `.env`, en |
|
|
|
|
cuyo caso se borran luego de ser utilizadas para finalizar la instalacion |
|
|
|
|
automatica. |
|
|
|
|
- `GANCIO_ADMIN_PASS`, clave de acceso de la cuenta de administradora [ solo |
|
|
|
|
es necesaria en Instalaciones Automaticas nuevas ]. |
|
|
|
|
|
|
|
|
|
_TODO eliminar estas variables de `.env` luego de persistirlas en la bbdd_ |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Ejecucion de Gancio |
|
|
|
|
Llegado este punto, podemos iniciar nuestra intancia |
|
|
|
|