Tutorial: Putar ulang dan bandingkan dalam Pengujian Aplikasi Modernisasi AWS Mainframe menggunakan CardDemo untuk AWS Blu Age yang digunakan di Amazon EC2 - AWS Modernisasi Mainframe
Langkah 1: Dapatkan Gambar Mesin Amazon EC2 Amazon AWS Blu Age (AMI)Langkah 2: Mulai EC2 instance Amazon menggunakan AWS Blu Age AMILangkah 3: Unggah file CardDemo dependen ke S3Langkah 4: Muat database dan inisialisasi aplikasi CardDemoLangkah 5: Luncurkan runtime AWS Blu Age CloudFormationLangkah 6: Menguji instans Amazon AWS EC2 Blu AgeLangkah 7: Validasi langkah-langkah sebelumnya telah diselesaikan dengan benarLangkah 8: Buat kasus ujiLangkah 9: Buat test suiteLangkah 10: Buat konfigurasi lingkungan pengujianLangkah 11: Unggah data masukan Anda di test suiteLangkah 12: Putar ulang dan bandingkan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Putar ulang dan bandingkan dalam Pengujian Aplikasi Modernisasi AWS Mainframe menggunakan CardDemo untuk AWS Blu Age yang digunakan di Amazon EC2

Dalam tutorial ini, Anda akan menyelesaikan langkah-langkah yang diperlukan untuk memutar ulang dan membandingkan beban kerja pengujian dengan CardDemo aplikasi yang berjalan di AWS Blu Age yang digunakan di Amazon. EC2

Langkah 1: Dapatkan Gambar Mesin Amazon EC2 Amazon AWS Blu Age (AMI)

Ikuti petunjuk dalam tutorial Pengaturan AWS Blu Age Runtime (di Amazon EC2) untuk langkah-langkah orientasi yang diperlukan untuk mendapatkan akses ke AWS Blu Age di Amazon AMI. EC2

Langkah 2: Mulai EC2 instance Amazon menggunakan AWS Blu Age AMI

  1. Siapkan AWS kredensyal Anda.

  2. Identifikasi lokasi file biner Amazon EC2 AMI 3.5.0 (hanya AWS CLI/versi Blu Age) dari bucket Amazon S3:

    aws s3 ls s3://aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1/
aws s3 ls s3://aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1/3.5.0/AMI/
    catatan

    Fitur Pengujian Aplikasi hanya tersedia untuk digunakan di 4 wilayah di prod (us-east-1, sa-east-1, eu-central-1 dan ap-southeast-2).

  3. Kembalikan AMI di akun Anda dengan perintah berikut:

    aws ec2 create-restore-image-task --object-key 3.5.0/AMI/ami-0182ffe3b9d63925b.bin --bucket aws-bluage-runtime-artifacts-xxxxxxx-eu-west-1 --region eu-west-1 --name "AWS BLUAGE RUNTIME AMI"
    catatan

    Ganti nama file bin AMI dan Wilayah tempat Anda ingin membuat AMI.

  4. Setelah membuat EC2 instans Amazon, Anda dapat menemukan ID AMI yang benar yang dipulihkan AMI dari bucket Amazon S3 di katalog EC2 gambar Amazon.

    catatan

    Dalam tutorial ini, ID AMI adalah ami-0d0fafcc636fd1e6d, dan Anda harus mengubah ID ini di file konfigurasi yang berbeda dengan yang diberikan kepada Anda.

    1. Jika aws ec2 create-restore-image-task gagal, periksa versi Python dan CLI Anda menggunakan perintah berikut:

      aws --version
      catatan

      Versi Python harus> = 3 dan versi CLI harus> = 2.

    2. Jika versi ini sudah usang, CLI harus diperbarui. Untuk memperbarui CLI:

      1. Ikuti petunjuk di Instal atau perbarui AWS CLI versi terbaru.

      2. Hapus CLI v1 dengan perintah berikut:

        sudo yum remove awscli

      3. Dan instal CLI v2 dengan perintah berikut:

        curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

      4. Terakhir, periksa versi Python dan CLI dengan perintah berikut:

        aws --version

    3. Anda kemudian dapat mengulang aws create-restore-image-task ec2.

