AWS Layanan Modernisasi Mainframe (Managed Runtime Environment experience) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Pengalaman yang Dikelola Sendiri). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan [AWS ketersediaan Modernisasi Mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Tutorial: Gunakan AWS Transform untuk Pengembang mainframe di Aplikasi WorkSpaces
Tutorial ini menunjukkan cara mengakses AWS Transform for mainframe Developer on WorkSpaces Applications dan menggunakannya dengan contoh aplikasi sehingga Anda dapat mencoba fitur-fiturnya. Ketika Anda menyelesaikan tutorial ini, Anda dapat menggunakan langkah yang sama dengan aplikasi Anda sendiri.
**Topics**
+ [Langkah 1: Buat database](#tutorial-ba-developer-create-db)
+ [Langkah 2: Akses lingkungan](#tutorial-ba-developer-access-env)
+ [Langkah 3: Mengatur runtime](#tutorial-ba-developer-set-up-runtime)
+ [Langkah 4: Mulai IDE Eclipse](#tutorial-ba-developer-start-eclipse)
+ [Langkah 5: Siapkan proyek Maven](#tutorial-ba-developer-set-up-maven)
+ [Langkah 6: Konfigurasikan server Tomcat](#tutorial-ba-developer-config-tomcat)
+ [Langkah 7: Menyebarkan ke Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [Langkah 8: Buat database JICS](#tutorial-ba-developer-create-jics)
+ [Langkah 9: Mulai dan uji aplikasi](#tutorial-ba-developer-test-app)
+ [Langkah 10: Debug aplikasi](#tutorial-ba-developer-debug)
+ [Pembersihan sumber daya](#tutorial-ba-developer-clean)
## Langkah 1: Buat database
Pada langkah ini, Anda menggunakan Amazon RDS untuk membuat database PostgreSQL terkelola yang digunakan aplikasi demo untuk menyimpan informasi konfigurasi.
1. Buka konsol Amazon RDS.
1. Pilih **Database > Buat database**.
1. **Pilih **Standard create > PostgreSQL**, tinggalkan versi default, lalu pilih Tingkat gratis.**
1. Pilih pengidentifikasi instans DB.
1. Untuk **Pengaturan Kredensi**, pilih **Kelola kredenal master** di. AWS Secrets Manager Untuk informasi selengkapnya, lihat [Manajemen kata sandi dengan Amazon RDS dan AWS Secrets Manager](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html) di *Panduan Pengguna Amazon RDS*.
1. Pastikan VPC sama dengan yang Anda gunakan untuk instance WorkSpaces Aplikasi. Anda dapat meminta admin Anda untuk nilai ini.
1. Untuk **grup keamanan VPC**, pilih **Buat** Baru.
1. Tetapkan **akses Publik** ke **Ya**.
1. Tinggalkan semua nilai default lainnya. Tinjau nilai-nilai ini.
1. Pilih **Buat basis data**.
Untuk membuat server database dapat diakses dari instans Anda, pilih server database di Amazon RDS. Di bawah **Konektivitas & keamanan**, pilih grup keamanan VPC untuk server database. Grup keamanan ini sebelumnya dibuat untuk Anda dan harus memiliki deskripsi yang mirip dengan yang ada di **Dibuat oleh konsol manajemen RDS**. Pilih **Tindakan > Edit aturan masuk**, pilih **Tambahkan aturan**, dan buat aturan tipe **PostgreSQL**. Untuk sumber aturan, gunakan **default** grup keamanan Anda dapat mulai mengetik nama sumber di bidang **Sumber** dan kemudian menerima ID yang disarankan. Terakhir, pilih **Simpan aturan**.
## Langkah 2: Akses lingkungan
Pada langkah ini, Anda mengakses lingkungan pengembangan AWS Transform for mainframe pada WorkSpaces Aplikasi.
1. Hubungi administrator Anda untuk cara yang tepat untuk mengakses instans WorkSpaces Aplikasi Anda. Untuk informasi umum tentang kemungkinan klien dan konfigurasi, lihat [Metode Akses WorkSpaces Aplikasi dan Klien](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html) di *Panduan Administrasi WorkSpaces Aplikasi Amazon*. Pertimbangkan untuk menggunakan klien asli untuk pengalaman terbaik.
1. Di WorkSpaces Aplikasi pilih **Desktop**.
## Langkah 3: Mengatur runtime
Pada langkah ini, Anda mengatur AWS Transform for mainframe runtime. Anda harus mengatur runtime pada peluncuran pertama dan lagi jika Anda diberi tahu tentang peningkatan runtime. Langkah ini mengisi `.m2` folder Anda.
1. Pilih **Aplikasi**, dari bilah menu, lalu pilih **Terminal**.
1. Masukkan perintah berikut:
```
~/_install-velocity-runtime.sh
```
## Langkah 4: Mulai IDE Eclipse
Pada langkah ini, Anda memulai Eclipse IDE dan memilih lokasi di mana Anda ingin membuat ruang kerja.
1. Di WorkSpaces Applications pilih ikon Launch Application pada toolbar, dan kemudian pilih **Eclipse JEE**.
![\[Luncurkan ikon Aplikasi pada bilah alat di WorkSpaces Aplikasi. Eclipse JEE dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/aas-ba-eclipse.png)
1. **Saat peluncur terbuka, masukkan lokasi tempat Anda ingin membuat ruang kerja, dan pilih Luncurkan.**
![\[AWS Transform for mainframePeluncur Eclipse IDE di Aplikasi. WorkSpaces Ruang kerja dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-launcher.png)
Secara opsional, Anda dapat meluncurkan Eclipse dari baris perintah, sebagai berikut:
```
~/eclipse &
```
## Langkah 5: Siapkan proyek Maven
Pada langkah ini, Anda mengimpor proyek Maven untuk aplikasi demo Planets.
1. Unggah [PlanetsDemo-pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) ke folder Home Anda. Anda dapat menggunakan fitur “File Saya” klien asli untuk melakukan ini.
1. Gunakan alat baris `unzip` perintah untuk mengekstrak file.
1. Arahkan ke dalam folder yang tidak di-zip dan buka root `pom.xml` proyek Anda di editor teks.
1. Edit `gapwalk.version` properti sehingga cocok dengan AWS Transform yang diinstal untuk runtime mainframe.
Jika Anda tidak yakin dengan versi yang diinstal, keluarkan perintah berikut di terminal:
```
cat ~/runtime-version.txt
```
Perintah ini mencetak versi runtime yang tersedia saat ini, misalnya,`3.1.0-b3257-dev`.
**catatan**
Jangan sertakan `-dev` sufiks dalam`gapwalk.version`. Misalnya, nilai yang valid adalah`3.1.0-b3257`.
1. **Di Eclipse, pilih **File**, lalu Impor.** Di jendela dialog **Impor**, perluas **Maven dan pilih Proyek Maven** **yang Ada**. Pilih **Berikutnya**.
1. **Di **Impor Proyek Maven**, berikan lokasi file yang diekstrak dan pilih Selesai.**
Anda dapat dengan aman mengabaikan popup berikut. Maven mengunduh salinan lokal `node.js` untuk membangun bagian Angular (\$1-web) dari proyek:
![\[Pesan peringatan tentang hilang node.js.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-node-warning.png)
Tunggu sampai akhir build. Anda dapat mengikuti build di tampilan **Progress**.
1. Di Eclipse, pilih proyek dan pilih **Run** as. Kemudian pilih **Maven install**. Setelah instalasi Maven berhasil, itu membuat file di `war` bawah. `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war`
## Langkah 6: Konfigurasikan server Tomcat
Pada langkah ini, Anda mengonfigurasi server Tomcat tempat Anda menyebarkan dan memulai aplikasi yang dikompilasi.
1. Di Eclipse, pilih **Window > Show View > Server** untuk menampilkan tampilan **Server**:
![\[AWS Transform untuk mainframe Eclipse dengan tampilan Server dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-servers.png)
1. Pilih **Tidak ada server yang tersedia. Klik tautan ini untuk membuat server baru...** . Wizard **Server Baru** muncul. Di bidang **Pilih jenis server** wizard, masukkan **tomcat v9, dan pilih **Tomcat** v9.0** Server. Lalu pilih **Selanjutnya**.
![\[Kotak dialog Server Baru. Tomcat v9.0 Server dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. Pilih **Browse**, dan pilih folder **tomcat** di root folder Home. Biarkan JRE pada nilai defaultnya dan pilih **Selesai**.
**Proyek **Server** dibuat di ruang kerja, dan server Tomcat v9.0 sekarang tersedia di tampilan Server.** Di sinilah aplikasi yang dikompilasi akan digunakan dan dimulai:
![\[AWS Transform untuk tab Eclipse Servers mainframe dengan server Tomcat baru terdaftar.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-server-added.png)
## Langkah 7: Menyebarkan ke Tomcat
Pada langkah ini, Anda menyebarkan aplikasi demo Planets ke server Tomcat sehingga Anda dapat menjalankan aplikasi.
1. Pilih `PlanetsDemo-web` file dan pilih **Run As > Maven install**. Pilih `PlanetsDemo-web` lagi dan pilih **Refresh** untuk memastikan bahwa frontend yang dikompilasi npm dikompilasi dengan benar ke .war dan diperhatikan oleh Eclipse.
1. Unggah [PlanetsDemo-runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) ke instance, dan unzip file di lokasi yang dapat diakses. Ini memastikan bahwa aplikasi demo dapat mengakses folder konfigurasi dan file yang dibutuhkannya.
1. Salin konten `PlanetsDemo-runtime/tomcat-config` ke dalam `Servers/Tomcat v9.0...` subfolder yang Anda buat untuk server Tomcat Anda:
![\[AWS Transform untuk subfolder mainframe Eclipse Tomcat v9.0 dan file yang dikandungnya.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. Buka entri `tomcat v9.0` server di tampilan Server. Editor properti server muncul:
![\[Editor properti server. Tab Ikhtisar dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. Di tab **Ikhtisar**, tingkatkan nilai **Timeout** menjadi 450 detik untuk Mulai, dan 150 detik untuk Berhenti, seperti yang ditunjukkan di sini:
![\[Mulai nilai batas waktu diatur ke 450 detik. Nilai batas waktu berhenti diatur ke 150 detik.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. Pilih **Buka konfigurasi peluncuran**. Seorang penyihir muncul. Di wizard, arahkan ke folder **Argumen** dan, untuk **direktori Kerja**, pilih **Lainnya**. Pilih **File System**, dan navigasikan ke `PlanetsDemo-runtime` folder yang di-unzip sebelumnya. Folder ini harus berisi subfolder langsung yang disebut **config**.
![\[Kotak dialog Edit Konfigurasi dengan direktori kerja yang ditentukan di bidang Lainnya.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. Pilih tab **Modul** editor properti server dan buat perubahan berikut:
+ Pilih **Add Web Module** dan tambahkan`PlanetsDemo-service`.
+ Pilih **Tambahkan Modul Web Eksternal**. Jendela dialog **Add Web Module** muncul. Lakukan perubahan berikut:
+ Di **Dasar dokumen**, pilih **Browse** dan navigasikan ke `~/webapps/gapwalk-application...war`
+ Di **Jalan**, masuk`/gapwalk-application`.
+ Pilih OK.
+ Pilih **Add External Web Module** lagi dan buat perubahan berikut:
+ Untuk **basis Document**, masukkan path ke frontend .war (in) `PlanetsDemo-web/target`
+ Untuk **Path**, masukkan `/demo`
+ Pilih OK
+ Simpan modifikasi editor (Ctrl\$1S).
Konten editor sekarang harus mirip dengan yang berikut ini.
![\[Tab Modul Web untuk properti server Tomcat dengan modul yang terdaftar.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## Langkah 8: Buat database JICS
Pada langkah ini, Anda terhubung ke database yang Anda buat[Langkah 1: Buat database](#tutorial-ba-developer-create-db).
1. Dari instance WorkSpaces Applications, keluarkan perintah berikut di terminal untuk diluncurkan`pgAdmin`:
```
./pgadmin-start.sh
```
1. Pilih alamat email dan kata sandi sebagai pengidentifikasi login. Catat URL yang disediakan (biasanya http://127.0.0.1:5050). Luncurkan Google Chrome di instance, salin dan tempel URL ke browser, dan masuk dengan pengenal Anda.
![\[Kotak dialog login pgAdmin.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-pgadmin-login.png)
1. Setelah Anda masuk, pilih **Tambahkan Server Baru** dan masukkan informasi koneksi ke database yang dibuat sebelumnya sebagai berikut.
![\[Kotak dialog Pgadmin Register Server. Tab Koneksi dipilih.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. Saat Anda terhubung ke server database, gunakan **Object > Create > Database** dan buat database baru bernama **jics**.
1. Edit informasi koneksi database yang digunakan aplikasi demo. Informasi ini didefinisikan dalam`PlanetsDemo-runtime/config/application-main.yml`. Cari `jicsDs` entri. Untuk mengambil nilai untuk `username` dan`password`, di konsol Amazon RDS, navigasikan ke database. Pada tab **Konfigurasi**, di bawah **Master Credentials ARN**, pilih Manage in **Secrets** Manager. Kemudian, di konsol Secrets Manager, dalam rahasia, pilih **Ambil nilai rahasia**.
## Langkah 9: Mulai dan uji aplikasi
Pada langkah ini, Anda memulai server Tomcat dan aplikasi demo sehingga Anda dapat mengujinya.
1. **Untuk memulai server Tomcat dan aplikasi yang digunakan sebelumnya, pilih entri server di tampilan Server dan pilih Mulai.** Konsol muncul yang menampilkan log startup.
1. Periksa status server di tampilan **Server**, atau tunggu **server dimulai dalam pesan milidetik [xxx]** di konsol. Setelah server dimulai, periksa apakah aplikasi gapwalk digunakan dengan benar. Untuk melakukan ini, akses URL **http://localhost:8080/gapwalk-application** di browser Google Chrome. Anda harus melihat yang berikut ini.
![\[Pesan konfirmasi yang menunjukkan bahwa aplikasi jics sedang berjalan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. Akses frontend aplikasi yang diterapkan dari Google Chrome di http://localhost:8080/demo. Halaman **Transaction Launcher** berikut akan muncul.
![\[Halaman peluncur transaksi JICS.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-jics-launcher.png)
1. Untuk memulai transaksi aplikasi, masukkan `PINQ` di kolom input, dan pilih **Jalankan** (atau tekan Enter).
Layar aplikasi demo akan muncul.
![\[Layar PlanetsDemo aplikasi dalam mode sisipkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-demo-app-screen.png)
1. Ketik nama planet di bidang yang sesuai dan tekan Enter.
![\[Layar PlanetsDemo aplikasi dengan Bumi dimasukkan di bidang nama Planet.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-demo-with-data.png)
## Langkah 10: Debug aplikasi
Pada langkah ini, Anda menguji menggunakan fitur debugging Eclipse standar. Fitur-fitur ini tersedia saat Anda mengerjakan aplikasi modern.
1. Untuk membuka kelas layanan utama, tekan Ctrl\$1Shift\$1T. Lalu masukkan. `PlanetsinqProcessImpl`
![\[Jendela dialog Eclipse Open Type dengan PlanetsinqProcessImpl dimasukkan.\]](http://docs.aws.amazon.com/id_id/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. Arahkan ke `searchPlanet` metode, dan letakkan breakpoint di sana.
1. Pilih nama server dan pilih **Restart di Debug**.
1. Ulangi langkah sebelumnya. Artinya, akses aplikasi, masukkan nama planet, dan tekan Enter.
Eclipse akan menghentikan aplikasi dalam metode ini`searchPlanet`. Sekarang Anda bisa memeriksanya.
## Pembersihan sumber daya
Jika Anda tidak lagi membutuhkan sumber daya yang Anda buat untuk tutorial ini, hapus sehingga Anda tidak dikenakan biaya tambahan. Selesaikan langkah-langkah berikut:
+ Jika aplikasi Planets masih berjalan, hentikan.
+ Hapus database yang Anda buat[Langkah 1: Buat database](#tutorial-ba-developer-create-db). Untuk informasi selengkapnya, lihat [Menghapus instans DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html).