เวิร์กช็อปการโมดิฟายแอป

1. บทนำ

อัปเดตล่าสุด: 2024-11-01

เราจะปรับแอปพลิเคชัน PHP เก่าให้ทันสมัยใน Google Cloud ได้อย่างไร

(📽️ ดูวิดีโอแนะนำความยาว 7 นาทีเกี่ยวกับ Codelab นี้)

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

ในเวิร์กช็อปนี้ คุณจะได้ทำสิ่งต่อไปนี้

  1. สร้างคอนเทนเนอร์สำหรับแอปพลิเคชัน PHP
  2. เปลี่ยนไปใช้บริการฐานข้อมูลที่มีการจัดการ (Cloud SQL)
  3. ทำให้ใช้งานได้กับ Cloud Run (ซึ่งเป็นทางเลือกแบบ Zero-Ops แทน GKE/Kubernetes)
  4. รักษาความปลอดภัยให้กับแอปพลิเคชันด้วย Identity and Access Management (IAM) และ Secret Manager
  5. กำหนดไปป์ไลน์ CI/CD ผ่าน Cloud Build คุณสามารถเชื่อมต่อ Cloud Build กับที่เก็บ Git ที่โฮสต์ในผู้ให้บริการ Git ยอดนิยม เช่น GitHub หรือ GitLab และทริกเกอร์ได้ทุกครั้งที่มีการพุชไปยัง Main เป็นต้น
  6. โฮสต์รูปภาพแอปพลิเคชันใน Cloud Storage ซึ่งทำได้โดยการต่อเชื่อม และไม่จำเป็นต้องใช้โค้ดเพื่อเปลี่ยนแอป
  7. แนะนำฟังก์ชันการทำงานของ Gen AI ผ่าน Gemini ซึ่งจัดการผ่าน Cloud Functions (แบบไม่ใช้เซิร์ฟเวอร์)
  8. ทำความคุ้นเคยกับ SLO และการใช้งานแอปที่ปรับปรุงใหม่

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

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

เกี่ยวกับแอป

แอปพลิเคชัน (โค้ดภายใต้ใบอนุญาต MIT) ที่คุณจะ Fork เป็นแอปพลิเคชัน PHP 5.7 พื้นฐานที่มีการตรวจสอบสิทธิ์ MySQL แนวคิดหลักของแอปคือการจัดหาแพลตฟอร์มที่ผู้ใช้สามารถอัปโหลดรูปภาพได้ และผู้ดูแลระบบสามารถติดแท็กรูปภาพที่ไม่เหมาะสมได้ แอปพลิเคชันมี 2 ตาราง ได้แก่

  • ผู้ใช้ มาพร้อมกับผู้ดูแลระบบที่กำหนดไว้ล่วงหน้า ผู้ใช้ใหม่สามารถลงทะเบียนได้
  • รูปภาพ มาพร้อมรูปภาพตัวอย่างบางส่วน ผู้ใช้ที่เข้าสู่ระบบจะอัปโหลดรูปภาพใหม่ได้ เราจะเพิ่มข้อมูลที่นี่

เป้าหมายของคุณ

เราต้องการปรับปรุงแอปพลิเคชันเก่าให้ทันสมัยเพื่อให้ใช้งานใน Google Cloud ได้ เราจะใช้ประโยชน์จากเครื่องมือและบริการของ Google Cloud เพื่อปรับปรุงความสามารถในการปรับขนาด เพิ่มความปลอดภัย จัดการโครงสร้างพื้นฐานโดยอัตโนมัติ และผสานรวมฟีเจอร์ขั้นสูง เช่น การประมวลผลรูปภาพ การตรวจสอบ และพื้นที่เก็บข้อมูล โดยใช้บริการต่างๆ เช่น Cloud SQL, Cloud Run, Cloud Build, Secret Manager และอื่นๆ

445f7a9ae37e9b4d.png

ที่สำคัญกว่านั้นคือเราต้องการดำเนินการทีละขั้นตอนเพื่อให้คุณเรียนรู้กระบวนการคิดเบื้องหลังแต่ละขั้นตอน และโดยปกติแล้ว แต่ละขั้นตอนจะปลดล็อกความเป็นไปได้ใหม่ๆ สำหรับขั้นตอนถัดไป (เช่น โมดูล 2 -> 3 และ 6 -> 7)

หากยังไม่แน่ใจ ดูวิดีโอความยาว 7 นาทีนี้ใน YouTube

สิ่งที่ต้องมี

  • คอมพิวเตอร์ที่มีเบราว์เซอร์และเชื่อมต่ออินเทอร์เน็ต
  • เครดิต GCP บางส่วน ดูขั้นตอนถัดไปสำหรับเรื่องนี้
  • คุณจะใช้ Cloud Shell ซึ่งมาพร้อมกับคำสั่งที่ติดตั้งไว้ล่วงหน้าทั้งหมดที่คุณต้องการและ IDE
  • บัญชี GitHub คุณต้องใช้สิ่งนี้เพื่อแยกโค้ดต้นฉบับ 🧑🏻‍💻 gdgpescara/app-mod-workshop ด้วยที่เก็บ Git ของคุณเอง ซึ่งจำเป็นสำหรับการมีไปป์ไลน์ CI/CD ของคุณเอง (คอมมิตอัตโนมัติ -> บิลด์ -> ติดตั้งใช้งาน)

ดูตัวอย่างโซลูชันได้ที่นี่

เวิร์กช็อปนี้ออกแบบมาให้ดำเนินการใน Cloud Shell (ในเบราว์เซอร์) จนเสร็จสมบูรณ์

แต่คุณก็สามารถลองดำเนินการจากคอมพิวเตอร์ในเครื่องได้เช่นกัน

2. การตั้งค่าเครดิตและ Fork

6dafc658860c0ce5.png

แลกรับเครดิต GCP และตั้งค่าสภาพแวดล้อม GCP [ไม่บังคับ]

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

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

bd7548f78689db0b.png

สร้างโปรเจ็กต์ใหม่หากยังไม่มี ดังที่แสดงในภาพหน้าจอด้านล่าง มีตัวเลือก "NEW PROJECT" ที่มุมขวาบน

6c82aebcb9f5cd47.png

ตรวจสอบว่าได้ลิงก์โปรเจ็กต์ใหม่กับบัญชีสำหรับการเรียกเก็บเงิน GCP แบบทดลองใช้แล้ว โดยทำดังนี้

f202527d254893fb.png

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

7d732d7bf0deb12e.png

ตรวจสอบว่าได้เลือกโปรเจ็กต์ใหม่ที่ด้านซ้ายบนแล้ว

ไม่ได้เลือก (ไม่ดี):

c2ffd36a781b276a.png

เลือกแล้ว (ดี):

594563c158f4f590.png

Fork แอปจาก GitHub

  1. ไปที่แอปสาธิต: https://github.com/gdgpescara/app-mod-workshop
  2. คลิก 🍴 ส้อม
  3. หากไม่มีบัญชี GitHub คุณจะต้องสร้างบัญชีใหม่
  4. แก้ไขสิ่งต่างๆ ตามต้องการ

734e51bfc29ee5df.png

  1. โคลนโค้ดของแอปโดยใช้
  2. git clone https://github.com/YOUR-GITHUB-USER/YOUR-REPO-NAME
  1. เปิดโฟลเดอร์โปรเจ็กต์ที่โคลนด้วยเครื่องมือแก้ไขที่คุณชื่นชอบ หากเลือก Cloud Shell คุณสามารถทำได้โดยคลิก "เปิดเครื่องมือแก้ไข" ดังที่แสดงด้านล่าง

40f5977ea4c1d1cb.png

คุณมีทุกสิ่งที่ต้องการด้วย Google Cloud Shell Editor ดังที่แสดงในรูปภาพต่อไปนี้

a4e5ffb3e9a35e84.png

ซึ่งทำได้โดยคลิก "เปิดโฟลเดอร์" แล้วเลือกโฟลเดอร์ ซึ่งน่าจะเป็น app-mod-workshop ในโฟลเดอร์หลัก

3. โมดูลที่ 1: สร้างอินสแตนซ์ SQL

645902e511a432a6.png

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

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

  1. ไปที่หน้า Cloud SQL: https://console.cloud.google.com/sql/instances
  2. คลิก "Create Instance"
  3. เปิดใช้ API (หากจำเป็น) การดำเนินการนี้อาจใช้เวลาสักครู่
  4. เลือก MySQL
  5. (เราพยายามหาเวอร์ชันที่ถูกที่สุดให้คุณเพื่อให้ใช้งานได้นานขึ้น)
  • รุ่น: Enterprise
  • ค่าที่กำหนดล่วงหน้า: development (เราลองใช้ Sandbox แล้วแต่ไม่ได้ผล)
  • Mysql เวอร์ชัน: 5.7 (ว้าว ย้อนอดีตกันเลยทีเดียว)
  1. รหัสอินสแตนซ์: เลือก appmod-phpapp (หากคุณเปลี่ยนรหัสนี้ โปรดอย่าลืมเปลี่ยนสคริปต์และโซลูชันในอนาคตให้สอดคล้องกันด้วย)
  2. รหัสผ่าน: อะไรก็ได้ที่คุณต้องการ แต่ให้จดไว้เป็น CLOUDSQL_INSTANCE_PASSWORD
  3. ภูมิภาค: ใช้ภูมิภาคเดียวกับที่คุณเลือกไว้สำหรับส่วนที่เหลือของแอป (เช่น มิลาน = europe-west8)
  4. ความพร้อมใช้งานของโซน: โซนเดียว (เรากำลังประหยัดเงินสำหรับการสาธิต)

คลิกปุ่มสร้างอินสแตนซ์เพื่อทำให้ฐานข้อมูล Cloud SQL ใช้งานได้ ⌛ การดำเนินการนี้ใช้เวลาประมาณ 10 นาทีจึงจะเสร็จสมบูรณ์⌛ ในระหว่างนี้ โปรดอ่านเอกสารประกอบต่อไป คุณยังเริ่มแก้ปัญหาโมดูลถัดไป ("สร้างคอนเทนเนอร์ให้แอป PHP") ได้ด้วย เนื่องจากโมดูลนี้ไม่มีทรัพยากร Dependency ในส่วนแรก (จนกว่าคุณจะแก้ไขการเชื่อมต่อฐานข้อมูล)

หมายเหตุ อินสแตนซ์นี้ควรมีค่าใช้จ่ายประมาณ $7/วัน อย่าลืมแยกออกหลังจากเวิร์กช็อป

สร้าง DB และผู้ใช้ image_catalog ใน Cloud SQL

โปรเจ็กต์แอปมาพร้อมกับโฟลเดอร์ db/ ซึ่งมีไฟล์ SQL 2 ไฟล์ ได้แก่

  1. 01_schema.sql: มีโค้ด SQL เพื่อสร้างตาราง 2 ตารางที่มีข้อมูลผู้ใช้และรูปภาพ
  2. 02_seed.sql: มีโค้ด SQL เพื่อสร้างข้อมูลในตารางที่สร้างไว้ก่อนหน้านี้

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

  1. เปิดอินสแตนซ์ แล้วคลิกแท็บฐานข้อมูล
  2. คลิก "Create Database"
  3. ตั้งชื่อว่า image_catalog (ตามการกำหนดค่าแอป PHP)

997ef853e5ebd857.png

จากนั้นเราจะสร้างผู้ใช้ฐานข้อมูล ซึ่งจะช่วยให้เราตรวจสอบสิทธิ์ในฐานข้อมูล image_catalog ได้

  1. ตอนนี้ให้คลิกแท็บผู้ใช้
  2. คลิก "เพิ่มบัญชีผู้ใช้"
  3. ผู้ใช้: มาสร้างกันเลย
  • ชื่อผู้ใช้: appmod-phpapp-user
  • รหัสผ่าน: เลือกสิ่งที่คุณจำได้ หรือคลิก "สร้าง"
  • คงค่า "Allow any host (%)" ไว้
  1. คลิก "เพิ่ม"

เปิดฐานข้อมูลให้กับ IP ที่รู้จัก

