Hướng Dẫn Triển Khai Ứng Dụng Spring Boot Trên Google Cloud Run

Spring Boot là một trong những framework phổ biến nhất để xây dựng các Microservices dựa trên Java. Với Google Cloud Run, bạn có thể triển khai ứng dụng Spring Boot của mình trong một môi trường không máy chủ, được quản lý hoàn toàn mà không cần lo lắng về việc cung cấp máy chủ, mở rộng hay quản lý hạ tầng.

Mục Lục

1. Giới thiệu
2. Yêu cầu trước khi bắt đầu
3. Bước 1: Kiểm Tra Cài Đặt Gcloud và Cấu Hình Dự Án
4. Bước 2: Kiểm Tra Các API Cần Thiết
5. Bước 3: Tạo Kho Lưu Trữ Artifact Registry
6. Bước 4: Tạo Dockerfile Đa Giai Đoạn Trong Ứng Dụng Spring Boot
7. Bước 5: Xây Dựng và Đẩy Ảnh Docker Sử Dụng Cloud Build
8. Bước 6: Triển Khai Trên Cloud Run
9. Thực Hành Tốt Nhất
10. Câu Hỏi Thường Gặp
11. Kết Luận

Giới Thiệu

Trong bài viết này, tôi sẽ hướng dẫn bạn từng bước để triển khai một ứng dụng Spring Boot lên Cloud Run. Bạn sẽ học cách sử dụng Google Cloud CLI, tạo kho lưu trữ Docker và triển khai ứng dụng của mình một cách nhanh chóng.

Yêu Cầu Trước Khi Bắt Đầu

Trước khi bắt đầu, bạn cần đảm bảo rằng bạn đã chuẩn bị những điều sau:

• Tài khoản Google Cloud với tính năng thanh toán đã được kích hoạt.
• Google Cloud SDK đã được cài đặt trên máy tính của bạn.
• Một ứng dụng Spring Boot đơn giản (Mã nguồn).

Bước 1: Kiểm Tra Cài Đặt Gcloud và Cấu Hình Dự Án

Trước tiên, hãy đảm bảo rằng Google Cloud CLI (gcloud) đã được cài đặt và có thể truy cập được:

gcloud --version

Sau đó, kiểm tra dự án hiện tại:

gcloud config get-value project

Nếu bạn cần thiết lập một dự án mới, hãy sử dụng lệnh sau:

gcloud config set project [PROJECT_ID]

Cuối cùng, thiết lập vùng và khu vực mặc định (Tùy chọn nhưng được khuyến nghị):

gcloud config set compute/region us-central1

gcloud config set compute/zone us-central1-a

Bước 2: Kiểm Tra Các API Cần Thiết

Trước khi triển khai, hãy đảm bảo rằng các dịch vụ cần thiết đã được kích hoạt trong dự án của bạn.

Kiểm tra các dịch vụ đã được kích hoạt:

gcloud services list --enabled

Nếu có bất kỳ dịch vụ nào còn thiếu, hãy kích hoạt chúng bằng các lệnh sau:

gcloud services enable artifactregistry.googleapis.com

gcloud services enable cloudbuild.googleapis.com

gcloud services enable run.googleapis.com

gcloud services enable compute.googleapis.com

Bước 3: Tạo Kho Lưu Trữ Artifact Registry

Artifact Registry là nơi được khuyến nghị để lưu trữ hình ảnh Docker của bạn.

Kiểm tra các kho lưu trữ hiện có:

gcloud artifacts repositories list

Tạo kho lưu trữ:

gcloud artifacts repositories create springboot-docker-repo --repository-format=docker --location=us-central1 --description="Docker repo for Spring Boot images"

Xác nhận:

gcloud artifacts repositories list

Bước 4: Tạo Dockerfile Đa Giai Đoạn Trong Ứng Dụng Spring Boot

Trong thư mục gốc của dự án Spring Boot của bạn, thêm một file có tên Dockerfile với nội dung như sau:

# Chọn image Java
FROM openjdk:11-jre-slim

# Thiết lập thư mục làm việc
WORKDIR /app

# Sao chép mã nguồn vào container
COPY target/myapp.jar myapp.jar

# Chạy ứng dụng
CMD ["java", "-jar", "myapp.jar"]

Bước 5: Xây Dựng và Đẩy Ảnh Docker Sử Dụng Cloud Build

Thay vì xây dựng cục bộ với Docker, bạn có thể sử dụng Cloud Build để xây dựng và đẩy hình ảnh trực tiếp đến Artifact Registry.

Thiết lập đường dẫn thư mục đến thư mục gốc của ứng dụng Spring Boot:

Kiểm tra kho lưu trữ Artifact để xem có hình ảnh nào đã có sẵn không:

gcloud artifacts docker images list us-central1-docker.pkg.dev/[YOUR_PROJECT_ID]/springboot-docker-repo

Xây dựng & Đẩy:

gcloud builds submit --tag=us-central1-docker.pkg.dev/[YOUR_PROJECT_ID]/springboot-docker-repo/cloudrunspringbootdeploy:v1

Lệnh này sẽ:

• Xây dựng hình ảnh Docker trên Google Cloud.
• Gán nhãn cho nó với đường dẫn kho lưu trữ Artifact đã chỉ định.
• Tự động đẩy nó đến kho lưu trữ Artifact của bạn.

Xác nhận:
Hình ảnh đã được tạo và đẩy vào kho lưu trữ Artifact.

Bước 6: Triển Khai Trên Cloud Run

Triển khai container trực tiếp từ Artifact Registry:

gcloud run deploy springboot-service --image=us-central1-docker.pkg.dev/[YOUR_PROJECT_ID]/springboot-docker-repo/cloudrunspringbootdeploy:v1 --region=us-central1 --allow-unauthenticated

Xác nhận:
Có một endpoint /healthCheck được định nghĩa trong ứng dụng Spring Boot như hình bên dưới. Bạn có thể truy cập endpoint REST thông qua trình duyệt.

Thực Hành Tốt Nhất

• Sử dụng biến môi trường: Đảm bảo rằng mọi thông tin nhạy cảm như mật khẩu hoặc khóa API đều được lưu trữ an toàn thông qua biến môi trường.
• Giám sát ứng dụng: Sử dụng Google Cloud Monitoring để theo dõi hiệu suất và phát hiện sự cố.

Câu Hỏi Thường Gặp

1. Tôi có cần phải có kinh nghiệm với Docker không?
Có, một chút kiến thức về Docker sẽ hữu ích nhưng không bắt buộc.

2. Có cách nào khác để triển khai ứng dụng không?
Có, bạn có thể sử dụng Google Kubernetes Engine hoặc App Engine tùy vào nhu cầu của bạn.

Kết Luận

Triển khai ứng dụng Spring Boot lên Google Cloud Run giúp bạn tiết kiệm thời gian và công sức trong việc quản lý hạ tầng. Hy vọng rằng qua bài viết này, bạn đã có thể thực hiện từng bước để triển khai ứng dụng của mình thành công. Hãy thử nghiệm và khám phá thêm các tính năng khác của Google Cloud!

Chúng tôi khuyến khích bạn tìm hiểu thêm về các dịch vụ của Google Cloud và áp dụng vào dự án của mình.