Tiempo aproximado de lectura: 00:08:00 min
Duda: ¿Cómo habilitar el migrador para un nuevo producto?
Ambiente: Cloud - Línea T-Cloud - Todas las versiones
Solución: Para habilitar el migrador para un nuevo producto, siga los siguientes pasos:
Para habilitar el migrador, será necesario crear un nuevo registro de migración a través del menú Administración\Aprovisionamiento\Registro de Templates.
Para registrar un nuevo template, se debe ingresar la siguiente información:
migration_catalog: Cadena de texto (String) que contiene un identificador único que será el código del catálogo de migración.
enabled: Habilita el catálogo de migración para que se muestre en la lista de catálogos de la pantalla de registro de migración.
user_id: Arreglo (Array) de usuarios que serán responsables del mantenimiento de este template.
so: Sistema operativo del producto.
produto: Producto en el que se utilizará el catálogo. Este campo añade el producto a la selección presentada en la pantalla de registro de migración.
- description: Descripción del catálogo de migración. Este campo añade la descripción del catálogo a la selección presentada en la pantalla de registro de migración.
application: Arreglo de diccionarios con los campos que se presentarán para cargar los artefactos del producto. El diccionario de este campo posee las siguientes claves:
application_type: Código que se enviará en el script en la instancia para identificar el tipo de artefacto correspondiente al enlace de descarga.
label: Descripción presentada en la pantalla de registro del migrador.
structure_validation: Arreglo con la estructura de carpetas para validar dentro del archivo .zip (acepta comodines/wildcards).
database: Arreglo de bases de datos que se presentarán para cargar el backup de la base de datos.
database_type: Código de la base de datos.
label: Descripción presentada en la pantalla de registro del migrador.
structure_validation: Arreglo con la estructura de carpetas para validar dentro del archivo .zip (acepta comodines/wildcards).
platform: Campo utilizado en la migración de Datasul para identificar si el backup de la base de datos fue generado a partir de una instancia Linux o Windows.
payload_script_database_pre: Payload de la acción previa a la importación de datos de la base de datos. La estructura de este payload es la misma que se utiliza en las demás acciones de instancias configuradas en T-Cloud.
payload_script_database_pos: Payload de la acción posterior a la importación de datos de la base de datos. La estructura de este payload es la misma que se utiliza en las demás acciones de instancias configuradas en T-Cloud.
payload_script_migration: Payload a ser utilizado en el paso (step) de ejecución de scripts en la topología que está recibiendo la acción de migración de la aplicación. La estructura de este payload es la misma que se utiliza en las demás acciones de instancias configuradas en T-Cloud.
checklist_files: Arreglo con los ítems del checklist que se presentarán al usuario antes de mostrar la pantalla de carga de archivos. Este checklist solo se presentará en el flujo del Evento Comercial de Migración.
label: Descripción del ítem del checklist que se presentará en T-Cloud.
link: Enlace de TDN, o de otra página, que contenga la documentación referente al ítem del checklist. Este campo es opcional y, en caso de ser informado, se añadirá al ítem del checklist mediante un hipervínculo al final de su descripción con el texto "Más información".
type: Identificador del ítem del checklist.
checklist_homolog: Arreglo con los ítems del checklist que se presentarán al usuario después de la migración de los datos, para que el cliente verifique los elementos que deben ser validados antes de programar el go-live para la migración. Este checklist solo se presentará en el flujo del Evento Comercial de Migración.
label: Descripción del ítem del checklist que se presentará en T-Cloud.
link: Enlace de TDN, o de otra página, que contenga la documentación referente al ítem del checklist. Este campo es opcional y, en caso de ser informado, se añadirá al ítem del checklist mediante un hipervínculo al final de su descripción con el texto "Más información".
type: Identificador del ítem del checklist.
Los datos de payload mencionados anteriormente se utilizan en los pipelines generados para la importación de datos de la aplicación y de la base de datos.
Detalles de la acción de importación de datos migrados de la aplicación:
El pipeline de importación de datos migrados de la aplicación posee el siguiente diagrama de ejecución:
1- Control de la cola de la acción.
2- Cambio de puertos informados en la aplicación on-premise, en caso de que se modifique algún puerto en el momento de aplicar la migración.
3- Ejecución de la acción registrada en la chavepayload_script_migrationdo del template de migración.
Los scripts registrados en la lista de comandospayload_script_migration recibirán como argumento una lista de los artefactos registrados en la migración en la clave "download_info".
Ejemplo de payload recibido por los scripts:
{
"download_info": [{
"application_type": "bin",
"filename": "bin.zip",
"migration_id": 917
}, {
"application_type": "protheus_data",
"filename": "protheus_data.zip",
"migration_id": 917
}, {
"application_type": "rpo",
"filename": "rpo.zip",
"migration_id": 917
}, {
"application_type": "ini",
"filename": "ini.zip",
"migration_id": 917
}]
}
Con esta información, será posible recuperar la URL prefirmada para la descarga de cada archivo llamando a la siguiente API de T-Cloud:
POSThttps://api-tcloud.fluig.cloudtotvs.com.br/prod/customer/{ccode}/topology/{topology_id}/migration/{migration_id}/get-application-presign-url/{type}
Obs.: Es necesario enviar en el body de esta API las claves "topology_api_key" y "topology_api_secret".
Ejemplo de retorno:
Ejemplo de payload recibido por los scripts
Detalle de la acción de importación de datos migrados de Base de Datos
Ejemplo de un catálogo de migración:
{
"migration_catalog": "protheus_windows_teste",
"application": [
{
"application_type": "bin",
"label": "Binários",
"structure_validation": [
"appserver/appserver.exe",
"appserver/dbapi.dll",
"dbaccess/dbaccess*.exe",
"dbaccess/dbapi.dll",
"dbaccess/dbaccess64.dll",
"smartclient/smartclient.exe"
]
},
.
.
.
],
"database": [
{
"database_type": "mssql",
"label": "Microsoft SQL Server",
"structure_validation": [
"dump/*.bak"
]
},
{
"database_type": "oracle",
"label": "Oracle"
}
],
"description": "Catalogo de Migração para o Protheus Windows",
"enabled": true,
"payload_script_database_pre": {
"cmd_list": [
{
"cmd": "protheus_stop_all.ps1",
"instance_type": [
"core_instance",
"protheus_special"
],
"timeout": 900
},
.
.
.
]
},
"payload_script_migration": {
"cmd_list": [
{
"cmd": "protheus_download_migration_files.ps1",
"instance_type": [
"core_instance"
],
"timeout": 14400
},
.
.
.
]
},
"payload_script_database_pos": {
"cmd_list": [
{
"cmd": "protheus_start_all.ps1",
"instance_type": [
"core_instance",
"protheus_special"
],
"timeout": 900
},
.
.
.
]
},
"product": "protheus",
"so": "windows",
"user_id": ["claudio.lourenco@totvs.com.br"],
"checklist_files": [
{
"label": "Você verificou XYZ?",
"link": "https://tdn.totvs.com.br/pages/viewpage.action?pageId=709420892",
"type": "ID123"
},
.
.
.
],
"checklist_homolog": [
{
"label": "Você verificou XYZ?",
"link": "https://tdn.totvs.com.br/pages/viewpage.action?pageId=709420892",
"type": "ID123"
},
.
.
.
]
}
0 Comentários