โปรดทราบว่าฐานข้อมูลทั้งหมดใน Cloud SQL จะถูกสร้างขึ้นแบบ "แยกต่างหาก" คุณต้องตั้งค่าเครือข่ายอย่างชัดเจนเพื่อให้เข้าถึงได้

  1. คลิกอินสแตนซ์
  2. เปิดเมนู "การเชื่อมต่อ"
  3. คลิกแท็บ "เครือข่าย"
  4. คลิกในส่วน "เครือข่ายที่ได้รับอนุญาต" ตอนนี้ให้เพิ่มเครือข่าย (เช่น ซับเน็ต)
  • ในตอนนี้ ให้เลือกการตั้งค่าที่รวดเร็วแต่ไม่ปลอดภัยเพื่อให้แอปทำงานได้ คุณอาจต้องการจำกัดการตั้งค่าในภายหลังให้เหลือเฉพาะ IP ที่คุณเชื่อถือ ดังนี้
  • ชื่อ: "ทุกคนในโลก - ไม่ปลอดภัย"
  • เครือข่าย: "0.0.0.0/0" (หมายเหตุ: นี่คือส่วนที่ไม่ปลอดภัย)
  • คลิกเสร็จสิ้น
  1. คลิกบันทึก

คุณควรเห็นข้อความลักษณะนี้

5ccb9062a7071964.png

หมายเหตุ โซลูชันนี้เป็นวิธีที่เหมาะสมในการทำเวิร์กช็อปให้เสร็จภายใน O(ชั่วโมง) อย่างไรก็ตาม โปรดดูเอกสารความปลอดภัยเพื่อช่วยรักษาความปลอดภัยของโซลูชันสำหรับการใช้งานจริง

ได้เวลาทดสอบการเชื่อมต่อ DB แล้ว

มาดูกันว่าผู้ใช้ image_catalog ที่เราสร้างไว้ก่อนหน้านี้ใช้งานได้หรือไม่

เข้าถึง "Cloud SQL Studio" ภายในอินสแตนซ์ แล้วป้อนฐานข้อมูล ผู้ใช้ และรหัสผ่านเพื่อตรวจสอบสิทธิ์ดังที่แสดงด้านล่าง

d56765c6154c11a4.png

เมื่อเข้ามาแล้ว คุณจะเปิดเครื่องมือแก้ไข SQL และไปยังส่วนถัดไปได้

นำเข้าฐานข้อมูลจากฐานของโค้ด

ใช้เครื่องมือแก้ไข SQL เพื่อนำเข้าตาราง image_catalog พร้อมข้อมูล คัดลอกโค้ด SQL จากไฟล์ในที่เก็บ (01_schema.sql แล้วตามด้วย 02_seed.sql) และเรียกใช้ทีละรายการตามลำดับ

หลังจากนี้ คุณควรเห็นตาราง 2 ตารางใน image_catalog ซึ่งก็คือ users และ images ดังที่แสดงด้านล่าง

65ba01e4c6c2dac0.png

คุณทดสอบได้โดยเรียกใช้คำสั่งต่อไปนี้ในเครื่องมือแก้ไข select * from images;

นอกจากนี้ โปรดจดที่อยู่ IP สาธารณะของอินสแตนซ์ Cloud SQL ไว้ด้วย เนื่องจากคุณจะต้องใช้ในภายหลัง หากต้องการดู IP ให้ไปที่หน้าหลักของอินสแตนซ์ Cloud SQL ในหน้าภาพรวม (ภาพรวม > เชื่อมต่อกับอินสแตนซ์นี้ > ที่อยู่ IP สาธารณะ)

4. โมดูล 2: สร้างแอป PHP โดยใช้คอนเทนเนอร์

e7f0e9979d8805f5.png

เราต้องการสร้างแอปนี้สำหรับระบบคลาวด์

ซึ่งหมายถึงการรวมโค้ดไว้ในไฟล์ ZIP บางประเภทที่มีข้อมูลทั้งหมดเพื่อเรียกใช้ในระบบคลาวด์

ซึ่งทำได้หลายวิธี ดังนี้

  • Docker ได้รับความนิยมอย่างมาก แต่การตั้งค่าให้ถูกต้องค่อนข้างซับซ้อน
  • Buildpack ไม่ค่อยได้รับความนิยม แต่มีแนวโน้มที่จะ "เดาอัตโนมัติ" ว่าจะสร้างอะไรและเรียกใช้อะไร ซึ่งมักจะใช้ได้ทันที

ในบริบทของเวิร์กช็อปนี้ เราจะถือว่าคุณใช้ Docker

หากเลือกใช้ Cloud Shell คุณจะต้องเปิดอีกครั้ง (คลิกที่ด้านขวาบนของ Cloud Console)

ec6a6b90b39e03e.png

ซึ่งจะเปิด Shell ที่สะดวกที่ด้านล่างของหน้า ซึ่งคุณควรแยกโค้ดในขั้นตอนการตั้งค่า

6999b906c0dedeb7.png

Docker

หากต้องการควบคุม โซลูชันนี้เหมาะสำหรับคุณ ซึ่งเหมาะสำหรับกรณีที่คุณต้องการกำหนดค่าไลบรารีที่เฉพาะเจาะจง และแทรกพฤติกรรมบางอย่างที่ไม่ชัดเจน (chmod ในการอัปโหลด, ไฟล์ปฏิบัติการที่ไม่ได้มาตรฐานในแอป ฯลฯ)

เนื่องจากเราต้องการติดตั้งใช้งานแอปพลิเคชันที่สร้างเป็นคอนเทนเนอร์ใน Cloud Run ในท้ายที่สุด โปรดดูเอกสารประกอบต่อไปนี้ คุณจะพอร์ตโค้ดจาก PHP 8 กลับไปเป็น PHP 5.7 ได้อย่างไร คุณอาจใช้ Gemini เพื่อช่วยในเรื่องนี้ได้ หรือจะใช้เวอร์ชันที่สร้างไว้ล่วงหน้านี้ก็ได้

# Use the official PHP image: https://hub.docker.com/_/php
FROM php:5.6-apache

# Configure PHP for Cloud Run.
# Precompile PHP code with opcache.
# Install PHP's extension for MySQL
RUN docker-php-ext-install -j "$(nproc)" opcache mysqli pdo pdo_mysql && docker-php-ext-enable pdo_mysql

RUN set -ex; \
  { \
    echo "; Cloud Run enforces memory & timeouts"; \
    echo "memory_limit = -1"; \
    echo "max_execution_time = 0"; \
    echo "; File upload at Cloud Run network limit"; \
    echo "upload_max_filesize = 32M"; \
    echo "post_max_size = 32M"; \
    echo "; Configure Opcache for Containers"; \
    echo "opcache.enable = On"; \
    echo "opcache.validate_timestamps = Off"; \
    echo "; Configure Opcache Memory (Application-specific)"; \
    echo "opcache.memory_consumption = 32"; \
  } > "$PHP_INI_DIR/conf.d/cloud-run.ini"

# Copy in custom code from the host machine.
WORKDIR /var/www/html

COPY . .

# Setup the PORT environment variable in Apache configuration files: https://cloud.google.com/run/docs/reference/container-contract#port
ENV PORT=8080

# Tell Apache to use 8080 instead of 80.
RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

# Note: This is quite insecure and opens security breaches. See last chapter for hardening ideas.
# Uncomment at your own risk:
#RUN chmod 777 /var/www/html/uploads/

# Configure PHP for development.
# Switch to the production php.ini for production operations.
# RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
# https://github.com/docker-library/docs/blob/master/php/README.md#configuration
RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"

# Expose the port
EXPOSE 8080

Dockerfile เวอร์ชันล่าสุดพร้อมใช้งานที่นี่

หากต้องการทดสอบแอปพลิเคชันในเครื่อง เราต้องเปลี่ยนไฟล์ config.php เพื่อให้แอป PHP เชื่อมต่อกับฐานข้อมูล MYSQL ที่มีอยู่ใน Google CloudSQL เติมคำในช่องว่างตามที่คุณได้ตั้งค่าไว้ก่อนหน้านี้

<?php
// Database configuration
$db_host = '____________';
$db_name = '____________';
$db_user = '____________';
$db_pass = '____________';

try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>
  • DB_HOST คือที่อยู่ IP สาธารณะของ Cloud SQL ซึ่งดูได้ในคอนโซล SQL โดยทำดังนี้

bd27071bf450a8d0.png

  • DB_NAME ไม่ควรเปลี่ยนแปลง: image_catalog
  • DB_USER ควรเป็น appmod-phpapp-user
  • DB_PASS คือสิ่งที่คุณเลือก ตั้งค่าในเครื่องหมายคำพูดเดี่ยวและหลีกเลี่ยงตามความจำเป็น

นอกจากนี้ คุณยังแปลข้อความภาษาอิตาลี 🇮🇹 2-3 ข้อความให้เป็นภาษาอังกฤษได้โดยใช้ Gemini

ตอนนี้คุณมี Dockerfile และได้กำหนดค่าแอป PHP ให้เชื่อมต่อกับฐานข้อมูลแล้ว มาลองใช้กันเลย

ติดตั้ง Docker หากยังไม่มี (ลิงก์) คุณไม่จำเป็นต้องใช้สิ่งนี้หากใช้ Cloud Shell (เจ๋งใช่ไหมล่ะ)

ตอนนี้ให้ลองสร้างและเรียกใช้แอป PHP ที่สร้างโดยใช้คอนเทนเนอร์ด้วยคำสั่ง docker build และ run ที่เหมาะสม

# Build command - don't forget the final . This works if Dockerfile is inside the code folder:
$ docker build -t my-php-app-docker .   

# Local Run command: most likely ports will be 8080:8080
$ docker run -it -p <CONTAINER_PORT>:<LOCAL_MACHINE_PORT> my-php-app-docker

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

33a24673f4550454.png

การทดสอบผลลัพธ์ในเบราว์เซอร์

ตอนนี้แอปพลิเคชันของคุณควรมีลักษณะดังนี้

2718ece96b1f18b6.png

และหากเข้าสู่ระบบด้วย Admin/admin123 คุณควรเห็นข้อมูลดังนี้

68b62048c2e86aea.png

เยี่ยมเลย Apart from the Italian text, it's working! 🎉🎉🎉

หากการสร้าง Docker เป็นไปด้วยดี แต่ข้อมูลเข้าสู่ระบบ DB ไม่ถูกต้อง คุณอาจได้รับข้อความลักษณะนี้

e22f45b79bab86e1.png

ลองอีกครั้ง คุณใกล้จะทำได้แล้ว

การบันทึกลงใน Artifact Registry [ไม่บังคับ]

ตอนนี้คุณควรมีแอปพลิเคชัน PHP ที่สร้างเป็นคอนเทนเนอร์ซึ่งใช้งานได้และพร้อมที่จะนำไปใช้งานในระบบคลาวด์แล้ว ถัดไป เราต้องมีพื้นที่ในระบบคลาวด์เพื่อจัดเก็บอิมเมจ Docker และทำให้เข้าถึงได้สำหรับการทำให้ใช้งานได้ในบริการ Google Cloud เช่น Cloud Run โซลูชันพื้นที่เก็บข้อมูลนี้เรียกว่า Artifact Registry ซึ่งเป็นบริการ Google Cloud ที่มีการจัดการครบวงจรซึ่งออกแบบมาเพื่อจัดเก็บอาร์ติแฟกต์ของแอปพลิเคชัน รวมถึงอิมเมจคอนเทนเนอร์ Docker, แพ็กเกจ Maven, โมดูล npm และอื่นๆ

มาสร้างที่เก็บใน Google Cloud Artifact Registry โดยใช้ปุ่มที่เหมาะสมกัน

e1123f0c924022e6.png

เลือกชื่อที่ถูกต้อง รูปแบบ และภูมิภาคที่เหมาะสำหรับการจัดเก็บอาร์ติแฟกต์

4e516ed209c470ee.png

กลับไปที่แท็กสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง แล้วพุชอิมเมจคอนเทนเนอร์ของแอปไปยังที่เก็บ Artifact Registry ที่เพิ่งสร้างขึ้น โดยใช้คำสั่งต่อไปนี้

  • docker tag SOURCE_IMAGE[:TAG] TARGET_IMAGE[:TAG]
  • docker push TARGET_IMAGE[:TAG]

