Actualizar desde versiones 1.6 a 1.7

Consideraciones

Esta guía lo lleva en el proceso de actualizar una instalación pre-existente de EEI. Tenga en cuenta que:

• la versión requerida de EEI en ejecución es la v1.6.x
• se actualiza toda la solución EEI que se despliega con Docker

Arai-Docs

Actualizar variables

En la versión 1.6 de Arai-Docs se agregaron nuevas configuraciones. Los cambios se detallan acá y acá.

Bajar stack docs-api

docker stack rm docs

Actualizar Base de Datos

1. Realizar el backup de PostgreSQL de manera preventiva

2. Desplegar el servicio que actualiza la base de datos

docker stack deploy --with-registry-auth --compose-file prod/arai/util/docs_actualizar_base.yml docs_actualizar_base

Se puede observar el avance del proceso de migración en el log del servicio. Finalizada la migración, se puede eliminar dicho despliegue del servicio

docker service logs docs_actualizar_base_update -f
docker stack rm docs_actualizar_base

Nota: esto requiere acceso a la base de datos para modificar su estructura. Alternativamente, puede seguir esta guía para actualizar la base de datos.

Actualizar API y Worker

Desplegar las nuevas versiones de la API y del Worker

docker stack deploy --with-registry-auth -c prod/arai/docs.yml docs

Arai-Usuarios

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

Desplegar las nuevas versiones

docker stack deploy --with-registry-auth -c prod/arai/usuarios.yml usuarios

Huarpe

Actualizar variables

En la versión 3.2 de Huarpe se agregaron nuevas configuraciones como variables de entorno y se renombraron otras. Todas se detallan acá.

Todas estas configuraciones, se deben ver reflejados en el archivo huarpe.env.

Actualizar el despliegue

1. Bajar stack huarpe

   docker stack rm huarpe

2. Desplegar las nuevas versiones del servicio

   cd prod/arai
   docker stack deploy --with-registry-auth -c prod/arai/huarpe.yml huarpe

Sudocu

Antes de actualizar

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto.

Actualizar base PostgreSQL

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.4.14

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu

Nota: Tener en cuenta que hay nuevas opciones en los JSON de configuración (archivo config-api-server.json), que requieren ser actualizados. Todas se detallan acá.

1.7.0 a 1.7.1

Sudocu

Antes de actualizar

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto.

Actualizar base PostgreSQL

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.4.9

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu

Nota: Tener en cuenta que en muchos casos hay nuevas opciones en los JSON de configuración (archivo config-api-server.json), que requieren ser actualizados. Todas se detallan acá. Se sugiere revisar esto antes de desplegar nuevamente.

1.7.1 a 1.7.2

Arai-Usuarios

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

2. Desplegar las nuevas versiones

docker stack deploy --with-registry-auth -c prod/arai/usuarios.yml usuarios

Arai-Docs

Bajar stack docs-api

docker stack rm docs

Actualizar Base de Datos

1. Realizar el backup de PostgreSQL de manera preventiva

2. Desplegar el servicio que actualiza la base de datos

docker stack deploy --with-registry-auth --compose-file prod/arai/util/docs_actualizar_base.yml docs_actualizar_base

Se puede observar el avance del proceso de migración en el log del servicio. Finalizada la migración, se puede eliminar dicho despliegue del servicio

docker service logs docs_actualizar_base_update -f
docker stack rm docs_actualizar_base

Nota: esto requiere acceso a la base de datos para modificar su estructura. Alternativamente, puede seguir esta guía para actualizar la base de datos.

Desplegar las nuevas versiones de la API y del Worker

docker stack deploy --with-registry-auth -c prod/arai/docs.yml docs

Sudocu

Antes de actualizar

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto.

Actualizar base PostgreSQL

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.4.10

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión

Nota: Tener en cuenta que en muchos casos hay nuevas opciones en los JSON de configuración (archivo config-api-server.json), que requieren ser actualizados. Todas se detallan acá. Se sugiere revisar esto antes de desplegar nuevamente.

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu

1.7.2 a 1.7.3

Arai-Usuarios

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

Desplegar las nuevas versiones

docker stack deploy --with-registry-auth -c prod/arai/usuarios.yml usuarios

Huarpe

Se generó una versión menor para corrección de errores. Solo es necesario correr el deploy para que detecte los cambios.

Actualizar el despliegue

1. Desplegar las nuevas versiones del servicio

   docker stack deploy --with-registry-auth -c prod/arai/huarpe.yml huarpe

Sudocu

Antes de actualizar

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto.

Actualizar base PostgreSQL

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.4.12

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu

1.7.3 a 1.7.4

Sudocu

Antes de actualizar

Antes de actualizar es necesario realizar un backup de la base de datos.

Borrar el stack actual:

docker stack rm sudocu

Nota: esto elimina tanto los servicios del stack como los configs (que levantan los archivos .json de configuración). Si necesita, puede actualizarlos en este punto, ya que se agregaron nuevas opciones.

Actualizar base PostgreSQL

Finalmente, ejecutamos el proceso de migración de la base de datos.

docker run --rm \
  --env SUDOCU_DB_HOST=ip-host-db-sudocu \
  --env SUDOCU_DB_NAME=sudocu \
  --env SUDOCU_DB_PORT=5432 \
  --env SUDOCU_DB_USER=postgres \
  --env SUDOCU_DB_PASSWORD=postgres \
  ungs/sudocu-db-instalador:1.4.14

Nota: Tener en cuenta que SUDOCU_DB_HOST debe apuntar al host donde corre el PostgreSQL que contiene dicha base.

Desplegar la nueva versión

Realizar nuevo deploy:

docker stack deploy --with-registry-auth --compose-file prod/sudocu/sudocu.yml sudocu