Menginstal aplikasi sampel Amazon QLDB Java - Database Buku Besar Amazon Quantum (AmazonQLDB)
PrasyaratPenginstalan

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

Menginstal aplikasi sampel Amazon QLDB Java

penting

Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi QLDB Buku Besar Amazon ke Amazon Aurora Postgre. SQL

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

DMVContoh aplikasi untuk Java adalah open source di GitHub repositori amazon-qldb-dmv-sampleaws-samples/ -java.

Prasyarat

Sebelum Anda memulai, pastikan Anda menyelesaikan QLDB driver untuk JavaPrasyarat. Ini termasuk yang berikut:

  1. Mendaftar untuk AWS.

  2. Buat pengguna dengan QLDB izin 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 selain AWS Cloud9, instal Java dan berikan akses terprogram untuk pengembangan.

Penginstalan

Langkah-langkah berikut menjelaskan cara mengunduh dan mengatur aplikasi sampel dengan lingkungan pengembangan lokal. Atau, Anda dapat mengotomatiskan pengaturan aplikasi sampel dengan menggunakan AWS Cloud9 sebagai milik AndaIDE, dan AWS CloudFormation templat untuk menyediakan sumber daya pengembangan Anda.

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 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 file. Tutorial Java

  2. Muat dan jalankan aplikasi yang disediakan.

    • Jika Anda menggunakan Eclipse:

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

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

      3. Anda dapat mencoba menjalankan ListLedgers program sebagai contoh. Buka menu konteks (klik kanan) untuk ListLedgers.java file tersebut, dan pilih Run as Java Application.

    • Jika Anda menggunakan IntelliJ:

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

      2. Di direktori root proyek, telusuri dan pilih direktori aplikasi yang berisi build.gradle file. Kemudian, pilih OK. Pertahankan pengaturan default, dan pilih OK lagi.

      3. Anda dapat mencoba menjalankan ListLedgers program sebagai contoh. Buka menu konteks (klik kanan) untuk ListLedgers.java file tersebut, dan pilih Jalankan 'ListLedgers'.

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

Instruksi ini menjelaskan cara mengotomatiskan pengaturan aplikasi sampel registrasi QLDB kendaraan Amazon untuk Java, menggunakan AWS Cloud9sebagai aplikasi AndaIDE. Dalam panduan ini, Anda menggunakan AWS CloudFormationtemplate untuk menyediakan sumber daya pengembangan Anda.

Untuk informasi selengkapnya AWS Cloud9, lihat Panduan AWS Cloud9 Pengguna. Untuk mempelajari selengkapnya AWS CloudFormation, lihat Panduan AWS CloudFormation Pengguna.

Bagian 1: Menyediakan sumber daya Anda

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

Untuk membuka AWS CloudFormation konsol dan memuat QLDB contoh template aplikasi

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

    Beralih ke Wilayah yang mendukungQLDB. Untuk daftar lengkapnya, lihat QLDBtitik akhir Amazon dan kuota di. Referensi Umum AWS Tangkapan layar berikut AWS Management Console menunjukkan US East (Virginia N.) sebagai yang dipilih Wilayah AWS.

    AWS Management Console menunjukkan US East (Virginia N.) sebagai yang terpilih Wilayah AWS.

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

  3. Pada halaman Buat tumpukan di bawah Tentukan template, pilih Amazon S3 URL.

  4. Masukkan yang berikut iniURL, 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. Lalu pilih Selanjutnya.

  7. Tinjau pengaturan tumpukan Anda, dan pilih Buat tumpukan. AWS CloudFormation Skrip mungkin membutuhkan waktu beberapa menit untuk menyelesaikannya.

    Skrip ini menyediakan AWS Cloud9 lingkungan Anda dengan instance Amazon Elastic Compute Cloud (AmazonEC2) terkait yang Anda gunakan untuk menjalankan QLDB contoh aplikasi dalam tutorial ini. Itu juga mengkloning repositori aws-samples/ amazon-qldb-dmv-sample -java dari ke lingkungan pengembangan Anda. GitHub AWS Cloud9

Bagian 2: Siapkan IDE

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

Untuk mengatur AWS Cloud9 lingkungan Anda

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

  2. Di bawah lingkungan Anda, cari kartu untuk lingkungan bernama QLDBDMVSample Application, dan pilih Open IDE. Lingkungan Anda mungkin membutuhkan waktu satu menit untuk dimuat saat EC2 instance yang mendasarinya diluncurkan.

    AWS Cloud9 Lingkungan Anda sudah 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. Tangkapan layar AWS Cloud9 konsol berikut menunjukkan panel folder lingkungan Aplikasi QLDB DMV Sampel.

    AWS Cloud9 konsol yang menampilkan panel folder lingkungan Aplikasi QLDB DMV Sampel.

    Jika Anda tidak melihat panel navigasi, alihkan tab Lingkungan di sisi kiri konsol Anda. Jika Anda tidak melihat folder apa pun di panel, aktifkan Show Environment Root menggunakan ikon pengaturan ( Settings icon ).

  3. Di panel bawah konsol Anda, Anda akan melihat jendela bash terminal yang terbuka. Jika Anda tidak melihat ini, pilih Terminal Baru dari menu Jendela di bagian atas konsol Anda.

  4. Selanjutnya, unduh dan jalankan skrip penyiapan untuk menginstal Open JDK 8 dan—jika berlaku—periksa cabang yang sesuai dari repositori Git. Di AWS Cloud9 terminal yang Anda buat pada 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 dicetak di terminal:

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

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

Bagian 3: Jalankan aplikasi QLDB DMV sampel

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

Untuk menjalankan aplikasi 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

    Misalnya, jalankan perintah berikut untuk mencantumkan semua buku besar di Wilayah Anda Akun AWS dan saat ini.

    ./gradlew run -Dtutorial=ListLedgers

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

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

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

    2. Hapus juga AWS Cloud9 tumpukan yang dibuat AWS CloudFormation template untuk Anda.