Men-deploy aplikasi Spring Boot ke lingkungan standar App Engine

1. Sebelum memulai

Aplikasi App Engine mudah dibuat, mudah dipelihara, dan mudah diskalakan seiring perubahan kebutuhan traffic dan penyimpanan data Anda. Dengan App Engine, Anda tidak perlu memelihara server. Anda cukup mengupload aplikasi dan aplikasi tersebut siap digunakan.

Aplikasi App Engine akan otomatis diskalakan berdasarkan traffic masuk. Load balancing, microservice, otorisasi, database SQL dan NoSQL, caching memori, pemisahan traffic, logging, penelusuran, pembuatan versi, peluncuran dan pembatalan, serta pemindaian keamanan semuanya didukung secara native dan sangat mudah disesuaikan.

Lingkungan standar App Engine dan lingkungan fleksibel App Engine mendukung berbagai bahasa pemrograman, termasuk Java, Python, PHP, NodeJS, dan Go. Kedua lingkungan ini memberikan fleksibilitas maksimum kepada developer dalam hal perilaku aplikasi mereka. Setiap lingkungan memiliki kelebihan tertentu. Untuk mengetahui informasi selengkapnya, lihat Memilih lingkungan App Engine.

Anda akan mempelajari cara men-deploy aplikasi Spring Boot ke lingkungan standar App Engine. Lingkungan standar akan diskalakan menjadi nol instance saat tidak ada yang menggunakannya dan otomatis diskalakan.

Prasyarat

• Pemahaman tentang bahasa dan alat pemrograman Java
• Pengetahuan tentang editor teks Linux standar, seperti Vim, Emacs, dan nano

Yang akan Anda lakukan

• Cara membuat aplikasi Java Spring Boot di App Engine

Yang akan Anda butuhkan

• Project Google Cloud
• Browser, seperti Google Chrome

2. Penyiapan dan persyaratan

Penyiapan lingkungan mandiri

1. Login ke Google Cloud Console dan buat project baru atau gunakan kembali project yang sudah ada. Jika belum memiliki akun Gmail atau Google Workspace, Anda harus membuatnya.

• Project name adalah nama tampilan untuk peserta project ini. String ini adalah string karakter yang tidak digunakan oleh Google API. Anda dapat memperbaruinya kapan saja.
• Project ID bersifat unik di semua project Google Cloud dan tidak dapat diubah (tidak dapat diubah setelah ditetapkan). Cloud Console otomatis membuat string unik; biasanya Anda tidak mementingkan kata-katanya. Di sebagian besar codelab, Anda harus merujuk Project ID-nya (umumnya diidentifikasi sebagai PROJECT_ID). Jika tidak suka dengan ID yang dibuat, Anda dapat membuat ID acak lainnya. Atau, Anda dapat mencobanya sendiri, dan lihat apakah ID tersebut tersedia. ID tidak dapat diubah setelah langkah ini dan tersedia selama durasi project.
• Sebagai informasi, ada nilai ketiga, Project Number, yang digunakan oleh beberapa API. Pelajari lebih lanjut ketiga nilai ini di dokumentasi.

Perhatian: Project ID bersifat unik secara global dan tidak dapat digunakan orang lain setelah Anda memilihnya. Anda adalah satu-satunya pengguna ID tersebut. Meskipun project sudah dihapus, ID tersebut tidak dapat digunakan lagi

Catatan: Jika menggunakan akun Gmail, Anda dapat menyetel lokasi default ke No organization. Jika Anda menggunakan akun Google Workspace, pilih lokasi yang sesuai untuk organisasi Anda.

2. Selanjutnya, Anda harus mengaktifkan penagihan di Konsol Cloud untuk menggunakan resource/API Cloud. Menjalankan operasi dalam codelab ini tidak akan memakan banyak biaya, bahkan mungkin tidak sama sekali. Guna mematikan resource agar tidak menimbulkan penagihan di luar tutorial ini, Anda dapat menghapus resource yang dibuat atau menghapus project-nya. Pengguna baru Google Cloud memenuhi syarat untuk mengikuti program Uji Coba Gratis senilai$300 USD.

Cloud Shell

Anda akan menggunakan Cloud Shell, lingkungan command line yang berjalan di Google Cloud.

Mengaktifkan Cloud Shell

1. Dari Cloud Console, klik Activate Cloud Shell .

Jika ini adalah pertama kalinya Anda memulai Cloud Shell, Anda akan melihat layar perantara yang menjelaskan apa itu Cloud Shell. Jika Anda melihat layar perantara, klik Continue.

Perlu waktu beberapa saat untuk menyediakan dan terhubung ke Cloud Shell.

Mesin virtual ini berisi semua alat pengembangan yang diperlukan. VM ini menawarkan direktori beranda tetap sebesar 5 GB dan beroperasi di Google Cloud, sehingga sangat meningkatkan performa dan autentikasi jaringan. Sebagian besar pekerjaan Anda dalam codelab ini dapat dilakukan dengan browser.

Setelah terhubung ke Cloud Shell, Anda akan melihat bahwa Anda telah diautentikasi dan project ditetapkan ke project ID Anda.

2. Jalankan perintah berikut di Cloud Shell untuk mengonfirmasi bahwa Anda telah diautentikasi:

gcloud auth list

Output perintah

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Catatan: Alat command-line gcloud adalah alat command-line yang canggih dan terpadu di Google Cloud. Alat ini sudah diinstal lebih dulu di Cloud Shell. Anda akan melihat dukungannya untuk penyelesaian tab. Untuk mengetahui informasi selengkapnya, lihat ringkasan alat command line gcloud.