ผลลัพธ์ควรมีลักษณะเหมือนภาพหน้าจอต่อไปนี้

1e498feb4e88be9f.png

ไชโย 🎉🎉🎉 คุณเลื่อนไปสู่ระดับถัดไปได้แล้ว ก่อนหน้านั้น คุณอาจใช้เวลา 2 นาทีในการลองอัปโหลด/เข้าสู่ระบบ/ออกจากระบบ และทำความคุ้นเคยกับปลายทางของแอป คุณจะต้องใช้ปลายทางเหล่านี้ในภายหลัง

ข้อผิดพลาดที่เป็นไปได้

หากพบข้อผิดพลาดในการสร้างคอนเทนเนอร์ ให้ลองใช้ Gemini เพื่ออธิบายและแก้ไขข้อผิดพลาด โดยระบุข้อมูลต่อไปนี้

  • Dockerfile ปัจจุบันของคุณ
  • ข้อผิดพลาดที่ได้รับ
  • [หากจำเป็น] โค้ด PHP ที่กำลังดำเนินการ

สิทธิ์ในการอัปโหลด นอกจากนี้ ให้ลองใช้ปลายทาง /upload.php และลองอัปโหลดรูปภาพ คุณอาจได้รับข้อผิดพลาดด้านล่าง หากเป็นเช่นนั้น คุณจะต้องแก้ไข chmod/chown ใน Dockerfile

คำเตือน: move_uploaded_file(uploads/image (3).png): failed to open stream: Permission denied in /var/www/html/upload.php on line 11

PDOException "could not find driver" (หรือ "Errore di connessione: could not find driver") ตรวจสอบว่า Dockerfile มีไลบรารี PDO ที่เหมาะสมสำหรับ mysql (pdo_mysql) เพื่อเชื่อมต่อกับ DB รับแรงบันดาลใจจากโซลูชันต่างๆ ที่นี่

ส่งต่อคำขอของคุณไปยังแบ็กเอนด์ไม่ได้ เชื่อมต่อกับเซิร์ฟเวอร์ในพอร์ต 8080 ไม่ได้ ซึ่งหมายความว่าคุณอาจแสดงพอร์ตที่ไม่ถูกต้อง ตรวจสอบว่าคุณเปิดเผยพอร์ตที่ Apache/Nginx แสดงผลจริงๆ ซึ่งไม่ใช่เรื่องง่าย หากเป็นไปได้ ให้ลองใช้พอร์ต 8080 (ทำให้ชีวิตง่ายขึ้นด้วย Cloud Run) หากต้องการเก็บพอร์ต 80 ไว้ (เช่น เนื่องจาก Apache ต้องการให้เป็นเช่นนั้น) ให้ใช้คำสั่งอื่นเพื่อเรียกใช้ ดังนี้

$ docker run -it -p 8080:80 # force 80

# Use the PORT environment variable in Apache configuration files.

# https://cloud.google.com/run/docs/reference/container-contract#port

RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf

5. โมดูล 3: ติดตั้งใช้งานแอปใน Cloud Run

9ffca42774f6c5d1.png

ทำไมต้องใช้ Cloud Run

เป็นคำถามที่ดี เมื่อหลายปีก่อน คุณคงเลือก Google App Engine อย่างแน่นอน

พูดง่ายๆ ก็คือ ปัจจุบัน Cloud Run มีชุดซอฟต์แวร์โครงสร้างพื้นฐานที่ใหม่กว่า ทำให้ติดตั้งใช้งานได้ง่ายขึ้น มีราคาถูกลง และลดทรัพยากรลงเหลือ 0 เมื่อคุณไม่ได้ใช้งาน ความยืดหยุ่นในการเรียกใช้คอนเทนเนอร์แบบไม่เก็บสถานะและการผสานรวมกับบริการต่างๆ ของ Google Cloud ทำให้ Cloud Run เหมาะอย่างยิ่งสำหรับการติดตั้งใช้งาน Microservice และแอปพลิเคชันสมัยใหม่โดยมีค่าใช้จ่ายเพิ่มเติมต่ำสุดและมีประสิทธิภาพสูงสุด

กล่าวอย่างเจาะจงคือ Cloud Run เป็นแพลตฟอร์มที่มีการจัดการครบวงจรโดย Google Cloud ซึ่งช่วยให้คุณเรียกใช้แอปพลิเคชันที่ใช้คอนเทนเนอร์แบบไม่เก็บสถานะในสภาพแวดล้อมแบบ Serverless ได้ โดยจะจัดการโครงสร้างพื้นฐานทั้งหมดโดยอัตโนมัติ โดยปรับขนาดจาก 0 เพื่อรองรับการเข้าชมที่เข้ามาและลดขนาดลงเมื่อไม่มีการใช้งาน ซึ่งทำให้คุ้มค่าและมีประสิทธิภาพ Cloud Run รองรับภาษาหรือไลบรารีใดก็ได้ตราบใดที่รวมอยู่ในคอนเทนเนอร์ ซึ่งช่วยให้การพัฒนาเป็นไปอย่างยืดหยุ่น โดยผสานรวมกับบริการอื่นๆ ของ Google Cloud ได้เป็นอย่างดี และเหมาะสำหรับการสร้าง Microservice, API, เว็บไซต์ และแอปพลิเคชันที่ขับเคลื่อนด้วยเหตุการณ์โดยไม่ต้องจัดการโครงสร้างพื้นฐานของเซิร์ฟเวอร์

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

หากต้องการทำงานนี้ให้เสร็จ คุณควรติดตั้ง gcloud ในเครื่องของคุณ หากไม่เห็น โปรดดูวิธีการที่นี่ แต่หากคุณใช้ Google Cloud Shell ก็ไม่จำเป็นต้องดำเนินการใดๆ

ก่อนติดตั้งใช้งาน...

หากคุณทำงานในสภาพแวดล้อมภายใน ให้ตรวจสอบสิทธิ์กับ Google Cloud โดยทำดังนี้

  • $ gcloud auth login –update-adc # not needed in Cloud Shell

ซึ่งจะตรวจสอบสิทธิ์ของคุณผ่านการเข้าสู่ระบบ OAuth ในเบราว์เซอร์ ตรวจสอบว่าคุณเข้าสู่ระบบผ่าน Chrome ด้วยผู้ใช้รายเดียวกัน (เช่น vattelapesca@gmail.com) ที่เข้าสู่ระบบ Google Cloud โดยเปิดใช้การเรียกเก็บเงิน

เปิดใช้ Cloud Run API ด้วยคำสั่งต่อไปนี้

  • $ gcloud services enable run.googleapis.com cloudbuild.googleapis.com

ตอนนี้ทุกอย่างพร้อมที่จะทำให้ใช้งานได้ใน Cloud Run แล้ว

ติดตั้งใช้งานแอปไปยัง Cloud Run ผ่าน gcloud

คำสั่งที่ช่วยให้คุณติดตั้งใช้งานแอปใน Cloud Run ได้คือ gcloud run deploy คุณตั้งค่าได้หลายวิธีเพื่อให้บรรลุเป้าหมาย ชุดตัวเลือกขั้นต่ำ (ซึ่งคุณระบุได้ผ่านบรรทัดคำสั่ง หรือเครื่องมือจะถามคุณด้วยข้อความแจ้งแบบอินเทอร์แอกทีฟ) มีดังนี้

  1. ชื่อบริการ Cloud Run ที่คุณต้องการทำให้ใช้งานได้สำหรับแอป บริการ Cloud Run จะแสดงผล URL ที่ระบุปลายทางสำหรับแอปของคุณ
  2. ภูมิภาค Google Cloud ที่แอปของคุณจะทำงาน (--region REGION)
  3. อิมเมจคอนเทนเนอร์ที่รวมแอปของคุณไว้
  4. ตัวแปรสภาพแวดล้อมที่แอปต้องใช้ในระหว่างการดำเนินการ
  5. แฟล็ก Allow-Unauthenticated ที่อนุญาตให้ทุกคนเข้าถึงแอปของคุณได้โดยไม่ต้องตรวจสอบสิทธิ์เพิ่มเติม

ดูเอกสารประกอบ (หรือเลื่อนลงเพื่อดูวิธีแก้ปัญหาที่เป็นไปได้) เพื่อดูวิธีใช้ตัวเลือกนี้กับบรรทัดคำสั่ง

การทำให้ใช้งานได้จะใช้เวลาสักครู่ หากทุกอย่างถูกต้อง คุณควรเห็นข้อมูลลักษณะนี้ในคอนโซล Google Cloud

ef1029fb62f8de81.pngf7191d579c21ca3e.png

คลิก URL ที่ Cloud Run ระบุไว้และทดสอบแอปพลิเคชัน เมื่อตรวจสอบสิทธิ์แล้ว คุณจะเห็นข้อความลักษณะนี้

d571a90cd5a373f9.png

"gcloud run deploy" โดยไม่มีอาร์กิวเมนต์

คุณอาจสังเกตเห็นว่า gcloud run deploy ถามคำถามที่ถูกต้องและเติมข้อมูลในช่องว่างที่คุณเว้นไว้ ยอดเยี่ยมไปเลย

อย่างไรก็ตาม ในบางโมดูล เราจะเพิ่มคำสั่งนี้ลงในทริกเกอร์บิลด์ Cloud Build เพื่อไม่ให้มีคำถามแบบอินเทอร์แอกทีฟ เราต้องกรอกข้อมูลทุกตัวเลือกในคำสั่ง คุณจึงต้องการสร้าง gcloud run deploy --option1 blah --foo bar --region your-fav-region สีทอง คุณจะใช้วิธีใด

  1. ทำขั้นตอนที่ 2-3-4 ซ้ำจนกว่า gcloud จะหยุดถามคำถาม
  2. [LOOP] พบ gcloud run deploy พร้อมตัวเลือกแล้ว
  3. [LOOP] ระบบขอตัวเลือก X
  4. [LOOP] ค้นหาวิธีตั้งค่า X จาก CLI โดยเพิ่มตัวเลือก --my-option [my-value] ในเอกสารสาธารณะ
  5. กลับไปที่ขั้นตอนที่ 2 ตอนนี้ เว้นแต่ gcloud จะเสร็จสมบูรณ์โดยไม่มีคำถามเพิ่มเติม
  6. gcloud run deploy บลา บลา บลา นี้เจ๋งมาก บันทึกคำสั่งไว้ที่ใดที่หนึ่ง เนื่องจากคุณจะต้องใช้ในภายหลังสำหรับขั้นตอน Cloud Build

ดูวิธีแก้ปัญหาที่เป็นไปได้ที่นี่ ดูเอกสารได้ที่นี่

ยินดีด้วย 🎉🎉🎉 คุณติดตั้งใช้งานแอปใน Google Cloud เรียบร้อยแล้ว ซึ่งถือเป็นขั้นตอนแรกของการปรับปรุงให้ทันสมัย

6. โมดูลที่ 4: ล้างรหัสผ่านด้วย Secret Manager

95cd57b03b4e3c73.png

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

การทำซ้ำครั้งแรก: อัปเดต config.php เพื่อใช้ ENV

คุณอาจสังเกตเห็นว่าเราใส่รหัสผ่าน DB ลงในโค้ดในไฟล์ config.php โดยตรง ซึ่งเหมาะสำหรับการทดสอบและดูว่าแอปทำงานได้หรือไม่ แต่คุณไม่สามารถคอมมิต/ใช้โค้ดดังกล่าวในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ได้ ควรอ่านรหัสผ่าน (และพารามิเตอร์การเชื่อมต่อฐานข้อมูลอื่นๆ) แบบไดนามิกและส่งไปยังแอปขณะรันไทม์ เปลี่ยนไฟล์ config.php เพื่อให้อ่านพารามิเตอร์ db จากตัวแปร ENV หากไม่สำเร็จ คุณควรพิจารณาตั้งค่าค่าเริ่มต้น ซึ่งจะเป็นประโยชน์ในกรณีที่คุณโหลด ENV ไม่สำเร็จ ดังนั้นเอาต์พุตของหน้าจะบอกคุณว่ากำลังใช้ค่าเริ่มต้นอยู่หรือไม่ เติมข้อมูลในช่องว่างและแทนที่โค้ดใน config.php

