Menyesuaikan rencana migrasi untuk server JBoss

Anda harus meninjau file rencana migrasi yang dihasilkan dari pembuatan migrasi. Sesuaikan file sebelum menjalankan migrasi. Detail rencana migrasi Anda digunakan untuk mengekstrak artefak penampung workload dari sumber.

Bagian ini menjelaskan konten migrasi dan jenis penyesuaian yang dapat Anda pertimbangkan sebelum menjalankan migrasi dan membuat artefak deployment.

Sebelum memulai

Dokumen ini mengasumsikan bahwa Anda telah membuat migrasi dan memiliki file rencana migrasi.

Mengedit rencana migrasi

Setelah menyalin sistem file dan menganalisisnya, Anda dapat menemukan rencana migrasi di direktori baru yang dibuat di jalur output yang ditentukan: ANALYSIS_OUTPUT_PATH/config.yaml.

Edit rencana migrasi sesuai kebutuhan dan simpan perubahan.

Struktur rencana migrasi

Rencana migrasi untuk beban kerja JBoss memiliki struktur berikut, yang dapat Anda sesuaikan seperti yang dijelaskan di bagian berikut.

# 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

Untuk menambahkan informasi sesuai kebutuhan, tinjau detail rencana migrasi dan komentar panduan Anda.

Secara khusus, pertimbangkan pengeditan di sekitar bagian berikut.

Menentukan image Docker

Pada rencana migrasi, kita membuat tag image komunitas Docker berdasarkan versi JBoss. Versi JBoss terdeteksi dan dikonversi ke versi utama (versi minor tidak didukung). Jika kita gagal mendeteksi versi JBoss, fromImage akan berisi string kosong.

Pada rencana migrasi, kolom fromImage mewakili tag Image Docker yang digunakan sebagai dasar image container.

Versi JBoss asli yang terdeteksi di VM sumber terdapat dalam discovery-report.yaml yang dihasilkan oleh penemuan awal.

Jika ingin mengubah image komunitas Docker, atau menyediakan image docker Anda sendiri, Anda dapat mengubah tag fromImage dalam rencana migrasi menggunakan format berikut:

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

Kolom targetImageHome menentukan jalur direktori utama JBoss dalam image target, dan berasal dari kolom fromImage. Anda tidak perlu mengubah nilai kolom ini kecuali jika Anda menggunakan image JBoss dengan nilai rumah JBoss yang berbeda.

Menentukan aplikasi

Untuk mengecualikan aplikasi dari image container, hapus aplikasi tersebut dari daftar aplikasi.

Menentukan modul

Daftar module berisi daftar modul JBoss yang ada yang ditandai dengan tanda plus atau minus. Hanya modul yang ditandai dengan tanda plus yang akan ditambahkan ke image penampung yang dihasilkan. Modul yang ditandai dengan tanda minus, misalnya, (/system/layers/base) sudah ada dalam gambar komunitas, dan tidak akan ditimpa kecuali jika Anda menandainya ulang dengan tanda plus.

Mengonfigurasi migrasi data sensitif

Untuk mengupload data sensitif ke repositori, Anda perlu menetapkan kolom includeSensitiveData pada rencana migrasi ke true. Secret diupload di secrets.yaml.

Kolom sensitiveDataPaths menentukan daftar file yang akan difilter dari rencana migrasi. File ini mungkin berisi informasi sensitif seperti sertifikat, secret store, pengguna, dan sandi yang digunakan oleh JBoss. Jika Anda menghapus jalur file dari kolom sensitiveDataPaths, file akan diupload ke gambar.

Langkah selanjutnya