การสร้างแอปพลิเคชันแชท LLM และ RAG โดยใช้ฐานข้อมูล Cloud SQL และ LangChain

1. บทนำ

ใน Codelab นี้ คุณจะได้เรียนรู้วิธีทำให้บริการดึงข้อมูลฐานข้อมูล GenAI ใช้งานได้ และสร้างแอปพลิเคชันแบบอินเทอร์แอกทีฟตัวอย่างโดยใช้สภาพแวดล้อมที่ทำให้ระบบใช้งานได้

8727a44c8c402834.png

ดูข้อมูลเพิ่มเติมเกี่ยวกับบริการดึงข้อมูล GenAI และแอปพลิเคชันตัวอย่างได้ที่นี่

ข้อกำหนดเบื้องต้น

  • ความเข้าใจเบื้องต้นเกี่ยวกับคอนโซล Google Cloud
  • ทักษะพื้นฐานในอินเทอร์เฟซบรรทัดคำสั่งและ Google Cloud Shell

สิ่งที่คุณจะได้เรียนรู้

  • วิธีสร้างอินสแตนซ์ Cloud SQL
  • วิธีเชื่อมต่อกับอินสแตนซ์
  • วิธีกำหนดค่าและทำให้บริการดึงข้อมูลฐานข้อมูล GenAI ใช้งานได้
  • วิธีทำให้แอปพลิเคชันตัวอย่างใช้งานได้โดยใช้บริการที่ทำให้ใช้งานได้

สิ่งที่คุณต้องมี

  • บัญชี Google Cloud และโปรเจ็กต์ Google Cloud
  • เว็บเบราว์เซอร์ เช่น Chrome

2. การตั้งค่าและข้อกำหนด

การตั้งค่าสภาพแวดล้อมตามเวลาที่สะดวก

  1. ลงชื่อเข้าใช้ Google Cloud Console และสร้างโปรเจ็กต์ใหม่หรือใช้โปรเจ็กต์ที่มีอยู่อีกครั้ง หากยังไม่มีบัญชี Gmail หรือ Google Workspace คุณต้องสร้างบัญชี

fbef9caa1602edd0.png

a99b7ace416376c4.png

5e3ff691252acf41.png

  • ชื่อโครงการคือชื่อที่แสดงของผู้เข้าร่วมโปรเจ็กต์นี้ เป็นสตริงอักขระที่ Google APIs ไม่ได้ใช้ โดยคุณจะอัปเดตวิธีการชำระเงินได้ทุกเมื่อ
  • รหัสโปรเจ็กต์จะไม่ซ้ำกันในทุกโปรเจ็กต์ของ Google Cloud และจะเปลี่ยนแปลงไม่ได้ (เปลี่ยนแปลงไม่ได้หลังจากตั้งค่าแล้ว) Cloud Console จะสร้างสตริงที่ไม่ซ้ำกันโดยอัตโนมัติ ปกติแล้วคุณไม่สนว่าอะไรเป็นอะไร ใน Codelab ส่วนใหญ่ คุณจะต้องอ้างอิงรหัสโปรเจ็กต์ (โดยปกติจะระบุเป็น PROJECT_ID) หากคุณไม่ชอบรหัสที่สร้างขึ้น คุณสามารถสร้างรหัสแบบสุ่มอื่นได้ หรือคุณจะลองดำเนินการเองแล้วดูว่าพร้อมให้ใช้งานหรือไม่ คุณจะเปลี่ยนแปลงหลังจากขั้นตอนนี้ไม่ได้และจะยังคงอยู่ตลอดระยะเวลาของโปรเจ็กต์
  • สำหรับข้อมูลของคุณ ค่าที่ 3 คือหมายเลขโปรเจ็กต์ ซึ่ง API บางตัวใช้ ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าทั้ง 3 ค่าเหล่านี้ในเอกสารประกอบ
  1. ถัดไป คุณจะต้องเปิดใช้การเรียกเก็บเงินใน Cloud Console เพื่อใช้ทรัพยากร/API ของระบบคลาวด์ การใช้งาน Codelab นี้จะไม่มีค่าใช้จ่ายใดๆ หากมี หากต้องการปิดทรัพยากรเพื่อหลีกเลี่ยงการเรียกเก็บเงินที่นอกเหนือจากบทแนะนำนี้ คุณสามารถลบทรัพยากรที่คุณสร้างหรือลบโปรเจ็กต์ได้ ผู้ใช้ Google Cloud ใหม่มีสิทธิ์เข้าร่วมโปรแกรมช่วงทดลองใช้ฟรี$300 USD

เริ่มต้น Cloud Shell

แม้ว่าคุณจะดำเนินการ Google Cloud จากระยะไกลได้จากแล็ปท็อป แต่คุณจะใช้ Google Cloud Shell ซึ่งเป็นสภาพแวดล้อมแบบบรรทัดคำสั่งที่ทำงานในระบบคลาวด์ใน Codelab นี้

จากคอนโซล Google Cloud ให้คลิกไอคอน Cloud Shell ในแถบเครื่องมือด้านขวาบน ดังนี้

55efc1aaa7a4d3ad.png

การจัดสรรและเชื่อมต่อกับสภาพแวดล้อมนี้ควรใช้เวลาเพียงครู่เดียว เมื่อเสร็จแล้ว คุณจะเห็นข้อมูลต่อไปนี้

7ffe5cbb04455448.png

เครื่องเสมือนนี้เต็มไปด้วยเครื่องมือการพัฒนาทั้งหมดที่คุณต้องการ โดยมีไดเรกทอรีหลักขนาด 5 GB ที่ใช้งานได้ต่อเนื่องและทำงานบน Google Cloud ซึ่งช่วยเพิ่มประสิทธิภาพของเครือข่ายและการตรวจสอบสิทธิ์ได้อย่างมาก งานทั้งหมดใน Codelab นี้ทำได้ในเบราว์เซอร์ คุณไม่จำเป็นต้องติดตั้งอะไรเลย

3. ก่อนเริ่มต้น

เปิดใช้ API

ตรวจสอบใน Cloud Shell ว่าได้ตั้งค่ารหัสโปรเจ็กต์แล้ว ดังนี้

โดยปกติแล้ว รหัสโปรเจ็กต์จะแสดงในวงเล็บในพรอมต์คำสั่งใน Cloud Shell ดังที่แสดงในภาพ

fa6ee779963405d5.png

gcloud config set project [YOUR-PROJECT-ID]

จากนั้นตั้งค่าตัวแปรสภาพแวดล้อม PROJECT_ID เป็นรหัสโปรเจ็กต์ Google Cloud ดังนี้

PROJECT_ID=$(gcloud config get-value project)

เปิดใช้บริการที่จำเป็นทั้งหมด