<?php
// Database configuration with ENV variables. Set default values as well 
$db_host = getenv('DB_HOST') ?: 'localhost';
$db_name = getenv('DB_NAME') ?: 'image_catalog';
$db_user = getenv('DB_USER') ?: 'appmod-phpapp-user';
$db_pass = getenv('DB_PASS') ?: 'wrong_password';
// Note getenv() is PHP 5.3 compatible
try {
    $pdo = new PDO("mysql:host=$db_host;dbname=$db_name", $db_user, $db_pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("Errore di connessione: " . $e->getMessage());
}

session_start();
?>

เนื่องจากแอปของคุณอยู่ในคอนเทนเนอร์ คุณจึงต้องระบุวิธีส่งตัวแปร ENV ไปยังแอป ซึ่งทำได้หลายวิธีดังนี้

  • ในเวลาบิลด์ใน Dockerfile เพิ่มพารามิเตอร์ 4 รายการลงใน Dockerfile ก่อนหน้าโดยใช้ไวยากรณ์ ENV DB_VAR=ENV_VAR_VALUE การดำเนินการนี้จะตั้งค่าเริ่มต้นซึ่งสามารถลบล้างได้ที่รันไทม์ เช่น คุณสามารถตั้งค่า "DB_NAME" และ "DB_USER" ได้ที่นี่เท่านั้น
  • ในเวลาเรียกใช้ คุณสามารถตั้งค่าตัวแปรเหล่านี้สำหรับ Cloud Run ได้ทั้งจาก CLI หรือจาก UI นี่คือตำแหน่งที่เหมาะสมในการใส่ตัวแปรทั้ง 4 ตัว (เว้นแต่คุณต้องการเก็บค่าเริ่มต้นที่ตั้งไว้ใน Dockerfile)

ใน localhost คุณอาจต้องใส่ตัวแปร ENV ในไฟล์ .env (ตรวจสอบโฟลเดอร์ solutions)

นอกจากนี้ โปรดตรวจสอบว่าได้เพิ่ม .env ลงใน .gitignore แล้ว เนื่องจากคุณไม่ต้องการพุชข้อมูลลับไปยัง GitHub

echo .env >> .gitignore

หลังจากนั้น คุณจะทดสอบอินสแตนซ์ในเครื่องได้โดยทำดังนี้

docker run -it -p 8080:8080 --env-file .env my-php-app-docker

ตอนนี้คุณได้ทำสิ่งต่อไปนี้แล้ว

  1. แอปจะอ่านตัวแปรแบบไดนามิกจาก ENV
  2. คุณได้ปรับปรุงความปลอดภัยเนื่องจากได้นำรหัสผ่าน DB ออกจากโค้ดแล้ว)

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

  • ไปที่ https://console.cloud.google.com/run
  • คลิกแอปของคุณ
  • คลิก "แก้ไขและทำให้การแก้ไขใหม่ใช้งานได้"
  • ในแท็บแรก "คอนเทนเนอร์" ให้คลิกแท็บด้านล่าง "ตัวแปรและข้อมูลลับ"
  • คลิก "+ เพิ่มตัวแปร" แล้วเพิ่มตัวแปรที่จำเป็นทั้งหมด คุณควรได้ผลลัพธ์ดังนี้

7a5fbfa448544d3.pngf2780c35585388ca.png

แบบนี้โอเคไหม ไม่ ผู้ให้บริการส่วนใหญ่จะยังคงเห็น PASS ของคุณ ปัญหานี้อาจลดลงเมื่อใช้ Google Cloud Secret Manager

การทำซ้ำครั้งที่ 2: Secret Manager

รหัสผ่านของคุณหายไปจากโค้ดของคุณเอง ชัยชนะเป็นของคุณแล้ว แต่เดี๋ยวก่อน เราปลอดภัยแล้วหรือยัง

รหัสผ่านของคุณจะยังคงแสดงแก่ทุกคนที่มีสิทธิ์เข้าถึงคอนโซล Google Cloud อันที่จริงแล้ว หากเข้าถึงไฟล์การติดตั้งใช้งาน YAML ของ Cloud Run คุณจะดึงข้อมูลดังกล่าวได้ หรือหากคุณพยายามแก้ไขหรือทำให้การแก้ไข Cloud Run ใหม่ใช้งานได้ รหัสผ่านจะปรากฏในส่วนตัวแปรและข้อมูลลับดังที่แสดงในภาพหน้าจอด้านล่าง

Secret Manager ของ Google Cloud เป็นบริการแบบรวมศูนย์ที่ปลอดภัยสำหรับการจัดการข้อมูลที่ละเอียดอ่อน เช่น คีย์ API, รหัสผ่าน, ใบรับรอง และข้อมูลลับอื่นๆ

ซึ่งช่วยให้คุณจัดเก็บ จัดการ และเข้าถึงข้อมูลลับด้วยสิทธิ์แบบละเอียดและการเข้ารหัสที่มีประสิทธิภาพ Secret Manager ผสานรวมกับ Identity and Access Management (IAM) ของ Google Cloud ช่วยให้คุณควบคุมผู้ที่เข้าถึงข้อมูลลับที่เฉพาะเจาะจงได้ ซึ่งจะช่วยรักษาความปลอดภัยข้อมูลและการปฏิบัติตามกฎระเบียบ

นอกจากนี้ยังรองรับการหมุนเวียนและการกำหนดเวอร์ชันของข้อมูลลับโดยอัตโนมัติ ซึ่งช่วยลดความซับซ้อนในการจัดการวงจรของข้อมูลลับและเพิ่มความปลอดภัยในแอปพลิเคชันในบริการต่างๆ ของ Google Cloud

หากต้องการเข้าถึง Secret Manager ให้ไปที่บริการความปลอดภัยจากเมนู 3 ขีด แล้วค้นหาในส่วนการคุ้มครองข้อมูล ดังที่แสดงในภาพหน้าจอด้านล่าง

6df83a1c3cb757f6.png

เปิดใช้ Secret Manager API เมื่อคุณอยู่ในหน้าดังกล่าวตามรูปภาพต่อไปนี้

a96c312e2c098db1.png

  • ตอนนี้ให้คลิก "สร้างข้อมูลลับ" โดยตั้งชื่อให้สมเหตุสมผล ดังนี้
  • ชื่อ: php-amarcord-db-pass
  • ค่าข้อมูลลับ: "รหัสผ่าน DB ของคุณ" (ไม่ต้องสนใจส่วน "อัปโหลดไฟล์")
  • ใส่คำอธิบายประกอบลิงก์ลับนี้ ซึ่งควรมีลักษณะดังนี้ projects/123456789012/secrets/php-amarcord-db-pass นี่คือตัวชี้ที่ไม่ซ้ำกันไปยังข้อมูลลับของคุณ (สำหรับ Terraform, Cloud Run และอื่นๆ) หมายเลขดังกล่าวคือหมายเลขโปรเจ็กต์ที่ไม่ซ้ำกันของคุณ

เคล็ดลับ: พยายามใช้รูปแบบการตั้งชื่อที่สอดคล้องกันสำหรับข้อมูลลับ โดยระบุจากซ้ายไปขวา เช่น cloud-devrel-phpamarcord-dbpass

  • องค์กร (ร่วมกับบริษัท)
  • ทีม (ภายในองค์กร)
  • แอปพลิเคชัน (ภายในทีม)
  • ชื่อตัวแปร (ภายในแอป)

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

สร้างการแก้ไข Cloud Run ใหม่

เมื่อมีข้อมูลลับใหม่แล้ว เราต้องกำจัดตัวแปร DB_PASS ENV และแทนที่ด้วยข้อมูลลับใหม่ ดังนั้น

  • เข้าถึง Cloud Run โดยใช้คอนโซล Google Cloud
  • เลือกแอป
  • คลิก "Edit & Deploy a New Revision"
  • ค้นหาแท็บ "Variables & Secrets"
  • ใช้ปุ่ม "+ อ้างอิงข้อมูลลับ" เพื่อรีเซ็ตตัวแปร ENV ของ DB_PASS
  • ใช้ "DB_PASS" เดียวกันสำหรับข้อมูลลับที่อ้างอิงและใช้เวอร์ชันล่าสุด

9ed4e35be7654dcb.png

เมื่อดำเนินการเสร็จแล้ว คุณควรได้รับข้อผิดพลาดต่อไปนี้

da0ccd7af39b04ed.png

ลองหาวิธีแก้ไข หากต้องการแก้ไขปัญหานี้ คุณต้องเข้าถึงส่วน IAM และผู้ดูแลระบบ แล้วเปลี่ยนสิทธิ์การให้สิทธิ์ ขอให้สนุกกับการแก้ไขข้อบกพร่อง

เมื่อทราบสาเหตุแล้ว ให้กลับไปที่ Cloud Run และทำให้การแก้ไขใหม่ใช้งานได้อีกครั้ง ผลลัพธ์ควรมีลักษณะดังภาพต่อไปนี้

e89f9ca780169b6b.png

เคล็ดลับ: Developer Console (UI) เหมาะอย่างยิ่งสำหรับการระบุปัญหาเกี่ยวกับสิทธิ์ โปรดสละเวลาเพื่อไปยังลิงก์ทั้งหมดสำหรับนิติบุคคล Cloud ของคุณ

7. โมดูล 5: ตั้งค่า CI/CD ด้วย Cloud Build

ba49b033c11be94c.png

ทำไมต้องใช้ไปป์ไลน์ CI/CD

ถึงตอนนี้ คุณน่าจะพิมพ์ gcloud run deploy ไปแล้ว 2-3 ครั้ง โดยอาจเป็นการตอบคำถามเดิมซ้ำแล้วซ้ำเล่า

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

หากต้องการใช้ไปป์ไลน์ CI/CD คุณจะต้องมี 2 สิ่งต่อไปนี้

  1. ที่เก็บ Git ส่วนตัว: โชคดีที่คุณควรจะแยกที่เก็บเวิร์กช็อปไปยังบัญชี GitHub ของคุณแล้วในขั้นตอนที่ 2 หากยังไม่ได้ดำเนินการ ให้กลับไปทำตามขั้นตอนนี้ให้เสร็จสมบูรณ์ ที่เก็บที่แยกของคุณควรมีลักษณะดังนี้ https://github.com/<YOUR_GITHUB_USER>/app-mod-workshop
  2. Cloud Build บริการที่ยอดเยี่ยมและราคาถูกนี้ช่วยให้คุณกำหนดค่าการสร้างระบบอัตโนมัติสำหรับเกือบทุกอย่าง ไม่ว่าจะเป็น Terraform, แอปที่ใช้ Docker...

ส่วนนี้จะเน้นที่การตั้งค่า Cloud Build

เข้าสู่ Cloud Build

เราจะใช้ Cloud Build เพื่อดำเนินการต่อไปนี้

  • สร้างแหล่งที่มา (ด้วย Dockerfile) ให้คิดว่านี่เป็น "ไฟล์ .zip ขนาดใหญ่" ซึ่งมีทุกสิ่งที่คุณต้องการเพื่อสร้างและเรียกใช้ (อาร์ติแฟกต์บิลด์)
  • พุชอาร์ติแฟกต์นี้ไปยัง Artifact Registry (AR)
  • จากนั้นออกการติดตั้งใช้งานจาก AR ไปยัง Cloud Run สำหรับแอป "php-amarcord"
  • ซึ่งจะสร้างเวอร์ชันใหม่ ("การแก้ไข") ของแอปที่มีอยู่ (นึกถึงเลเยอร์ที่มีโค้ดใหม่) และเราจะกำหนดค่าให้เปลี่ยนเส้นทางการเข้าชมไปยังเวอร์ชันใหม่หากพุชสำเร็จ

นี่คือตัวอย่างของบิลด์บางส่วนสำหรับแอป php-amarcord ของฉัน

f30f42d4571ad5e2.png

เราทำทั้งหมดนี้ได้อย่างไร

  1. โดยการสร้างไฟล์ YAML ที่สมบูรณ์แบบ 1 ไฟล์: cloudbuild.yaml
  2. สร้างทริกเกอร์บิลด์ของ Cloud Build
  3. โดยการเชื่อมต่อกับที่เก็บ GitHub ผ่าน UI ของ Cloud Build

