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

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


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-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "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. ดู Diff แบบละเอียดของเทมเพลตที่ใช้งานอยู่และเวอร์ชันอื่นๆ ที่จัดเก็บไว้ได้โดย วางเมาส์เหนือเมนูตามบริบทของเวอร์ชันที่ไม่ได้เลือก แล้วเลือกเปรียบเทียบกับเวอร์ชันที่เลือก

ย้อนกลับไปเป็นเทมเพลต 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 และความผูกพัน > การกำหนดค่าระยะไกล > หน้าพารามิเตอร์หรือ Conditions

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

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

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

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

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

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

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

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

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

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

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

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

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

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