gcloud services enable sqladmin.googleapis.com \
                       compute.googleapis.com \
                       cloudresourcemanager.googleapis.com \
                       servicenetworking.googleapis.com \
                       vpcaccess.googleapis.com \
                       aiplatform.googleapis.com \
                       cloudbuild.googleapis.com \
                       artifactregistry.googleapis.com \
                       run.googleapis.com \
                       iam.googleapis.com

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (gleb-test-short-004)$ gcloud services enable sqladmin.googleapis.com \
                       compute.googleapis.com \
                       cloudresourcemanager.googleapis.com \
                       servicenetworking.googleapis.com \
                       vpcaccess.googleapis.com \
                       aiplatform.googleapis.com \
                       cloudbuild.googleapis.com \
                       artifactregistry.googleapis.com \
                       run.googleapis.com \
                       iam.googleapis.com
Operation "operations/acf.p2-404051529011-664c71ad-cb2b-4ab4-86c1-1f3157d70ba1" finished successfully.

4. สร้างอินสแตนซ์ Cloud SQL

สร้างอินสแตนซ์ Cloud SQL ที่เปิดใช้การสนับสนุนเวกเตอร์

สร้างรหัสผ่าน

กำหนดรหัสผ่านสำหรับผู้ใช้ฐานข้อมูลเริ่มต้น คุณจะกำหนดรหัสผ่านของตัวเองหรือใช้ฟังก์ชันแบบสุ่มเพื่อสร้างรหัสผ่านก็ได้

export CLOUDSQL_PASSWORD=`openssl rand -hex 12`

จดค่าที่สร้างขึ้นสำหรับรหัสผ่าน

echo $CLOUDSQL_PASSWORD

MySQL

คุณเปิดใช้แฟล็ก cloudsql_vector ได้เมื่อสร้างอินสแตนซ์ ปัจจุบันมีการสนับสนุนเวกเตอร์ใน MySQL 8.0.36 และ 8.0.37.

export region=us-central1
gcloud sql instances create my-cloudsql-instance --region=$region --database-version=MYSQL_8_0_36 --database-flags=cloudsql_vector=ON --root-password=$CLOUDSQL_PASSWORD

เอาต์พุตคอนโซลที่คาดไว้ (ปกปิดที่อยู่ IP)

student@cloudshell:~ export region=us-central1
gcloud sql instances create my-cloudsql-instance --region=$region --database-version=MYSQL_8_0_36 --database-flags=cloudsql_vector=ON --root-password=$CLOUDSQL_PASSWORD
Creating Cloud SQL instance for MYSQL_8_0_36...done.                                                                                                                                 
Created [https://sqladmin.googleapis.com/sql/v1beta4/projects/test-project-402417/instances/my-cloudsql-instance].
NAME                   DATABASE_VERSION  LOCATION       TIER             PRIMARY_ADDRESS  PRIVATE_ADDRESS  STATUS
my-cloudsql-instance  MYSQL_8_0_36      us-central1-a  db-n1-standard-1  00.000.00.00   -                RUNNABLE

PostgreSQL

มีส่วนขยาย pgvector ในเวอร์ชัน >= 11

export region=us-central1
gcloud sql instances create my-cloudsql-instance --region=$region --database-version=POSTGRES_15 --tier=db-g1-small

เอาต์พุตคอนโซลที่คาดไว้ (ปกปิดที่อยู่ IP)

student@cloudshell:~ export region=us-central1
gcloud sql instances create my-cloudsql-instance --region=$region --database-version=POSTGRES_15 --tier=db-g1-small
Creating Cloud SQL instance for POSTGRES_15...done.                                                                                                                                  
Created [https://sqladmin.googleapis.com/sql/v1beta4/projects/test-project-402417/instances/my-cloudsql-instance].
NAME                   DATABASE_VERSION  LOCATION       TIER         PRIMARY_ADDRESS  PRIVATE_ADDRESS  STATUS
my-cloudsql-instance  POSTGRES_15       us-central1-a  db-g1-small  00.000.00.00     -                RUNNABLE

หลังจากสร้างอินสแตนซ์ เราต้องกำหนดรหัสผ่านสำหรับผู้ใช้เริ่มต้นในอินสแตนซ์ และตรวจสอบว่าเราเชื่อมต่อกับรหัสผ่านได้หรือไม่ ใส่รหัสผ่านในข้อความแจ้งเมื่อพร้อมเชื่อมต่อ

gcloud sql users set-password postgres \
    --instance=my-cloudsql-instance \
    --password=$CLOUDSQL_PASSWORD
gcloud sql connect my-cloudsql-instance --user=postgres

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-402417)$ gcloud sql users set-password postgres \
    --instance=my-cloudsql-instance \
    --password=$CLOUDSQL_PASSWORD
gcloud sql connect my-cloudsql-instance --user=postgres
Updating Cloud SQL user...done.                                                                                                                                                                                                                                            
Allowlisting your IP for incoming connection for 5 minutes...done.                                                                                                                                                                                                         
Connecting to database with SQL user [postgres].Password: 
psql (16.3 (Ubuntu 16.3-1.pgdg22.04+1), server 15.7)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.

postgres=>

ออกจากเซสชัน psql

exit

5. เตรียมเครื่องเสมือน GCE

สร้างบัญชีบริการ

เนื่องจากเราจะใช้ VM เพื่อทำให้บริการดึงข้อมูลฐานข้อมูล GenAI และโฮสต์แอปพลิเคชันตัวอย่าง ขั้นตอนแรกคือการสร้างบัญชีบริการของ Google (GSA) GCE จะนำ GSA ไปใช้และเราจะต้องมอบสิทธิ์ที่จำเป็นในการทำงานร่วมกับบริการอื่นๆ

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts create compute-aip --project $PROJECT_ID
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudbuild.builds.editor"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/artifactregistry.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/storage.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/run.admin"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/iam.serviceAccountUser"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudsql.viewer"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudsql.client"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

ทำให้ GCE VM ใช้งานได้

สร้าง GCE VM ในภูมิภาคและ VPC เดียวกันกับอินสแตนซ์ Cloud SQL

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

export ZONE=us-central1-a
gcloud compute instances create instance-1 \
    --zone=$ZONE \
    --create-disk=auto-delete=yes,boot=yes,image=projects/debian-cloud/global/images/$(gcloud compute images list --filter="family=debian-12 AND family!=debian-12-arm64" --format="value(name)") \
    --scopes=https://www.googleapis.com/auth/cloud-platform \
  --service-account=compute-aip@$PROJECT_ID.iam.gserviceaccount.com

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-402417)$ export ZONE=us-central1-a
student@cloudshell:~ (test-project-402417)$ export ZONE=us-central1-a
gcloud compute instances create instance-1 \
    --zone=$ZONE \
    --create-disk=auto-delete=yes,boot=yes,image=projects/debian-cloud/global/images/$(gcloud compute images list --filter="family=debian-12 AND family!=debian-12-arm64" --format="value(name)") \
    --scopes=https://www.googleapis.com/auth/cloud-platform