Langkah 3: Unggah file CardDemo dependen ke S3

Salin konten folder database, file-system, dan userdata. Unduh dan unzip CardDemo aplikasi. Ketiga folder ini harus disalin ke salah satu bucket Anda yang disebut amzn-s3-demo-bucket dalam dokumentasi ini.

Langkah 4: Muat database dan inisialisasi aplikasi CardDemo

Buat EC2 instance Amazon sementara yang akan Anda gunakan sebagai sumber daya komputasi untuk menghasilkan snapshot database yang diperlukan untuk aplikasi. CardDemo EC2 Instance ini tidak akan menjalankan CardDemo aplikasi itu sendiri, melainkan menghasilkan snapshot database yang akan digunakan nanti.

Mulailah dengan mengedit CloudFormation template yang disediakan bernama 'load-and-create-ba-snapshots.yml'. Ini adalah CloudFormation template yang digunakan untuk membuat EC2 instance Amazon yang digunakan untuk menghasilkan snapshot database.

  1. Hasilkan dan berikan EC2 key pair Anda yang akan digunakan untuk EC2 instance tersebut. Untuk informasi selengkapnya, lihat Membuat pasangan kunci.

    Contoh:

    Ec2KeyPair:
    Description: 'ec2 key pair'
    Default: 'm2-tests-us-west-2'
    Type: String

  2. Tentukan jalur Amazon S3 dari folder Anda tempat Anda meletakkan folder database dari langkah sebelumnya:

    S3DBScriptsPath:
    Description: 'S3 DB scripts folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/databases'

  3. Tentukan jalur Amazon S3 dari folder Anda tempat Anda meletakkan folder sistem file dari langkah sebelumnya:

    S3ApplicationFilesPath:
    Description: 'S3 application files folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/file-system'

  4. Tentukan jalur Amazon S3 dari folder Anda tempat Anda meletakkan folder userdata dari langkah sebelumnya:

    S3UserDataPath:
    Description: 'S3 userdata folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/userdata'

  5. Juga tentukan jalur Amazon S3 tempat Anda akan menyimpan file hasil yang akan digunakan pada langkah berikutnya.

    S3SaveProducedFilesPath:
    Description: 'S3 path folder to save produced files'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/post-produced-files'

  6. Ubah ID AMI dengan yang benar diperoleh sebelumnya dalam tutorial ini menggunakan template berikut:

    
  BaaAmiId:
    Description: 'ami id (AL2) for ba anywhere'
    Default: 'ami-0bd41245734fd20d9'
    Type: String

    1. Anda dapat secara opsional mengubah nama tiga snapshot yang akan dibuat dengan menjalankan database beban dengan. CloudFormation Ini akan terlihat di CloudFormation tumpukan saat sedang dibuat dan akan digunakan nanti dalam tutorial ini. Ingatlah untuk mencatat nama yang digunakan untuk snapshot database.

      SnapshotPrimary:
    Description: 'Snapshot Name DB BA Primary'
    Type: String
    Default: 'snapshot-primary'

  SnapshotBluesam:
    Description: 'Snapshot Name DB BA Bluesam'
    Type: String
    Default: 'snapshot-bluesam'

  SnapshotJics:
    Description: 'Snapshot Name DB BA Jics'
    Type: String
    Default: 'snapshot-jics'
      catatan

      Dalam dokumen ini, kami berasumsi bahwa nama snapshot tetap konsisten.

  7. Jalankan CloudFormation dengan CLI atau AWS konsol menggunakan tombol Create Stack dan wizard. Di akhir proses, Anda akan melihat tiga snapshot di konsol RDS dengan nama yang Anda pilih diikuti oleh ID unik. Anda akan membutuhkan nama-nama ini di langkah berikutnya.

    catatan

    RDS akan menambahkan postfix ke nama snapshot yang ditentukan dalam template. AWS CloudFormation Pastikan untuk mendapatkan nama snapshot lengkap dari RDS sebelum melanjutkan ke langkah berikutnya.

    Contoh perintah CLI-

    aws cloudformation create-stack --stack-name load-and-create-ba-snapshots --template-url https://your-apptest-bucket.s3.us-west-2.amazonaws.com/load-and-create-ba-snapshots.yml --capabilities CAPABILITY_NAMED_IAM

    Anda juga dapat memeriksa di jalur Amazon S3 yang Anda berikan untuk S3 SaveProducedFilesPath bahwa kumpulan data telah dibuat dengan benar.