สร้างทริกเกอร์ (และเชื่อมต่อที่เก็บ)

  • ไปที่ https://console.cloud.google.com/cloud-build/triggers
  • คลิก "สร้างทริกเกอร์"
  • คอมไพล์:
  • ชื่อ: ชื่อที่มีความหมาย เช่น on-git-commit-build-php-app
  • Event: Push to branch
  • แหล่งที่มา: "เชื่อมต่อที่เก็บใหม่" ข้อความแสดงแทน
  • ซึ่งจะเปิดหน้าต่าง "เชื่อมต่อที่เก็บ" ทางด้านขวา
  • ผู้ให้บริการแหล่งที่มา: "Github" (อันดับแรก)
  • "ต่อไป"
  • การตรวจสอบสิทธิ์จะเปิดหน้าต่างใน GitHub เพื่อตรวจสอบสิทธิ์แบบข้ามแพลตฟอร์ม ทำตามขั้นตอนและอดทนรอ หากคุณมีที่เก็บจำนวนมาก อาจใช้เวลาสักครู่
  • "เลือกที่เก็บ" เลือกบัญชี/ที่เก็บของคุณ แล้วทำเครื่องหมายในส่วน "ฉันเข้าใจ..."
  • หากได้รับข้อผิดพลาด: ไม่ได้ติดตั้งแอป GitHub ในที่เก็บใดๆ ให้คลิก "ติดตั้ง Google Cloud Build" แล้วทำตามวิธีการ
  • 23e0e0f1219afea3.pngคลิกเชื่อมต่อ
  • bafd904ec07122d2.png
  • ถูกต้อง! เชื่อมต่อที่เก็บของคุณแล้ว
  • กลับไปที่ส่วนทริกเกอร์...
  • การกำหนดค่า: ตรวจหาอัตโนมัติ (*)
  • ขั้นสูง: เลือกบัญชีบริการ "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • xxxxx คือรหัสโปรเจ็กต์ของคุณ
  • บัญชีบริการ Compute เริ่มต้นเหมาะสำหรับแนวทางแบบห้องปฏิบัติการ แต่อย่าใช้ในเวอร์ชันที่ใช้งานจริง (ดูข้อมูลเพิ่มเติม)
  • ปล่อยให้ส่วนอื่นๆ เป็นเหมือนเดิม
  • คลิกปุ่ม "สร้าง"

(*) วิธีนี้เป็นวิธีที่ง่ายที่สุดเนื่องจากจะตรวจสอบ Dockerfile หรือ cloudbuild.yaml อย่างไรก็ตาม cloudbuild.yaml ช่วยให้คุณตัดสินใจได้ว่าจะทำอะไรในขั้นตอนใด

ฉันมีพลัง!

