Diferencia entre revisiones de «SIU-Diaguita/version3.1.0/imagen docker»

De SIU
Saltar a: navegación, buscar
(Página creada con «derecha|link=SIU-Diaguita/version3.1.0<br /> <span style="float: ;margin: 0 0 16px 16px;">{{TOClimit|1}}</span> == Consideraciones técnicas =...»)
 
 
(No se muestran 6 ediciones intermedias del mismo usuario)
Línea 2: Línea 2:
 
<span style="float: ;margin: 0 0 16px 16px;">{{TOClimit|1}}</span>
 
<span style="float: ;margin: 0 0 16px 16px;">{{TOClimit|1}}</span>
  
−
== Consideraciones técnicas ==
+
== Uso de imágenes docker en SIU-Diaguita ==
−
=== '''Conectar SIU-Diaguita con otros sistemas''' ===
+
=== '''Acceso a imágenes docker SIU-Diaguita desde hub.siu.edu.ar''' ===
−
Para permitir que otros siatemas puedan acceder a los servicios que SIU-Diaguita tiene disponible,
+
Para poder descargar la imágen de docker de SIU-Diaguita, se debe realizar una solicitud de vinculación por nota. La explicación, detalle y enlace a una nota modelo la pueden obtener desde este link:
−
# Se debe configurar el archivo '''servidor.ini''' ubicado en la siguiente ruta
 
−
#:
 
−
#:<source lang="php" enclose="div">
 
−
SIU-Diaguita/instalacion/i__produccion/p__diaguita/rest/servidor.ini
 
−
</source>
 
−
#:
 
−
#:El contenido de dicho archivo debe ser similar a lo siguiente, quedando configurados los usuarios que se utilizarán desde SIU-Diaguita. Este archivo puede contener otros usuarios para otros sistemas.
 
−
#:
 
−
#:<source lang="php" enclose="div">
 
−
autenticacion = digest
 
−
 
 
−
;;
 
−
;;Opciones que recibe la librería - > rest/rest.php
 
−
;;
 
−
[settings]
 
−
formato_respuesta = json
 
−
url_protegida = /.*/
 
−
</source>
 
−
#:
 
−
#:
 
−
# También se debe configurar el archivo '''servidor_usuarios.ini''' ubicado en la siguiente ruta
 
−
#:
 
−
#:<source lang="php" enclose="div">
 
−
SIU-Diaguita/instalacion/i__produccion/p__diaguita/rest/servidor_usuarios.ini
 
−
</source>
 
−
#:
 
−
#:El contenido de dicho archivo debe ser similar a lo siguiente, quedando configurados los usuarios que se utilizarán desde SIU-Diaguita. Este archivo puede contener otros usuarios para otros sistemas.
 
−
#:
 
−
#:<source lang="php" enclose="div">
 
−
[toba] *** (es el nombre del usuario que se puso en el archivo cliente.ini)
 
−
password = toba *** (es el password del usuario que se puso en el archivo cliente.ini)
 
−
api_key= toba
 
−
</source>
 
−
#:
 
−
#:
 
−
#:Se puede configurar desde la base de datos o funcionalmente a través de la siguiente ruta: ''Administración / Configuración de parámetros''
 
−
#:
 
−
#:
 