Langkah 5: Luncurkan runtime AWS Blu Age CloudFormation

Gunakan CloudFormation untuk menjalankan EC2 instance Amazon dengan aplikasi CardDemo AWS Blu Age. Anda harus mengganti beberapa variabel dalam CloudFormation nama m2-with-ba-using-snapshots-https-authentication.yml dengan mengedit file YAMM atau dengan memodifikasi nilai di konsol selama peluncuran CFN.

  1. Ubah AllowedVpcEndpointPrincipals untuk menentukan akun mana yang akan mencapai titik akhir VPC untuk mengakses runtime AWS Blu Age, menggunakan perintah berikut:

    AllowedVpcEndpointPrincipals:
    Description: 'comma-separated list of IAM users, IAM roles, or AWS accounts'
    Default: 'apptest.amazonaws.com'
    Type: String

  2. Ubah nilai variabel SnapshotPrimaryDb, SnapshotBlusamDb, dan SnapshotJicsDb ke nama snapshot. Dapatkan juga nama snapshot dari RDS setelah dibuat pada langkah sebelumnya.

    SnapshotPrimary:
    Description: 'Snapshot DB cluster for DB Primary'
    Type: String
    Default: 'snapshot-primary87d067b0'

  SnapshotBluesam:
    Description: 'Snapshot DB cluster for DB Bluesam'
    Type: String
    Default: 'snapshot-bluesam87d067b0'

  SnapshotJics:
    Description: 'Snapshot DB cluster for DB Jics'
    Type: String
    Default: 'snapshot-jics87d067b0'
    catatan

    RDS akan menambahkan postfix sendiri ke nama snapshot.

  3. Berikan EC2 key pair Amazon Anda untuk EC2 instance, menggunakan perintah ini:

    Ec2KeyPair:
    Description: 'ec2 key pair'
    Default: 'm2-tests-us-west-2'
    Type: String

  4. Berikan ID AMI yang telah Anda peroleh selama proses registrasi AMI untuk variabel tersebut BaaAmiId, dengan menggunakan:

    BaaAmiId:
    Description: 'ami id (AL2) for ba anywhere'
    Default: 'ami-0d0fafcc636fd1e6d'
    Type: String

  5. Berikan jalur folder Amazon S3 yang Anda gunakan pada langkah sebelumnya untuk menyimpan file yang dihasilkan, menggunakan perintah berikut:

    S3ApplicationFilesPath:
    Description: 'bucket name'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/post-produced-files'

  6. Terakhir, berikan jalur folder s3-: userdata-folder-path

    S3UserDataPath:
    Description: 'S3 userdata folder path'
    Type: String
    Default: 's3://amzn-s3-demo-bucket/userdata'

    • (Opsional) Anda dapat mengaktifkan mode HTTPS dan otentikasi HTTP dasar untuk tomcat. Meskipun pengaturan default juga akan berfungsi.

      catatan

      Secara default, mode HTTPS dinonaktifkan dan diatur ke mode HTTP dalam parameter BacHttpsMode:

      Misalnya:

      BacHttpsMode:
    Description: 'http or https for Blue Age Runtime connection mode '
    Default: 'http'
    Type: String
    AllowedValues: [http, https]

    • (Opsional) Untuk mengaktifkan mode HTTPS, Anda harus mengubah nilai ke HTTPS dan untuk memberikan ARN sertifikat ACM Anda dengan mengubah nilai variabel Arn: ACMCert

      ACMCertArn:
    Type: String
    Description: 'ACM certificate ARN'
    Default: 'your arn certificate'

    • (Opsional) Otentikasi dasar dinonaktifkan secara default dengan parameter WithBacBasicAuthenticationdisetel ke false. Anda dapat mengaktifkannya dengan menetapkan nilai ke true.

      WithBacBasicAuthentication:
    Description: 'false or true for Blue Age Runtime Basic Authentication '
    Default: false
    Type: String
    AllowedValues: [true, false]

  7. Ketika Anda telah menyelesaikan konfigurasi, Anda dapat membuat tumpukan dengan menggunakan CloudFormation template yang diedit.

