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

De SIU
Saltar a: navegación, buscar
Línea 8: Línea 8:
 
<nowiki>https://www.siu.edu.ar/solicitud/</nowiki>
 
<nowiki>https://www.siu.edu.ar/solicitud/</nowiki>
  
−
En cuanto esté la nota y su correspondiente autorización, procederemos a realizarles la vinculación de sus usuarios al hub de diaguita.
+
=== '''Parámetros disponibles en entry point''' ===
−
# 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
 
  
−
;;
+
--fix-permissions: Configura los permisos de archivos para la aplicación
−
;;Opciones que recibe la librería - > rest/rest.php
+
--reconfigure: Realiza la reconfiguración del proyecto a partir de las variables de entorno
−
;;
+
--reconfigure-alias: Realiza la reconfiguración de los alias
−
[settings]
+
--compilar-perfiles: Compila los perfiles funcionales
−
formato_respuesta = json
+
--create-db: Indica que se debe crear la base de datos al correr un proceso de instalación
−
url_protegida = /.*/
+
--db-existente: Indica que se debe utilizar una base de negocio existente al correr un proceso de instalación.
−
</source>
+
--db-initialize: Inicializa la base de datos.
−
#:
+
--db-migrate: Realiza la migración del proyecto.
−
#:
+
--worker-docs: Inicia el worker de documentos.
−
# También se debe configurar el archivo '''servidor_usuarios.ini''' ubicado en la siguiente ruta
+
--start-jasper: Inicia jasper
−
#:
+
--change-apache-usr:  
−
#:<source lang="php" enclose="div">
+
--serve
−
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 />
+
=== '''Inicializar base diaguita 3.0.0''' ===
−
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]
+
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
  
−
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====
 
  
−
* '''<u>''En SIU-Diaguita''</u>'''<br />
+
=== '''Correr diaguita 3.0.0''' ===
−
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 ====
+
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
  
−
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'''
+
=== '''Exportar instancia''' ===
  
−
:<source lang="php" enclose="div">
 
−
###### 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"
+
docker exec -i diaguita3.0.0 /usr/local/app/bin/toba instancia exportar_local -­i produccion
−
! width="25%" | Variable de entorno
 
−
! width="75%" | Descripción
 
−
|-
 
−
| ARAI_PROV_DB_HOST
 
−
| el host/ip del equipo donde corre la base de datos
 
−
|-
 
−
| ARAI_PROV_DB_PORT
 
−
| el puerto donde corre la base de datos
 
−
|-
 
−
| ARAI_PROV_DB_DBNAME
 
−
| el nombre de la base de datos de proveedores
 
−
|-
 
−
| ARAI_PROV_DB_USERNAME
 
−
| el usuario para la conectarse a la base de datos
 
−
|-
 
−
| ARAI_PROV_DB_PASSWORD
 
−
| la clave del usuario para conectarse a la base de datos
 
−
|-
 
−
| ARAI_PROV_DB_SCHEMA
 
−
| el nombre del esquema dentro de la base de datos
 
−
|-
 
−
| ARAI_PROV_DB_ENCODING
 
−
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
 
−
|}
 
  
−
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.
 
  
−
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]
+
# copiar dir instalación exportado
 +
docker cp diaguita3.0.0:/usr/local/app/instalacion /tmp/instalacion_exportada/
  
−
==== Estados de Sincronización ====
 
−
El cambio de los estados se puede hacer manualmente desde los parámetros del sistema, para modificarlo vamos a:<br />
 
  
−
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 />
+
-- Actualizar 3.1.0 (migrar db negocio, db toba, importar 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
  
−
'''''(Valor no):''''' no se utiliza la funcionalidad Arai (en Diaguita), se carga personas, proveedores  por  ABM - Personas y  ABM – Proveedores<br />
 
  
−
=== '''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.
 
  
 
==== Uso ====
 
==== Uso ====

Revisión del 16:11 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 entry point

--fix-permissions: Configura los permisos de archivos para la aplicación --reconfigure: Realiza la reconfiguración del proyecto a partir de las variables de entorno --reconfigure-alias: Realiza la reconfiguración de los alias --compilar-perfiles: Compila los perfiles funcionales --create-db: 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: --serve


Inicializar base diaguita 3.0.0

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

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

Exportar instancia

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


  1. copiar dir instalación exportado

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


-- Actualizar 3.1.0 (migrar db negocio, db toba, importar 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



Uso

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a | Documentación Técnica de los WS de AFIP

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.

###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token

Parámetros de configuración disponibles

Parametro Descripcion
AFIP_WS_CUIT (int) El CUIT a usar en los Web Services.
AFIP_WS_CERT (string)Ruta absoluta donde se encuentra el certificado
AFIP_WS_KEY (string)Ruta absoluta donde se encuentra la clave
AFIP_WS_TOKEN_DIR (string)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 Configuración SIU-Diaguita

Verificar Configuración de Servicios

Verificar Configuración de Servicios Funcional

Esta operación dentro del sistema se encuentra en el Menú Administración / Configuración SIU-Diaguita


Anonimizar la Base de datos

Backup Anonimizado

É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.
La forma de utilizar este comando es la siguiente:
Acceder por línea de comandos a la carpeta raiz del sistema y ejecutar

Para Linux

. ./entorno_toba.env
toba proyecto anonimizar_base -p diaguita -i produccion

Para Windows

diaguita.bat base anonimizar_base


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

<Volver

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