QuickStart: Menyebarkan aplikasi Java ke Elastic Beanstalk

QuickStart Tutorial ini memandu Anda melalui proses membuat aplikasi Java dan menyebarkannya ke AWS Elastic Beanstalk lingkungan.

catatan

QuickStart Tutorial ini ditujukan untuk tujuan demonstrasi. Jangan gunakan aplikasi yang dibuat dalam tutorial ini untuk lalu lintas produksi.

Klaster AWS akun

Jika Anda belum menjadi AWS pelanggan, Anda perlu membuat AWS akun. Mendaftar memungkinkan Anda mengakses Elastic Beanstalk dan lainnya AWS layanan yang Anda butuhkan.

Jika Anda sudah memiliki AWS akun, Anda dapat melanjutkan kePrasyarat.

Buat sebuah AWS akun

Mendaftar untuk Akun AWS

Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.

Untuk mendaftar untuk Akun AWS

1. Buka https://portal.aws.amazon.com/billing/pendaftaran.

2. Ikuti petunjuk online.

   Bagian dari prosedur pendaftaran melibatkan tindakan menerima panggilan telepon dan memasukkan kode verifikasi di keypad telepon.

   Ketika Anda mendaftar untuk Akun AWS, sebuah Pengguna root akun AWSdiciptakan. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan tugas yang memerlukan akses pengguna root.

AWS mengirimi Anda email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk https://aws.amazon.comke/ dan memilih Akun Saya.

Buat pengguna dengan akses administratif

Setelah Anda mendaftar untuk Akun AWS, amankan Anda Pengguna root akun AWS, aktifkan AWS IAM Identity Center, dan buat pengguna administratif sehingga Anda tidak menggunakan pengguna root untuk tugas sehari-hari.

Amankan Anda Pengguna root akun AWS

1. Masuk ke AWS Management Consolesebagai pemilik akun dengan memilih pengguna Root dan memasukkan Akun AWS alamat email. Di laman berikutnya, masukkan kata sandi.

   Untuk bantuan masuk menggunakan pengguna root, lihat Masuk sebagai pengguna root di AWS Sign-In Panduan Pengguna.

2. Aktifkan otentikasi multi-faktor (MFA) untuk pengguna root Anda.

   Untuk petunjuk, lihat Mengaktifkan MFA perangkat virtual untuk Akun AWS root user (konsol) di Panduan IAM Pengguna.

Buat pengguna dengan akses administratif

1. Aktifkan Pusat IAM Identitas.

   Untuk petunjuk, lihat Mengaktifkan AWS IAM Identity Centerdi AWS IAM Identity Center Panduan Pengguna.

2. Di Pusat IAM Identitas, berikan akses administratif ke pengguna.

   Untuk tutorial tentang menggunakan Direktori Pusat Identitas IAM sebagai sumber identitas Anda, lihat Mengkonfigurasi akses pengguna dengan default Direktori Pusat Identitas IAMdi AWS IAM Identity Center Panduan Pengguna.

Masuk sebagai pengguna dengan akses administratif

• Untuk masuk dengan pengguna Pusat IAM Identitas, gunakan login URL yang dikirim ke alamat email saat Anda membuat pengguna Pusat IAM Identitas.

  Untuk bantuan masuk menggunakan pengguna Pusat IAM Identitas, lihat Masuk ke AWS akses portal di AWS Sign-In Panduan Pengguna.

Tetapkan akses ke pengguna tambahan

1. Di Pusat IAM Identitas, buat set izin yang mengikuti praktik terbaik menerapkan izin hak istimewa paling sedikit.

   Untuk petunjuknya, lihat Membuat set izin di AWS IAM Identity Center Panduan Pengguna.

2. Tetapkan pengguna ke grup, lalu tetapkan akses masuk tunggal ke grup.

   Untuk petunjuk, lihat Menambahkan grup di AWS IAM Identity Center Panduan Pengguna.

Prasyarat

Untuk mengikuti prosedur di panduan ini, Anda memerlukan terminal atau shell baris perintah untuk menjalankan perintah. Perintah ditampilkan dalam daftar yang diawali dengan simbol prompt ($) dan nama direktori saat ini, bila perlu.

~/eb-project$ this is a command
this is output

Di Linux dan macOS, Anda dapat menggunakan shell dan manajer paket pilihan Anda. Pada Windows Anda dapat menginstal Windows Subsystem untuk Linux untuk mendapatkan versi Windows terintegrasi dari Ubuntu dan Bash.

EB CLI

Tutorial ini menggunakan Elastic Beanstalk Command Line Interface (EB). CLI Untuk detail tentang menginstal dan mengkonfigurasi EBCLI, lihat Pasang Antarmuka Baris Perintah Elastic Beanstalk dan. Mengonfigurasi EB CLI

Java dan Maven

Jika Anda tidak menginstal Amazon Corretto di mesin lokal Anda, Anda dapat menginstalnya dengan mengikuti petunjuk penginstalan di Panduan Pengguna Amazon Corretto.