Langkah 6: Menguji instans Amazon AWS EC2 Blu Age

Jalankan CloudFormation template secara manual untuk membuat EC2 instance Amazon AWS Blu Age untuk CardDemo aplikasi untuk memastikan bahwa itu dimulai tanpa kesalahan. Hal ini dilakukan untuk memverifikasi bahwa CloudFormation template dan semua prasyarat valid, sebelum menggunakan CloudFormation template dengan fitur Pengujian Aplikasi. Anda kemudian dapat menggunakan Pengujian Aplikasi untuk secara otomatis membuat EC2 instans Amazon AWS Blu Age target selama pemutaran ulang dan perbandingan.

  1. Jalankan perintah CloudFormation create stack untuk membuat EC2 instance Amazon AWS Blu Age, menyediakan template m2- with-ba-using-snapshots CloudFormation -https-authentication.yl yang Anda edit pada langkah sebelumnya:

    aws cloudformation create-stack --stack-name load-and-create-ba-snapshots —-template-url https://apptest-ba-demo.s3.us-west-2.amazonaws.com/m2-with-ba-using-snapshots-https-authentication.yml --capabilities CAPABILITY_NAMED_IAM --region us-west-2
    catatan

    Ingatlah untuk menentukan Wilayah yang benar di mana AMI Zaman AWS Blu dipulihkan.

  2. Pastikan semuanya berfungsi dengan benar dengan melihat di konsol untuk menemukan EC2 instance Amazon yang sedang berjalan. Connect menggunakan Session Manager.

  3. Setelah Anda terhubung ke EC2 instans Amazon, gunakan perintah berikut:

    sudo su
cd /m2-anywhere/tomcat.gapwalk/velocity/logs
cat catalina.log

  4. Pastikan tidak ada pengecualian atau kesalahan dalam log.

  5. Selanjutnya, periksa apakah aplikasi merespons dengan menggunakan perintah ini:

    curl http://localhost:8080/gapwalk-application/

Anda akan melihat pesan, “Aplikasi Jics sedang berjalan.”

Langkah 7: Validasi langkah-langkah sebelumnya telah diselesaikan dengan benar

Dalam beberapa langkah berikutnya, kita akan menggunakan Pengujian Aplikasi Modernisasi AWS Mainframe untuk memutar ulang dan membandingkan kumpulan data yang dibuat oleh aplikasi. CardDemo Langkah-langkah ini bergantung pada keberhasilan penyelesaian semua langkah sebelumnya dalam tutorial ini. Validasi hal-hal berikut sebelum melanjutkan:

  1. Anda telah berhasil membuat EC2 instance AWS Blu Age di Amazon melalui AWS CloudFormation template.

  2. Layanan Tomcat pada Zaman AWS Blu di Amazon EC2 aktif dan berjalan, tanpa kecuali.

Saat menjalankan EC2 instance dengan CardDemo aplikasi, selesaikan langkah-langkah berikut di konsol Pengujian Aplikasi untuk melakukan pemutaran ulang dan membandingkan kumpulan data batch.

Langkah 8: Buat kasus uji

