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 digunakan untuk mengekstrak artefak penampung beban kerja 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 paket migrasi

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

Edit rencana migrasi seperlunya dan simpan perubahannya.

Struktur paket 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 paket migrasi dan panduan komentar Anda.

Secara khusus, pertimbangkan untuk mengedit bagian berikut.

Menentukan image Docker

Pada rencana migrasi, kami 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 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 gambar JBoss dengan nilai beranda 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 dibuat. Modul yang ditandai dengan tanda minus, misalnya, (/system/layers/base) sudah ada dalam image komunitas, dan tidak akan ditimpa, kecuali jika Anda menandainya ulang dengan tanda plus.

Mengonfigurasi migrasi data sensitif

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

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

Langkah selanjutnya