Created [https://www.googleapis.com/compute/v1/projects/test-project-402417/zones/us-central1-a/instances/instance-1].
NAME: instance-1
ZONE: us-central1-a
MACHINE_TYPE: n1-standard-1
PREEMPTIBLE: 
INTERNAL_IP: 10.128.0.2
EXTERNAL_IP: 34.71.192.233
STATUS: RUNNING

ให้สิทธิ์ VM เพื่อเชื่อมต่อกับ Cloud SQL

เราต้องเพิ่ม IP สาธารณะของ VM ลงในรายการเครือข่ายที่ได้รับอนุญาตสำหรับอินสแตนซ์ Cloud SQL ดำเนินการต่อไปนี้ใน Cloud Shell

VM_EXTERNAL_IP=$(gcloud compute instances describe instance-1 --zone=us-central1-a --format='get(networkInterfaces[0].accessConfigs[0].natIP)')
gcloud sql instances patch my-cloudsql-instance --authorized-networks=$VM_EXTERNAL_IP

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-402417)$ export ZONE=us-central1-a
student@cloudshell:~ (test-project-402417)$ VM_EXTERNAL_IP=$(gcloud compute instances describe instance-1 --zone=us-central1-a --format='get(networkInterfaces[0].accessConfigs[0].natIP)')
gcloud sql instances patch my-cloudsql-instance --authorized-networks=$VM_EXTERNAL_IP
When adding a new IP address to authorized networks, make sure to also include any IP addresses that have already been authorized. Otherwise, they will be overwritten and de-authorized.

Do you want to continue (Y/n)?  Y

The following message will be used for the patch API method.
{"name": "my-cloudsql-instance", "project": "test-project-402417", "settings": {"ipConfiguration": {"authorizedNetworks": [{"value": "34.71.252.173"}]}}}
Patching Cloud SQL instance...done.                                                                                                                                                                                     
Updated [https://sqladmin.googleapis.com/sql/v1beta4/projects/test-project-402417/instances/my-cloudsql-instance].

ติดตั้งไคลเอ็นต์ฐานข้อมูล

MySQL

ติดตั้งซอฟต์แวร์ไคลเอ็นต์ MySQL บน VM ที่ทำให้ใช้งานได้

เชื่อมต่อกับ VM:

gcloud compute ssh instance-1 --zone=us-central1-a

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-402417)$ gcloud compute ssh instance-1 --zone=us-central1-a
Updating project ssh metadata...working..Updated [https://www.googleapis.com/compute/v1/projects/test-project-402417].                                                                                                                                                         
Updating project ssh metadata...done.                                                                                                                                                                                                                                              
Waiting for SSH key to propagate.
Warning: Permanently added 'compute.5110295539541121102' (ECDSA) to the list of known hosts.
Linux instance-1 5.10.0-26-cloud-amd64 #1 SMP Debian 5.10.197-1 (2023-09-29) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
student@instance-1:~$ 

ติดตั้งซอฟต์แวร์ที่เรียกใช้คำสั่งภายใน VM ดังต่อไปนี้

sudo apt-get update
sudo apt-get install --yes default-mysql-client

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ sudo apt-get update
sudo apt-get install --yes mysql-client
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  libconfig-inifiles-perl libdbd-mariadb-perl libdbi-perl libgdbm-compat4 libperl5.32 libterm-readkey-perl mariadb-client-10.5 mariadb-client-core-10.5 perl perl-modules-5.32
Suggested packages:
  libclone-perl libmldbm-perl libnet-daemon-perl libsql-statement-perl perl-doc libterm-readline-gnu-perl | libterm-readline-perl-perl make libtap-harness-archive-perl
The following NEW packages will be installed:
  default-mysql-client libconfig-inifiles-perl libdbd-mariadb-perl libdbi-perl libgdbm-compat4 libperl5.32 libterm-readkey-perl mariadb-client-10.5 mariadb-client-core-10.5 perl
  Perl-modules-5.32
...redacted...
Processing triggers for libc-bin (2.31-13+deb11u10) ...

PostgreSQL

ติดตั้งซอฟต์แวร์ไคลเอ็นต์ PostgreSQL บน VM ที่ทำให้ใช้งานได้แล้ว

เชื่อมต่อกับ VM:

gcloud compute ssh instance-1 --zone=us-central1-a

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-402417)$ gcloud compute ssh instance-1 --zone=us-central1-a
Updating project ssh metadata...working..Updated [https://www.googleapis.com/compute/v1/projects/test-project-402417].                                                                                                                                                         
Updating project ssh metadata...done.                                                                                                                                                                                                                                              
Waiting for SSH key to propagate.
Warning: Permanently added 'compute.5110295539541121102' (ECDSA) to the list of known hosts.
Linux instance-1 5.10.0-26-cloud-amd64 #1 SMP Debian 5.10.197-1 (2023-09-29) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
student@instance-1:~$ 

ติดตั้งซอฟต์แวร์ที่เรียกใช้คำสั่งภายใน VM ดังต่อไปนี้

sudo apt-get update
sudo apt-get install --yes postgresql-client

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ sudo apt-get update
sudo apt-get install --yes postgresql-client
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:4 file:/etc/apt/mirrors/debian-security.list Mirrorlist [39 B]
Hit:7 https://packages.cloud.google.com/apt google-compute-engine-bookworm-stable InRelease
Get:8 https://packages.cloud.google.com/apt cloud-sdk-bookworm InRelease [1652 B]
Get:2 https://deb.debian.org/debian bookworm InRelease [151 kB]
Get:3 https://deb.debian.org/debian bookworm-updates InRelease [55.4 kB]
...redacted...
update-alternatives: using /usr/share/postgresql/15/man/man1/psql.1.gz to provide /usr/share/man/man1/psql.1.gz (psql.1.gz) in auto mode
Setting up postgresql-client (15+248) ...
Processing triggers for man-db (2.11.2-2) ...
Processing triggers for libc-bin (2.36-9+deb12u7) ...

เชื่อมต่อกับอินสแตนซ์

MySQL

เชื่อมต่อกับอินสแตนซ์หลักจาก VM โดยใช้ MySQL

ดำเนินการต่อด้วยเซสชัน SSH ที่เปิดอยู่ไปยัง VM หากถูกตัดการเชื่อมต่อ ให้เชื่อมต่ออีกครั้งโดยใช้คำสั่งเดียวกับด้านบน

ใช้ $CLOUDSQL_PASSWORD ที่บันทึกไว้ก่อนหน้านี้และชื่ออินสแตนซ์เพื่อเชื่อมต่อกับ Cloud SQL จาก GCE VM:

export CLOUDSQL_PASSWORD=<Noted password>
export PROJECT_ID=$(gcloud config get-value project)
export REGION=us-central1
export INSTANCE_NAME=my-cloudsql-instance
export INSTANCE_IP=$(gcloud sql instances list --filter=name:$INSTANCE_NAME --format="value(PRIMARY_ADDRESS)")
mysql --host=$INSTANCE_IP --user=root --password=$CLOUDSQL_PASSWORD

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ export CLOUDSQL_PASSWORD=P9...
student@instance-1:~$ export REGION=us-central1
student@instance-1:~$ export INSTANCE_NAME=my-cloud-sql-instance
student@instance-1:~$ export INSTANCE_IP=$(gcloud sql instances list --filter=name:$INSTANCE_NAME --format="value(PRIMARY_ADDRESS)")
student@instance-1:~$ mysql  –host=$INSTANCE_IP –user=root –password=$CLOUDSQL_PASSWORD –sslmode=require 
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MySQL connection id is 2824706
Server version: 8.0.36-google (Google)

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MySQL [(none)]>

ออกจากเซสชัน MySQL เพื่อรักษาการเชื่อมต่อ SSH เอาไว้ ดังนี้

exit

เอาต์พุตคอนโซลที่คาดไว้:

MySQL [(none)]> exit
Bye
student@instance-1:~$ 

PostgreSQL

เชื่อมต่อกับอินสแตนซ์หลักจาก VM โดยใช้ psql

ดำเนินการต่อด้วยเซสชัน SSH ที่เปิดอยู่ไปยัง VM หากคุณถูกตัดการเชื่อมต่อ ให้เชื่อมต่ออีกครั้งโดยใช้คำสั่งเดียวกับด้านบน

ใช้ $CLOUDSQL_PASSWORD ที่บันทึกไว้ก่อนหน้านี้และชื่ออินสแตนซ์เพื่อเชื่อมต่อกับ PostgreSQL จาก GCE VM:

export PGPASSWORD=<Noted password (CLOUDSQL_PASSWORD)>
export CLOUDSQL_PASSWORD=$PGPASSWORD
export PROJECT_ID=$(gcloud config get-value project)
export REGION=us-central1
export INSTANCE_NAME=my-cloudsql-instance
export INSTANCE_IP=$(gcloud sql instances list --filter=name:$INSTANCE_NAME --format="value(PRIMARY_ADDRESS)")
psql "host=$INSTANCE_IP user=postgres sslmode=require"

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ export CLOUDSQL_PASSWORD=P9...
student@instance-1:~$ export REGION=us-central1
student@instance-1:~$ export INSTANCE_IP=$(gcloud sql instances list --filter=name:$INSTANCE_NAME --format="value(PRIMARY_ADDRESS)")
student@instance-1:~$ psql "host=$INSTANCE_IP user=postgres sslmode=require"
psql (13.11 (Debian 13.11-0+deb11u1), server 14.7)
WARNING: psql major version 13, server major version 14.
         Some psql features might not work.
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)
Type "help" for help.

