Personalizar o plano de migração de servidores JBoss

Revise o arquivo do plano de migração gerado ao criar a migração. Personalize o arquivo antes de realizar a migração. Os detalhes do plano de migração são usados para extrair os artefatos de contêiner da carga de trabalho da origem.

Nesta seção, você verá uma descrição do conteúdo da migração e dos tipos de personalização disponíveis antes de executar a migração e gerar artefatos de implantação.

Antes de começar

Neste documento, consideramos que você já criou uma migração e tem o arquivo do plano de migração.

Editar o plano de migração

Depois de copiar o sistema de arquivos e analisá-lo, encontre o plano de modernização no novo diretório criado no caminho de saída especificado: ANALYSIS_OUTPUT_PATH/config.yaml.

Edite o plano de migração conforme necessário e salve as alterações.

Estrutura do plano de migração

O plano de migração de uma carga de trabalho do JBoss tem a estrutura a seguir, que pode ser personalizada conforme descrito nas próximas seções.

# Server name. Edit this to change the artifacts naming.
serverName: jboss-server
# JBoss home directory.
home: /opt/jboss/wildfly
# Parent Wildfly image for the generated container image.
fromImage: docker.io/jboss/wildfly:10.1.0.Final
# JBoss home directory in the target image.
targetImageHome: /opt/wildfly
# Configuration file path from source VM.
configurationFile: /opt/jboss/wildfly/standalone/configuration/standalone.xml
# Ports list to expose on the generated container image.
ports:
- name: management-http
  port: 9990
- name: management-https
  port: 9993
- name: ajp
  port: 8009
- name: http
  port: 8080
- name: https
  port: 8433
- name: txn-recovery-environment
  port: 4712
- name: txn-status-manager
  port: 4713
# List of deployments files to copy.
deployments:
  directory: /opt/jboss/wildfly/standalone/deployments
  applications:
  - test.war
# List of modules to copy in rsync filter format.
# Note: files under '/system/layers/base/' are JBoss/Wildfly binaries and should be copied only if they have been modified.
modules:
- '- system/layers/base'
# External paths required for running the JBoss server or apps.
additionalFiles: []
# Sensitive data which is filtered out of the container image.
# If includeSensitiveData is set to true the sensitive data is mounted on the container.
sensitiveData:
  includeSensitiveData: false
  sensitiveDataPaths:
  - /opt/jboss/wildfly/standalone/configuration/application-roles.properties
  - /opt/jboss/wildfly/standalone/configuration/application-users.properties
  - /opt/jboss/wildfly/standalone/configuration/application.keystore
  - /opt/jboss/wildfly/standalone/configuration/mgmt-groups.properties
  - /opt/jboss/wildfly/standalone/configuration/mgmt-users.properties

Para adicionar informações conforme necessário, analise os detalhes do plano de migração e os comentários de orientação.

Mais especificamente, considere editar as seguintes seções:

Especificar a imagem do Docker

No plano de migração, geramos uma tag de imagem da comunidade do Docker com base na versão do JBoss. A versão do JBoss é detectada e convertida em uma versão principal (versões secundárias não são compatíveis). Se não detectarmos uma versão do JBoss, o fromImage conterá uma string vazia.

No plano de migração, o campo fromImage representa a tag de imagem do Docker usada como base da imagem do contêiner.

As versões originais do JBoss detectadas na VM de origem estão contidas em discovery-report.yaml, que é gerado pela descoberta inicial.

Se você quiser alterar a imagem da comunidade do Docker ou fornecer sua própria imagem do Docker, modifique a tag fromImage no plano de migração usando o seguinte formato:

# Parent Wildfly image for the generated container image.
 fromImage: docker.io/jboss/wildfly:10.1.0.Final

O campo targetImageHome especifica o caminho do diretório inicial do JBoss na imagem de destino e é derivado do campo fromImage. Não é necessário alterar o valor desse campo, a menos que você use uma imagem JBoss com um valor inicial diferente.

Especificar aplicativos

Para excluí-los da imagem do contêiner, remova-os da lista.

Especificar módulos

A lista module contém os módulos JBoss atuais marcados com um sinal de adição ou subtração. Somente os módulos marcados com um sinal de adição serão adicionados à imagem de contêiner gerada. Os módulos marcados com um sinal de subtração, por exemplo, (/system/layers/base), já estão presentes na imagem da comunidade e não serão substituídos, a menos que você os marque novamente com um sinal de adição.

Configurar a migração de dados confidenciais

Para fazer upload de dados confidenciais no repositório, defina o campo includeSensitiveData no plano de migração como true. Os secrets são enviados em secrets.yaml

O campo sensitiveDataPaths especifica as listas de arquivos a serem filtrados do plano de migração. Esses arquivos podem conter informações confidenciais, como certificados, armazenamento de secrets, usuários e senhas usados pelo JBoss. Se você remover um caminho de arquivo do campo sensitiveDataPaths, o arquivo será enviado para a imagem.

A seguir