Pada langkah ini, Anda membuat test case yang akan digunakan untuk membandingkan dataset yang dibuat dalam aplikasi Card Demo.

  1. Buat kasus uji baru. Berikan nama dan deskripsi.

  2. Tentukan CREASTMT.JCL sebagai nama JCL.

  3. Tambahkan kumpulan data berikut ke definisi kasus Uji:

    Nama

    CCSID

    RecordFormat

    RecordLength

    AWS.M2.CARDDEMO.STATEMNT.PS

    “037"

    FB

    80

    AWS.M2.CARDDEMO.STATEMNT.HTML

    “037"

    FB

    100
    catatan

    Nama JCL dan detail dataset Anda harus cocok.

Langkah 9: Buat test suite

  1. Buat rangkaian pengujian baru, dan berikan nama dan deskripsi untuknya.

  2. Tambahkan kasus uji yang Anda buat pada langkah sebelumnya ke rangkaian pengujian Anda.

  3. Setelah rangkaian pengujian dibuat, tangkap kasus uji di mainframe, dan unggah data referensi mainframe ke Pengujian AWS Aplikasi.

  4. Pilih Buat rangkaian pengujian.

Langkah 10: Buat konfigurasi lingkungan pengujian

  1. Buat konfigurasi lingkungan pengujian baru, dan berikan nama dan deskripsi untuknya.

  2. Tambahkan CloudFormation template Anda. Anda juga dapat menambahkan nama parameter input dan nilai dari CloudFormation template Anda.

  3. Pilih layanan Modernisasi AWS Mainframe AWS Blu Age non-managed sebagai runtime Anda.

  4. Tambahkan nama variabel keluaran untuk nama ID aplikasi Modernisasi AWS Mainframe, nama variabel keluaran untuk ID layanan titik akhir VPC, nama variabel keluaran untuk port Listener, dan nama variabel keluaran untuk nama. WebApp

    catatan

    Nama-nama bidang ini harus sesuai dengan nama variabel keluaran dari CloudFormation template yang akan dikembalikan dari Modernisasi AWS Mainframe selama pembuatan tumpukan.

  5. (Opsional) Pilih nama variabel keluaran untuk tugas DMS (Database Migration Service) ARN dan database sumber DDL (bahasa definisi Database) Lokasi S3 URI.

  6. (Opsional) Sesuaikan kunci Layanan Manajemen Kunci (KMS) Anda. Untuk informasi selengkapnya, lihat Mengelola akses ke kunci terkelola pelanggan di Panduan AWS Key Management Service Pengembang.

  7. Pilih Buat konfigurasi lingkungan pengujian.

Langkah 11: Unggah data masukan Anda di test suite

Pada langkah ini, Anda menjalankan kasus uji pada sumbernya. Untuk melakukan itu:

  1. Download dan jalankan dataset yang berasal dari mainframe run aplikasi. CardDemo

  2. Unggah folder yang tidak di-zip ke bucket Amazon S3 Anda. Bucket Amazon S3 ini harus berada di Wilayah yang sama dengan sumber daya Pengujian Aplikasi Anda yang lain.

    catatan

    Harus ada dua file dengan nama yang cocok dengan nama kumpulan data yang diteruskan dalam kasus uji sebelumnya.

  3. Pada halaman ikhtisar Test suite, pilih tombol Upload.

  4. Pada halaman Unggah data referensi, tentukan lokasi Amazon S3 tempat Anda mengunggah kumpulan data yang diperoleh dari mainframe sumber.

  5. Pilih Upload untuk memulai proses upload.

    catatan

    Tunggu hingga rekaman selesai sebelum Anda melakukan pemutaran ulang dan membandingkan.

Langkah 12: Putar ulang dan bandingkan

Jalankan rangkaian pengujian dan kasus uji di EC2 lingkungan AWS AWS Blu Age target di Amazon. Pengujian Aplikasi akan menangkap kumpulan data yang dihasilkan replay, dan membandingkannya dengan kumpulan data referensi yang direkam pada mainframe.

  1. Pilih Replay dan bandingkan. Ini akan memakan waktu sekitar tiga menit untuk membuat CloudFormation tumpukan, dan melakukan perbandingan.

Setelah semuanya selesai, Anda harus memiliki hasil perbandingan dengan beberapa perbedaan yang sengaja dibuat untuk tujuan demo ini.