Menyiapkan dan mengakses Mainframe Assessment Tool

Halaman ini menjelaskan cara menyiapkan dan mengakses Mainframe Assessment Tool. Mainframe Assessment Tool dapat di-deploy sebagai instance virtual machine (VM), atau di cluster Google Kubernetes Engine. Anda hanya dapat mengupgrade instance Mainframe Assessment Tool yang di-deploy sebagai instance VM.

Setelah men-deploy Mainframe Assessment Tool, Anda dapat terhubung dan berinteraksi dengan antarmuka pengguna grafis berbasis web untuk menganalisis aplikasi mainframe Anda.

Sebelum memulai

Selesaikan langkah-langkah untuk bersiap melakukan penemuan dan penilaian.

Opsi 1: Siapkan instance VM Mainframe Assessment Tool

Untuk menyiapkan instance VM Mainframe Assessment Tool, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, klik Activate Cloud Shell.

   Buka Google Cloud konsol

2. Untuk membuat instance VM Mainframe Assessment Tool, jalankan perintah berikut:

   gcloud compute instances create mainframe-assessment-tool-1-instance \
     --machine-type=MACHINE_TYPE \
     --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com  \
     --scopes=cloud-platform --image-project=migrate-modernize-public \
     --image-family=mainframe-assessment-tool --zone=ZONE \
     --boot-disk-size=DISK_SIZE
   

   Ganti kode berikut:

   • MACHINE_TYPE: jenis mesin VM.
   • SERVICE_ACCOUNT_NAME: nama akun layanan khusus yang Anda buat.
   • PROJECT_ID: Google Cloud project ID Anda.
   • DISK_SIZE: ukuran boot disk.
   • ZONE: zona tempat Anda ingin membuat VM. Semua zona di lokasi endpoint model Google didukung.

   Gunakan tabel berikut untuk menentukan nilai MACHINE_TYPE dan DISK_SIZE berdasarkan ukuran data penilaian yang diharapkan.

   Ukuran file zip penilaian	MACHINE_TYPE	DISK_SIZE
   Lebih kecil dari 5 MB	e2-standard-4	100 GB
   Antara 5 MB dan 50 MB	e2-standard-8	100 GB
   Lebih besar dari 50 MB, atau beberapa penilaian secara paralel	e2-highmem-16	300GB

   Jika Anda telah mengonfigurasi firewall di project untuk mengizinkan tunnel IAP hanya untuk VM dengan tag jaringan tertentu, Anda juga dapat menambahkan tag jaringan menggunakan flag --tags. Contoh, --tags=assessment-iap.

   Jika project Anda sudah memiliki penyiapan Cloud NAT yang berfungsi, tambahkan flag --no-address ke perintah gcloud yang membuat VM.

Mengakses VM Mainframe Assessment Tool dari komputer Anda

Anda dapat mengakses Mainframe Assessment Tool dari komputer berbasis Linux, macOS, atau Windows menggunakan Google Cloud CLI melalui tunnel Identity-Aware Proxy.

Untuk membuat tunnel terenkripsi ke port instance VM Mainframe Assessment Tool, jalankan perintah berikut:

   gcloud compute start-iap-tunnel VM_NAME 4000 --zone=ZONE \
     --local-host-port=localhost:LOCAL_PORT --project=PROJECT_ID

Ganti kode berikut:

• VM_NAME: nama VM.
• ZONE: zona VM.
• LOCAL_PORT: nomor port apa pun di mesin lokal yang ingin Anda gunakan untuk koneksi yang di-tunnel ke Mainframe Assessment Tool.
• PROJECT_ID: project ID project VM.

Google Cloud CLI melakukan uji konektivitas dengan instance VM, lalu membuka tunnel dan menampilkan nomor port sebagai berikut:

   Listening on port 6060.

Semua traffic yang dikirim ke localhost:LOCAL_PORT diteruskan ke instance VM Mainframe Assessment Tool. Port hanya dapat diakses oleh aplikasi yang berjalan di komputer lokal Anda.

Untuk mengakses Mainframe Assessment Tool dari komputer lokal, buka browser web dan buka localhost:LOCAL_PORT.

Opsi 2: Men-deploy Mainframe Assessment Tool di cluster GKE

Untuk men-deploy Mainframe Assessment Tool di cluster GKE, ikuti langkah-langkah berikut:

1. Di Google Cloud konsol, klik Activate Cloud Shell.

   Buka Google Cloud konsol

2. Aktifkan Google Kubernetes Engine API untuk project Google Cloud Anda.

