SEMILLERO ASO Y APX by Santiago Chaves

Prerrequisitos

santodechaveez — 2024-09-24 17:51:23 UTC

Se debe instalar los siguientes programas para poder realizar la ambientación correctamente.

Instalación disco local D

santodechaveez — 2024-09-24 19:55:53 UTC

*Este paso se debe realizar, si el computador donde se instale no tiene una unidad local “D:”

a. Crear la carpeta "D" dentro del disco local “C:”

b. En el interior de la carpeta D se deben copiar los archivos: *CrearUnidadD.bat

*BorrarUnidadD.bat

c. Para iniciar la unidad D se debe ejecutar el archivo “CrearUnidadD.bat”. (Si se quiere desmontar la unidad se debe ejecutar “BorrarUnidadD.bat”)

*De debe descomprimir el archivo “ASO_LOCAL.zip” en la raíz de la unidad “D:”.

Python

santodechaveez — 2024-09-24 20:08:17 UTC

Se deben instalar el archivo “D:\ASO_LOCAL\Instaladores\python-2.7.15.amd64.msi” y garantizar que se instale en la ruta “D:\ASO_LOCAL\Python_2.7.15”.

Se debe habilitar la opción “Add python.exe to Path” esto para incluir la variable de entorno.

A continuacion se instalan las dependencias para que ASO y sus comandos puedan ser reconocidos por el sistema

Instalacion de dependencias ASO

santodechaveez — 2024-09-24 21:45:29 UTC

Despues de instalar python se debe abrir la consola de comandos y ejecutar las siguientes dependencias.

•pip install pip==20.2.2

• pip install backports.ssl-match-hostname==3.7.0.1

• pip install certifi==2020.6.20

• pip install chardet==3.0.4

• pip install click==6.7

• pip install docker==3.3.0

• pip install docker-pycreds==0.2.3

• pip install gitdb2==2.0.6

• pip install gitpython==2.1.15

• pip install idna==2.10

• pip install ipaddress==1.0.23

• pip install pypiwin32==219

• pip install pywin32==228

• pip install requests==2.24.0

• pip install six==1.15.0

• pip install smmap==3.0.4

• pip install smmap2==3.0.1

• pip install urllib3==1.25.10

• pip install websocket-client==0.47.0

santodechaveez — 2024-09-24 21:59:58 UTC

Después de la instalación de las dependencias, se deben ejecutar los siguientes comandos en consola:

a. D:

b. cd D:\ASO_LOCAL\Scripts

c. python .\setup.py install

d. python .\aso.py install

Si se obtiene el resultado que esta en la imagen, quiere decir que ya está instalada la herramienta aso-cli de BBVA.

Creacion de contenedor Docker

santodechaveez — 2024-09-24 22:17:12 UTC

*Se debe descargar el archivo “imageASOes510412.tar” y abrir la consola de comandos despues navegar dentro de la misma hasta la siguiente ruta “D:\ASO_LOCAL\Imagen”, después ejecutar los siguientes comandos:

Una vez instalada la imagen se procede a crear el contenedor. Esto se realiza con el comando:

• docker run -d -p 7500:7500 -p 8789:8789 --name asoLocal globaldevtools.bbva.com:5000/aso/es/aso-image-es:5.10.4.12

Configuracion del ambiente

santodechaveez — 2024-09-25 13:25:09 UTC

Para configurar el ambiente, se debe descargar el archivo de propiedades de este. Debido a esto se debe, mediante consola de comandos, ejecutar el comando Docker: (Esto debe ejecutarse dentro de algun directorio o en el mismo ASO_LOCAL)

• docker cp asoLocal:/app/ctqsrv01/online/database/BackupProperties_localhost.xml .

*En el archivo se debe incluir la librería “ccol_commons” al final, como servicio. Esta librería tiene definiciones generales como ENUM, paginados y elementos transversales que se utilizan en lo servicios de Colombia. Para ello se debe agregar el fragmento de codigo que se encuentra e la primera imagen.

Configuracion archivo xml y .jar

santodechaveez — 2024-09-25 14:09:47 UTC

*Al finalizar las modificaciones sobre el archivo de configuración XML, se debe guardar los cambios y subir el archivo nuevamente al servidor.

Para ello se debe mediante consola de comandos, ingresar a la ruta donde está el archivo y ejecutar el siguiente comando:

• docker cp BackupProperties_localhost.xml asoLocal:/app/ctqsrv01/online/database

*Después de configurar la nueva librería en el ambiente Local, se debe cargar el archivo JAR que contiene sus clases. Para ello desde consola de comandos, se debe acceder a la ruta donde está el compilado y ejecutar el siguiente comando:

• aso deploy ccol_commons.jar servicios asoLocal

*Para que se reflejen los cambios se debe reiniciar la imagen ejecutando en consola el comando: • aso restart asoLocal

Respuesta postman

santodechaveez — 2024-09-25 14:16:15 UTC

Para validar que el servidor local está arriba, se inicia y se accede a la siguiente url en el navegador: http://<<localhost o la ip de acceso aDocker>>:7500/TechArchitecture/grantingTickets/V02?_wadlPor ejemplo,http://192.168.99.100:7500/TechArchitecture/grantingTickets/V02?_wadl

Debe entrar la respuesta que se encuentra en pantalla

GRACIAS

santodechaveez — 2024-09-25 16:15:45 UTC

Estructura para creacion de servicios ASO

santodechaveez — 2024-09-25 16:18:34 UTC

Configuracion inicial

santodechaveez — 2024-09-25 16:44:08 UTC

Normalmente, al momento de crear el componente se utilizan los siguientes datos:

• Name: Nombre del repositorio asignado, para este ejemplo nos asignaron: hubpaymentscardholderauthenticationv1

• GroupId: Se coloca fijo “com.bbva.” y se le une la UUAA y el repositorio sin el número de la versión. Para este caso sería: com.bbva.ccol.hubpaymentscardholderauthentication

• ArtifactId: Su valor es uuaa_nombre repositorio. Para este caso es: ccol_hubpaymentscardholderauthenticationv1

• Version: se coloca por defecto 1.0.0

Configuracion Maven

santodechaveez — 2024-09-25 16:48:16 UTC

Antes de inciar con el desarollo Se debe configurar Maven en la esquina superior derecha en setting y configurar las siguientes variables:

• Maven home path: D:\ASO_LOCAL\Maven-3.0.3

• User settings file: D:\ASO_LOCAL\Maven-3.0.3\conf\settings.xml

• Local repository: D:\ASO_LOCAL\M2_REPO