Verifikasi instalasi Java Anda dengan menjalankan perintah berikut.

~$ java -version 

Tutorial ini menggunakan Maven. Ikuti petunjuk pengunduhan dan penginstalan di situs web Apache Maven Project. Untuk informasi lebih lanjut tentang Maven, lihat Pusat Pengguna Maven di situs web Apache Maven Project.

Verifikasi instalasi Maven Anda dengan menjalankan perintah berikut.

~$ mvn -v

Langkah 1: Buat aplikasi Java

Buat direktori proyek.

~$ mkdir eb-java
~$ cd eb-java

Selanjutnya, buat aplikasi yang akan Anda deploy menggunakan Elastic Beanstalk. Kami akan membuat layanan RESTful web “Hello World”.

Contoh ini menggunakan framework Spring Boot. Aplikasi ini membuka listener pada port 5000. Elastic Beanstalk meneruskan permintaan ke aplikasi Anda pada port 5000 secara default.

Buat file-file berikut:

File ini membuat aplikasi Spring Boot sederhana.

contoh ~/eb-java/src/main/java/com/example/Application.java

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

File ini membuat pemetaan yang mengembalikan String yang kita definisikan di sini.

contoh ~/eb-java/src/main/java/com/example/Controller.java

package com.example;
    
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
    
@RestController
public class Controller {
    
    @GetMapping("/")
    public String index() {
       return "Hello Elastic Beanstalk!";
    }
}

File ini mendefinisikan konfigurasi proyek Maven.

contoh ~/eb-java/pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.3</version>
  </parent>

  <groupId>com.example</groupId>
  <artifactId>BeanstalkJavaExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

File properti ini mengganti port default menjadi 5000. Ini adalah port default yang mengirimkan lalu lintas Elastic Beanstalk untuk aplikasi Java.

contoh ~/eb-java/application.properties

server.port=5000

Langkah 2: Jalankan aplikasi Anda secara lokal

Package aplikasi Anda dengan perintah berikut:

~/eb-java$ mvn clean package

Jalankan aplikasi Anda secara lokal dengan perintah berikut:

~/eb-java$ java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

Saat aplikasi sedang berjalan, http://127.0.0.1:5000/ navigasikan ke browser Anda. Anda akan melihat teks “Halo Elastic Beanstalk!”.

Langkah 3: Menyebarkan aplikasi Java Anda dengan EB CLI

Sebelum menerapkan aplikasi Java Anda ke Elastic Beanstalk, mari bersihkan aplikasi build dari direktori Anda dan buat Buildfile dan Procfile untuk mengontrol bagaimana aplikasi dibangun dan dijalankan di lingkungan Elastic Beanstalk Anda.

Untuk mempersiapkan dan mengkonfigurasi penerapan aplikasi

1. Bersihkan aplikasi yang dibangun.

   ~/eb-java$ mvn clean

2. Buat Buildfile Anda.

   contoh ~/eb-java/Buildfile

   build: mvn clean package

   Ini Buildfile menentukan perintah yang digunakan untuk membangun aplikasi Anda. Jika Anda tidak menyertakan aplikasi Buildfile untuk Java, Elastic Beanstalk tidak mencoba membangun aplikasi Anda.

3. Buat Procfile Anda.

   contoh ~/eb-java/Procfile

   web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

   Ini Procfile menentukan perintah yang digunakan untuk menjalankan aplikasi Anda. Jika Anda tidak menyertakan aplikasi Procfile untuk Java, Elastic Beanstalk mengasumsikan JAR ada satu file di root bundel sumber Anda dan mencoba menjalankannya dengan perintah. java -jar

Sekarang setelah Anda menyiapkan file konfigurasi untuk membangun dan memulai aplikasi Anda, Anda siap untuk menerapkannya.

Untuk membuat lingkungan dan menyebarkan aplikasi Java Anda

1. Inisialisasi CLI repositori EB Anda dengan perintah. eb init

   ~/eb-java eb init -p corretto java-tutorial --region us-east-2
           
   Application java-tutorial has been created.

   Perintah ini membuat aplikasi bernama java-tutorial dan mengkonfigurasi repositori lokal Anda untuk membuat lingkungan dengan versi platform Java terbaru.

2. (Opsional) Jalankan eb init lagi untuk mengonfigurasi key pair default sehingga Anda dapat menggunakan SSH untuk menyambung ke EC2 instance yang menjalankan aplikasi Anda.

   ~/eb-java$ eb init
   Do you want to set up SSH for your instances?
   (y/n): y
   Select a keypair.
   1) my-keypair
   2) [ Create new KeyPair ]

   Pilih pasangan kunci jika Anda sudah memilikinya, atau ikuti prompt untuk membuatnya. Jika Anda tidak melihat prompt atau perlu mengubah pengaturan Anda nanti, jalankan eb init -i.

