ทำให้สภาพแวดล้อมหลายอย่างใช้งานได้จากฐานของโค้ด

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

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

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

• โค้ดของแอปพลิเคชันจัดเก็บอยู่ใน GitHub อยู่แล้ว
• คุณได้สร้างโปรเจ็กต์ที่แตกต่างกันสำหรับแต่ละสภาพแวดล้อมแล้ว เช่น my-production-firebase-project และ my-staging-firebase-project ตรวจสอบว่าได้ติดแท็กโปรเจ็กต์ Firebase เวอร์ชันที่ใช้งานจริงด้วยประเภทสภาพแวดล้อม "เวอร์ชันที่ใช้งานจริง"
• ในแต่ละโปรเจ็กต์ คุณได้สร้างแบ็กเอนด์ App Hosting โดยตั้งค่า Branch ที่ใช้งานอยู่เป็น Branch ของ GitHub ที่ต้องการทำให้ใช้งานได้ (เช่น main) ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเริ่มต้นใช้งาน App Hosting

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

ขั้นตอนที่ 0: สร้างการกำหนดค่าเริ่มต้นใน apphosting.yaml

App Hosting รองรับไฟล์การกำหนดค่าที่เรียกว่า apphosting.yaml เพื่อจัดการการตั้งค่ารันไทม์ (CPU, การทำงานพร้อมกัน, ขีดจำกัดหน่วยความจำ ฯลฯ) และตัวแปรสภาพแวดล้อมสำหรับแอปของคุณ นอกจากนี้ยังรองรับการอ้างอิงถึงข้อมูลลับที่จัดการด้วย Cloud Secret Manager ซึ่งทำให้ตรวจสอบการควบคุมแหล่งที่มาได้อย่างปลอดภัย ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกำหนดค่าแบ็กเอนด์

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

ส่วนถัดไปจะอธิบายวิธีลบล้างค่าเริ่มต้นใน apphosting.yaml สำหรับสภาพแวดล้อมที่เฉพาะเจาะจง ขั้นตอนตัวอย่างนี้จะสร้างสภาพแวดล้อม Stagging

ขั้นตอนที่ 1: ตั้งชื่อสภาพแวดล้อม

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

วิธีตั้งชื่อสภาพแวดล้อมของแบ็กเอนด์

1. ในคอนโซล Firebase ให้เลือกโปรเจ็กต์ Staging (ในตัวอย่างนี้คือ my-staging-firebase-project)
2. ไปที่โฮสติ้งและแบบไม่ใช้เซิร์ฟเวอร์ > App Hosting
3. คลิกดูในแบ็กเอนด์ที่เลือก
4. ในแท็บการตั้งค่า ให้เลือกสภาพแวดล้อม
5. ในส่วนชื่อสภาพแวดล้อม ให้ป้อนชื่อสภาพแวดล้อม คุณตั้งชื่อสภาพแวดล้อมได้ตามต้องการ ในตัวอย่างนี้คือ staging
6. คลิกบันทึก

เมื่อมีการทริกเกอร์การเปิดตัว App Hosting สำหรับแบ็กเอนด์ของคุณ (ไม่ว่าจะใน git push หรือผ่านคอนโซล Firebase ด้วยตนเอง) App Hosting จะตรวจหาไฟล์ apphosting.ENVIRONMENT_NAME.yaml ก่อนที่จะกลับไปใช้ apphosting.yaml

ขั้นตอนที่ 2: สร้างไฟล์ apphosting.yaml เฉพาะสภาพแวดล้อม

สำหรับการกำหนดค่าเฉพาะสภาพแวดล้อม ให้สร้างไฟล์ที่มีชื่อว่า apphosting.ENVIRONMENT_NAME.yaml เพื่อระบุการลบล้างเฉพาะสภาพแวดล้อม ไฟล์นี้มีรูปแบบเดียวกับ apphosting.yaml เริ่มต้น และต้องอยู่ในไดเรกทอรีรากของแอปข้าง apphosting.yaml

ในเวลาบิลด์ App Hosting จะผสานไฟล์ทั้ง 2 ไฟล์นี้ โดยให้ความสำคัญกับค่าในไฟล์ YAML เฉพาะสภาพแวดล้อมมากกว่าไฟล์ apphosting.yaml พื้นฐาน

ในตัวอย่างนี้ คุณจะสร้างไฟล์ชื่อ apphosting.staging.yaml ในไดเรกทอรีรากของแอป ดังนี้

runConfig:
  cpu: 1
  memoryMiB: 512
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

สมมติว่าคุณมี apphosting.yaml ที่มีลักษณะดังนี้อยู่แล้ว

runConfig:
  cpu: 3
  memoryMiB: 1024
  maxInstances: 4
  minInstances: 0
  concurrency: 100

env:
-   variable: API_URL
    value: api.service.com
    availability:
      -   BUILD
      -   RUNTIME

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

เอาต์พุตที่ผสานขั้นสุดท้ายซึ่งคุณตรวจสอบได้ในบันทึก Cloud Build จะมีลักษณะดังนี้

runConfig:
  cpu: 1
  memoryMiB: 512
  maxInstances: 4
  minInstances: 0
  concurrency: 5

env:
-   variable: API_URL
    value: api.staging.service.com
    availability:
      -   BUILD

-   variable: STORAGE_BUCKET
    value: mybucket.firebasestorage.app
    availability:
      -   RUNTIME

-   variable: API_KEY
    secret: secretIDforAPI

-   variable: DATABASE_URL
    secret: secretStagingDatabaseURL

โปรดทราบว่าค่า runConfig บางค่า เช่น CPU ได้รับการเขียนทับ รวมถึงตัวแปรสภาพแวดล้อมที่ทับซ้อนกันด้วย

หมายเหตุ: คุณยังคงต้องให้สิทธิ์เข้าถึงบัญชีบริการที่เหมาะสมแก่ข้อมูลลับที่คุณสร้าง เช่นเดียวกับที่คุณทำกับข้อมูลลับ apphosting.yaml ดูข้อมูลเพิ่มเติมได้ที่จัดเก็บและเข้าถึงพารามิเตอร์ลับ

ขั้นตอนที่ 3: ติดตั้งใช้งานฐานของโค้ด

เมื่อแก้ไขไฟล์ apphosting.ENVIRONMENT_NAME.yaml สำหรับสภาพแวดล้อมที่เฉพาะเจาะจงเสร็จแล้ว ให้พุชไฟล์ไปยัง GitHub โดยทำดังนี้

$ git add apphosting.<ENVIRONMENT_NAME>.yaml
$ git commit -m "Added environment specific yaml file"
$ git push

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

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

• เจาะลึก: ดู Codelab ของ Firebase ที่ผสานรวมแอปที่โฮสต์กับฟีเจอร์ Firebase Authentication และ Gemini API: Next.js | Angular
• เชื่อมต่อโดเมนที่กำหนดเอง
• กำหนดค่าแบ็กเอนด์
• ตรวจสอบการเปิดตัว การใช้งานเว็บไซต์ และบันทึก