จัดการเทมเพลตเซิร์ฟเวอร์การกำหนดค่าระยะไกลและการกำหนดเวอร์ชัน

เลือกประเภทเทมเพลต เทมเพลตฝั่งไคลเอ็นต์ เทมเพลตฝั่งเซิร์ฟเวอร์


เทมเพลต Remote Config คือชุดพารามิเตอร์และเงื่อนไขที่จัดรูปแบบ JSON ซึ่งสร้างขึ้นสำหรับโปรเจ็กต์ Firebase ของคุณ เทมเพลตเซิร์ฟเวอร์จะแสดงการกำหนดค่าไปยังอินสแตนซ์เซิร์ฟเวอร์โดยใช้ Firebase Admin SDK สำหรับ Remote Config (ใช้ได้กับ Node.js, Java, Python และ Go)

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

ตัวอย่างไฟล์เทมเพลตเซิร์ฟเวอร์มีดังนี้

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

คุณสามารถทำงานด้านการจัดการเวอร์ชันเหล่านี้ได้ในคอนโซล Firebase (ไปที่ DevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล)

  • แสดงรายการเวอร์ชันเทมเพลตที่จัดเก็บไว้ทั้งหมด
  • ดึงข้อมูลเวอร์ชันที่เฉพาะเจาะจง
  • ย้อนกลับไปใช้เซิร์ฟเวอร์เวอร์ชันที่เฉพาะเจาะจง
  • ลบเทมเพลต Remote Config รายการจากหน้าประวัติการเปลี่ยนแปลง

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

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

คุณสามารถลบเทมเพลต Remote Config ได้ตามต้องการในหน้าDevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > ประวัติการเปลี่ยนแปลงของคอนโซล Firebase

จัดการเวอร์ชันเทมเพลต Remote Config รายการ

ส่วนนี้จะอธิบายวิธีจัดการเวอร์ชันของเทมเพลตเซิร์ฟเวอร์ Remote Config

แสดงรายการเทมเพลต Remote Config เวอร์ชันที่จัดเก็บไว้ทั้งหมด

คุณสามารถเรียกดูรายการเวอร์ชันที่จัดเก็บไว้ทั้งหมดของเทมเพลต Remote Config ได้ โดยทำดังนี้

  1. ในคอนโซล Firebase ให้ไปที่หน้า DevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > พารามิเตอร์

  2. เลือกไอคอน "นาฬิกา" ที่แสดงที่ด้านขวาบน

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

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

ดึงข้อมูลเทมเพลต Remote Config เวอร์ชันที่เฉพาะเจาะจง

คุณสามารถเรียกข้อมูลเทมเพลต Remote Config เวอร์ชันที่จัดเก็บไว้ได้ วิธีเรียกข้อมูลเวอร์ชันเทมเพลตที่จัดเก็บไว้มีดังนี้

  1. ในคอนโซล Firebase ให้ไปที่หน้า DevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > ประวัติการเปลี่ยนแปลง

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

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

ย้อนกลับไปเป็นเทมเพลต Remote Config เวอร์ชันที่จัดเก็บไว้ที่เฉพาะเจาะจง

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

  1. ในคอนโซล Firebase ให้ไปที่หน้า DevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > ประวัติการเปลี่ยนแปลง

  2. ค้นหาปุ่มตัวเลือกที่ด้านขวาบนของหน้าสำหรับเทมเพลตเวอร์ชันก่อนหน้าที่สามารถย้อนกลับได้

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

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

ลบเทมเพลต Remote Config

คุณลบเทมเพลต Remote Config ได้โดยใช้คอนโซล Firebase วิธีลบเทมเพลตมีดังนี้

  1. ในคอนโซล Firebase ให้ไปที่หน้า DevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > พารามิเตอร์

  2. คลิก ประวัติการเปลี่ยนแปลง

  3. สลับไปยังเทมเพลตที่ต้องการลบ คลิก เพิ่มเติม แล้วเลือกลบ

  4. เมื่อได้รับข้อความแจ้งให้ยืนยันการลบ ให้คลิกลบ

ดาวน์โหลดและเผยแพร่เทมเพลต Remote Config รายการ

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

คุณสามารถดาวน์โหลดเทมเพลต Remote Config ที่ใช้งานอยู่ในปัจจุบันได้จากคอนโซล Firebase จากนั้นคุณสามารถอัปเดตไฟล์ JSON ที่ส่งออกและเผยแพร่ไปยังโปรเจ็กต์เดียวกัน หรือเผยแพร่ไปยังโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่

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

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

พารามิเตอร์และค่าพารามิเตอร์ที่สร้างขึ้นเป็นตัวแปรโดยเฉพาะในการทดสอบ A/B Testing จะไม่รวมอยู่ในเทมเพลตที่ส่งออก

วิธีส่งออกและนำเข้าเทมเพลต Remote Config

  1. ดาวน์โหลดเทมเพลต Remote Config ปัจจุบัน
  2. ตรวจสอบเทมเพลต Remote Config
  3. เผยแพร่เทมเพลต Remote Config

ดาวน์โหลดเทมเพลต Remote Config ปัจจุบัน

ใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลดเทมเพลต Remote Config ที่ใช้งานอยู่ในรูปแบบ JSON

  1. ในคอนโซล Firebase ให้ไปที่หน้าDevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > พารามิเตอร์หรือเงื่อนไข

  2. เปิด เมนู แล้วเลือกดาวน์โหลดไฟล์การกำหนดค่าปัจจุบัน

  3. เมื่อได้รับข้อความแจ้ง ให้คลิกดาวน์โหลดไฟล์การกำหนดค่า เลือกตำแหน่งที่ต้องการบันทึกไฟล์ แล้วคลิกบันทึก

ตรวจสอบเทมเพลต Remote Config

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

เผยแพร่เทมเพลต Remote Config

หลังจากดาวน์โหลดเทมเพลต ทำการเปลี่ยนแปลงที่จำเป็นกับเนื้อหา JSON และตรวจสอบแล้ว คุณจะเผยแพร่เทมเพลตไปยังโปรเจ็กต์ได้

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

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

ทำตามขั้นตอนต่อไปนี้เพื่อเผยแพร่เทมเพลต

  1. ในคอนโซล Firebase ให้ไปที่หน้าDevOps และการมีส่วนร่วม > การกำหนดค่าระยะไกล > พารามิเตอร์หรือเงื่อนไข

  2. เปิด เมนู แล้วเลือกเผยแพร่จากไฟล์

  3. เมื่อมีข้อความแจ้ง ให้คลิกเรียกดู ไปที่ไฟล์ Remote Config ที่ต้องการเผยแพร่ แล้วคลิกเลือก

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

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