3. Jika cluster GKE belum ada di project Anda, buat cluster GKE dan pastikan kumpulan identitas beban kerja dikonfigurasi.

   Untuk membuat cluster GKE, jalankan perintah berikut:

     gcloud container clusters create CLUSTER_NAME \
     --project=PROJECT_ID \
     --zone=ZONE \
     --machine-type=MACHINE_TYPE \
     --enable-ip-alias \
     --release-channel="stable" \
     --workload-pool=PROJECT_ID.svc.id.goog \
     --disk-size=DISK_SIZE
   

   Ganti kode berikut:

   • CLUSTER_NAME: nama cluster GKE baru
   • PROJECT_ID: Google Cloud project ID Anda.
   • MACHINE_TYPE: jenis mesin setiap node.
   • ZONE: zona tempat Anda ingin membuat cluster. Semua zona di lokasi endpoint model Google didukung.

   • DISK_SIZE: ukuran boot disk.

     Gunakan tabel berikut untuk menentukan nilai MACHINE_TYPE dan DISK_SIZE berdasarkan ukuran data penilaian yang diharapkan:

     Ukuran file zip penilaian	MACHINE_TYPE	DISK_SIZE
     Lebih kecil dari 5 MB	e2-standard-4	100 GB
     Antara 5 MB dan 50 MB	e2-standard-8	100 GB
     Lebih besar dari 50 MB, atau beberapa penilaian secara paralel	e2-highmem-16	300GB

4. Aktifkan Workload Identity Federation for GKE di cluster dan node pool.

   Catatan: Di GKE Autopilot, Workload Identity Federation selalu diaktifkan.

5. Di lingkungan Anda, buat direktori untuk skrip deployment:

   mkdir DESTINATION_DIRECTORY
   

   Ganti DESTINATION_DIRECTORY dengan nama untuk direktori.

6. Untuk mendownload skrip deployment, jalankan perintah berikut:

   gcloud storage cp "gs://mainframe-ai-release/mat/VERSION/kustomize_deployment.zip" DESTINATION_DIRECTORY
   

   Ganti kode berikut:

   • VERSION: versi Mainframe Assessment Tool yang ingin Anda instal, misalnya, mainframe-assessment-2-8-0.
   • DESTINATION_DIRECTORY: direktori tujuan di komputer tempat skrip didownload.

7. Untuk mengikat akun layanan Google Cloud (GSA) ke akun layanan Kubernetes (KSA), jalankan perintah berikut:

   gcloud iam service-accounts add-iam-policy-binding \
   SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
   --role="roles/iam.workloadIdentityUser" \
   --member="serviceAccount:PROJECT_ID.svc.id.goog[VERSION/mat-service-account]"
   

   Ganti kode berikut:

   • PROJECT_ID: Google Cloud project ID Anda.
   • VERSION: versi Mainframe Assessment Tool, misalnya, mainframe-assessment-2-8-0.

8. Berikan izin baca, tulis, dan eksekusi pada direktori tujuan:

   chmod -R u+rwx DESTINATION_DIRECTORY
   

9. Ekstrak skrip yang didownload:

   cd DESTINATION_DIRECTORY && unzip kustomize_deployment.zip
   

   Ganti DESTINATION_DIRECTORY dengan direktori tempat Anda mendownload skrip deployment.

10. Untuk membuat container dan men-deploy Mainframe Assessment Tool, jalankan perintah berikut:

    ./deploy.sh PROJECT_ID ZONE \
    CLUSTER_NAME VERSION \
    us-docker.pkg.dev/migrate-modernize-public/mainframe-assessment-prod \
    SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
    

Kontainer akan beroperasi dalam beberapa menit.

Mengakses Mainframe Assessment Tool yang di-deploy di GKE dari komputer Anda

Anda dapat mengakses Mainframe Assessment Tool dari komputer Linux, macOS, atau Windows dengan menggunakan perintah kubectl untuk mengonfigurasi penerusan port.

Untuk membuat penerusan port terenkripsi, ikuti langkah-langkah berikut:

1. Untuk mengonfigurasi akses ke cluster, jalankan perintah berikut:

   gcloud container clusters get-credentials CLUSTER_NAME \
    --zone ZONE --project PROJECT_ID
   

2. Untuk mengonfigurasi penerusan port, jalankan perintah berikut:

   kubectl port-forward service/assessor-frontend LOCAL_PORT:4000 -n VERSION
   

   Ganti kode berikut:

   • LOCAL_PORT: nomor port di komputer lokal Anda yang digunakan untuk koneksi yang di-tunnel ke Mainframe Assessment Tool. Sebaiknya gunakan 8080, 8000, atau 3000. Jika port ini tidak tersedia, gunakan nomor port yang lebih tinggi dari 1024, misalnya, 3001.
   • VERSION: versi Mainframe Assessment Tool yang di-deploy di cluster GKE.

Langkah berikutnya

• Pelajari cara mengonfigurasi setelan untuk Mainframe Assessment Tool.