postgres=> 

ออกจากเซสชัน psql เพื่อรักษาการเชื่อมต่อ SSH เอาไว้ โดยทำดังนี้

exit

เอาต์พุตคอนโซลที่คาดไว้:

postgres=> exit
student@instance-1:~$ 

6. เริ่มต้นฐานข้อมูล

เราจะใช้ VM ของไคลเอ็นต์ เป็นแพลตฟอร์มเพื่อป้อนข้อมูลในฐานข้อมูลและโฮสต์แอปพลิเคชันของเรา ขั้นตอนแรกคือการสร้างฐานข้อมูลและเติมข้อมูลลงในฐานข้อมูล

สร้างฐานข้อมูล

MySQL

สร้างฐานข้อมูลด้วยชื่อ "assistantdemo"

ดำเนินการต่อไปนี้ในเซสชัน VM ของ GCE

mysql --host=$INSTANCE_IP  --user=root --password=$CLOUDSQL_PASSWORD -e "CREATE DATABASE assistantdemo"

เอาต์พุตคอนโซลที่คาดไว้ (ไม่มีเอาต์พุต):

student@instance-1:~$ mysql --host=$INSTANCE_IP  --user=root --password=$CLOUDSQL_PASSWORD -e "CREATE DATABASE assistantdemo"
student@instance-1:~$  

PostgreSQL

สร้างฐานข้อมูลด้วยชื่อ "assistantdemo"

ดำเนินการต่อไปนี้ในเซสชัน VM ของ GCE

psql "host=$INSTANCE_IP user=postgres" -c "CREATE DATABASE assistantdemo"  

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ psql "host=$INSTANCE_IP user=postgres" -c "CREATE DATABASE assistantdemo"
CREATE DATABASE
student@instance-1:~$  

เปิดใช้ส่วนขยาย pgvector

psql "host=$INSTANCE_IP user=postgres dbname=assistantdemo" -c "CREATE EXTENSION vector"  

เอาต์พุตคอนโซลที่คาดไว้ (ไม่มีเอาต์พุต):

student@instance-1:~$ psql "host=$INSTANCE_IP user=postgres dbname=assistantdemo" -c "CREATE EXTENSION vector"
CREATE EXTENSION
student@instance-1:~$

เตรียมสภาพแวดล้อม Python

ในการดำเนินการต่อ เราจะใช้สคริปต์ Python ที่เตรียมไว้จากที่เก็บ GitHub แต่ก่อนที่จะดำเนินการดังกล่าว เราจำเป็นต้องติดตั้งซอฟต์แวร์ที่จำเป็น

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

sudo apt install -y python3.11-venv git
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ sudo apt install -y python3.11-venv git
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  git-man liberror-perl patch python3-distutils python3-lib2to3 python3-pip-whl python3-setuptools-whl
Suggested packages:
  git-daemon-run | git-daemon-sysvinit git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn ed diffutils-doc
The following NEW packages will be installed:
  git git-man liberror-perl patch python3-distutils python3-lib2to3 python3-pip-whl python3-setuptools-whl python3.11-venv
0 upgraded, 9 newly installed, 0 to remove and 2 not upgraded.
Need to get 12.4 MB of archives.
After this operation, 52.2 MB of additional disk space will be used.
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
...redacted...
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 23.0.1
    Uninstalling pip-23.0.1:
      Successfully uninstalled pip-23.0.1
Successfully installed pip-24.0
(.venv) student@instance-1:~$

ยืนยันเวอร์ชัน Python

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

python -V

เอาต์พุตคอนโซลที่คาดไว้:

(.venv) student@instance-1:~$ python -V
Python 3.11.2
(.venv) student@instance-1:~$ 

เตรียมไฟล์การกำหนดค่า

โคลนที่เก็บ GitHub ด้วยโค้ดสำหรับบริการเรียกข้อมูลและแอปพลิเคชันตัวอย่าง

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

git clone https://github.com/GoogleCloudPlatform/genai-databases-retrieval-app.git

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ git clone https://github.com/GoogleCloudPlatform/genai-databases-retrieval-app.git
Cloning into 'genai-databases-retrieval-app'...
remote: Enumerating objects: 525, done.
remote: Counting objects: 100% (336/336), done.
remote: Compressing objects: 100% (201/201), done.
remote: Total 525 (delta 224), reused 179 (delta 135), pack-reused 189
Receiving objects: 100% (525/525), 46.58 MiB | 16.16 MiB/s, done.
Resolving deltas: 100% (289/289), done.