3. Buat lingkungan baru dan deploy aplikasi Anda dengan eb create. Elastic Beanstalk secara otomatis membuat file zip untuk aplikasi Anda dan memulainya pada port 5000.

   ~/eb-java$ eb create java-env

   Dibutuhkan sekitar lima menit untuk Elastic Beanstalk untuk menciptakan lingkungan Anda.

Langkah 4: Jalankan aplikasi Anda di Elastic Beanstalk

Ketika proses untuk membuat lingkungan Anda selesai, buka situs web Anda denganeb open.

~/eb-java eb open

Selamat! Anda telah menerapkan aplikasi Java dengan Elastic Beanstalk! Ini akan membuka jendela peramban menggunakan nama domain yang dibuat untuk aplikasi Anda.

Langkah 5: Bersihkan

Anda dapat menghentikan lingkungan Anda ketika Anda selesai bekerja dengan aplikasi Anda. Elastic Beanstalk mengakhiri semua AWS sumber daya yang terkait dengan lingkungan Anda.

Untuk mengakhiri lingkungan Elastic Beanstalk Anda dengan CLI EB jalankan perintah berikut.

~/eb-java$ eb terminate

AWS sumber daya untuk aplikasi Anda

Anda baru saja membuat aplikasi instance tunggal. Ini berfungsi sebagai aplikasi sampel langsung dengan satu EC2 instance, sehingga tidak memerlukan penyeimbangan beban atau penskalaan otomatis. Untuk aplikasi contoh tunggal Elastic Beanstalk menciptakan yang berikut AWS sumber daya:

• EC2instance — Mesin EC2 virtual Amazon yang dikonfigurasi untuk menjalankan aplikasi web pada platform yang Anda pilih.

  Setiap platform menjalankan satu set perangkat lunak, file konfigurasi, dan penulisan yang berbeda untuk mendukung versi bahasa, kerangka kerja, kontainer web tertentu, atau kombinasi dari semua ini. Sebagian besar platform menggunakan Apache atau nginx sebagai proksi terbalik yang memproses lalu lintas web di depan aplikasi web Anda, meneruskan permintaan ke aplikasi web, menyajikan aset statis, dan menghasilkan log akses dan kesalahan.

• Grup keamanan instans — Grup EC2 keamanan Amazon yang dikonfigurasi untuk memungkinkan lalu lintas masuk di port 80. Sumber daya ini memungkinkan HTTP lalu lintas dari penyeimbang beban mencapai EC2 instance yang menjalankan aplikasi web Anda. Secara default, lalu lintas tidak diizinkan di port lain.

• Bucket Amazon S3 – Lokasi penyimpanan untuk kode sumber, log, dan artifact lainnya yang dibuat saat Anda menggunakan Elastic Beanstalk.

• CloudWatch Alarm Amazon — Dua CloudWatch alarm yang memantau beban pada instans di lingkungan Anda dan dipicu jika beban terlalu tinggi atau terlalu rendah. Saat alarm terpicu, grup Auto Scaling Anda akan menaikkan atau menurunkan skala sebagai respons.

• AWS CloudFormation stack - Penggunaan Elastic Beanstalk AWS CloudFormation untuk meluncurkan sumber daya di lingkungan Anda dan menyebarkan perubahan konfigurasi. Sumber daya didefinisikan dalam template yang dapat Anda lihat di AWS CloudFormation konsol.

• Nama domain — Nama domain yang merutekan ke aplikasi web Anda dalam formulir subdomain.region.elasticbeanstalk.com.

Elastic Beanstalk mengelola semua sumber daya tersebut. Ketika Anda mengakhiri lingkungan, Elastic Beanstalk mengakhiri semua sumber daya yang dimuatnya.

Langkah selanjutnya

Setelah lingkungan Anda menjalankan aplikasi, Anda dapat men-deploy versi baru aplikasi atau aplikasi yang berbeda kapan saja. Menyebarkan versi aplikasi baru sangat cepat karena tidak memerlukan penyediaan atau memulai ulang instance. EC2 Anda juga dapat menjelajahi lingkungan baru Anda menggunakan konsol Elastic Beanstalk. Untuk langkah-langkah mendetail, lihat Menjelajahi lingkungan Anda di bagian Memulai panduan ini.

Coba lebih banyak tutorial

Jika Anda ingin mencoba tutorial lain dengan aplikasi contoh yang berbeda, lihatContoh aplikasi dan tutorial.

Setelah Anda menerapkan satu atau dua contoh aplikasi dan siap untuk mulai mengembangkan dan menjalankan aplikasi Java secara lokal, lihat. Menyiapkan lingkungan pengembangan Java Anda

Terapkan dengan konsol Elastic Beanstalk

Anda juga dapat menggunakan konsol Elastic Beanstalk untuk meluncurkan aplikasi sampel. Untuk langkah-langkah rinci, lihat Membuat aplikasi contoh di Bab Memulai panduan ini.