จัดการการเปิดตัวและรุ่น

หากเปิดใช้การเปิดตัวอัตโนมัติ ทุกครั้งที่คุณพุชคอมมิตใหม่ไปยังสาขาที่ใช้งานอยู่ (Live Branch) ในที่เก็บ GitHub App Hosting จะเปิดตัวแอปเวอร์ชันใหม่โดยอัตโนมัติ คุณสามารถตรวจสอบสถานะการเปิดตัวได้ในคอนโซล Firebase หรือในการตรวจสอบ GitHub ของ App Hosting

นอกจากนี้ App Hosting ยังรองรับการเปิดตัวที่ทริกเกอร์ด้วยตนเองสำหรับการผสานรวม CI/CD หรือกรณีอื่นๆ ที่คุณต้องการบังคับให้เปิดตัว

ดูการเปิดตัว

คอนโซล Firebase ช่วยให้คุณเข้าถึงข้อมูลโดยละเอียดเกี่ยวกับการเปิดตัวแอปทั้งหมด

ไปที่โฮสติ้งและแบบไม่ใช้เซิร์ฟเวอร์ > App Hosting แล้วเลือกดูสำหรับแบ็กเอนด์ที่ต้องการดูการเปิดตัว แท็บการเปิดตัวสำหรับแบ็กเอนด์จะแสดงตารางที่แสดงประวัติการเปิดตัวทั้งหมดสำหรับแบ็กเอนด์นี้

รายการการเปิดตัวแต่ละรายการจะมีลิงก์ไปยังงาน Cloud Build และการเปลี่ยนแปลงหรือคอมมิตที่ทริกเกอร์การเปิดตัว พร้อมกับข้อมูลพื้นฐานเกี่ยวกับผู้เขียน วันที่สร้าง และสถานะของการเปิดตัว

  • งาน Cloud Build คือสภาพแวดล้อมของบิลด์ที่ App Hosting เรียกใช้คำสั่งบิลด์ของแอป คุณสามารถเข้าถึงบันทึก Cloud Build ได้โดยคลิกที่รหัสบิลด์
  • การเปลี่ยนแปลงคือคอมมิต GitHub หรือการดำเนินการอื่นๆ ที่ทริกเกอร์การเปิดตัว

ทริกเกอร์การเปิดตัวด้วยตนเอง

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

  • บังคับให้สร้างเนื้อหาคงที่ใหม่
  • การอนุญาตให้ระบบ CI/CD ทริกเกอร์การเปิดตัว
  • จำกัดการเปิดตัวเวอร์ชันที่ใช้งานจริงให้เป็นวันที่หรือเวลาที่เฉพาะเจาะจง

วิธีทริกเกอร์การเปิดตัวในคอนโซล Firebase

  1. ในคอนโซล Firebase ให้ไปที่โฮสติ้งและแบบไม่ใช้เซิร์ฟเวอร์ > App Hosting
  2. คลิกดูสำหรับแบ็กเอนด์ที่ต้องการสร้างการเปิดตัว
  3. ในสรุปแดชบอร์ดแบ็กเอนด์ ให้เลือกสร้างการเปิดตัว
  4. เลือก Branch ที่จะทำให้ใช้งานได้
  5. เลือกคอมมิตที่จะทำให้ใช้งานได้ ไม่ว่าจะเป็นคอมมิตล่าสุดหรือคอมมิตก่อนหน้าที่ระบุโดยรหัสคอมมิต
  6. เลือกสร้าง สถานะและหมายเลขบิลด์สําหรับการเปิดตัวจะแสดงในตารางประวัติการเปิดตัว เมื่อกระบวนการเปิดตัวเสร็จสมบูรณ์แล้ว การเปิดตัวนี้จะแสดงเป็นการเปิดตัวปัจจุบัน

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

firebase apphosting:rollouts:create BACKEND_ID

หรือจะเริ่มการเปิดตัวสำหรับคอมมิตล่าสุดของสาขาที่เฉพาะเจาะจงโดยใช้ตัวเลือก --git-branch ก็ได้

firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME

นอกจากนี้ คุณยังสร้างการเปิดตัวด้วยคอมมิตที่เฉพาะเจาะจงได้โดยใช้ตัวเลือก --git-commit ดังนี้

firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID

คืนค่าการเปิดตัวก่อนหน้า

App Hosting มี 2 ตัวเลือกในการกู้คืนการเปิดตัวก่อนหน้า ดังนี้

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

สร้างการย้อนกลับทันที

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

วิธีสร้างการย้อนกลับทันที

  1. ในคอนโซล Firebase ให้ไปที่โฮสติ้งและแบบไม่ใช้เซิร์ฟเวอร์ > App Hosting
  2. คลิกดูสำหรับแบ็กเอนด์ที่ต้องการสร้างการย้อนกลับ
  3. เลือกแท็บการเปิดตัว
  4. ในตารางประวัติของแบ็กเอนด์ ให้เลือกเมนู 3 จุดสำหรับบิลด์ก่อนหน้า
  5. เลือกย้อนกลับไปใช้บิลด์นี้ แล้วยืนยัน

สร้างใหม่และย้อนกลับ

หากต้องการเปลี่ยนกลับไปใช้แอปเวอร์ชันเก่าแต่ยังคงการกำหนดค่าปัจจุบันไว้ คุณสามารถสร้างแอปใหม่โดยเป็นส่วนหนึ่งของกระบวนการย้อนกลับได้ ตัวอย่างเช่น หากเวอร์ชันล่าสุดอัปเดตค่าคีย์ API ใน Secret Manager การสร้างใหม่จะช่วยให้มั่นใจได้ว่าระบบจะใช้คีย์ใหม่ในแอปหลังจากย้อนกลับ

วิธีสร้างใหม่และย้อนกลับ

  1. ในคอนโซล Firebase ให้ไปที่โฮสติ้งและแบบไม่ใช้เซิร์ฟเวอร์ > App Hosting
  2. คลิกดูแดชบอร์ดสำหรับแบ็กเอนด์ที่ต้องการสร้างการย้อนกลับ
  3. เลือกแท็บการเปิดตัว
  4. เลือกสร้างการเปิดตัว
  5. ในกล่องโต้ตอบสร้างการเปิดตัว ให้เลือกคอมมิตก่อนหน้า แล้วป้อนรหัสคอมมิตสำหรับเวอร์ชันที่ต้องการสร้างใหม่และย้อนกลับไปใช้ รหัสคอมมิตเป็นส่วนหนึ่งของ "รายละเอียดการเปลี่ยนแปลง" สำหรับการเปิดตัวแต่ละรายการที่แสดงในประวัติการเปิดตัว ซึ่งอยู่ในวงเล็บในป้ายกำกับ
  6. เลือกสร้างเพื่อเริ่มการย้อนกลับ

เปลี่ยนการตั้งค่าการเปิดตัว

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

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

จัดการการเปิดตัวอัตโนมัติ

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

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

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

ภาพหน้าจอของ UI ที่อธิบายไว้ในหน้านี้

หากคุณพุชคอมมิตที่ไม่มีไฟล์ที่เปลี่ยนแปลงตรงกับเส้นทางที่จำเป็น (หรือหากการเปลี่ยนแปลงทั้งหมดได้รับการยกเว้นอย่างชัดเจนโดยเส้นทางที่ละเว้น) App Hosting จะยังคงรับทราบการรับเหตุการณ์ GitHub แต่จะทำเครื่องหมายสถานะการสร้างและการเปิดตัวเป็น SKIPPED และจะไม่มีการทริกเกอร์การเปิดตัวอัตโนมัติ