−
Esto se puede Verificar en [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/consideraciones_tecnicas#Verificar_Configuraci.C3.B3n_de_Servicios_Funcional Configuración SIU-Diaguita]
 
−
 
 
−
==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====
 
−
* '''<u>''En SIU-Pilagá''</u>'''<br />
 
−
Para permitir que SIU-Pilagá acceda a recursos de SIU-Diaguita  ir a [http://documentacion.siu.edu.ar/wiki/SIU-Pilaga/version3.4.0/consideraciones_tecnicas#Conectar_SIU-Pilag.C3.A1_con_SIU-Diaguita Conectar SIU-Pilagá con SIU-Diaguita]
 
−
 
 
−
* '''<u>''En SIU-Diaguita''</u>'''<br />
 
−
Para permitir que SIU-Diaguita acceda a recursos de SIU-Pilagá ir a [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/post_instalacion#Conectar_SIU-Diaguita_con_SIU-Pilag.C3.A1 Conectar SIU-Diaguita con SIU-Pilagá]
 
−
<br />
 
−
 
 
−
Esto se puede Verificar en [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/consideraciones_tecnicas#Verificar_Configuraci.C3.B3n_de_Servicios_Funcional Configuración SIU-Diaguita]
 
−
 
 
−
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====
 
−
 
 
−
* '''<u>''En SIU-Diaguita''</u>'''<br />
 
−
Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche ir a [https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version3.1.0/post_instalacion#Conectar_SIU-Diaguita_con_SIU-Mapuche Conectar SIU-Diaguita con SIU-Mapuche]
 
−
<br />
 
−
Esto se puede Verificar en [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/consideraciones_tecnicas#Verificar_Configuraci.C3.B3n_de_Servicios_Funcional Configuración SIU-Diaguita]
 
−
 
 
−
=== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ===
 
−
 
 
−
==== Configuración de la base de datos de Arai Proveedores ====
 
  
−
Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''
+
<nowiki>https://www.siu.edu.ar/solicitud/</nowiki>
  
−
:<source lang="php" enclose="div">
+
=== '''Parámetros disponibles en entrypoint''' ===
−
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
 
−
ARAI_PROV_DB_HOST=localhost
 
−
ARAI_PROV_DB_PORT=5432
 
−
ARAI_PROV_DB_DBNAME=db_arai_proveedores
 
−
ARAI_PROV_DB_USERNAME=postgres
 
−
ARAI_PROV_DB_PASSWORD=postgres
 
−
ARAI_PROV_DB_SCHEMA=public
 
−
ARAI_PROV_DB_ENCODING=UTF8
 
−
</source>
 
  
 
{| class="wikitable"
 
{| class="wikitable"
−
! width="25%" | Variable de entorno
+
! width="25%" | Parametro
−
! width="75%" | Descripción
+
! width="75%" | Descripcion
 +
|-
 +
| --fix-permissions
 +
| Configura los permisos de archivos para la aplicación
 +
|-
 +
| --reconfigure
 +
| Configura los permisos de archivos para la aplicación
 +
|-
 +
| --reconfigure-alias
 +
| Realiza la reconfiguración de los alias
 +
|-
 +
| --compilar-perfiles
 +
| Compila los perfiles funcionales
 +
|-
 +
| --create-db
 +
| Compila los perfiles funcionales
 +
|-
 +
| --compilar-perfiles
 +
| Indica que se debe crear la base de datos al correr un proceso de instalación
 
|-
 
|-
−
| ARAI_PROV_DB_HOST
+
| --db-existente
−
| el host/ip del equipo donde corre la base de datos
+
| Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.
 
|-
 
|-
−
| ARAI_PROV_DB_PORT
+
| --db-initialize
−
| el puerto donde corre la base de datos
+
| Inicializa la base de datos.
 
|-
 
|-
−
| ARAI_PROV_DB_DBNAME
+
| --db-migrate
−
| el nombre de la base de datos de proveedores
+
| Realiza la migración del proyecto.
 
|-
 
|-
−
| ARAI_PROV_DB_USERNAME
+
| --worker-docs
−
| el usuario para la conectarse a la base de datos
+
| Inicia el worker de documentos
 
|-
 
|-
−
| ARAI_PROV_DB_PASSWORD
+
| --start-jasper
−
| la clave del usuario para conectarse a la base de datos
+
| Inicia jasper
 
|-
 
|-
−
| ARAI_PROV_DB_SCHEMA
+
| --change-apache-usr
−
| el nombre del esquema dentro de la base de datos
+
| Cambia usuario apache
 
|-
 
|-
−
| ARAI_PROV_DB_ENCODING
+
| --serve
−
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
+
| Queda ejecutando servicio
 
|}
 
|}
  
−
Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Diaguita.
+
== Ejemplo de uso de las imágenes docker en SIU-Diaguita ==
  
−
Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]
+
=== '''Inicializar base diaguita''' ===
 +
Este comando inicializa la BD del proyecto
  
−
==== Estados de Sincronización ====
+
:<source lang="php" enclose="div">
−
El cambio de los estados se puede hacer manualmente desde los parámetros del sistema, para modificarlo vamos a:<br />
+
docker run --rm -it \
 +
--env-file ~/workspace/siu/imagen_test/instalador.env \
 +
--env APACHE_RUN_USER=$(id -u) \
 +
--name diaguita-new-db gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.0.0 --db-initialize --create-db
 +
</source>
  
−
Administración/Parámetros ('''aplicar_sincronizacion_arai_prov''')
 
−
[[Archivo:ARAIconfDiaguita.png|centro|marco]]
 
−
'''''Modo conectado (valor sí):''''' cada cambio que se realice se sincroniza automáticamente con la base. En Diaguita si se utiliza este estado, solo se podrá cargar personas por la operación ABM - Personas ARAI y no por ABM - Personas<br />
 
  
−
'''''Modo desconectado (valor desconectado):''''' si por algún motivo se cae la conexión con la red, se tendrá que poner este estado para poder cargar proveedores y seguir operando. Una vez que se restablezca la conexión, pedirá que se realice una sincronización inicial<br />
 
  
−
'''''(Valor no):''''' no se utiliza la funcionalidad Arai (en Diaguita), se carga personas, proveedores  por  ABM - Personas y  ABM – Proveedores<br />
+
=== '''Correr diaguita 3.0.0''' ===
 +
Este comando permite correr el contenedor de SIU-Diaguita, con los parámetros del entrypoint mencionados anteriormente.
 +
:<source lang="php" enclose="div">
 +
docker run --detach \
 +
--env APACHE_RUN_USER=$(id -u) \
 +
--env-file ~/workspace/siu/imagen_test/instalador.env \
 +
--name diaguita3.0.0 gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.0.0 --reconfigure --reconfigure-alias --serve --start-jasper --fix-permissions --change-apache-usr
 +
</source>
  
−
=== '''Conectar SIU-Diaguita con la AFIP''' ===
 
  
−
Los pasos que se describen a continuación permiten configurar el acceso a recursos de la AFIP expuestos mediante servicios web.
+
== Actualización SIU-Diaguita a 3.1.0 ==
  
−
==== Uso ====
+
=== '''Exportar instancia''' ===
 +
En primer lugar se debe exportar la instancia de la versión anterior.
  
−
En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.
+
:<source lang="php" enclose="div">
 +
docker exec -i diaguita3.0.0 /usr/local/app/bin/toba instancia exportar_local -­i produccion
 +
</source>
  
−
Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]
+
Luego copiar la instancia exportada fuera del contenedor
−
 
 
−
==== Configuración ====
 
−
 
 
−
Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.
 
  
 
:<source lang="php" enclose="div">
 
:<source lang="php" enclose="div">
−
###### CONFIG AFIP WS ######
+
docker cp diaguita3.0.0:/usr/local/app/instalacion /tmp/instalacion_exportada/
−
AFIP_WS_CUIT=cuit
 
−
AFIP_WS_CERT=/ruta/a/cert
 
−
AFIP_WS_KEY=/ruta/a/key
 
−
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
 
 
</source>
 
</source>
  
−
==== Parámetros de configuración disponibles ====
 
−
 
−
{| class="wikitable"
 
−
! width="25%" | Parametro
 
−
! width="75%" | Descripcion
 
−
|-
 
−
| AFIP_WS_CUIT
 
−
| <code>(int)</code> El CUIT a usar en los Web Services.
 
−
|-
 
−
| AFIP_WS_CERT
 
−
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
 
−
|-
 
−
| AFIP_WS_KEY
 
−
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
 
−
|-
 
−
| AFIP_WS_TOKEN_DIR
 
−
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
 
−
|}
 
  
−
Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalacion ya se podrá usar el servicio de Afip en el sistema.
 
  
−
Esto se puede Verificar en [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/consideraciones_tecnicas#Verificar_Configuraci.C3.B3n_de_Servicios_Funcional Configuración SIU-Diaguita]
+
=== '''Migración de db negocio, db toba e importación de usuarios y perfiles''' ===
 +
Finalmente correr el comando de migración con la imagen de la nueva versión.
 +
En este ejemplo se monta un volumen con la instalación exportada en el paso anterior.
 +
El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.
  
−
=== '''Verificar Configuración de Servicios''' ===
+
:<source lang="php" enclose="div">
 +
docker run --rm -it \
 +
--env-file ~/workspace/siu/imagen_test/instalador.env \
 +
--env APACHE_RUN_USER=$(id -u) \
 +
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \
 +
--name diaguita-update-db gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.1.0 -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress
  
−
==== Verificar Configuración de Servicios Funcional ====
+
</source>
−
Esta operación dentro del sistema se encuentra en el Menú Administración / [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.1.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION  Configuración SIU-Diaguita]
 
  
  
−
=== '''Anonimizar la Base de datos''' ===
+
=== '''Correr diaguita 3.1.0''' ===
  
−
==== Backup Anonimizado ====
+
:<source lang="php" enclose="div">
−
Éste es un comando nuevo incorporado a partir de la versión 3.1.0 y está pensado para que cuando necesiten enviar su base de datos, por algún problema, lo hagan de forma que los datos no contengan valores reales de las personas.
+
docker run --detach \
−
<br />
+
--env APACHE_RUN_USER=$(id -u) \
−
La forma de utilizar este comando es la siguiente:<br />
+
--env-file ~/workspace/siu/imagen_test/instalador.env \
−
Acceder por línea de comandos a la carpeta raiz del sistema y ejecutar<br />
+
--name diaguita3.1.0 gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.1.0 --reconfigure --reconfigure-alias --serve --start-jasper --fix-permissions --change-apache-usr --compilar-perfiles
  
−
''' Para Linux '''
 
−
<source lang="php" enclose="div">
 
−
. ./entorno_toba.env
 
−
toba proyecto anonimizar_base -p diaguita -i produccion
 
 
</source>
 
</source>
−
''' Para Windows '''
 
−
<source lang="php" enclose="div">
 
−
diaguita.bat base anonimizar_base
 
−
</source>
 
−
 
  
−
Cuando se ejecute el comando, este solicitará la clave de la Base de  datos.
 
  
−
El backup anonimizado será exportado dentro de la carpeta "temp" dentro de la instalación
 
−
<br />
 
  
 
----
 
----
  
 
[[SIU-Diaguita/version3.1.0|<Volver]]
 
[[SIU-Diaguita/version3.1.0|<Volver]]

Revisión actual del 17:00 28 jul 2021

Siu-diaguita.png

Uso de imágenes docker en SIU-Diaguita

Acceso a imágenes docker SIU-Diaguita desde hub.siu.edu.ar

Para poder descargar la imágen de docker de SIU-Diaguita, se debe realizar una solicitud de vinculación por nota. La explicación, detalle y enlace a una nota modelo la pueden obtener desde este link:

https://www.siu.edu.ar/solicitud/

Parámetros disponibles en entrypoint

Parametro Descripcion
--fix-permissions Configura los permisos de archivos para la aplicación
--reconfigure Configura los permisos de archivos para la aplicación
--reconfigure-alias Realiza la reconfiguración de los alias
--compilar-perfiles Compila los perfiles funcionales
--create-db Compila los perfiles funcionales
--compilar-perfiles Indica que se debe crear la base de datos al correr un proceso de instalación
--db-existente Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.
--db-initialize Inicializa la base de datos.
--db-migrate Realiza la migración del proyecto.
--worker-docs Inicia el worker de documentos
--start-jasper Inicia jasper
--change-apache-usr Cambia usuario apache
--serve Queda ejecutando servicio

Ejemplo de uso de las imágenes docker en SIU-Diaguita

Inicializar base diaguita

Este comando inicializa la BD del proyecto

docker run --rm -it \
--env-file ~/workspace/siu/imagen_test/instalador.env \
--env APACHE_RUN_USER=$(id -u) \
--name diaguita-new-db gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.0.0 --db-initialize --create-db


Correr diaguita 3.0.0

Este comando permite correr el contenedor de SIU-Diaguita, con los parámetros del entrypoint mencionados anteriormente.

docker run --detach \
--env APACHE_RUN_USER=$(id -u) \
--env-file ~/workspace/siu/imagen_test/instalador.env \
--name diaguita3.0.0 gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.0.0 --reconfigure --reconfigure-alias --serve --start-jasper --fix-permissions --change-apache-usr


Actualización SIU-Diaguita a 3.1.0

Exportar instancia

En primer lugar se debe exportar la instancia de la versión anterior.

docker exec -i diaguita3.0.0 /usr/local/app/bin/toba instancia exportar_local -­i produccion

Luego copiar la instancia exportada fuera del contenedor

docker cp diaguita3.0.0:/usr/local/app/instalacion /tmp/instalacion_exportada/


Migración de db negocio, db toba e importación de usuarios y perfiles

Finalmente correr el comando de migración con la imagen de la nueva versión. En este ejemplo se monta un volumen con la instalación exportada en el paso anterior. El comando docker:db-actualizar realiza la migración de la base de negocio, de la base de toba y la migración de usuarios y perfiles.

docker run --rm -it \
--env-file ~/workspace/siu/imagen_test/instalador.env \
--env APACHE_RUN_USER=$(id -u) \
-v /tmp/instalacion_exportada:/tmp/instalacion_exportada \
--name diaguita-update-db gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.1.0 -- bin/instalador docker:db-actualizar -p /tmp/instalacion_exportada --no-interaction --no-progress


Correr diaguita 3.1.0

docker run --detach \
--env APACHE_RUN_USER=$(id -u) \
--env-file ~/workspace/siu/imagen_test/instalador.env \
--name diaguita3.1.0 gitlab.siu.edu.ar:5005/siu/diaguita/app:v3.1.0 --reconfigure --reconfigure-alias --serve --start-jasper --fix-permissions --change-apache-usr --compilar-perfiles


<Volver

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version3.1.0/imagen_docker&oldid=74294»