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


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

ส่วนนี้จะกล่าวถึงเทมเพลตเซิร์ฟเวอร์ ดูข้อมูลเกี่ยวกับเทมเพลต เฉพาะไคลเอ็นต์ได้โดยคลิก เทมเพลตไคลเอ็นต์

คุณใช้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 Console (ไปที่ 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ที่ใช้งานอยู่ ในรูปแบบ JSON

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

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

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

ตรวจสอบเทมเพลตการกำหนดค่าระยะไกล

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

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

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

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

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

ใช้คำสั่งต่อไปนี้เพื่อเผยแพร่เทมเพลต

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

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

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

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

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