Menginstal aplikasi sampel Amazon QLDB Java

Bagian ini menjelaskan cara menginstal dan menjalankan aplikasi sampel Amazon QLDB yang disediakan untuk tutorial step-by-step Java. Kasus penggunaan untuk aplikasi sampel ini adalah departemen database kendaraan bermotor (DMV) yang melacak informasi historis lengkap tentang pendaftaran kendaraan.

Aplikasi sampel DMV untuk Java adalah open source di GitHub repositori amazon-qldb-dmv-sampleaws-samples/-java.

Prasyarat

Sebelum memulai, pastikan Anda menyelesaikan driver QLDB untuk JavaPrasyarat. Hal ini termasuk skenario berikut:

1. Daftar ke AWS.

2. Buat pengguna dengan izin QLDB yang sesuai. Untuk menyelesaikan semua langkah dalam tutorial ini, Anda memerlukan akses administratif penuh ke sumber daya buku besar Anda melalui QLDB API.

3. Jika Anda menggunakan IDE selainAWS Cloud9, instal Java dan berikan akses terprogram untuk pengembangan.

Instalasi

Langkah-langkah berikut menjelaskan cara mengunduh dan menyiapkan contoh aplikasi dengan lingkungan pengembangan lokal. Atau, Anda dapat mengotomatiskan pengaturan aplikasi sampel dengan menggunakanAWS Cloud9 sebagai IDE Anda, danAWS CloudFormation template untuk menyediakan sumber daya pengembangan Anda.

Lingkungan pengembangan lokal

Petunjuk ini menjelaskan cara mengunduh dan menginstal aplikasi sampel QLDB Java menggunakan sumber daya dan lingkungan pengembangan Anda sendiri.

Untuk mengunduh dan menjalankan aplikasi sampel

1. Masukkan perintah berikut untuk mengkloning aplikasi sampel sampel dari GitHub.

   2.x

   git clone https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git

   1.x

   git clone -b v1.2.0 https://github.com/aws-samples/amazon-qldb-dmv-sample-java.git

   Paket ini mencakup konfigurasi Gradle dan kode lengkap dari filetutorial java.

2. Muat dan jalankan aplikasi yang disediakan.

   • Jika Anda menggunakan Eclipse:

     1. Mulai Eclipse, dan pada menu Eclipse, pilih File, Import, dan kemudian Existing Gradle Project.

     2. Di direktori root proyek, telusuri dan pilih direktori aplikasi yang berisibuild.gradle file. Kemudian, pilih Selesai untuk menggunakan pengaturan Gradle default untuk impor.

     3. Anda dapat mencoba menjalankanListLedgers program sebagai contoh. Buka menu konteks (klik kanan) untukListLedgers.java file, lalu pilih Jalankan aplikasi Java.

   • Jika Anda menggunakan IntelliJ:

     1. Mulai IntelliJ, dan pada menu IntelliJ, pilih File dan kemudian Buka.

     2. Di direktori root proyek, telusuri dan pilih direktori aplikasi yang berisibuild.gradle file. Kemudian, pilih OK. Simpan pengaturan default, dan pilih OK lagi.

     3. Anda dapat mencoba menjalankanListLedgers program sebagai contoh. Buka menu konteks (klik kanan) untukListLedgers.java file, lalu pilih Jalankan menu konteks (klik kananListLedgers).

3. LanjutkanLangkah 1: Buat buku besar baru untuk memulai tutorial dan membuat buku besar.

AWS Cloud9

Petunjuk ini menjelaskan cara mengotomatiskan penyiapan aplikasi sampel pendaftaran kendaraan Amazon QLDB untuk Java, yang digunakan AWS Cloud9sebagai IDE Anda. Dalam panduan ini, Anda menggunakan AWS CloudFormationtemplate untuk menyediakan sumber daya pengembangan Anda.

Untuk informasi selengkapnya tentang AWS Cloud9, lihat AWS Cloud9Panduan Pengguna . Untuk mempelajari lebih lanjutAWS CloudFormation, lihat PanduanAWS CloudFormation Pengguna.

Bagian 1: Untuk menyediakan sumber daya Anda

Pada langkah pertama ini, Anda gunakanAWS CloudFormation untuk menyediakan sumber daya yang diperlukan untuk menyiapkan lingkungan pengembangan Anda dengan aplikasi sampel Amazon QLDB.

Untuk membukaAWS CloudFormation konsol dan memuat template aplikasi sampel QLDB

1. Masuk ke AWS Management Console dan buka konsol AWS CloudFormation di https://console.aws.amazon.com/cloudformation.

   Beralih ke Wilayah yang mendukung QLDB. Untuk daftar lengkapnya, lihat titik akhir dan kuota Amazon QLDB di bagian Referensi Umum AWS. Berikut screenshot dariAWS Management Console acara US (N. Virginia) sebagai yang dipilihWilayah AWS..

   

2. DiAWS CloudFormation konsol, pilih Buat tumpukan, lalu pilih Dengan sumber daya baru (standar).

3. Pada halaman Create stack di bawah Specify template, pilih URL Amazon S3.

4. Masukkan URL berikut, dan pilih Berikutnya.

   https://amazon-qldb-assets.s3.amazonaws.com/templates/QLDB-DMV-SampleApp.yml