3. Jalankan perintah berikut di Cloud Shell untuk mengonfirmasi bahwa perintah gcloud mengetahui project Anda:

gcloud config list project

Output perintah

[core]
project = <PROJECT_ID>

Jika tidak, Anda dapat menyetelnya dengan perintah ini:

gcloud config set project <PROJECT_ID>

Output perintah

Updated property [core/project].

Catatan: Jika Anda menyelesaikan tutorial ini di luar Cloud Shell, ikuti Menyiapkan Kredensial Default Aplikasi.

3. Membuat aplikasi web Spring Boot baru

Setelah Cloud Shell diluncurkan, Anda dapat menggunakan command line untuk membuat aplikasi Spring Boot baru dengan Spring Initializr.

$ curl https://start.spring.io/starter.tgz \
  -d bootVersion=3.0.5 \
  -d dependencies=web \
  -d type=maven-project \
  -d baseDir=gae-standard-example | tar -xzvf -
$ cd gae-standard-example

4. Memperbarui Maven pom.xml

Ada dua cara untuk men-deploy aplikasi server Java—menggunakan Maven App Engine Plugin atau Gradle App Engine Plugin, atau dengan men-deploy direktori paket war. Anda akan menggunakan Maven App Engine Plugin untuk men-deploy aplikasi.

Menambahkan Maven App Engine Plugin

Perbarui pom.xml untuk menyertakan plugin Google Cloud yang menyederhanakan proses deployment. Anda dapat menggunakan Vim, nano, atau Emacs untuk mengedit file.

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" ...>
  ...
  <build>
    <plugins>
      ...
      <plugin>
        <groupId>com.google.cloud.tools</groupId>
        <artifactId>appengine-maven-plugin</artifactId>
        <version>2.4.4</version>
        <configuration>
          <version>1</version>
          <projectId>GCLOUD_CONFIG</projectId>
        </configuration>
      </plugin>
      ...
    </plugins>
  </build>
</project>

5. Menambahkan deskriptor App Engine

1. Untuk men-deploy aplikasi ke lingkungan standar App Engine, Anda harus membuat file deskriptor src/main/appengine/app.yaml baru.

$ mkdir -p src/main/appengine/
$ touch src/main/appengine/app.yaml

2. Edit file src/main/appengine/app.yaml dan tambahkan konten berikut:

src/main/appengine/app.yaml

runtime: java17
instance_class: F1

Catatan: Class instance yang berbeda memungkinkan Anda menggunakan jumlah memori yang berbeda. Class instance F1 adalah instance terkecil. Untuk aplikasi produksi, Anda harus mempertimbangkan untuk menggunakan instance yang lebih besar untuk mengakomodasi beban kerja Anda. Untuk mengetahui informasi selengkapnya, lihat File Konfigurasi app.yaml.

6. Menambahkan pengontrol

Tambahkan pengontrol baru yang menampilkan "hello world!" di DemoApplication.java.

src/main/java/com/example/demo/DemoApplication.java

package com.example.demo;

...

// Add imports
import org.springframework.web.bind.annotation.*;

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

// Add the controller.
@RestController
class HelloWorldController {
  @GetMapping("/")
  public String hello() {
    return "hello world!";
  }
}

7. Menjalankan aplikasi secara lokal

1. Pastikan JAVA_HOME ditetapkan ke versi JDK yang benar:

$ export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/

2. Anda dapat memulai aplikasi Spring Boot dengan plugin Spring Boot:

$ ./mvnw -DskipTests spring-boot:run

3. Setelah aplikasi dimulai, klik Web Preview di toolbar Cloud Shell, lalu pilih Preview on port 8080.

Tab di browser Anda akan terbuka dan terhubung ke server yang Anda mulai.

8. Men-deploy aplikasi ke App Engine

1. Pertama, inisialisasi project agar dapat menjalankan aplikasi App Engine. Selain itu, inisialisasi project untuk dijalankan di wilayah pusat Amerika Serikat.

$ gcloud app create --region us-central
You are creating an app for project [...].
WARNING: Creating an App Engine application for a project is irreversible and the region
cannot be changed. More information about regions is at
https://cloud.google.com/appengine/docs/locations

Catatan: Atau, Anda dapat mencantumkan semua region yang tersedia dengan gcloud app regions list dan memilih salah satunya.

2. Kemudian, deploy aplikasi Anda ke lingkungan standar App Engine dengan menjalankan mvn appengine:deploy.

$ ./mvnw -DskipTests package appengine:deploy
... first time deploy may take a couple of minutes

Catatan: Deployment pertama kali mungkin memerlukan waktu beberapa menit. Di balik layar, lingkungan runtime, jaringan, dan load balancer disediakan, serta aplikasi dimulai.

3. Setelah aplikasi di-deploy, Anda dapat membukanya dengan membuka http://<project-id>.appspot.com di browser web atau menggunakan perintah berikut di Cloud Shell:

$ gcloud app browse
... [It may print out the URL for your app]

Catatan: Secara opsional, Anda dapat membeli dan menggunakan nama domain tingkat atas untuk aplikasi atau menggunakan nama domain yang sudah Anda daftarkan.

9. Pembersihan

Anda tidak dapat menghapus aplikasi App Engine, tetapi Anda dapat menonaktifkannya.

Buka App Engine dan Settings di Konsol Google Cloud, lalu pilih Disable Application:

Atau, Anda dapat menghapus seluruh project:

$ gcloud projects delete YOUR-PROJECT-ID

10. Selamat

Anda telah mempelajari cara menulis aplikasi web App Engine pertama Anda.

Pelajari lebih lanjut

• Java di Google Cloud
• App Engine
• Contoh kode Java