ตอนนี้ทริกเกอร์จะใช้งานไม่ได้ เว้นแต่คุณจะให้สิทธิ์บัญชีบริการ Cloud Build (บัญชีบริการคืออะไร อีเมลของ "หุ่นยนต์" ที่ทำหน้าที่แทนคุณสำหรับงานหนึ่งๆ ซึ่งในกรณีนี้คือการสร้างสิ่งต่างๆ ในระบบคลาวด์

SA จะสร้างและทำให้ใช้งานได้ไม่สำเร็จ เว้นแต่คุณจะให้สิทธิ์ SA ดำเนินการ โชคดีที่ทำได้ง่ายๆ

  • ไปที่ "Cloud Build" > "การตั้งค่า"
  • บัญชีบริการ "[PROJECT_NUMBER]- compute@developer.gserviceaccount.com"
  • เลือกช่องต่อไปนี้
  • Cloud Run
  • Secret Manager
  • บัญชีบริการ
  • Cloud Build
  • และเลือก "ตั้งเป็นบัญชีบริการที่ต้องการ" ด้วย

8715acca72286a46.png

YAML ของ Cloud Build อยู่ที่ไหน

เราขอแนะนำอย่างยิ่งให้คุณใช้เวลาสร้าง YAML ของ Cloud Build ของคุณเอง

แต่หากไม่มีเวลาหรือไม่ต้องการใช้เวลา คุณสามารถหาแรงบันดาลใจได้ในโฟลเดอร์โซลูชันนี้: .solutions

ตอนนี้คุณสามารถพุชการเปลี่ยนแปลงไปยัง GitHub และสังเกต Cloud Build ในส่วนของตนเองได้แล้ว

การตั้งค่า Cloud Build อาจเป็นเรื่องยุ่งยาก คาดว่าจะมีการติดต่อกลับไปกลับมาภายในวันที่:

  • ตรวจสอบบันทึกใน https://console.cloud.google.com/cloud-build/builds;region=global
  • กำลังค้นหาข้อผิดพลาด
  • แก้ไขในโค้ด และออก git commit / git push อีกครั้ง
  • บางครั้งข้อผิดพลาดไม่ได้อยู่ในโค้ด แต่อยู่ในการกำหนดค่าบางอย่าง ในกรณีนี้ คุณสามารถสร้างบิลด์ใหม่จาก UI (Cloud Build > "ทริกเกอร์" > เรียกใช้)

97acd16980a144ab.png

โปรดทราบว่าหากใช้โซลูชันนี้ คุณยังคงต้องดำเนินการบางอย่าง เช่น คุณต้องตั้งค่าตัวแปร ENV สำหรับปลายทาง dev/prod ที่สร้างขึ้นใหม่ ดังนี้

3da8723e4ff80c0a.png

โดยสามารถทำได้สองวิธี:

  • ผ่าน UI - โดยการตั้งค่าตัวแปร ENV อีกครั้ง
  • ผ่าน CLI โดยการสร้างสคริปต์ที่ "สมบูรณ์แบบ" สำหรับคุณ ดูตัวอย่างได้ที่ gcloud-run-deploy.sh คุณต้องปรับแต่งบางอย่าง เช่น ปลายทางและหมายเลขโปรเจ็กต์ โดยดูหมายเลขโปรเจ็กต์ได้ในภาพรวมของ Cloud

ฉันจะคอมมิตโค้ดไปยัง GitHub ได้อย่างไร

การสอนวิธีที่ดีที่สุดในการgit pushไปยัง GitHub อยู่นอกขอบเขตของเวิร์กช็อปนี้ อย่างไรก็ตาม หากคุณติดขัดและอยู่ใน Cloud Shell คุณจะทำได้ 2 วิธีดังนี้

  1. CLI เพิ่มคีย์ ssh ในเครื่องและเพิ่มรีโมตด้วย git@github.com:YOUR_USER/app-mod-workshop.git (แทน http)
  2. VSCode หากใช้เครื่องมือแก้ไข Cloud Shell คุณสามารถใช้แท็บการควบคุมแหล่งที่มา (ctrl-shift-G) คลิก "ซิงค์การเปลี่ยนแปลง" แล้วทำตามวิธีการ คุณควรตรวจสอบสิทธิ์บัญชี GitHub กับ VS Code ได้ และการดึง/พุชจากที่นั่นจะกลายเป็นเรื่องง่าย

f0d53f839c7fa3b6.png

อย่าลืมgit add clodubuild.yamlในไฟล์อื่นๆ ด้วย ไม่เช่นนั้นจะใช้งานไม่ได้

Deep เทียบกับ Shallow "dev/prod parity" [ไม่บังคับ]

หากคุณคัดลอกเวอร์ชันโมเดลจากที่นี่ คุณจะมีเวอร์ชัน DEV และ PROD ที่เหมือนกัน 2 เวอร์ชัน ซึ่งเป็นเรื่องดีและสอดคล้องกับกฎข้อที่ 10 ของแอป 12 ปัจจัย

อย่างไรก็ตาม เราใช้ปลายทางเว็บ 2 รายการที่แตกต่างกันเพื่อให้แอปชี้ไปยังฐานข้อมูลเดียวกัน ซึ่งเพียงพอสำหรับเวิร์กช็อป แต่ในชีวิตจริง คุณควรใช้เวลาสร้างสภาพแวดล้อมเวอร์ชันที่ใช้งานจริงที่เหมาะสม ซึ่งหมายความว่าคุณต้องมีฐานข้อมูล 2 รายการ (รายการหนึ่งสำหรับเวอร์ชัน Dev และอีกรายการหนึ่งสำหรับเวอร์ชัน Prod) และเลือกตำแหน่งที่จะเก็บฐานข้อมูลไว้สำหรับการกู้ข้อมูลคืนหลังจากภัยพิบัติ/ความพร้อมใช้งานสูง แม้ว่าเรื่องนี้จะอยู่นอกเหนือขอบเขตของเวิร์กช็อปนี้ แต่ก็เป็นข้อมูลที่เป็นประโยชน์

หากคุณมีเวลาสร้างเวอร์ชัน "เชิงลึก" ของการผลิต โปรดคำนึงถึงทรัพยากรทั้งหมดที่คุณต้องทำซ้ำ เช่น

  • ฐานข้อมูล Cloud SQL (และอาจรวมถึงอินสแตนซ์ SQL)
  • Bucket ของ GCS
  • Cloud Function
  • คุณอาจใช้ Gemini 1.5 Flash เป็นโมเดลในการพัฒนา (ถูกกว่า เร็วกว่า) และ Gemini 1.5 Pro (มีประสิทธิภาพมากกว่า)

โดยทั่วไป ทุกครั้งที่คุณดำเนินการเกี่ยวกับแอป ให้พิจารณาอย่างรอบคอบว่าเวอร์ชันที่ใช้งานจริงควรมีค่าเดียวกันนี้หรือไม่ และหากยังไม่สำเร็จ ให้ลองอีกครั้ง แน่นอนว่าวิธีนี้จะง่ายขึ้นมากเมื่อใช้ Terraform ซึ่งคุณสามารถแทรกสภาพแวดล้อม (-dev, -prod) เป็นคำต่อท้ายทรัพยากรได้

8. โมดูล 6: ย้ายไปยัง Google Cloud Storage

a680e0f287dd2dfb.png

พื้นที่เก็บข้อมูล

dc3a4b8ea92aaef6.png

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

เราจะแก้ไขปัญหานี้ได้อย่างไร มีหลายวิธีด้วยกัน

  1. จัดเก็บรูปภาพในฐานข้อมูล นั่นคือสิ่งที่ฉันทำกับแอป PHP ก่อนหน้านี้ เป็นวิธีแก้ปัญหาที่ง่ายที่สุดเพราะไม่ได้เพิ่มความซับซ้อนให้กับแอป แต่จะเพิ่มเวลาในการตอบสนองและภาระงานให้กับฐานข้อมูลอย่างแน่นอน
  2. ย้ายแอป Cloud Run ไปยังโซลูชันที่เหมาะกับพื้นที่เก็บข้อมูล: GCE + Persistent Disk หรือจะเป็น GKE + พื้นที่เก็บข้อมูล หมายเหตุ: สิ่งที่คุณได้รับจากการควบคุมคือสิ่งที่คุณสูญเสียไปในด้านความคล่องตัว
  3. ย้ายไปที่ GCS Google Cloud Storage มีพื้นที่เก็บข้อมูลที่ดีที่สุดในระดับเดียวกันสำหรับ Google Cloud ทั้งหมด และเป็นโซลูชันที่เหมาะกับระบบคลาวด์มากที่สุด อย่างไรก็ตาม เราต้องลงมือเขียนโค้ดด้วยไลบรารี PHP เรามีไลบรารี PHP 5.7 สำหรับ GCS ไหม PHP 5.7 รองรับ Composer หรือไม่ (ดูเหมือนว่า PHP 5.3.2 เป็นเวอร์ชันแรกสุดที่ Composer รองรับ)
  4. ลองใช้ docker sidecar ไหม
  5. หรืออาจใช้ Cloud Run Volume Mounts ของ GCS ฟังดูน่าสนใจมาก

🤔 ย้ายข้อมูลพื้นที่เก็บข้อมูล (ปลายเปิด)

[ปลายเปิด] ในแบบฝึกหัดนี้ เราต้องการให้คุณค้นหาวิธีแก้ปัญหาเพื่อย้ายรูปภาพในลักษณะที่คงอยู่ถาวร

การทดสอบการยอมรับ

ฉันไม่ต้องการบอกวิธีแก้ปัญหา แต่ฉันต้องการให้เกิดสิ่งต่อไปนี้

  1. คุณอัปโหลด newpic.jpg คุณจะเห็นในแอป
  2. คุณอัปเกรดแอปเป็นเวอร์ชันใหม่
  3. newpic.jpg ยังคงอยู่และมองเห็นได้

💡 วิธีแก้ปัญหาที่เป็นไปได้ (GCS Cloud Run Volume Mounts)

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

ซึ่งจะช่วยให้คุณต่อเชื่อมโฟลเดอร์จาก Cloud Run ไปยัง GCS ได้ ดังนั้น

  1. การอัปโหลดทั้งหมดไปยัง GCS จะปรากฏในแอปของคุณ
  2. การอัปโหลดทั้งหมดไปยังแอปของคุณจะอัปโหลดไปยัง GCS จริงๆ
  3. ระบบจะดำเนินการกับออบเจ็กต์ที่อัปโหลดใน GCS (บทที่ 7)

หมายเหตุ โปรดอ่านข้อความตัวอักษรขนาดเล็กของ FUSE ซึ่งไม่เป็นไรหากประสิทธิภาพเป็นปัญหา

สร้างที่เก็บข้อมูล GCS

GCS เป็นบริการพื้นที่เก็บข้อมูลที่พร้อมใช้งานทุกที่ทุกเวลาของ Google Cloud ซึ่งผ่านการทดสอบมาอย่างหนักหน่วงและใช้โดยบริการ GCP ทุกบริการที่ต้องการพื้นที่เก็บข้อมูล

โปรดทราบว่า Cloud Shell จะส่งออก PROJECT_ID เป็น GOOGLE_CLOUD_PROJECT ดังนี้

$ export PROJECT_ID=$GOOGLE_CLOUD_PROJECT

#!/bin/bash

set -euo pipefail

# Your Cloud Run Service Name, eg php-amarcord-dev
SERVICE_NAME='php-amarcord-dev'
BUCKET="${PROJECT_ID}-public-images"
GS_BUCKET="gs://${BUCKET}"

# Create bucket
gsutil mb -l "$GCP_REGION" -p "$PROJECT_ID" "$GS_BUCKET/"

# Copy original pictures there - better if you add an image of YOURS before.
gsutil cp ./uploads/*.png "$GS_BUCKET/"

กำหนดค่า Cloud Run ให้ต่อเชื่อมบักเก็ตในโฟลเดอร์ /uploads/

ทีนี้มาดูส่วนที่สวยงามกันบ้าง เราสร้างวอลุ่ม php_uploads และสั่งให้ Cloud Run ทำการต่อเชื่อม FUSE ใน MOUNT_PATH (เช่น /var/www/html/uploads/) ดังนี้

#!/bin/bash

set -euo pipefail

# .. keep variables from previous script..

# Uploads folder within your docker container.
# Tweak it for your app code.
MOUNT_PATH='/var/www/html/uploads/'

# Inject a volume mount to your GCS bucket in the right folder.
gcloud --project "$PROJECT_ID" beta run services update "$SERVICE_NAME" \
    --region $GCP_REGION \
    --execution-environment gen2 \
    --add-volume=name=php_uploads,type=cloud-storage,bucket="$BUCKET"  \
    --add-volume-mount=volume=php_uploads,mount-path="$MOUNT_PATH"

ตอนนี้ ให้ทำขั้นตอนนี้ซ้ำสำหรับปลายทางทั้งหมดที่ต้องการชี้ไปยัง Cloud Storage

คุณยังทำแบบเดียวกันได้จาก UI

  1. ในแท็บ "Volumes" ให้สร้าง Volume Mounts ที่ชี้ไปยังที่เก็บข้อมูลของคุณ ซึ่งเป็นประเภท "ที่เก็บข้อมูล Cloud Storage" เช่น ชื่อ "php_uploads"
  2. ในส่วนคอนเทนเนอร์ > การต่อเชื่อมวอลุ่ม ให้ต่อเชื่อมวอลุ่มที่คุณเพิ่งสร้างขึ้นในจุดวอลุ่มที่แอปขอ ซึ่งจะขึ้นอยู่กับ Dockerfile แต่อาจมีลักษณะเป็น var/www/html/uploads/

ไม่ว่าจะด้วยวิธีใด หากใช้งานได้ การแก้ไขการแก้ไข Cloud Run ใหม่ควรแสดงข้อมูลดังนี้

6c2bb98fc1b0e077.png

ตอนนี้ให้ทดสอบแอปพลิเคชันใหม่โดยอัปโหลดรูปภาพใหม่ 1 รูปไปยังปลายทาง /upload.php

รูปภาพควรแสดงบน GCS ได้อย่างราบรื่นโดยไม่ต้องเขียน PHP แม้แต่บรรทัดเดียว

70032b216afee2d7.png

เกิดอะไรขึ้น

มีสิ่งมหัศจรรย์เกิดขึ้น

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

  • หากต้องการส่งอีเมลทุกครั้งที่มีรูปภาพที่มีคำว่า "อันตราย" หรือ "ภาพเปลือย" เข้ามา คุณสามารถทำได้โดยไม่ต้องแก้ไขโค้ด PHP
  • ต้องการใช้โมเดล Gemini Multimodal ทุกครั้งที่มีรูปภาพเข้ามาเพื่ออธิบายรูปภาพนั้น และอัปโหลดฐานข้อมูลพร้อมคำอธิบายไหม คุณสามารถทำได้โดยไม่ต้องแก้ไขโค้ด PHP คุณไม่เชื่อฉันเหรอ อ่านต่อในบทที่ 7

เราเพิ่งปลดล็อกโอกาสครั้งใหญ่ที่นี่

9. โมดูล 7: เพิ่มประสิทธิภาพแอปด้วย Google Gemini

c00425f0ad83b32c.png

ตอนนี้คุณมีแอป PHP ใหม่ที่ทันสมัยและยอดเยี่ยม (เช่น Fiat 126 ปี 2024) พร้อมพื้นที่เก็บข้อมูลในระบบคลาวด์แล้ว

คุณใช้ชื่อช่องทำอะไรได้บ้าง

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

ในบทที่แล้ว โซลูชันโมเดลช่วยให้เราต่อเชื่อมรูปภาพ /uploads/ บน GCS ได้ ซึ่งเป็นการแยกตรรกะของแอปออกจากพื้นที่เก็บข้อมูลรูปภาพโดยพฤตินัย

แบบฝึกหัดนี้กำหนดให้คุณต้องทำสิ่งต่อไปนี้

  • ทำแบบฝึกหัดในบทที่ 6 (พื้นที่เก็บข้อมูล) เสร็จสมบูรณ์แล้ว
  • มีที่เก็บข้อมูล GCS ที่มีการอัปโหลดรูปภาพ ซึ่งผู้ใช้จะอัปโหลดรูปภาพในแอปของคุณและรูปภาพจะส่งไปยังที่เก็บข้อมูลของคุณ

ตั้งค่า Cloud Function (ใน Python)

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

  • เมื่อ <เหตุการณ์> เกิดขึ้น => ส่งอีเมล
  • เมื่อ <event> เกิดขึ้น => หาก <condition> เป็นจริง ให้อัปเดตฐานข้อมูล

เหตุการณ์อาจเป็นอะไรก็ได้ ตั้งแต่ระเบียนใหม่ที่พร้อมใช้งานใน BigQuery, ออบเจ็กต์ใหม่ที่เปลี่ยนแปลงในโฟลเดอร์ใน GCS หรือข้อความใหม่ที่รออยู่ในคิวใน Pub/Sub

Google Cloud รองรับกระบวนทัศน์หลายแบบเพื่อให้บรรลุเป้าหมายนี้ โดยเฉพาะอย่างยิ่งในเรื่องต่อไปนี้

  • EventArc ดูวิธีรับเหตุการณ์ GCS เหมาะสำหรับการสร้าง DAG และจัดระเบียบการดำเนินการตามเงื่อนไข if-then-else ในระบบคลาวด์
  • Cloud Scheduler เช่น เหมาะสำหรับงาน Cron ตอนเที่ยงคืนในระบบคลาวด์
  • Cloud Workflows ช่วยให้คุณทำสิ่งต่อไปนี้ได้คล้ายกับ Event Arc
  • Cloud Run Functions (หรือที่รู้จักกันในชื่อ lambdas)
  • Cloud Composer โดยพื้นฐานแล้วเป็น Apache Airflow เวอร์ชัน Google และยังเหมาะสำหรับ DAG ด้วย

ในแบบฝึกหัดนี้ เราจะเจาะลึกเกี่ยวกับ Cloud Function เพื่อให้ได้ผลลัพธ์ที่น่าทึ่ง และเราจะให้แบบฝึกหัดเสริมแก่คุณ

โปรดทราบว่าโค้ดตัวอย่างมีให้ใช้งานภายใต้ .solutions/

ตั้งค่า Cloud Function (🐍 python)

เราพยายามสร้าง GCF ที่มีความทะเยอทะยานอย่างมาก

  1. เมื่อมีการสร้างรูปภาพใหม่ใน GCS.. (อาจเป็นเพราะมีคนอัปโหลดไว้ในแอป แต่ก็อาจมีสาเหตุอื่นๆ ด้วย)
  2. .. เรียกใช้ Gemini เพื่ออธิบายและรับคำอธิบายแบบข้อความของรูปภาพ .. (ควรตรวจสอบ MIME และตรวจสอบว่าเป็นรูปภาพ ไม่ใช่ PDF, MP3 หรือข้อความ)
  3. .. และอัปเดตฐานข้อมูลด้วยคำอธิบายนี้ (ซึ่งอาจต้องมีการแพตช์ฐานข้อมูลเพื่อเพิ่มคอลัมน์ description ลงในตาราง images)

แพตช์ฐานข้อมูลเพื่อเพิ่ม description ลงในรูปภาพ

  1. เปิด Cloud SQL Studio โดยทำดังนี้

b92b07c4cba658ef.png

  1. ป้อนผู้ใช้และรหัสผ่านสำหรับฐานข้อมูลรูปภาพ
  2. แทรก SQL นี้ซึ่งจะเพิ่มคอลัมน์สำหรับคำอธิบายรูปภาพ

ALTER TABLE images ADD COLUMN description TEXT;

3691aced78a6389.png

เท่านี้ก็เรียบร้อย ลองตรวจสอบตอนนี้เลยว่าได้ผลหรือไม่

SELECT * FROM images;

คุณควรเห็นคอลัมน์คำอธิบายใหม่ดังนี้

bed69d6ad0263114.png

เขียน f(x) ของ Gemini

หมายเหตุ ฟังก์ชันนี้สร้างขึ้นโดยใช้ความช่วยเหลือจาก Gemini Code Assist

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

  1. เปิดใช้ API
  2. ไปที่ https://console.cloud.google.com/functions/list
  3. คลิก "Create Function"
  4. เปิดใช้ API จากวิซาร์ด API โดยทำดังนี้

d22b82658cfd4c48.png

คุณจะสร้าง GCF จาก UI หรือจากบรรทัดคำสั่งก็ได้ ในที่นี้เราจะใช้บรรทัดคำสั่ง

คุณดูรหัสที่เป็นไปได้ได้ในส่วน .solutions/

  1. สร้างโฟลเดอร์เพื่อโฮสต์โค้ด เช่น "gcf/" ป้อนโฟลเดอร์
  2. สร้างไฟล์ requirements.txt โดยทำดังนี้
google-cloud-storage
google-cloud-aiplatform
pymysql
  1. สร้างฟังก์ชัน Python ดูโค้ดตัวอย่างได้ที่ gcf/main.py
#!/usr/bin/env python

"""Complete this"""

from google.cloud import storage
from google.cloud import aiplatform
import vertexai
from vertexai.generative_models import GenerativeModel, Part
import os
import pymysql
import pymysql.cursors

# Replace with your project ID
PROJECT_ID = "your-project-id"
GEMINI_MODEL = "gemini-1.5-pro-002"
DEFAULT_PROMPT = "Generate a caption for this image: "

def gemini_describe_image_from_gcs(gcs_url, image_prompt=DEFAULT_PROMPT):
    pass

def update_db_with_description(image_filename, caption, db_user, db_pass, db_host, db_name):
    pass

def generate_caption(event, context):
    """
    Cloud Function triggered by a GCS event.
    Args:
        event (dict): The dictionary with data specific to this type of event.
        context (google.cloud.functions.Context): The context parameter contains
                                                event metadata such as event ID
                                                and timestamp.
    """
    pass
  1. กดฟังก์ชัน คุณสามารถใช้สคริปต์ที่คล้ายกับ gcf/push-to-gcf.sh ได้

หมายเหตุ 1 ตรวจสอบว่าได้จัดหา ENV ที่มีค่าที่ถูกต้อง หรือเพียงแค่เพิ่มไว้ด้านบน (GS_BUCKET=blah, ..)

หมายเหตุ 2 การดำเนินการนี้จะพุชโค้ดในเครื่องทั้งหมด (.) ดังนั้นโปรดตรวจสอบว่าได้รวมโค้ดไว้ในโฟลเดอร์ที่เฉพาะเจาะจงและใช้ .gcloudignore อย่างมืออาชีพเพื่อหลีกเลี่ยงการพุชไลบรารีขนาดใหญ่ (ตัวอย่าง)

#!/bin/bash

set -euo pipefail

# add your logic here, for instance:
source .env || exit 2 

echo "Pushing ☁️ f(x)☁ to 🪣 $GS_BUCKET, along with DB config.. (DB_PASS=$DB_PASS)"

gcloud --project "$PROJECT_ID" functions deploy php_amarcord_generate_caption \
    --runtime python310 \
    --region "$GCP_REGION" \
    --trigger-event google.cloud.storage.object.v1.finalized \
    --trigger-resource "$BUCKET" \
    --set-env-vars "DB_HOST=$DB_HOST,DB_NAME=$DB_NAME,DB_PASS=$DB_PASS,DB_USER=$DB_USER" \
    --source . \
    --entry-point generate_caption \
    --gen2

หมายเหตุ: ในตัวอย่างนี้ generate_caption จะเป็นเมธอดที่เรียกใช้ และ Cloud Function จะส่งเหตุการณ์ GCS ไปยังเมธอดดังกล่าวพร้อมข้อมูลที่เกี่ยวข้องทั้งหมด (ชื่อที่เก็บข้อมูล ชื่อออบเจ็กต์ ฯลฯ) โปรดใช้เวลาสักครู่เพื่อแก้ไขข้อบกพร่องของ Python Dict ของเหตุการณ์นั้น

การทดสอบฟังก์ชัน

Unit Test

ฟังก์ชันนี้มีองค์ประกอบที่เปลี่ยนแปลงได้หลายอย่าง คุณอาจต้องการทดสอบตัวแปรเดี่ยวทั้งหมด

ดูตัวอย่างได้ใน gcf/test.py

UI ของ Cloud Functions

นอกจากนี้ โปรดใช้เวลาสักครู่เพื่อสำรวจฟังก์ชันใน UI ทุกแท็บควรค่าแก่การสำรวจ โดยเฉพาะ Source (แท็บโปรดของเรา), Variables, Trigger และ Logs คุณจะใช้เวลาส่วนใหญ่ใน Logs เพื่อแก้ปัญหาข้อผิดพลาด (ดูข้อผิดพลาดที่อาจเกิดขึ้นที่ด้านล่างของหน้านี้ด้วย) และอย่าลืมตรวจสอบ Permissions ด้วย

cf3ded30d532a2c7.png

การทดสอบ E2E

ได้เวลาทดสอบฟังก์ชันด้วยตนเองแล้ว

  1. ไปที่แอปและเข้าสู่ระบบ
  2. อัปโหลดรูปภาพ (ขนาดไม่ใหญ่เกินไป เนื่องจากเราพบปัญหาเกี่ยวกับรูปภาพขนาดใหญ่)
  3. ตรวจสอบใน UI ว่าอัปโหลดรูปภาพแล้ว
  4. ตรวจสอบใน Cloud SQL Studio ว่าคำอธิบายได้รับการอัปเดตแล้ว เข้าสู่ระบบและเรียกใช้การค้นหานี้: SELECT * FROM images

43a680b12dbbdda0.png

ซึ่งก็ใช้ได้ผล นอกจากนี้ เราอาจต้องการอัปเดตฟรอนท์เอนด์เพื่อแสดงคำอธิบายนั้นด้วย

อัปเดต PHP เพื่อแสดง [ไม่บังคับ]

เราได้พิสูจน์แล้วว่าแอปใช้งานได้ อย่างไรก็ตาม คงจะดีหากผู้ใช้เห็นคำอธิบายนั้นด้วย

เราไม่จำเป็นต้องเป็นผู้เชี่ยวชาญ PHP เพื่อเพิ่มคำอธิบายลงใน index.php โค้ดนี้ควรทำสิ่งต่อไปนี้ (ใช่แล้ว Gemini เขียนโค้ดนี้ให้ฉันด้วย)

<?php if (!empty($image['description'])): ?>
    <p class="font-bold">Gemini Caption:</p>
    <p class="italic"><?php echo $image['description']; ?></p>
<?php endif; ?>

วางโค้ดนี้ไว้ใน foreach ตามที่คุณต้องการ

ในขั้นตอนถัดไป เราจะเห็น UI เวอร์ชันที่สวยงามยิ่งขึ้นด้วย Gemini Code Assist เวอร์ชันที่จัดรูปแบบแล้วอาจมีลักษณะดังนี้

fdc12de0c88c4464.png

สรุป

คุณมี Cloud Function ที่ทริกเกอร์บนออบเจ็กต์ใหม่ที่เข้าสู่ GCS ซึ่งสามารถใส่คำอธิบายประกอบเนื้อหาของรูปภาพได้เหมือนกับที่มนุษย์ทำ และอัปเดตฐานข้อมูลโดยอัตโนมัติ ว้าว

ต้องทำอะไรต่อ คุณสามารถใช้เหตุผลเดียวกันนี้เพื่อให้ได้ฟังก์ชันการทำงานที่ยอดเยี่ยม 2 อย่าง

[ไม่บังคับ] เพิ่ม Cloud Functions อื่นๆ [คำถามปลายเปิด]

มีฟีเจอร์เพิ่มเติมอีก 2-3 รายการที่น่าสนใจ

📩 ทริกเกอร์อีเมล

ทริกเกอร์อีเมลซึ่งจะส่งอีเมลถึงคุณทุกครั้งที่มีคนส่งรูปภาพ

  • บ่อยเกินไปใช่ไหม เพิ่มข้อจำกัดเพิ่มเติม: รูปภาพขนาดใหญ่ หรือรูปภาพที่มีเนื้อหา Gemini ที่มีคำว่า "เปลือย/ภาพเปลือย/รุนแรง"
  • ลองตรวจสอบ EventArc สำหรับเรื่องนี้

🚫 จัดการรูปภาพที่ไม่เหมาะสมโดยอัตโนมัติ

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

ข้อจำกัด Generative AI มีเอาต์พุตที่คาดเดาไม่ได้ ตรวจสอบว่า "เอาต์พุตครีเอทีฟโฆษณา" จาก Gemini เป็นไปตาม "แนวทาง" คุณอาจขอคำตอบเชิงกำหนด เช่น คะแนนความเชื่อมั่นตั้งแต่ 0 ถึง 1, JSON, .. คุณสามารถทำได้หลายวิธี เช่น * ใช้ไลบรารี Python pydantic, langchain, .. * ใช้เอาต์พุตที่มีโครงสร้างของ Gemini

เคล็ดลับ คุณอาจมีฟังก์ชันหลายรายการหรือมีพรอมต์เดียวที่บังคับใช้คำตอบ JSON (ทำงานได้ดีกับ "เอาต์พุตที่มีโครงสร้างของ Gemini" ตามที่ไฮไลต์ไว้ด้านบน) เช่น

พรอมต์ที่ใช้สร้างภาพนี้ควรเป็นอย่างไร

{
    "description": "This is the picture of an arrosticino",
    "suitable": TRUE
}

คุณสามารถเพิ่มช่องเพิ่มเติมในพรอมต์เพื่อรับข้อมูลเชิงลึก เช่น มีอะไรดีเกี่ยวกับเรื่องนี้ไหม แย่ไหม คุณรู้จักสถานที่นี้ไหม มีข้อความไหม (OCR ทำได้ง่ายกว่าที่เคย):

  • goods: "ดูเหมือนอาหารอร่อยๆ"
  • bads: "ดูเหมือนอาหารที่ไม่ดีต่อสุขภาพ"
  • OCR: "Da consumare preferibilmente prima del 10 Novembre 2024"
  • location: "Pescara, Lungomare"

แม้ว่าโดยปกติแล้วการมีฟังก์ชัน N สำหรับผลลัพธ์ N จะดีกว่า แต่การทำสิ่งเดียวที่ทำได้ 10 อย่างก็คุ้มค่าอย่างไม่น่าเชื่อ ดูวิธีได้ที่บทความนี้โดย Riccardo

ข้อผิดพลาดที่อาจเกิดขึ้น (ส่วนใหญ่เป็น IAM/สิทธิ์)

ครั้งแรกที่ฉันพัฒนาโซลูชันนี้ ฉันพบปัญหาเกี่ยวกับสิทธิ์ IAM บางอย่าง เราจะเพิ่มไว้ที่นี่เพื่อแสดงความเห็นอกเห็นใจและให้แนวคิดเกี่ยวกับวิธีแก้ไข

ข้อผิดพลาด: สิทธิ์สำหรับบัญชีบริการไม่เพียงพอ

  1. โปรดทราบว่าหากต้องการทำให้ฟังก์ชัน GCF ที่คอยฟังเหตุการณ์ในที่เก็บข้อมูล GCS ใช้งานได้ คุณต้องตั้งค่าสิทธิ์ที่เหมาะสมให้กับบัญชีบริการที่ใช้สำหรับงาน ดังที่แสดงในภาพต่อไปนี้

22f51012fa6b4a24.png

นอกจากนี้ คุณอาจต้องเปิดใช้ EventArc API ด้วย โดยรอสักครู่ก่อนที่ API จะพร้อมใช้งานอย่างเต็มรูปแบบ

ข้อผิดพลาด: ไม่มีผู้เรียกใช้ Cloud Run

  1. ความคิดเห็นอีกรายการจาก UI สำหรับการให้สิทธิ์ GCF มีดังนี้ (บทบาทผู้เรียกใช้ Cloud Run)

be72e17294f2d3f3.png

ข้อผิดพลาดนี้แก้ไขได้โดยเรียกใช้คำสั่งในรูปภาพ ซึ่งคล้ายกับ fix-permissions.sh

ปัญหานี้อธิบายไว้ที่ https://cloud.google.com/functions/docs/securing/authenticating

ข้อผิดพลาด: เกินขีดจำกัดหน่วยความจำ

ครั้งแรกที่ฉันเรียกใช้ บันทึกอาจระบุว่า "เกินขีดจำกัดหน่วยความจำ 244 MiB โดยใช้ไป 270 MiB ลองเพิ่มขีดจำกัดหน่วยความจำ โปรดดู https://cloud.google.com/functions/docs/configuring/memory'" เพิ่ม RAM ลงใน GCF อีกครั้ง ซึ่งทำได้ง่ายมากใน UI ปัญหาที่อาจเกิดขึ้นมีดังนี้

bed69d6ad0263114.png

หรือจะแก้ไขสคริปต์การติดตั้งใช้งาน Cloud Run เพื่อเพิ่ม MEM/CPU ก็ได้ การดำเนินการนี้จะใช้เวลานานกว่าปกติเล็กน้อย

ข้อผิดพลาด: เผยแพร่ PubSub แล้ว

การสร้างทริกเกอร์ด้วย GCF v1 แสดงข้อผิดพลาดนี้ครั้งเดียว

e5c338ee35ad4c24.png

ซึ่งปัญหานี้แก้ไขได้ง่ายๆ โดยไปที่ IAM และให้บทบาท "ผู้เผยแพร่ Pub/Sub" แก่บัญชีบริการของคุณ

ข้อผิดพลาด: ไม่ได้ใช้ Vertex AI

หากได้รับข้อผิดพลาดนี้ ให้ทำดังนี้

สิทธิ์ถูกปฏิเสธ: 403 Vertex AI API ไม่เคยใช้ในโปรเจ็กต์ YOUR_PROJECT มาก่อนหรือถูกปิดใช้ เปิดใช้โดยไปที่ https://console.developers.google.com/apis/api/aiplatform.googleapis.com/overview?project=YOR_PROJECT

คุณเพียงแค่ต้องเปิดใช้ Vertex AI API วิธีที่ง่ายที่สุดในการเปิดใช้ API ที่จำเป็นทั้งหมดมีดังนี้

  1. https://console.cloud.google.com/vertex-ai
  2. คลิก "เปิดใช้ API ที่แนะนำทั้งหมด"

492f05ac377f3630.png

ข้อผิดพลาด: ไม่พบทริกเกอร์ EventArc

หากได้รับข้อความนี้ โปรดทำให้ฟังก์ชันใช้งานได้อีกครั้ง

8ec4fc11833d7420.png

ข้อผิดพลาด: 400 กำลังจัดสรร Service Agent

400 ระบบกำลังจัดสรร Service Agent (https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents) โดย Service Agent จำเป็นต้องอ่านไฟล์ Cloud Storage ที่ระบุ โปรดลองอีกครั้งในอีกสักครู่

หากเกิดกรณีนี้ขึ้น ให้รอสักครู่หรือสอบถาม Googler

10. โมดูล 8: สร้าง SLO ความพร้อมใช้งาน

ในบทนี้ เราพยายามที่จะบรรลุเป้าหมายต่อไปนี้

  1. การสร้าง SLI
  2. การสร้าง SLO โดยอิงตาม SLI
  3. การสร้างการแจ้งเตือนตาม SLO

f63426182c052123.png

หัวข้อนี้เป็นหัวข้อที่ผู้เขียนให้ความสำคัญเป็นอย่างมาก เนื่องจาก Riccardo ทำงานในด้าน SRE/DevOps ของ Google Cloud

(ปลายเปิด) สร้าง SLI และ SLO สำหรับแอปนี้

แอปจะมีประโยชน์อะไรหากคุณไม่รู้ว่าแอปหยุดทำงานเมื่อใด

SLO คืออะไร

บังเอิญจริงๆ Google เป็นผู้คิดค้น SLO หากต้องการอ่านข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้ เราขอแนะนำแหล่งข้อมูลต่อไปนี้

ขั้นตอนที่ 1: สร้าง SLI/SLO ความพร้อมใช้งาน

มาเริ่มกันที่ SLO ความพร้อมใช้งาน เนื่องจากเป็นสิ่งที่วัดได้ง่ายที่สุดและอาจสำคัญที่สุด

โชคดีที่ Cloud Run มาพร้อมกับการรองรับ SLO ที่สร้างไว้ล่วงหน้าด้วย Istio

เมื่อแอปของคุณอยู่ใน Cloud Run แล้ว การดำเนินการนี้จะทำได้ง่ายมาก โดยใช้เวลาเพียง 30 วินาทีเท่านั้น

  • ไปที่หน้า Cloud Run
  • คลิก/เลือกแอป
  • เลือกแท็บ SLOs
  • คลิก "+ สร้าง SLO"
  • ความพร้อมใช้งาน, อิงตามคำขอ
  • ดำเนินการต่อ
  • เดือนตามปฏิทิน / 99%
  • คลิก "สร้าง SLO"

e471c7ebdc56cdf6.png

ขั้นตอนที่ 2: ตั้งค่าการแจ้งเตือนใน SLO นี้

เราขอแนะนำให้สร้างการแจ้งเตือน 2 รายการดังนี้

  1. การแจ้งเตือนที่มีอัตราการใช้ทรัพยากรต่ำ ("Slowburn") เพื่อแจ้งเตือนคุณทางอีเมล (จำลองทิกเก็ตที่มีลำดับความสำคัญต่ำ)
  2. แบบแรกมีอัตราการใช้สูง ("Fastburn") เพื่อแจ้งเตือนคุณผ่าน SMS (จำลองตั๋ว/เพจเจอร์ที่มีลำดับความสำคัญสูง)

ไปที่ SLO tab จากก่อนหน้านี้

ทำเช่นนี้ 2 ครั้ง

314bfd6b9ef0a260.png

  • คลิก "สร้างการแจ้งเตือน SLO" (ปุ่ม 🔔 ที่มีเครื่องหมายบวกอยู่ด้านในทางด้านขวา)
  • ระยะเวลา Lookback, เกณฑ์อัตราการใช้ทรัพยากร:
  • [FAST] ครั้งแรก: 60 นาที / 10 ครั้ง
  • [SLOW] ครั้งที่ 2: 720 นาที / 2 ครั้ง
  • ช่องทางการแจ้งเตือน: คลิก "จัดการช่องทางการแจ้งเตือน"
  • ก่อนอื่น "อีเมล" -> เพิ่มใหม่ -> ..
  • 2. "SMS" -> เพิ่มใหม่ -> ยืนยันทางโทรศัพท์
  • เคล็ดลับ: เราชอบใช้อีโมจิในชื่อ สนุกดีสำหรับการสาธิต
  • เมื่อเสร็จแล้ว ให้คลิก X ขนาดใหญ่ที่ด้านขวาบน
  • เลือกโทรศัพท์ก่อน (เร็ว) แล้วค่อยเลือกอีเมล (ช้า)
  • เพิ่มเอกสารประกอบตัวอย่าง เช่น
  • [PHP Amarcord] Riccardo told me to type sudo reboot or to check documentation in http://example.com/playbooks/1.php but I guess he was joking

ถูกต้อง!

ผลการตัดสิน

เราจะถือว่าแบบฝึกหัดนี้เสร็จสิ้นเมื่อคุณมี SLO ที่ใช้งานได้ 1 รายการ + การแจ้งเตือน 2 รายการสำหรับความพร้อมใช้งาน และระบบจะแจ้งเตือนไปยังอีเมลและโทรศัพท์ของคุณ

หากต้องการ คุณสามารถเพิ่มเวลาในการตอบสนอง (และเราขอแนะนำอย่างยิ่งให้คุณทำเช่นนั้น) หรือแม้แต่เมตริกที่ซับซ้อนกว่านั้น สำหรับเวลาในการตอบสนอง ให้เลือกเวลาในการตอบสนองที่คุณเห็นว่าเหมาะสม หากไม่แน่ใจ ให้เลือก 200ms

11. ขั้นตอนถัดไป

คุณทำทุกอย่างเสร็จแล้ว แต่ยังมีอะไรขาดหายไป

สิ่งที่ควรพิจารณามีดังนี้

สนุกไปกับ Gemini

คุณใช้ Gemini ได้ 2 รูปแบบดังนี้

  1. Vertex AI "วิธีแบบองค์กร" ที่เชื่อมโยงกับ GCP ของคุณ ซึ่งเราได้พูดถึงไปแล้วในบทที่ 7 (GCF+Gemini) การตรวจสอบสิทธิ์ทั้งหมดทำงานได้อย่างราบรื่น และบริการต่างๆ เชื่อมต่อกันได้อย่างลงตัว
  2. Google AI "วิธีของผู้บริโภค" คุณรับคีย์ Gemini API ได้จากที่นี่ และเริ่มสร้างสคริปต์เล็กๆ ที่สามารถผูกกับภาระงานใดก็ได้ที่คุณมีอยู่แล้ว (งานที่เป็นกรรมสิทธิ์, คลาวด์อื่นๆ, โลคัลโฮสต์ ฯลฯ) เพียงแค่แทนที่คีย์ API ของคุณ แล้วโค้ดก็จะเริ่มทำงานอย่างน่าอัศจรรย์

เราขอแนะนำให้คุณลองสำรวจ (2) ด้วยโปรเจ็กต์ส่วนตัวของคุณเอง

UI Lifting

ฉันไม่ถนัดเรื่อง UI แต่ Gemini ทำได้ คุณสามารถใช้หน้า PHP เพียงหน้าเดียวและพูดว่า

I have a VERY old PHP application. I want to touch it as little as possible. Can you help me:

1. add some nice CSS to it, a single static include for tailwind or similar, whatever you prefer
2. Transform the image print with description into cards, which fit 4 per line in the canvas?

Here's the code:

-----------------------------------
[Paste your PHP page, for instance index.php - mind the token limit!]

คุณสามารถรับข้อมูลนี้ได้อย่างง่ายดายในเวลาไม่ถึง 5 นาที เพียงใช้ Cloud Build :)

คำตอบจาก Gemini นั้นสมบูรณ์แบบ (หมายความว่าฉันไม่ต้องเปลี่ยนแปลงอะไรเลย) ดังนี้

8a3d5fe37ec40bf8.png

และนี่คือเลย์เอาต์ใหม่ในแอปส่วนตัวของผู้เขียน

81620eb90ae3229a.png

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

ความปลอดภัย

การรักษาความปลอดภัยแอปนี้อย่างเหมาะสมไม่ใช่เป้าหมายของเวิร์กช็อป 4 ชั่วโมงนี้ เนื่องจากจะเพิ่มเวลาในการทำเวิร์กช็อปนี้ให้เสร็จสมบูรณ์ขึ้น 1-2 เท่า

อย่างไรก็ตาม หัวข้อนี้สำคัญมาก เราได้รวบรวมไอเดียบางส่วนไว้ใน SECURITY

12. ยินดีด้วย

ยินดีด้วย 🎉🎉🎉 คุณปรับปรุงแอปพลิเคชัน PHP เดิมให้ทันสมัยด้วย Google Cloud เรียบร้อยแล้ว

24cb9a39b1841fbd.png

โดยสรุปแล้ว คุณได้เรียนรู้สิ่งต่อไปนี้ใน Codelab นี้

  • วิธีติดตั้งใช้งานฐานข้อมูลใน Google Cloud SQL และวิธีย้ายข้อมูลฐานข้อมูลที่มีอยู่ไปยัง Google Cloud SQL
  • วิธีสร้างคอนเทนเนอร์แอปพลิเคชัน PHP ด้วย Docker และ Buildpacks และจัดเก็บอิมเมจไว้ใน Google Cloud Artifact Registry
  • วิธีติดตั้งใช้งานแอปที่สร้างเป็นคอนเทนเนอร์ใน Cloud Run และทำให้แอปทำงานร่วมกับ Cloud SQL
  • วิธีจัดเก็บ/ใช้พารามิเตอร์การกำหนดค่าที่ละเอียดอ่อน (เช่น รหัสผ่าน DB) อย่างลับๆ โดยใช้ Google Secret Manager
  • วิธีตั้งค่าไปป์ไลน์ CI/CD ด้วย Google Cloud Build เพื่อสร้างและทำให้แอป PHP ใช้งานได้โดยอัตโนมัติเมื่อมีการพุชโค้ดไปยังที่เก็บ GitHub
  • วิธีใช้ Cloud Storage เพื่อ "เปลี่ยนเป็นระบบคลาวด์" สำหรับทรัพยากรแอป
  • วิธีใช้ประโยชน์จากเทคโนโลยีแบบ Serverless เพื่อสร้างเวิร์กโฟลว์ที่ยอดเยี่ยมบน Google Cloud โดยไม่ต้องแตะโค้ดแอป
  • ใช้ความสามารถแบบหลายรูปแบบของ Gemini สำหรับกรณีการใช้งานที่เหมาะสม
  • ใช้หลักการ SRE ภายใน Google Cloud

นี่เป็นจุดเริ่มต้นที่ดีในการเดินทางสู่การปรับแอปพลิเคชันให้ทันสมัยด้วย Google Cloud

🔁 ความคิดเห็น

หากต้องการบอกเล่าประสบการณ์ที่ได้รับจากเวิร์กช็อปนี้ โปรดกรอกแบบฟอร์มความคิดเห็นนี้

เรายินดีรับฟังความคิดเห็นของคุณ รวมถึง PR สำหรับโค้ดที่คุณภูมิใจเป็นพิเศษ

🙏 ขอบคุณ

ผู้เขียนขอขอบคุณ Mirko Gilioli และ Maurizio Ipsale จาก Datatonic ที่ให้ความช่วยเหลือในการเขียนและทดสอบโซลูชัน