MySQL

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

cd ~/genai-databases-retrieval-app/retrieval_service
cp example-config-cloudsql.yml config.yml
cp example-config-cloudsql.yml config.yml
sed -i s/engine/mysql/g config.yml
sed -i s/my-project/$PROJECT_ID/g config.yml
sed -i s/my-region/$REGION/g config.yml
sed -i s/my-instance/$INSTANCE_NAME/g config.yml
sed -i s/my-password//g config.yml
sed -i s/my_database/assistantdemo/g config.yml
sed -i s/my-user/root/g config.yml
cat config.yml

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ cd genai-databases-retrieval-app/retrieval_service
cp example-config-cloudsql.yml config.yml
sed -i s/127.0.0.1/$INSTANCE_IP/g config.yml
sed -i s/my-password/$CLOUDSQL_PASSWORD/g config.yml
sed -i s/my_database/assistantdemo/g config.yml
sed -i s/my-user/postgres/g config.yml
cat config.yml
host: 0.0.0.0
# port: 8080
datastore:
  # Example for MySQL
  kind: "cloudsql-mysql"
  host: 10.65.0.2
  # port: 5432
  database: "assistantdemo"
  user: "root"
  password: "P9..."

Postgres

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

cd ~/genai-databases-retrieval-app/retrieval_service
cp example-config-cloudsql.yml config.yml
sed -i s/engine/postgres/g config.yml
sed -i s/my-project/$PROJECT_ID/g config.yml
sed -i s/my-region/$REGION/g config.yml
sed -i s/my-instance/$INSTANCE_NAME/g config.yml
sed -i s/my-password/$PGPASSWORD/g config.yml
sed -i s/my_database/assistantdemo/g config.yml
sed -i s/my-user/postgres/g config.yml
cat config.yml

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~$ cd genai-databases-retrieval-app/retrieval_service
cp example-config-cloudsql.yml config.yml
sed -i s/engine/postgres/g config.yml
sed -i s/my-project/$PROJECT_ID/g config.yml
sed -i s/my-region/$REGION/g config.yml
sed -i s/my-instance/$INSTANCE_NAME/g config.yml
sed -i s/my-password/$CLOUDSQL_PASSWORD/g config.yml
sed -i s/my_database/assistantdemo/g config.yml
sed -i s/my-user/postgres/g config.yml
cat config.yml
host: 0.0.0.0
# port: 8080
datastore:
  # Example for Postgres
  kind: "cloudsql-postgres"
  host: 10.65.0.2
  # port: 5432
  database: "assistantdemo"
  user: "postgres"
  password: "P9..."

สร้างฐานข้อมูล

เติมข้อมูลฐานข้อมูลด้วยชุดข้อมูลตัวอย่าง คำสั่งแรกคือเพิ่มแพ็กเกจที่จำเป็นทั้งหมดลงในสภาพแวดล้อมเสมือนของ Python และคำสั่งที่ 2 กำลังใส่ข้อมูลในฐานข้อมูลของเรา

ในการดำเนินการ VM ของ GCE ให้ทำดังนี้

cd ~/genai-databases-retrieval-app/retrieval_service
pip install -r requirements.txt
python run_database_init.py

เอาต์พุตของคอนโซลที่คาดไว้ (ปกปิดไว้):

student@instance-1:~/genai-databases-retrieval-app/retrieval_service$ pip install -r requirements.txt
python run_database_init.py
Collecting asyncpg==0.28.0 (from -r requirements.txt (line 1))
  Obtaining dependency information for asyncpg==0.28.0 from https://files.pythonhosted.org/packages/77/a4/88069f7935b14c58534442a57be3299179eb46aace2d3c8716be199ff6a6/asyncpg-0.28.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata
  Downloading asyncpg-0.28.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (4.3 kB)
Collecting fastapi==0.101.1 (from -r requirements.txt (line 2))
...
database init done.
student@instance-1:~/genai-databases-retrieval-app/retrieval_service$

7. ทำให้บริการดึงข้อมูลใช้งานได้กับ Cloud Run

ตอนนี้ เราสามารถทำให้บริการดึงข้อมูลใช้งานได้กับ Cloud Run แล้ว บริการมีหน้าที่ทำงานกับฐานข้อมูลและดึงข้อมูลที่จำเป็นจากฐานข้อมูลตามคำขอจากแอปพลิเคชัน AI

สร้างบัญชีบริการ

สร้างบัญชีบริการสำหรับบริการดึงข้อมูลและให้สิทธิ์ที่จำเป็น

เปิดแท็บ Cloud Shell อีกแท็บโดยใช้เครื่องหมาย "+" ที่ด้านบน

4ca978f5142bb6ce.png

ในแท็บ Cloud Shell ใหม่จะมีการดำเนินการต่อไปนี้

export PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts create retrieval-identity
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:retrieval-identity@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"
gcloud projects add-iam-policy-binding $PROJECT_ID \
--member="serviceAccount:retrieval-identity@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudsql.client"

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (gleb-test-short-003)$ gcloud iam service-accounts create retrieval-identity
Created service account [retrieval-identity].

ปิดแท็บโดยใช้คำสั่งการดำเนินการ "exit" ในแท็บ

exit

ทำให้บริการดึงข้อมูลใช้งานได้

ดำเนินการต่อในแท็บแรกที่คุณเชื่อมต่อกับ VM ผ่าน SSH ด้วยการทำให้บริการใช้งานได้

ดำเนินการต่อไปนี้ในเซสชัน SSH บน VM

cd ~/genai-databases-retrieval-app
gcloud alpha run deploy retrieval-service \
    --source=./retrieval_service/\
    --no-allow-unauthenticated \
    --service-account retrieval-identity \
    --region us-central1 \
    --network=default \
    --quiet

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~/genai-databases-retrieval-app$ gcloud alpha run deploy retrieval-service \
    --source=./retrieval_service/\
    --no-allow-unauthenticated \
    --service-account retrieval-identity \
    --region us-central1 \
    --network=default
This command is equivalent to running `gcloud builds submit --tag [IMAGE] ./retrieval_service/` and `gcloud run deploy retrieval-service --image [IMAGE]`