5. Masukkan nama Stack (sepertiqldb-sample-app), dan pilih Next.

6. Anda dapat menambahkan tag apa pun yang sesuai dan menyimpan opsi default. Kemudian pilih Selanjutnya.

7. Tinjau pengaturan tumpukan Anda, dan pilih Buat tumpukan. AWS CloudFormationSkrip mungkin memerlukan waktu beberapa menit untuk diselesaikan.

   Skrip ini menyediakanAWS Cloud9 lingkungan Anda dengan instans Amazon Elastic Compute Cloud (Amazon EC2) yang Anda gunakan untuk menjalankan aplikasi sampel QLDB dalam tutorial ini. Ini juga mengkloning repositori aws-samples/amazon-qldb-dmv-sample -java dari GitHub ke lingkunganAWS Cloud9 pengembangan Anda.

Bagian 2: Siapkan IDE Anda

Pada langkah ini, Anda menyelesaikan pengaturan lingkungan pengembangan cloud Anda. Anda mengunduh dan menjalankan skrip shell yang disediakan untuk mengaturAWS Cloud9 IDE Anda dengan dependensi aplikasi sampel.

Untuk mempersiapkanAWS Cloud9 lingkungan Anda

1. BukaAWS Cloud9 konsol di https://console.aws.amazon.com/cloud9/.

2. Di lingkungan Anda, cari kartu untuk lingkungan bernama QLDB DMV Sample Application, dan pilih Open IDE. Lingkungan Anda mungkin memerlukan waktu satu menit untuk dimuat saat instans EC2 yang mendasarinya diluncurkan.

   AWS Cloud9Lingkungan Anda telah dikonfigurasi sebelumnya dengan dependensi sistem yang Anda butuhkan untuk menjalankan tutorial. Di panel navigasi Lingkungan konsol Anda, konfirmasikan bahwa Anda melihat folder bernamaQLDB DMV Sample Application. Screenshot berikut dariAWS Cloud9 konsol menunjukkan panel folder lingkungan Aplikasi Sampel DMV QLDB.

   

   Jika Anda tidak melihat panel navigasi, alihkan tab Lingkungan di sisi kiri konsol. Jika Anda tidak melihat folder apa pun di panel, aktifkan Tampilkan Akar Lingkungan menggunakan ikon pengaturan ( ).

3. Pada panel bawah konsol Anda, Anda akan melihat jendelabash terminal yang terbuka. Jika Anda tidak melihat ini, pilih Terminal Baru dari menu Window di bagian atas konsol Anda.

4. Selanjutnya, unduh dan jalankan skrip penyiapan untuk menginstal OpenJDK 8 dan—jika dapat diterapkan - periksa cabang yang sesuai dari repositori Git. DiAWS Cloud9 terminal yang Anda buat di langkah sebelumnya, jalankan dua perintah berikut secara berurutan:

   2.x

   aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup-v2.sh .

   sh dmv-setup-v2.sh

   1.x

   aws s3 cp s3://amazon-qldb-assets/setup-scripts/dmv-setup.sh .

   sh dmv-setup.sh

   Setelah selesai, Anda akan melihat pesan berikut yang dicetak di terminal:

   ** DMV Sample App setup completed , enjoy!! **

5. Luangkan waktu sejenak untuk menelusuri contoh kode aplikasiAWS Cloud9, terutama di jalur direktori berikut:src/main/java/software/amazon/qldb/tutorial.

Bagian 3: Jalankan aplikasi sampel sampel QLDB DMV

Pada langkah ini, Anda mempelajari cara menjalankan tugas aplikasi sampel Amazon QLDB DMV menggunakanAWS Cloud9. Untuk menjalankan kode contoh, kembali keAWS Cloud9 terminal Anda atau buat jendela terminal baru seperti yang Anda lakukan di Bagian 2: Mengatur IDE Anda.

Untuk menjalankan aplikasi sampel sampel sampel sampel sampel sampel.

1. Jalankan perintah berikut di terminal Anda untuk beralih ke direktori root proyek:

   cd ~/environment/amazon-qldb-dmv-sample-java

   Pastikan Anda menjalankan contoh di jalur direktori berikut.

   /home/ec2-user/environment/amazon-qldb-dmv-sample-java/

2. Perintah berikut menunjukkan sintaks Gradle untuk menjalankan setiap tugas.

   ./gradlew run -Dtutorial=Task

   Sebagai contoh, jalankan perintah berikut untuk mencantumkan semua buku besar di Region AndaAkun AWS dan saat ini.

   ./gradlew run -Dtutorial=ListLedgers

3. LanjutkanLangkah 1: Buat buku besar baru untuk memulai tutorial dan membuat buku besar.

4. (Opsional) Setelah Anda menyelesaikan tutorial, bersihkanAWS CloudFormation sumber daya Anda jika tidak lagi membutuhkannya.

   1. BukaAWS CloudFormation konsol di https://console.aws.amazon.com/cloudformation, dan hapus tumpukan yang Anda buat di Bagian 1: Menyediakan Sumber Daya Anda.

   2. Juga hapusAWS Cloud9 tumpukan yang dibuatAWS CloudFormation template untuk Anda.