Kết nối ứng dụng của bạn với dữ liệu AlloyDB và triển khai trên Cloud Run

1. Tổng quan

Trong lớp học lập trình này, chúng ta sẽ trình bày một phương thức đơn giản, dễ thực hiện để thiết lập AlloyDB và kết nối ứng dụng của chúng ta với AlloyDB. Đây là một lớp học cấp độ L100 giúp nâng cao trải nghiệm của nhà phát triển khi tích hợp các ứng dụng AI nâng cao vào các tính năng dữ liệu phức tạp mà AlloyDB cung cấp.

Sản phẩm bạn sẽ tạo ra

Một ứng dụng web đơn giản.

Trong quá trình này, bạn sẽ:

1. Tạo một thực thể và cụm AlloyDB bằng cách cài đặt chỉ bằng một cú nhấp chuột
2. Tạo một ứng dụng mẫu để kết nối với thực thể này và thiết lập dữ liệu

Ứng dụng này sẽ chỉ kết nối với quá trình thiết lập cơ sở dữ liệu mà bạn đã thực hiện ở bước 1, đồng thời tạo một bảng và chèn một bản ghi vào đó.

Yêu cầu

• Một trình duyệt, chẳng hạn như Chrome hoặc Firefox
• Một dự án trên Google Cloud đã bật tính năng thanh toán.

2. Trước khi bắt đầu

Tạo dự án

1. Trong Google Cloud Console, trên trang bộ chọn dự án, hãy chọn hoặc tạo một dự án trên Google Cloud.
2. Đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án trên Cloud. Tìm hiểu cách kiểm tra xem bạn đã bật tính năng thanh toán cho một dự án hay chưa.
3. Bạn sẽ sử dụng Cloud Shell, một môi trường dòng lệnh chạy trong Google Cloud. Nhấp vào Kích hoạt Cloud Shell ở đầu bảng điều khiển Cloud.

4. Sau khi kết nối với Cloud Shell, bạn hãy kiểm tra để đảm bảo rằng bạn đã được xác thực và dự án được đặt thành mã dự án của bạn bằng lệnh sau:

gcloud auth list

5. Chạy lệnh sau trong Cloud Shell để xác nhận rằng lệnh gcloud biết về dự án của bạn.

gcloud config list project

6. Nếu dự án của bạn chưa được thiết lập, hãy dùng lệnh sau để thiết lập:

gcloud config set project <YOUR_PROJECT_ID>

7. Bật các API bắt buộc: Làm theo đường liên kết và bật các API.

Ngoài ra, bạn có thể sử dụng lệnh gcloud cho việc này. Tham khảo tài liệu về các lệnh gcloud và cách sử dụng.

3. Thiết lập cơ sở dữ liệu

Trong phòng thí nghiệm này, chúng ta sẽ sử dụng AlloyDB làm cơ sở dữ liệu cho dữ liệu kiểm thử. AlloyDB sử dụng cụm để lưu giữ tất cả tài nguyên, chẳng hạn như cơ sở dữ liệu và nhật ký. Mỗi cụm có một thực thể chính cung cấp một điểm truy cập vào dữ liệu. Bảng sẽ lưu giữ dữ liệu thực tế.

Hãy tạo một cụm, thực thể và bảng AlloyDB để tải tập dữ liệu kiểm thử.

1. Nhấp vào nút hoặc Sao chép đường liên kết bên dưới vào trình duyệt mà bạn đã đăng nhập vào người dùng Google Cloud Console.

One Click &Run

2. Sau khi hoàn tất bước này, kho lưu trữ sẽ được sao chép vào trình chỉnh sửa Cloud Shell cục bộ và bạn có thể chạy lệnh bên dưới từ thư mục dự án (quan trọng là phải đảm bảo bạn đang ở trong thư mục dự án):

sh run.sh

3. Bây giờ, hãy sử dụng giao diện người dùng (nhấp vào đường liên kết trong dòng lệnh hoặc nhấp vào đường liên kết "xem trước trên web" trong dòng lệnh).
4. Nhập thông tin chi tiết về mã dự án, tên cụm và tên thực thể để bắt đầu.
5. Hãy đi lấy một tách cà phê trong khi các nhật ký cuộn và bạn có thể đọc về cách nhật ký thực hiện việc này ở hậu trường tại đây.

4. Tạo ứng dụng mẫu để kiểm thử kết nối

Trong Dòng lệnh Cloud Shell, hãy chạy lệnh sau

git clone https://github.com/AbiramiSukumaran/verify-easy-alloydb-connection

Thay đổi tệp verify_connection.py cho quá trình thiết lập AlloyDB mà bạn vừa định cấu hình trong phần cuối cùng:

# Replace this with the Private IP of your AlloyDB Instance
DB_HOST = <<>> 
DB_PORT = "5432"
DB_NAME = "postgres"
DB_USER = "postgres"
# Replace this with your actual AlloyDB password    
DB_PASS = <<>>

Nếu bạn muốn kiểm thử cục bộ hoặc từ bất cứ đâu, hãy chuyển đến thực thể AlloyDB, nhấp vào "CHỈNH SỬA" rồi nhấp vào "Bật IP công khai" hoặc "Kết nối IP công khai" (không phải IP исходящий) và nhập "0.0.0.0/0" trong "Mạng bên ngoài được uỷ quyền" cho mục đích phát triển, nhưng sau khi hoàn tất, hãy xoá và tắt kết nối IP công khai.

5. Triển khai lên Cloud Run

Trong Dòng lệnh Cloud Shell, hãy đảm bảo bạn đang ở bên trong thư mục chính và trong thư mục dự án.

Sau khi bạn chắc chắn đang ở trong thư mục dự án, hãy chạy lệnh sau:

gcloud beta run deploy verify-alloydb \
    --source . \
    --region=us-central1 \
    --network=easy-alloydb-vpc \
    --subnet=easy-alloydb-subnet \
    --allow-unauthenticated \
    --vpc-egress=all-traffic

Sau khi triển khai, bạn sẽ nhận được một Điểm cuối Cloud Run đã triển khai có dạng như sau:

https://verify-alloydb-**********-uc.a.run.app/

6. Bản minh hoạ

Để xác nhận rằng quá trình này đã hoạt động, bạn có thể xem kết quả trên trình duyệt hoặc trình khám phá nhật ký.

Bạn có thể chuyển đến AlloyDB trên Google Cloud Console và mở thực thể mới tạo. Nhấp vào "AlloyDB Studio" trong ngăn điều hướng ở bên trái rồi kết nối bằng thông tin đăng nhập của bạn.

Trong studio, trên ngăn bên trái, hãy làm mới các đối tượng cơ sở dữ liệu và bạn sẽ thấy bảng mới tạo:

Bạn có thể nhanh chóng truy vấn để xác minh rằng quá trình chèn đã hoàn tất thành công:

7. Dọn dẹp

Sau khi hoàn tất phòng thí nghiệm dùng thử này, đừng quên xoá cụm và thực thể alloyDB.

Truy cập vào https://console.cloud.google.com/alloydb/clusters. Chọn cụm mà bạn muốn xoá bằng cách nhấp vào dấu ba chấm dọc bên cạnh cụm đó rồi nhấp vào XOÁ.

Thao tác này sẽ dọn dẹp cụm cùng với(các) thực thể của cụm đó.

8. Kết luận

Bắt đầu thiết lập dữ liệu của bạn một cách nhanh chóng và dễ dàng bằng AlloyDB!!!