Building using Dockerfile and deploying container to Cloud Run service [retrieval-service] in project [gleb-test-short-003] region [us-central1]
X Building and deploying... Done.
  ✓ Uploading sources...
  ✓ Building Container... Logs are available at [https://console.cloud.google.com/cloud-build/builds/6ebe74bf-3039-4221-b2e9-7ca8fa8dad8e?project=1012713954588].
  ✓ Creating Revision...
  ✓ Routing traffic...
    Setting IAM Policy...
Completed with warnings:
  Setting IAM policy failed, try "gcloud beta run services remove-iam-policy-binding --region=us-central1 --member=allUsers --role=roles/run.invoker retrieval-service"
Service [retrieval-service] revision [retrieval-service-00002-4pl] has been deployed and is serving 100 percent of traffic.
Service URL: https://retrieval-service-onme64eorq-uc.a.run.app
student@instance-1:~/genai-databases-retrieval-app$

ยืนยันบริการ

ตอนนี้เราสามารถตรวจสอบได้ว่าบริการทำงานได้อย่างถูกต้องและ VM มีสิทธิ์เข้าถึงปลายทางหรือไม่ เราใช้ยูทิลิตี gcloud เพื่อรับปลายทางบริการดึงข้อมูล หรือคุณจะตรวจสอบในคอนโซลระบบคลาวด์และแทนที่ "$(gcloud run services list –filter="(retrieval-service)" ในคำสั่ง curl ด้วยค่าจากที่นั่น

ดำเนินการต่อไปนี้ในเซสชัน SSH บน VM

curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" $(gcloud  run services list --filter="(retrieval-service)" --format="value(URL)")

เอาต์พุตคอนโซลที่คาดไว้:

student@instance-1:~/genai-databases-retrieval-app$ curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" $(gcloud  run services list --filter="(retrieval-service)" --format="value(URL)")
{"message":"Hello World"}student@instance-1:~/genai-databases-retrieval-app$

ถ้าเราเห็นหน้าต่าง "สวัสดีทุกคน" หมายความว่าบริการของเราทำงานและให้บริการตามคำขอ

8. ทำให้แอปพลิเคชันตัวอย่างใช้งานได้

ในตอนนี้เมื่อเรามีบริการดึงข้อมูลและเรียกใช้ เราสามารถทำให้แอปพลิเคชันตัวอย่างซึ่งจะใช้บริการนั้นได้ ติดตั้งใช้งานแอปพลิเคชันบน VM หรือบริการอื่นๆ ได้ เช่น Cloud Run, Kubernetes หรือแม้กระทั่งในเครื่องบนแล็ปท็อป ตอนนี้ เราจะแสดงวิธีติดตั้งใช้งานบน VM

เตรียมสภาพแวดล้อม

เราดําเนินการต่อบน VM โดยใช้เซสชัน SSH เดียวกัน เราจำเป็นต้องเพิ่มโมดูล Python บางรายการเพื่อเรียกใช้แอปพลิเคชัน ระบบจะดำเนินการคำสั่งจากไดเรกทอรีของแอปพลิเคชันในสภาพแวดล้อมเสมือนของ Python เดียวกัน

ดำเนินการต่อไปนี้ในเซสชัน SSH บน VM

cd ~/genai-databases-retrieval-app/llm_demo
pip install -r requirements.txt

เอาต์พุตที่คาดไว้ (ปกปิดไว้):

student@instance-1:~$ cd ~/genai-databases-retrieval-app/llm_demo
pip install -r requirements.txt
Collecting fastapi==0.104.0 (from -r requirements.txt (line 1))
  Obtaining dependency information for fastapi==0.104.0 from https://files.pythonhosted.org/packages/db/30/b8d323119c37e15b7fa639e65e0eb7d81eb675ba166ac83e695aad3bd321/fastapi-0.104.0-py3-none-any.whl.metadata
  Downloading fastapi-0.104.0-py3-none-any.whl.metadata (24 kB)
...

เตรียมรหัสไคลเอ็นต์

หากต้องการใช้ฟังก์ชันการจองของแอปพลิเคชัน เราต้องเตรียมรหัสไคลเอ็นต์ OAuth 2.0 โดยใช้ Cloud Console เราจะลงชื่อเข้าใช้แอปพลิเคชันเนื่องจากการจองใช้ข้อมูลเข้าสู่ระบบของลูกค้าในการบันทึกข้อมูลการจองในฐานข้อมูล

ใน Cloud Console ให้ไปที่ API และบริการ แล้วคลิก "หน้าจอขอความยินยอม OAuth" แล้วเลือก "ภายใน" ผู้ใช้

2400e5dcdb93eab8.png

จากนั้นกด "สร้าง" แล้วทำตามในหน้าจอถัดไป

6c34d235156e571f.png

คุณต้องกรอกข้อมูลในช่องที่ต้องกรอก เช่น "ชื่อแอป" และ "อีเมลการสนับสนุนผู้ใช้" นอกจากนี้คุณยังสามารถเพิ่มโดเมนที่ต้องการแสดงบนหน้าจอคำยินยอม และสุดท้ายคือ "ข้อมูลติดต่อของนักพัฒนาซอฟต์แวร์"

2b7cd51aff915072.png

จากนั้นกดปุ่ม "บันทึกและดำเนินการต่อ" ที่ด้านล่างของหน้าซึ่งจะนำคุณไปยังหน้าถัดไป

d90c10c88fd347f9.png

คุณไม่จำเป็นต้องเปลี่ยนแปลงอะไรในส่วนนี้ เว้นแต่ต้องการระบุขอบเขต สุดท้าย ให้คุณยืนยันโดยการกดปุ่ม "บันทึกและดำเนินการต่อ" อีกครั้ง ซึ่งจะเป็นการตั้งค่าหน้าจอคำยินยอมของแอปพลิเคชัน

ขั้นตอนถัดไปคือการสร้างรหัสไคลเอ็นต์ ในแผงด้านซ้าย ให้คลิก "ข้อมูลเข้าสู่ระบบ" ซึ่งจะนำคุณไปยังข้อมูลรับรองสำหรับ OAuth2

7ad97432390f224c.png

คุณคลิก "Create Credentials'' (สร้างข้อมูลเข้าสู่ระบบ) ได้ ที่ด้านบนและเลือก "OAuth ClientID" จากนั้นหน้าจอจะเปิดขึ้นอีกหน้าจอ

325a926431c8f16d.png

เลือก "เว็บแอปพลิเคชัน" จากรายการแบบเลื่อนลงสำหรับประเภทแอปพลิเคชัน แล้วใส่ URI ของแอปพลิเคชัน (และพอร์ต - ไม่บังคับ) เป็น "ต้นทาง JavaScript ที่ได้รับอนุญาต" และคุณต้องเพิ่มลงใน " URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต" โฮสต์แอปพลิเคชันของคุณกับ "/login/google" ที่ส่วนท้ายเพื่อให้สามารถใช้หน้าจอป๊อปอัปการให้สิทธิ์ จากภาพด้านบน คุณจะเห็นว่าฉันใช้ http://localhost เป็น URI ของแอปพลิเคชันพื้นฐาน

หลังจากพุชส่วน "สร้าง" คุณจะเห็นหน้าต่างป๊อปอัปที่มีข้อมูลเข้าสู่ระบบของลูกค้า

e91adf03ec31cd15.png

เราจะต้องใช้รหัสไคลเอ็นต์ (และรหัสลับไคลเอ็นต์ (ไม่บังคับ)) เพื่อใช้กับแอปพลิเคชันของเราในภายหลัง

เรียกใช้แอปพลิเคชัน Assistant

ก่อนเริ่มแอปพลิเคชัน เราจำเป็นต้องตั้งค่าตัวแปรสภาพแวดล้อมบางรายการ ฟังก์ชันการทำงานพื้นฐานของแอปพลิเคชัน เช่น การค้นหาเที่ยวบินและสิ่งอำนวยความสะดวกในสนามบินต้องใช้เพียง BASE_URL ซึ่งจะนำแอปพลิเคชันไปยังบริการดึงข้อมูล ซึ่งเราสามารถเรียกได้โดยใช้คำสั่ง gcloud

ดำเนินการต่อไปนี้ในเซสชัน SSH บน VM

export BASE_URL=$(gcloud  run services list --filter="(retrieval-service)" --format="value(URL)")

เอาต์พุตที่คาดไว้ (ปกปิดไว้):

student@instance-1:~/genai-databases-retrieval-app/llm_demo$ export BASE_URL=$(gcloud  run services list --filter="(retrieval-service)" --format="value(URL)")

หากต้องการใช้ความสามารถขั้นสูงขึ้นของแอปพลิเคชัน เช่น การจองและเปลี่ยนเที่ยวบิน เราต้องลงชื่อเข้าใช้แอปพลิเคชันโดยใช้บัญชี Google ของเรา และเพื่อจุดประสงค์ดังกล่าว เราจำเป็นต้องระบุตัวแปรสภาพแวดล้อม CLIENT_ID โดยใช้รหัสไคลเอ็นต์ OAuth จากบท "เตรียมรหัสไคลเอ็นต์" ดังนี้

export CLIENT_ID=215....apps.googleusercontent.com

เอาต์พุตที่คาดไว้ (ปกปิดไว้):

student@instance-1:~/genai-databases-retrieval-app/llm_demo$ export CLIENT_ID=215....apps.googleusercontent.com

และตอนนี้เราสามารถเรียกใช้แอปพลิเคชันของเรา:

python run_app.py

เอาต์พุตที่คาดไว้:

student@instance-1:~/genai-databases-retrieval-app/llm_demo$ python main.py
INFO:     Started server process [28565]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8081 (Press CTRL+C to quit)

เชื่อมต่อกับแอปพลิเคชัน

การเชื่อมต่อกับแอปพลิเคชันที่ทำงานบน VM ทำได้หลายวิธี ตัวอย่างเช่น คุณสามารถเปิดพอร์ต 8081 บน VM โดยใช้กฎไฟร์วอลล์ใน VPC หรือสร้างตัวจัดสรรภาระงานที่มี IP สาธารณะ ในที่นี้เราจะใช้อุโมงค์ SSH ไปยัง VM ที่แปลพอร์ต 8080 ในเครื่องไปยังพอร์ต VM 8081

เชื่อมต่อจากเครื่องของคุณเอง

เมื่อเราต้องการเชื่อมต่อจากเครื่องภายใน เราจำเป็นต้องเรียกใช้อุโมงค์ข้อมูล SSH ซึ่งทำได้โดยใช้ gcloud compute ssh ดังนี้

gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8081:localhost:8081

เอาต์พุตที่คาดไว้:

student-macbookpro:~ student$ gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081
Warning: Permanently added 'compute.7064281075337367021' (ED25519) to the list of known hosts.
Linux instance-1.us-central1-c.c.gleb-test-001.internal 6.1.0-21-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.90-1 (2024-05-03) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
student@instance-1:~$

ตอนนี้เราสามารถเปิดเบราว์เซอร์และใช้ http://localhost:8081 เพื่อเชื่อมต่อกับแอปพลิเคชันของเราได้ เราจะเห็นหน้าจอแอปพลิเคชัน

c667b9013afac3f9.png

การเชื่อมต่อจาก Cloud Shell

หรือจะใช้ Cloud Shell เพื่อเชื่อมต่อก็ได้ เปิดแท็บ Cloud Shell อีกแท็บโดยใช้เครื่องหมาย "+" ที่ด้านบน

4ca978f5142bb6ce.png

ในแท็บ Cloud Shell ใหม่ ให้เริ่มอุโมงค์ข้อมูลไปยัง VM ของคุณโดยเรียกใช้คำสั่ง gcloud ดังนี้

gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081

การดำเนินการนี้จะแสดงข้อผิดพลาด "ไม่สามารถมอบหมายที่อยู่ที่ขอ" - ไม่ต้องสนใจ

เอาต์พุตที่คาดไว้มีดังนี้

student@cloudshell:~ gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081
bind [::1]:8081: Cannot assign requested address
inux instance-1.us-central1-a.c.gleb-codelive-01.internal 6.1.0-21-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.90-1 (2024-05-03) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Sat May 25 19:15:46 2024 from 35.243.235.73
student@instance-1:~$

ซึ่งจะเปิดพอร์ต 8080 บน Cloud Shell ซึ่งใช้สำหรับ "การแสดงตัวอย่างเว็บ" ได้

คลิก "ตัวอย่างเว็บ" ที่ด้านขวาบนของ Cloud Shell และจากเมนูแบบเลื่อนลง จากนั้นเลือก "แสดงตัวอย่างบนพอร์ต 8080"

444fbf54dcd4d160.png

โดยจะเปิดแท็บใหม่ในเว็บเบราว์เซอร์ด้วยอินเทอร์เฟซของแอปพลิเคชัน คุณควรเห็น "ผู้ช่วยฝ่ายบริการลูกค้าของ Cymbal Air" ในแถบที่อยู่ของหน้า เราจะเห็น URI ไปยังหน้าตัวอย่าง เราต้องนำส่วน "/?authuser=0&redirectPreviously=true" ออก ในช่วงท้าย

389f0ae2945beed5.png

และใช้ส่วนแรกของ URI เช่น "https://8080-cs-35704030349-default.cs-us-east1-vpcf.cloudshell.dev/" ในหน้าต่างเบราว์เซอร์และระบุเป็น "ต้นทาง JavaScript ที่ได้รับอนุญาต" และ " URI การเปลี่ยนเส้นทางที่ได้รับอนุญาต" สำหรับข้อมูลเข้าสู่ระบบของเราที่สร้างขึ้นในส่วน "เตรียมรหัสไคลเอ็นต์" การแทนที่หรือการเพิ่มบทลงในค่า http://localhost:8080 ที่ระบุไว้แต่เดิม ค่าที่สูงกว่าควรมีลักษณะดังนี้ "https://8080-cs-35704030349-default.cs-us-east1-vpcf.cloudshell.dev" และรหัสที่ต่ำกว่าจะเป็น "https://8080-cs-35704030349-default.cs-us-east1-vpcf.cloudshell.dev/login/google"

2c37eeda0a7e2f80.png

ลงชื่อเข้าใช้แอปพลิเคชัน

เมื่อตั้งค่าทุกอย่างเรียบร้อยแล้ว และเปิดแอปพลิเคชันของคุณ เราสามารถใช้ปุ่ม "ลงชื่อเข้าใช้" ที่ด้านบนขวาของหน้าจอแอปพลิเคชันเพื่อให้ข้อมูลเข้าสู่ระบบ วิธีการนี้ไม่บังคับและจำเป็นเฉพาะในกรณีที่คุณต้องการลองใช้ฟังก์ชันการจองของแอปพลิเคชัน

a1f571371b957129.png

หน้าต่างป๊อปอัปที่เราจะเลือกข้อมูลเข้าสู่ระบบได้

หลังจากลงชื่อเข้าใช้แอปพลิเคชันแล้ว คุณสามารถเริ่มโพสต์คำขอลงในฟิลด์ที่ด้านล่างของหน้าต่าง

การสาธิตนี้แสดงให้เห็นผู้ช่วยฝ่ายบริการลูกค้าของ Cymbal Air Cymbal Air เป็นสายการบินสมมติ ผู้ช่วยเป็นแชทบ็อต AI ที่ช่วยนักเดินทางจัดการเที่ยวบินและค้นหาข้อมูลเกี่ยวกับฮับของ Cymbal Air ที่สนามบินนานาชาติซานฟรานซิสโก (SFO)

หากไม่ได้ลงชื่อเข้าใช้ (ไม่มี CLIENT_ID) ก็จะช่วยตอบคำถามของผู้ใช้ได้ เช่น

เที่ยวบินถัดไปไปเดนเวอร์คือเมื่อไร

มีร้านค้าหรูแถวประตู C28 ไหม

จะหากาแฟใกล้ประตู A6 ได้ที่ไหน

ฉันจะซื้อของขวัญได้ที่ไหน

ช่วยจองเที่ยวบินไปเดนเวอร์ที่ออกเดินทางเวลา 10.35 น. ด้วยค่ะ

เมื่อลงชื่อเข้าใช้แอปพลิเคชันแล้ว คุณจะลองใช้ความสามารถอื่นๆ ได้ เช่น การจองเที่ยวบินหรือตรวจสอบว่าที่นั่งที่คุณได้รับเป็นที่นั่งแบบหน้าต่างหรือที่นั่งติดบนทางเดินหรือไม่

6E7758f707c67c3e

แอปพลิเคชันใช้โมเดลพื้นฐานล่าสุดของ Google เพื่อสร้างคำตอบและเสริมด้วยข้อมูลเกี่ยวกับเที่ยวบินและสิ่งอำนวยความสะดวกจากฐานข้อมูล Cloud SQL ที่ดำเนินงานอยู่ อ่านข้อมูลเพิ่มเติมเกี่ยวกับแอปพลิเคชันเดโมนี้ได้ในหน้า GitHub ของโปรเจ็กต์

9. ล้างสภาพแวดล้อม

เมื่องานทั้งหมดเสร็จสมบูรณ์แล้ว เราจะจัดการสภาพแวดล้อมให้ดีขึ้นได้

ลบบริการ Cloud Run

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

gcloud run services delete retrieval-service --region us-central1

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (gleb-test-short-004)$ gcloud run services delete retrieval-service --region us-central1
Service [retrieval-service] will be deleted.

Do you want to continue (Y/n)?  Y

Deleting [retrieval-service]...done.                                                                                                                                                                                                                 
Deleted service [retrieval-service].

ลบบัญชีบริการสำหรับบริการ Cloud Run

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete retrieval-identity@$PROJECT_ID.iam.gserviceaccount.com --quiet

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (gleb-test-short-004)$ PROJECT_ID=$(gcloud config get-value project)
Your active configuration is: [cloudshell-222]
student@cloudshell:~ (gleb-test-short-004)$ gcloud iam service-accounts delete retrieval-identity@$PROJECT_ID.iam.gserviceaccount.com --quiet
deleted service account [retrieval-identity@gleb-test-short-004.iam.gserviceaccount.com]
student@cloudshell:~ (gleb-test-short-004)$

ลบอินสแตนซ์ Cloud SQL

ทำลายอินสแตนซ์ Cloud SQL เมื่อคุณทำห้องทดลองเสร็จแล้ว

ใน Cloud Shell ให้กำหนดตัวแปรของโปรเจ็กต์และสภาพแวดล้อมหากคุณยกเลิกการเชื่อมต่อและการตั้งค่าก่อนหน้านี้ทั้งหมดจะหายไป ดังนี้

export INSTANCE_NAME=my-cloudsql-instance
export PROJECT_ID=$(gcloud config get-value project)

วิธีลบอินสแตนซ์

gcloud sql instances delete $INSTANCE_NAME --project=$PROJECT_ID

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~$ gcloud sql instances delete $INSTANCE_NAME --project=$PROJECT_ID
All of the instance data will be lost when the instance is deleted.

Do you want to continue (Y/n)?  y

Deleting Cloud SQL instance...done.                                                                                                                
Deleted [https://sandbox.googleapis.com/v1beta4/projects/test-project-001-402417/instances/my-cloudsql-instance].

ตอนนี้เราสามารถทำลาย VM ของเราได้

ลบ GCE VM

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

export GCEVM=instance-1
export ZONE=us-central1-a
gcloud compute instances delete $GCEVM \
    --zone=$ZONE \
    --quiet

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (test-project-001-402417)$ export GCEVM=instance-1
export ZONE=us-central1-a
gcloud compute instances delete $GCEVM \
    --zone=$ZONE \
    --quiet
Deleted 

ลบบัญชีบริการสำหรับ GCE VM และบริการดึงข้อมูล

ใน Cloud Shell ให้เรียกใช้คำสั่งต่อไปนี้

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete compute-aip@$PROJECT_ID.iam.gserviceaccount.com --quiet

เอาต์พุตคอนโซลที่คาดไว้:

student@cloudshell:~ (gleb-test-short-004)$ PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete compute-aip@$PROJECT_ID.iam.gserviceaccount.com --quiet
Your active configuration is: [cloudshell-222]
deleted service account [compute-aip@gleb-test-short-004.iam.gserviceaccount.com]
student@cloudshell:~ (gleb-test-short-004)$ 

10. ขอแสดงความยินดี

ขอแสดงความยินดีที่เรียน Codelab จนจบ

หัวข้อที่ครอบคลุม

  • วิธีสร้างอินสแตนซ์ Cloud SQL
  • วิธีเชื่อมต่อกับอินสแตนซ์ Cloud SQL
  • วิธีกำหนดค่าและทำให้บริการดึงข้อมูลฐานข้อมูล GenAI ใช้งานได้
  • วิธีทำให้แอปพลิเคชันตัวอย่างใช้งานได้โดยใช้บริการที่ทำให้ใช้งานได้

11. แบบสำรวจ

คุณจะใช้บทแนะนำนี้อย่างไร

โปรดอ่านเท่านั้น อ่านและทำแบบฝึกหัด