Cloud - Linha T-Cloud - Habilitando o migrador para um novo produto

Tempo aproximado para leitura: 00:08:00 min

Dúvida
Como habilitar o migrador para um novo produto?

Ambiente
Cloud - Linha T-Cloud - Todas as versões

Solução
Para habilitar o migrador para um novo produto, siga os passos a seguir:

Para habilitar o migrador, será necessário criar um novo cadastro de migração através do menu Administração\Provisionamento\Cadastro de Templates

Neste cadastro, acesse a aba "Catálogo de Migração"

Para cadastrar um novo template, as seguintes informações devem ser informadas:

• migration_catalog:String contendo um identificador único que será o código do catálogo de migração. 
• enabled:Habilita catálogo de migração para ser exibido na listagem de catálogos da tela de cadastro de migração
• user_id:Array de usuários que serão responsáveis pela manutenção deste template
• so:Sistema operacional do produto
• produto:Produto em que o catálogo será utilizado. Este campo adiciona o produto na seleção apresentada na tela de cadastro de migração

• description:Descrição do catálogo de migração. Este campo adiciona a descrição do catálogo na seleção apresentada na tela de cadastro de migração

• application:Array de dicionários com os campos que serão apresentados para subir os artefatos do produto. O dicionário deste campo possui as seguintes chaves:
  - application_type:Código que será enviado no script na instância para identificar o tipo de artefato correspondente ao link de download
  - label:Descrição apresentada na tela de cadastro do migrador
  -structure_validation:Array com estrutura de pastas para validar dentro do arquivo .zip (aceita wildcard)

• database:Array de bancos que serão apresentados para subir o backup do banco
  - database_type:Código do banco
  - label:Descrição apresentada na tela de cadastro do migrador
  -structure_validation:Array com estrutura de pastas para validar dentro do arquivo .zip(aceita wildcard)
  -platform:Campo utilizado na migração do Datasul para identificar se o backup do banco foi gerado a partir de uma instância Linux ou Windows

• payload_script_database_pre:Payload de ação pré importação de dados do banco. A estrutura deste payload é a mesma utilizadas nas demais ações de instâncias configuradas no TCloud
• payload_script_database_pos: Payload de ação pós importação de dados do banco. A estrutura deste payload é a mesma utilizadas nas demais ações de instâncias configuradas no TCloud
• payload_script_migration:Payload a ser utilizado no step de execução de scripts na topologia que está recebendo a ação de migração de aplicação. A estrutura deste payload é a mesma utilizadas nas demais ações de instâncias configuradas no TCloud
• checklist_files: Array com os itens de checklist que serão apresentados para o usuário antes de apresentar a tela de upload de arquivos. Este checklist só será apresentado no fluxo doEvento Comercial Migração

-label: Descrição do item de checklist que será apresentado no TCloud 

-link: Link do TDN, ou de outra página, que contenha a documentação referente ao item de checklist. Este campo é opcional e, caso seja informado, será adicionado ao item do checklist em um hyperlink no final de sua descrição com o texto "Saiba mais"

-type: Identificador do item de checklist

• checklist_homolog: Array com os itens de checklist que serão apresentados para o usuário após migração dos dados para que o cliente verifique os itens que devem ser validados antes de agendar o golive para migração. Este checklist só será apresentado no fluxo doEvento Comercial Migração

-label: Descrição do item de checklist que será apresentado no TCloud 

-link: Link do TDN, ou de outra página, que contenha a documentação referente ao item de checklist. Este campo é opcional e, caso seja informado, será adicionado ao item do checklist em um hyperlink no final de sua descrição com o texto "Saiba mais"

-type: Identificador do item de checklist

Os dados de payload acima são usados nos pipelines gerados de importação de dados da aplicação e do banco

{
"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
    }]
}

{
"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"
},
.
.
.
] 
}