QuickStart: Menyebarkan aplikasi Java ke Elastic Beanstalk

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

Klaster AWS akun

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

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

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 Windows-integrated versi Ubuntu dan Bash.

EB CLI

Tutorial ini menggunakan Elastic Beanstalk Command Line Interface (EB CLI). Untuk detail tentang pemasangan dan konfigurasi EB CLI, lihat Instal EB CLI dengan skrip pengaturan (disarankan) 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. Kita akan membuat layanan web RESTful "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.

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.

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.

<?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.

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.

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

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 AWS mengakhiri semua sumber daya yang terkait dengan lingkungan Anda.

Untuk mengakhiri lingkungan Elastic Beanstalk Anda dengan EB CLI 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 instans EC2, sehingga tidak memerlukan penyeimbangan beban atau penskalaan otomatis. Untuk aplikasi contoh tunggal Elastic Beanstalk menciptakan sumber daya berikut: AWS

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. Men-deploy versi aplikasi baru itu sangat cepat karena tidak memerlukan persediaan atau memulai ulang instans 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.

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.