การอ้างอิง Firebase CLI

Firebase CLI ( GitHub ) มีเครื่องมือที่หลากหลายสำหรับการจัดการ ดู และปรับใช้กับโปรเจ็กต์ Firebase

ก่อนที่จะใช้ Firebase CLI ให้ตั้งค่าโปรเจ็กต์ Firebase

ตั้งค่าหรืออัปเดต CLI

ติดตั้ง Firebase CLI

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

วินโดวส์ macOS ลินุกซ์

หน้าต่าง

คุณติดตั้ง Firebase CLI สำหรับ Windows ได้โดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

ตัวเลือก คำอธิบาย แนะนำสำหรับ...
ไบนารีแบบสแตนด์อโลน ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI จากนั้นคุณสามารถเข้าถึงไฟล์ปฏิบัติการเพื่อเปิดเชลล์ที่คุณสามารถรันคำสั่ง firebase ได้ นักพัฒนาใหม่

นักพัฒนาไม่ได้ใช้หรือไม่คุ้นเคยกับ Node.js
เวลา 22.00 น ใช้ npm (Node Package Manager) เพื่อติดตั้ง CLI และเปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก นักพัฒนาที่ใช้ Node.js

ไบนารีแบบสแตนด์อโลน

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

  1. ดาวน์โหลด ไบนารี Firebase CLI สำหรับ Windows

  2. เข้าถึงไบนารีเพื่อเปิดเชลล์ที่คุณสามารถเรียกใช้คำสั่ง firebase ได้

  3. ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI

เวลา 22.00 น

หากต้องการใช้ npm (Node Package Manager) เพื่อติดตั้ง Firebase CLI ให้ทำตามขั้นตอนเหล่านี้:

  1. ติดตั้ง Node.js โดยใช้ nvm-windows (Node Version Manager) การติดตั้ง Node.js จะติดตั้งเครื่องมือคำสั่ง npm โดยอัตโนมัติ

  2. ติดตั้ง Firebase CLI ผ่าน npm โดยรันคำสั่งต่อไปนี้:

    npm install -g firebase-tools

    คำสั่งนี้เปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก

  3. ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI

macOS หรือ Linux

คุณสามารถติดตั้ง Firebase CLI สำหรับ macOS หรือ Linux ได้โดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้:

ตัวเลือก คำอธิบาย แนะนำสำหรับ...
สคริปต์การติดตั้งอัตโนมัติ เรียกใช้คำสั่งเดียวที่จะตรวจจับระบบปฏิบัติการของคุณโดยอัตโนมัติ ดาวน์โหลด CLI รุ่นล่าสุด จากนั้นเปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก นักพัฒนาใหม่

นักพัฒนาไม่ได้ใช้หรือไม่คุ้นเคยกับ Node.js

การปรับใช้อัตโนมัติในสภาพแวดล้อม CI/CD
ไบนารีแบบสแตนด์อโลน ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI จากนั้น คุณสามารถกำหนดค่าและรันไบนารีให้เหมาะกับขั้นตอนการทำงานของคุณได้ เวิร์กโฟลว์ที่ปรับแต่งได้อย่างเต็มที่โดยใช้ CLI
เวลา 22.00 น ใช้ npm (Node Package Manager) เพื่อติดตั้ง CLI และเปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก นักพัฒนาที่ใช้ Node.js

สคริปต์การติดตั้งอัตโนมัติ

หากต้องการติดตั้ง Firebase CLI โดยใช้สคริปต์การติดตั้งอัตโนมัติ ให้ทำตามขั้นตอนเหล่านี้:

  1. รันคำสั่ง cURL ต่อไปนี้:

    curl -sL https://firebase.tools | bash

    สคริปต์นี้จะตรวจจับระบบปฏิบัติการของคุณโดยอัตโนมัติ ดาวน์โหลด Firebase CLI รุ่นล่าสุด จากนั้นเปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก

  2. ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI

สำหรับตัวอย่างและรายละเอียดเพิ่มเติมเกี่ยวกับสคริปต์การติดตั้งอัตโนมัติ โปรดดูซอร์สโค้ดของสคริปต์ที่ firebase.tools

ไบนารีแบบสแตนด์อโลน

หากต้องการดาวน์โหลดและเรียกใช้ไบนารีสำหรับ Firebase CLI เฉพาะสำหรับระบบปฏิบัติการของคุณ ให้ทำตามขั้นตอนเหล่านี้:

  1. ดาวน์โหลดไบนารี Firebase CLI สำหรับระบบปฏิบัติการของคุณ: macOS | ลินุกซ์

  2. (ไม่บังคับ) ตั้งค่าคำสั่ง firebase ที่ใช้ได้ทั่วโลก

    1. ทำให้ไบนารีปฏิบัติการได้โดยการรัน chmod +x ./firebase_tools
    2. เพิ่มเส้นทางของไบนารีให้กับ PATH ของคุณ
  3. ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI

เวลา 22.00 น

หากต้องการใช้ npm (Node Package Manager) เพื่อติดตั้ง Firebase CLI ให้ทำตามขั้นตอนเหล่านี้:

  1. ติดตั้ง Node.js โดยใช้ nvm (Node Version Manager)
    การติดตั้ง Node.js จะติดตั้งเครื่องมือคำสั่ง npm โดยอัตโนมัติ

  2. ติดตั้ง Firebase CLI ผ่าน npm โดยรันคำสั่งต่อไปนี้:

    npm install -g firebase-tools

    คำสั่งนี้เปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก

  3. ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI

เข้าสู่ระบบและทดสอบ Firebase CLI

หลังจากติดตั้ง CLI คุณต้องรับรองความถูกต้อง จากนั้น คุณจะยืนยันการตรวจสอบสิทธิ์ได้โดยแสดงรายการโปรเจ็กต์ Firebase ของคุณ

  1. เข้าสู่ระบบ Firebase โดยใช้บัญชี Google ของคุณโดยเรียกใช้คำสั่งต่อไปนี้:

    firebase login

    คำสั่งนี้จะเชื่อมต่อเครื่องในเครื่องของคุณกับ Firebase และให้สิทธิ์คุณในการเข้าถึงโปรเจ็กต์ Firebase ของคุณ

  2. ทดสอบว่า CLI ได้รับการติดตั้งอย่างถูกต้องและเข้าถึงบัญชีของคุณโดยแสดงรายการโปรเจ็กต์ Firebase ของคุณ รันคำสั่งต่อไปนี้:

    firebase projects:list

    รายการที่แสดงควรเหมือนกับโครงการ Firebase ที่แสดงอยู่ใน คอนโซล Firebase

อัปเดตเป็นเวอร์ชัน CLI ล่าสุด

โดยทั่วไป คุณต้องการใช้ Firebase CLI เวอร์ชันล่าสุด

วิธีที่คุณอัปเดตเวอร์ชัน CLI ขึ้นอยู่กับระบบปฏิบัติการของคุณและวิธีการติดตั้ง CLI

หน้าต่าง

ระบบปฏิบัติการ macOS

  • สคริปต์การติดตั้งอัตโนมัติ : เรียกใช้ curl -sL https://firebase.tools | upgrade=true bash
  • ไบนารี่แบบสแตนด์อโลน : ดาวน์โหลดเวอร์ชันใหม่ จากนั้นแทนที่ในระบบของคุณ
  • npm : รัน npm install -g firebase-tools

ลินุกซ์

  • สคริปต์การติดตั้งอัตโนมัติ : เรียกใช้ curl -sL https://firebase.tools | upgrade=true bash
  • ไบนารี่แบบสแตนด์อโลน : ดาวน์โหลดเวอร์ชันใหม่ จากนั้นแทนที่ในระบบของคุณ
  • npm : รัน npm install -g firebase-tools

ใช้ CLI กับระบบ CI

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

  1. บนเครื่องที่มีเบราว์เซอร์ ให้ติดตั้ง Firebase CLI

  2. เริ่มกระบวนการลงชื่อเข้าใช้โดยการรันคำสั่งต่อไปนี้:

    firebase login:ci
  3. ไปที่ URL ที่ให้ไว้ จากนั้นเข้าสู่ระบบโดยใช้บัญชี Google

  4. พิมพ์ โทเค็นการรีเฟรช ใหม่ เซสชัน CLI ปัจจุบันจะไม่ได้รับผลกระทบ

  5. จัดเก็บโทเค็นเอาต์พุตด้วยวิธีที่ปลอดภัยแต่สามารถเข้าถึงได้ในระบบ CI ของคุณ

  6. ใช้โทเค็นนี้เมื่อรันคำสั่ง firebase คุณสามารถใช้หนึ่งในสองตัวเลือกต่อไปนี้:

    • ตัวเลือกที่ 1: เก็บโทเค็นเป็นตัวแปรสภาพแวดล้อม FIREBASE_TOKEN ระบบของคุณจะใช้โทเค็นโดยอัตโนมัติ

    • ตัวเลือกที่ 2: เรียกใช้คำสั่ง firebase ทั้งหมดด้วยแฟล็ก --token TOKEN ในระบบ CI ของคุณ
      นี่คือลำดับความสำคัญสำหรับการโหลดโทเค็น: แฟล็ก, ตัวแปรสภาพแวดล้อม, โปรเจ็กต์ Firebase ที่ต้องการ

เริ่มต้นโปรเจ็กต์ Firebase

งานทั่วไปหลายอย่างที่ดำเนินการโดยใช้ CLI เช่น การปรับใช้กับโปรเจ็กต์ Firebase จำเป็นต้องมี ไดเร็กทอรีโปรเจ็กต์ คุณสร้างไดเร็กทอรีโปรเจ็กต์โดยใช้คำสั่ง firebase init โดยปกติไดเร็กทอรีโปรเจ็กต์จะเป็นไดเร็กทอรีเดียวกันกับรูทการควบคุมแหล่งที่มาของคุณ และหลังจากรัน firebase init แล้ว ไดเร็กทอรีก็จะมีไฟล์การกำหนดค่า firebase.json

หากต้องการเริ่มต้นโปรเจ็กต์ Firebase ใหม่ ให้รันคำสั่งต่อไปนี้จากภายในไดเร็กทอรีของแอปของคุณ:

firebase init

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

  • เลือกผลิตภัณฑ์ Firebase ที่ต้องการเพื่อตั้งค่าในโปรเจ็กต์ Firebase

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

  • เลือกโปรเจ็กต์ Firebase เริ่มต้น

    ขั้นตอนนี้จะเชื่อมโยงไดเร็กทอรีโปรเจ็กต์ปัจจุบันกับโปรเจ็กต์ Firebase เพื่อให้คำสั่งเฉพาะโปรเจ็กต์ (เช่น firebase deploy ) ทำงานเทียบกับโปรเจ็กต์ Firebase ที่เหมาะสม

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

เมื่อสิ้นสุดการเริ่มต้น Firebase จะสร้างไฟล์ 2 ไฟล์ต่อไปนี้ที่รากของไดเรกทอรีแอปในเครื่องของคุณโดยอัตโนมัติ:

  • ไฟล์การกำหนดค่า firebase.json ที่แสดงรายการการกำหนดค่าโปรเจ็กต์ของคุณ

  • ไฟล์ .firebaserc ที่เก็บ นามแฝง โปรเจ็กต์ของคุณ

ไฟล์ firebase.json

คำสั่ง firebase init จะสร้างไฟล์การกำหนดค่า firebase.json ในรากของไดเร็กทอรีโปรเจ็กต์ของคุณ

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

คุณสามารถ กำหนดค่าตัวเลือกโฮสติ้ง Firebase ส่วนใหญ่ ได้โดยตรงในไฟล์ firebase.json อย่างไรก็ตาม สำหรับ บริการ Firebase อื่นๆ ที่ปรับใช้กับ Firebase CLI ได้ คำสั่ง firebase init จะสร้างไฟล์เฉพาะซึ่งคุณสามารถกำหนดการตั้งค่าสำหรับบริการเหล่านั้นได้ เช่น ไฟล์ index.js สำหรับฟังก์ชันคลาวด์ คุณยังสามารถตั้งค่า hooks แบบ predeploy หรือ postdeploy ได้ ในไฟล์ firebase.json

ต่อไปนี้เป็นตัวอย่างไฟล์ firebase.json ที่มีการตั้งค่าเริ่มต้น หากคุณเลือกโฮสติ้ง Firebase, Cloud Firestore และฟังก์ชันคลาวด์สำหรับ Firebase (โดยเลือกตัวเลือกแหล่งที่มาของ TypeScript และ Lint) ในระหว่างการเริ่มต้น

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  },
  "firestore": {
      "rules": "firestore.rules",
      "indexes": "firestore.indexes.json"
  },
  "functions": {
    "predeploy": [
      "npm --prefix \"$RESOURCE_DIR\" run lint",
      "npm --prefix \"$RESOURCE_DIR\" run build"
    ]
  }
}

แม้ว่าจะใช้ firebase.json เป็นค่าเริ่มต้น คุณสามารถส่งผ่านแฟล็ก --config PATH เพื่อระบุไฟล์การกำหนดค่าสำรองได้

การกำหนดค่าสำหรับฐานข้อมูล Cloud Firestore หลายฐานข้อมูล

เมื่อคุณเรียกใช้ firebase init ไฟล์ firebase.json ของคุณจะมีคีย์ firestore เดียวที่สอดคล้องกับฐานข้อมูลเริ่มต้นของโปรเจ็กต์ของคุณ ดังที่แสดงด้านบน

หากโปรเจ็กต์ของคุณมีฐานข้อมูล Cloud Firestore หลายฐานข้อมูล ให้แก้ไขไฟล์ firebase.json เพื่อเชื่อมโยงกฎความปลอดภัยของ Cloud Firestore ที่แตกต่างกันและไฟล์ต้นฉบับดัชนีฐานข้อมูลกับแต่ละฐานข้อมูล แก้ไขไฟล์ด้วยอาร์เรย์ JSON โดยมีหนึ่งรายการสำหรับแต่ละฐานข้อมูล

      "firestore": [
        {
          "database": "default",
          "rules": "firestore.default.rules",
          "indexes": "firestore.default.indexes.json"
        },
        {
          "database": "ecommerce",
          "rules": "firestore.ecommerce.rules",
          "indexes": "firestore.ecommerce.indexes.json"
        }
      ],

ไฟล์ Cloud Functions ที่จะละเว้นเมื่อทำให้ใช้งานได้

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

รายการไฟล์ที่ถูกละเว้นโดยค่าเริ่มต้นซึ่งแสดงในรูปแบบ JSON คือ:

"ignore": [
  ".git",
  ".runtimeconfig.json",
  "firebase-debug.log",
  "firebase-debug.*.log",
  "node_modules"
]

หากคุณเพิ่มค่าที่กำหนดเองสำหรับ ignore ใน firebase.json ตรวจสอบให้แน่ใจว่าคุณเก็บ (หรือเพิ่ม หากไม่มี) รายการไฟล์ที่แสดงด้านบน

จัดการนามแฝงโครงการ

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

เพิ่มนามแฝงโครงการ

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

firebase use --add

คำสั่งนี้แจ้งให้คุณเลือกโปรเจ็กต์ Firebase อื่นและกำหนดโปรเจ็กต์เป็นนามแฝง การมอบหมายนามแฝงจะถูกเขียนลงในไฟล์ .firebaserc ภายในไดเร็กทอรีโปรเจ็กต์ของคุณ

ใช้นามแฝงโครงการ

หากต้องการใช้นามแฝงโปรเจ็กต์ Firebase ที่กำหนด ให้รันคำสั่งต่อไปนี้จากภายในไดเร็กทอรีโปรเจ็กต์ของคุณ

สั่งการ คำอธิบาย
firebase use ดูรายการนามแฝงที่กำหนดไว้ในปัจจุบันสำหรับไดเรกทอรีโครงการของคุณ
firebase use \
PROJECT_ID|ALIAS
สั่งให้คำสั่งทั้งหมดทำงานกับโปรเจ็กต์ Firebase ที่ระบุ
CLI ใช้โปรเจ็กต์นี้เป็น "โปรเจ็กต์ที่ใช้งานอยู่" ในปัจจุบัน
firebase use --clear ล้างโปรเจ็กต์ที่ใช้งานอยู่

เรียกใช้ firebase use PROJECT_ID|ALIAS เพื่อตั้งค่าโปรเจ็กต์ใหม่ที่ใช้งานอยู่ ก่อนที่จะรันคำสั่ง CLI อื่นๆ

firebase use \
--unalias PROJECT_ALIAS
ลบนามแฝงออกจากไดเรกทอรีโครงการของคุณ

คุณสามารถแทนที่สิ่งที่ถูกใช้เป็นโปรเจ็กต์ที่ใช้งานอยู่ในปัจจุบันได้โดยส่งแฟล็ก --project ด้วยคำสั่ง CLI ตามตัวอย่าง: คุณสามารถตั้งค่า CLI ของคุณให้ทำงานกับโปรเจ็กต์ Firebase ที่คุณกำหนดนามแฝง staging หากคุณต้องการรันคำสั่งเดียวกับโปรเจ็กต์ Firebase ที่คุณกำหนด prod alias คุณสามารถรันได้ เช่น firebase deploy --project=prod

การควบคุมแหล่งที่มาและนามแฝงของโครงการ

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

หากคุณมีโปรเจ็กต์การพัฒนาที่มีไว้สำหรับการใช้งานของคุณเท่านั้น คุณสามารถส่งแฟล็ก --project ด้วยแต่ละคำสั่ง หรือรัน firebase use PROJECT_ID โดยไม่ต้องกำหนดนามแฝงให้กับโปรเจ็กต์ Firebase

ให้บริการและทดสอบโปรเจ็กต์ Firebase ของคุณภายในเครื่อง

คุณสามารถดูและทดสอบโปรเจ็กต์ Firebase บน URL ที่โฮสต์ในเครื่องก่อนปรับใช้กับการใช้งานจริง หากคุณต้องการทดสอบคุณสมบัติที่เลือกเท่านั้น คุณสามารถใช้รายการที่คั่นด้วยเครื่องหมายจุลภาคในแฟล็กบนคำสั่ง firebase serve

รันคำสั่งต่อไปนี้จากรูทของไดเร็กทอรีโปรเจ็กต์ในเครื่องของคุณ หากคุณต้องการทำงานอย่างใดอย่างหนึ่งต่อไปนี้:

  • ดูเนื้อหาคงที่สำหรับแอปที่โฮสต์โดย Firebase
  • ใช้ฟังก์ชันคลาวด์เพื่อ สร้างเนื้อหาแบบไดนามิกสำหรับ Firebase Hosting และคุณต้องการใช้ฟังก์ชัน HTTP ที่ใช้งานจริง (ปรับใช้) เพื่อจำลองโฮสติ้งบน URL ในเครื่อง
firebase serve --only hosting

จำลองโครงการของคุณโดยใช้ฟังก์ชัน HTTP ในเครื่อง

เรียกใช้คำสั่งต่อไปนี้จากไดเร็กทอรีโปรเจ็กต์ของคุณเพื่อจำลองโปรเจ็กต์ของคุณโดยใช้ฟังก์ชัน HTTP ในเครื่อง

  • หากต้องการจำลองฟังก์ชัน HTTP และโฮสต์สำหรับการทดสอบ URL ในเครื่อง ให้ใช้คำสั่งใดคำสั่งหนึ่งต่อไปนี้:

    firebase serve
    firebase serve --only functions,hosting // uses a flag
  • หากต้องการจำลองฟังก์ชัน HTTP เท่านั้น ให้ใช้คำสั่งต่อไปนี้:

    firebase serve --only functions

ทดสอบจากอุปกรณ์ท้องถิ่นอื่นๆ

ตามค่าเริ่มต้น firebase serve จะตอบสนองต่อคำขอจาก localhost เท่านั้น ซึ่งหมายความว่าคุณจะสามารถเข้าถึงเนื้อหาที่โฮสต์ไว้ได้จากเว็บเบราว์เซอร์ของคอมพิวเตอร์ แต่ไม่ใช่จากอุปกรณ์อื่นในเครือข่ายของคุณ หากคุณต้องการทดสอบจากอุปกรณ์ท้องถิ่นอื่นๆ ให้ใช้แฟล็ก --host ดังนี้:

firebase serve --host 0.0.0.0  // accepts requests to any host

ทำให้ใช้งานได้กับโปรเจ็กต์ Firebase

Firebase CLI จัดการการปรับใช้โค้ดและเนื้อหาในโปรเจ็กต์ Firebase ของคุณ ซึ่งรวมถึง:

  • เว็บไซต์โฮสติ้ง Firebase รุ่นใหม่ของคุณ
  • ฟังก์ชั่นคลาวด์ใหม่ อัปเดต หรือที่มีอยู่สำหรับ Firebase
  • กฎสำหรับฐานข้อมูลเรียลไทม์ Firebase
  • กฎสำหรับ Cloud Storage สำหรับ Firebase
  • กฎสำหรับ Cloud Firestore
  • ดัชนีสำหรับ Cloud Firestore

หากต้องการปรับใช้กับโปรเจ็กต์ Firebase ให้รันคำสั่งต่อไปนี้จากไดเร็กทอรีโปรเจ็กต์ของคุณ:

firebase deploy

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

firebase deploy -m "Deploying the best new feature ever."

เมื่อคุณใช้คำสั่ง firebase deploy โปรดระวังสิ่งต่อไปนี้:

  • หากต้องการปรับใช้ทรัพยากรจากไดเรกทอรีโครงการ ไดเรกทอรีโครงการ จะต้อง มีไฟล์ firebase.json ไฟล์นี้ถูกสร้างขึ้นโดยอัตโนมัติสำหรับคุณโดยคำสั่ง firebase init

  • ตามค่าเริ่มต้น firebase deploy จะสร้างรุ่นสำหรับทรัพยากรที่ปรับใช้ได้ ทั้งหมด ในไดเรกทอรีโครงการของคุณ หากต้องการใช้บริการหรือคุณลักษณะ Firebase เฉพาะ ให้ใช้การปรับใช้บางส่วน

ข้อขัดแย้งในการปรับใช้สำหรับกฎความปลอดภัย

สำหรับฐานข้อมูลเรียลไทม์ Firebase, Cloud Storage สำหรับ Firebase และ Cloud Firestore คุณสามารถกำหนดกฎความปลอดภัยในไดเรกทอรีโปรเจ็กต์ในเครื่องของคุณหรือใน คอนโซล Firebase

อีกทางเลือกหนึ่งเพื่อหลีกเลี่ยงข้อขัดแย้งในการปรับใช้คือการ ใช้การปรับใช้บางส่วน และกำหนดกฎในคอนโซล Firebase เท่านั้น

โควต้าการทำให้ใช้งานได้

เป็นไปได้ (แต่ไม่น่าเป็นไปได้) ที่คุณอาจเกินโควต้าที่จำกัดอัตราหรือปริมาณการดำเนินการปรับใช้ Firebase ของคุณ ตัวอย่างเช่น เมื่อปรับใช้ฟังก์ชันจำนวนมาก คุณอาจได้รับข้อความแสดงข้อผิดพลาด HTTP 429 Quota เพื่อแก้ไขปัญหาดังกล่าว ให้ลอง ใช้การปรับใช้บางส่วน

ย้อนกลับการทำให้ใช้งานได้

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

ขณะนี้ยังไม่สามารถย้อนกลับกฎความปลอดภัยรุ่นต่างๆ สำหรับฐานข้อมูลเรียลไทม์ของ Firebase, Cloud Storage สำหรับ Firebase หรือ Cloud Firestore

ปรับใช้บริการ Firebase เฉพาะ

หากคุณต้องการปรับใช้บริการหรือคุณสมบัติ Firebase ที่เฉพาะเจาะจงเท่านั้น คุณสามารถใช้รายการที่คั่นด้วยเครื่องหมายจุลภาคในแฟล็กบนคำสั่ง firebase deploy ตัวอย่างเช่น คำสั่งต่อไปนี้ปรับใช้เนื้อหา Firebase Hosting และกฎความปลอดภัยของ Cloud Storage

firebase deploy --only hosting,storage

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

ไวยากรณ์แฟล็ก บริการหรือคุณลักษณะที่ใช้งาน
--only hosting เนื้อหาโฮสติ้งของ Firebase
--only database กฎฐานข้อมูลเรียลไทม์ Firebase
--only storage Cloud Storage สำหรับกฎ Firebase
--only firestore กฎ และ ดัชนีของ Cloud Firestore สำหรับฐานข้อมูลที่กำหนดค่าทั้งหมด
--only functions ฟังก์ชั่นคลาวด์สำหรับ Firebase (เป็นไปได้ ในเวอร์ชันที่เฉพาะเจาะจงมากขึ้นของการตั้งค่าสถานะนี้ )

ปรับใช้ฟังก์ชันเฉพาะ

เมื่อปรับใช้ฟังก์ชัน คุณสามารถกำหนดเป้าหมายฟังก์ชันเฉพาะได้ ตัวอย่างเช่น:

firebase deploy --only functions:function1
firebase deploy --only functions:function1,functions:function2

อีกทางเลือกหนึ่งคือจัดกลุ่มฟังก์ชันออกเป็นกลุ่มส่งออกในไฟล์ /functions/index.js ของคุณ ฟังก์ชันการจัดกลุ่มช่วยให้คุณสามารถปรับใช้หลายฟังก์ชันได้โดยใช้คำสั่งเดียว

ตัวอย่างเช่น คุณสามารถเขียนฟังก์ชันต่อไปนี้เพื่อกำหนด groupA และ groupB :

var functions = require('firebase-functions');

exports.groupA = {
  function1: functions.https.onRequest(...),
  function2: functions.database.ref('\path').onWrite(...)
}
exports.groupB = require('./groupB');

ในตัวอย่างนี้ ไฟล์ functions/groupB.js ที่แยกต่างหากมีฟังก์ชันเพิ่มเติมที่กำหนดฟังก์ชันใน groupB โดยเฉพาะ ตัวอย่างเช่น:

var functions = require('firebase-functions');

exports.function3 = functions.storage.object().onChange(...);
exports.function4 = functions.analytics.event('in_app_purchase').onLog(...);

ในตัวอย่างนี้ คุณสามารถปรับใช้ฟังก์ชัน groupA ทั้งหมดได้โดยการรันคำสั่งต่อไปนี้จากไดเร็กทอรีโปรเจ็กต์ของคุณ:

firebase deploy --only functions:groupA

หรือคุณสามารถกำหนดเป้าหมายฟังก์ชันเฉพาะภายในกลุ่มได้โดยการรันคำสั่งต่อไปนี้:

firebase deploy --only functions:groupA.function1,groupB.function4

ลบฟังก์ชัน

Firebase CLI รองรับคำสั่งและตัวเลือกต่อไปนี้สำหรับการลบฟังก์ชันที่ใช้งานก่อนหน้านี้:

  • ลบฟังก์ชันทั้งหมดที่ตรงกับชื่อที่ระบุในทุกภูมิภาค:

    firebase functions:delete FUNCTION-1_NAME

  • ลบฟังก์ชันที่ระบุที่ทำงานในภูมิภาคที่ไม่ใช่ค่าเริ่มต้น:

    firebase functions:delete FUNCTION-1_NAME --region REGION_NAME

  • ลบมากกว่าหนึ่งฟังก์ชัน:

    firebase functions:delete FUNCTION-1_NAME FUNCTION-2_NAME

  • ลบกลุ่มฟังก์ชันที่ระบุ:

    firebase functions:delete GROUP_NAME

  • ข้ามพร้อมท์การยืนยัน:

    firebase functions:delete FUNCTION-1_NAME --force

ตั้งค่างานสคริปต์ก่อนปรับใช้และหลังปรับใช้

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

หากต้องการตั้งค่า hooks ล่วงหน้าหรือหลังการปรับใช้ ให้เพิ่มสคริปต์ทุบตีลงในไฟล์การกำหนดค่า firebase.json คุณสามารถกำหนดสคริปต์สั้นๆ ได้โดยตรงในไฟล์ firebase.json หรือคุณสามารถอ้างอิงไฟล์อื่นๆ ที่อยู่ในไดเร็กทอรีโปรเจ็กต์ของคุณ

ตัวอย่างเช่น สคริปต์ต่อไปนี้คือนิพจน์ firebase.json สำหรับงานหลังปรับใช้ที่ส่งข้อความ Slack เมื่อปรับใช้กับโฮสติ้ง Firebase ได้สำเร็จ

"hosting": {
  // ...

  "postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
  "public": "public"
}

ไฟล์สคริปต์ messageSlack.sh อยู่ในไดเร็กทอรีโปรเจ็กต์และมีลักษณะดังนี้:

curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
     \https://SLACK_WEBHOOK_URL

คุณสามารถตั้งค่า hooks predeploy และ postdeploy สำหรับ เนื้อหาใดๆ ที่คุณสามารถปรับใช้ได้ โปรดทราบว่าการเรียกใช้ firebase deploy จะทริกเกอร์งานก่อนปรับใช้และหลังปรับใช้ ทั้งหมด ที่กำหนดไว้ในไฟล์ firebase.json ของคุณ หากต้องการรันเฉพาะงานที่เกี่ยวข้องกับบริการ Firebase เฉพาะ ให้ใช้คำสั่งการปรับใช้บางส่วน

ทั้งตะขอ predeploy และ postdeploy จะพิมพ์เอาต์พุตมาตรฐานและสตรีมข้อผิดพลาดของสคริปต์ไปยังเทอร์มินัล สำหรับกรณีความล้มเหลว โปรดทราบสิ่งต่อไปนี้:

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

ตัวแปรสภาพแวดล้อม

ภายในสคริปต์ที่ทำงานใน hooks ล่วงหน้าและหลังการปรับใช้ ตัวแปรสภาพแวดล้อมต่อไปนี้จะพร้อมใช้งาน:

  • $GCLOUD_PROJECT : รหัสโปรเจ็กต์ของโปรเจ็กต์ที่ใช้งานอยู่
  • $PROJECT_DIR : ไดเร็กทอรีรากที่มีไฟล์ firebase.json
  • $RESOURCE_DIR : (สำหรับสคริปต์ hosting และ functions เท่านั้น) ตำแหน่งของไดเร็กทอรีที่มีทรัพยากรโฮสติ้งหรือฟังก์ชันคลาวด์ที่จะปรับใช้

จัดการอินสแตนซ์ฐานข้อมูลเรียลไทม์หลายรายการ

โปรเจ็กต์ Firebase สามารถมี อินสแตนซ์ Firebase Realtime Database ได้หลายรายการ ตามค่าเริ่มต้น คำสั่ง CLI จะโต้ตอบกับอินสแตนซ์ฐานข้อมูล เริ่มต้น ของคุณ

อย่างไรก็ตาม คุณสามารถโต้ตอบกับอินสแตนซ์ฐานข้อมูลที่ไม่ใช่ค่าเริ่มต้นได้โดยใช้ --instance DATABASE_NAME คำสั่งต่อไปนี้รองรับแฟล็ก --instance :

  • firebase database:get
  • firebase database:profile
  • firebase database:push
  • firebase database:remove
  • firebase database:set
  • firebase database:update

การอ้างอิงคำสั่ง

คำสั่งการดูแลระบบ CLI

สั่งการ คำอธิบาย
ช่วย แสดงข้อมูลวิธีใช้เกี่ยวกับ CLI หรือคำสั่งเฉพาะ
ในนั้น เชื่อมโยงและตั้งค่าโครงการ Firebase ใหม่ในไดเรกทอรีปัจจุบัน คำสั่งนี้สร้างไฟล์การกำหนดค่า firebase.json ในไดเร็กทอรีปัจจุบัน
เข้าสู่ระบบ ตรวจสอบสิทธิ์ CLI กับบัญชี Firebase ของคุณ จำเป็นต้องเข้าถึงเว็บเบราว์เซอร์
หากต้องการเข้าสู่ระบบ CLI ในสภาพแวดล้อมระยะไกลที่ไม่อนุญาตการเข้าถึง localhost ให้ใช้ --no-localhost ธง
เข้าสู่ระบบ:ci สร้างโทเค็นการตรวจสอบสิทธิ์เพื่อใช้ในสภาพแวดล้อมที่ไม่โต้ตอบ
ออกจากระบบ ออกจากระบบ CLI จากบัญชี Firebase ของคุณ
เปิด เปิดเบราว์เซอร์ไปยังทรัพยากรโครงการที่เกี่ยวข้อง
โครงการ: รายการ แสดงรายการโครงการ Firebase ทั้งหมดที่คุณสามารถเข้าถึงได้
ใช้ ตั้งค่าโปรเจ็กต์ Firebase ที่ใช้งานอยู่สำหรับ CLI
จัดการ นามแฝงโครงการ

คำสั่งการจัดการโครงการ

สั่งการ คำอธิบาย
การจัดการโครงการ Firebase
โครงการ: addfirebase เพิ่มทรัพยากร Firebase ให้กับโครงการ Google Cloud ที่มีอยู่
โครงการ: สร้าง สร้างโปรเจ็กต์ Google Cloud ใหม่ จากนั้นเพิ่มทรัพยากร Firebase ให้กับโปรเจ็กต์ใหม่
โครงการ: รายการ แสดงรายการโครงการ Firebase ทั้งหมดที่คุณสามารถเข้าถึงได้
การจัดการแอป Firebase (iOS, Android, เว็บ)
แอพ: สร้าง สร้างแอป Firebase ใหม่ในโครงการที่ใช้งานอยู่
แอพ: รายการ แสดงรายการแอป Firebase ที่ลงทะเบียนไว้ในโปรเจ็กต์ที่ใช้งานอยู่
แอพพลิเคชั่น:sdkconfig พิมพ์การกำหนดค่าบริการของ Google ของแอป Firebase
การตั้งค่า:เว็บ เลิกใช้แล้ว ให้ใช้ apps:sdkconfig และระบุ web เป็นอาร์กิวเมนต์แพลตฟอร์มแทน
พิมพ์การกำหนดค่าบริการ Google ของ Firebase Web App
การจัดการแฮชใบรับรอง SHA (Android เท่านั้น)
แอพ: android:sha: สร้าง \
FIREBASE_APP_ID SHA_HASH
เพิ่มแฮชใบรับรอง SHA ที่ระบุให้กับแอป Firebase Android ที่ระบุ
แอพพลิเคชัน:android:sha:delete \
FIREBASE_APP_ID SHA_HASH
ลบแฮชใบรับรอง SHA ที่ระบุออกจากแอป Firebase Android ที่ระบุ
แอพพลิเคชัน:android:sha:list \
FIREBASE_APP_ID
แสดงรายการแฮชใบรับรอง SHA สำหรับแอป Firebase Android ที่ระบุ

การปรับใช้และการพัฒนาท้องถิ่น

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

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

คำสั่งการกระจายแอป

สั่งการ คำอธิบาย
การกระจายแอป: แจกจ่าย \
--แอป FIREBASE_APP_ID
ทำให้บิลด์พร้อมใช้งานสำหรับผู้ทดสอบ
การกระจายแอป: ผู้ทดสอบ: เพิ่ม เพิ่มผู้ทดสอบให้กับโปรเจ็กต์
การกระจายแอป: ผู้ทดสอบ: ลบ ลบผู้ทดสอบออกจากโปรเจ็กต์

คำสั่งการรับรองความถูกต้อง (การจัดการผู้ใช้)

สั่งการ คำอธิบาย
รับรองความถูกต้อง:ส่งออก ส่งออกบัญชีผู้ใช้ของโครงการที่ใช้งานอยู่เป็นไฟล์ JSON หรือ CSV สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ หน้า auth:import และ auth:export
รับรองความถูกต้อง: นำเข้า นำเข้าบัญชีผู้ใช้จากไฟล์ JSON หรือ CSV ไปยังโปรเจ็กต์ที่ใช้งานอยู่ สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ หน้า auth:import และ auth:export

คำสั่ง Cloud Firestore

สั่งการ คำอธิบาย
ร้านขายไฟ: สถานที่

แสดงรายการตำแหน่งที่พร้อมใช้งานสำหรับฐานข้อมูล Cloud Firestore ของคุณ

firestore: ฐานข้อมูล: สร้าง DATABASE_ID

สร้างอินสแตนซ์ฐานข้อมูลในโหมดดั้งเดิมในโปรเจ็กต์ Firebase ของคุณ

คำสั่งรับแฟล็กต่อไปนี้:

  • --location <ชื่อภูมิภาค> เพื่อระบุตำแหน่งการปรับใช้สำหรับฐานข้อมูล โปรดทราบว่าคุณสามารถเรียกใช้ firebase firestore:locations เพื่อแสดงรายการตำแหน่งที่มีอยู่ ที่จำเป็น .
  • --delete-protection <deleteProtectionState> เพื่ออนุญาตหรือป้องกันการลบฐานข้อมูลที่ระบุ ค่าที่ถูกต้องคือ ENABLED หรือ DISABLED ค่าเริ่มต้นเป็น DISABLED
  • --point-in-time-recovery <PITRState> เพื่อตั้งค่าว่าจะเปิดใช้งานการกู้คืน point-in-time หรือไม่ ค่าที่ถูกต้องคือ ENABLED หรือ DISABLED ค่าเริ่มต้นเป็น DISABLED ไม่จำเป็น.
firestore:ฐานข้อมูล:รายการ

แสดงรายการฐานข้อมูลในโครงการ Firebase ของคุณ

firestore: ฐานข้อมูล: รับ DATABASE_ID

รับการกำหนดค่าฐานข้อมูลสำหรับฐานข้อมูลที่ระบุในโปรเจ็กต์ Firebase ของคุณ

firestore: ฐานข้อมูล: อัปเดต DATABASE_ID

อัปเดตการกำหนดค่าฐานข้อมูลของฐานข้อมูลที่ระบุในโปรเจ็กต์ Firebase ของคุณ

ต้องมีอย่างน้อยหนึ่งแฟล็ก คำสั่งรับแฟล็กต่อไปนี้:

  • --delete-protection <deleteProtectionState> เพื่ออนุญาตหรือป้องกันการลบฐานข้อมูลที่ระบุ ค่าที่ถูกต้องคือ ENABLED หรือ DISABLED ค่าเริ่มต้นเป็น DISABLED
  • --point-in-time-recovery <PITRState> เพื่อตั้งค่าว่าจะเปิดใช้งานการกู้คืน point-in-time หรือไม่ ค่าที่ถูกต้องคือ ENABLED หรือ DISABLED ค่าเริ่มต้นเป็น DISABLED ไม่จำเป็น.
firestore: ฐานข้อมูล: ลบ DATABASE_ID

ลบฐานข้อมูลในโครงการ Firebase ของคุณ

firestore:ดัชนี

แสดงรายการดัชนีสำหรับฐานข้อมูลในโครงการ Firebase ของคุณ

คำสั่งรับแฟล็กต่อไปนี้:

  • --database DATABASE_ID เพื่อระบุชื่อของฐานข้อมูลที่จะแสดงรายการดัชนี หากไม่ได้ระบุไว้ ดัชนีจะแสดงรายการสำหรับฐานข้อมูลเริ่มต้น
ที่เก็บไฟ: ลบ

ลบเอกสารในฐานข้อมูลของโครงการที่ใช้งานอยู่ เมื่อใช้ CLI คุณสามารถลบเอกสารทั้งหมดในคอลเลกชันแบบวนซ้ำได้

โปรดทราบว่าการลบข้อมูล Cloud Firestore ด้วย CLI จะทำให้เกิดค่าใช้จ่ายในการอ่านและลบ สำหรับข้อมูลเพิ่มเติม โปรดดู ที่ ทำความเข้าใจการเรียกเก็บเงิน Cloud Firestore

คำสั่งรับแฟล็กต่อไปนี้:

  • --database DATABASE_ID เพื่อระบุชื่อของฐานข้อมูลที่จะลบเอกสาร หากไม่ได้ระบุ เอกสารจะถูกลบออกจากฐานข้อมูลเริ่มต้น ไม่จำเป็น.

ฟังก์ชั่นคลาวด์สำหรับคำสั่ง Firebase

สั่งการ คำอธิบาย
ฟังก์ชั่น: config: โคลน โคลนสภาพแวดล้อมของโปรเจ็กต์อื่นลงในโปรเจ็กต์ Firebase ที่ใช้งานอยู่
ฟังก์ชัน:config:get ดึงค่าการกำหนดค่าที่มีอยู่ของฟังก์ชันคลาวด์ของโปรเจ็กต์ที่ใช้งานอยู่
ฟังก์ชัน:config:set จัดเก็บค่าการกำหนดค่ารันไทม์ของฟังก์ชันคลาวด์ของโปรเจ็กต์ที่ใช้งานอยู่
ฟังก์ชั่น: config: ไม่ได้ตั้งค่า ลบค่าออกจากการกำหนดค่ารันไทม์ของโปรเจ็กต์ที่ใช้งานอยู่
ฟังก์ชัน:บันทึก อ่านบันทึกจาก Cloud Functions ที่ปรับใช้

สำหรับข้อมูลเพิ่มเติม โปรดดู เอกสารประกอบการกำหนดค่าสภาพแวดล้อม

คำสั่ง Crashlytics

สั่งการ คำอธิบาย
Crashlytics: mappingfile: สร้าง ID \
--resource-file= PATH/TO/ANDROID_RESOURCE.XML
สร้างรหัสไฟล์การแมปที่ไม่ซ้ำกันในไฟล์ทรัพยากร Android (XML) ที่ระบุ
Crashlytics: mappingfile: อัพโหลด \
--app= FIREBASE_APP_ID \
--resource-file= PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT
อัปโหลดไฟล์การแมปที่เข้ากันได้กับ Proguard (TXT) สำหรับแอปนี้ และเชื่อมโยงกับรหัสไฟล์การแมปที่ประกาศในไฟล์ทรัพยากร Android (XML) ที่ระบุ
Crashlytics: สัญลักษณ์: อัปโหลด \
--app= FIREBASE_APP_ID \
PATH/TO/SYMBOLS
สร้างไฟล์สัญลักษณ์ที่เข้ากันได้กับ Crashlytics สำหรับการขัดข้องของไลบรารีดั้งเดิมบน Android และอัปโหลดไปยังเซิร์ฟเวอร์ Firebase

คำสั่งส่วนขยาย

สั่งการ คำอธิบาย
ต่อ แสดงข้อมูลเกี่ยวกับวิธีการใช้คำสั่ง Firebase Extensions
แสดงรายการอินสแตนซ์ส่วนขยายที่ติดตั้งในโปรเจ็กต์ที่ใช้งานอยู่
ต่อ:กำหนดค่า \
EXTENSION_INSTANCE_ID
กำหนดค่าพารามิเตอร์ของอินสแตนซ์ส่วนขยายใหม่ในรายการ ส่วนขยาย ของคุณ
ต่อ:ข้อมูล \
PUBLISHER_ID/EXTENSION_ID
พิมพ์ข้อมูลโดยละเอียดเกี่ยวกับส่วนขยาย
ต่อ: ติดตั้ง \
PUBLISHER_ID/EXTENSION_ID
เพิ่มอินส แตนซ์ใหม่ของส่วนขยายลงในรายการส่วนขยาย ของคุณ
ต่อ:รายการ แสดงรายการอินสแตนซ์ส่วนขยายทั้งหมดที่ติดตั้งในโครงการ Firebase
พิมพ์ ID อินสแตนซ์สำหรับแต่ละส่วนขยาย
ต่อ: ถอนการติดตั้ง \
EXTENSION_INSTANCE_ID
ลบอิน สแตนซ์ส่วนขยายออกจากรายการส่วนขยาย ของคุณ
ต่อ: อัพเดต \
EXTENSION_INSTANCE_ID
อัปเดตอินสแตนซ์ส่วนขยายเป็นเวอร์ชันล่าสุดใน รายการส่วนขยาย ของคุณ
ต่อ:ส่งออก ส่งออกอินสแตนซ์ส่วนขยายที่ติดตั้งทั้งหมดจากโครงการของคุณไปยัง รายการส่วนขยาย ของคุณ

คำสั่งของผู้เผยแพร่ส่วนขยาย

สั่งการ คำอธิบาย
ต่อ:dev:init เตรียมใช้งาน codebase โครงกระดูกสำหรับส่วนขยายใหม่ในไดเร็กทอรีปัจจุบัน
ต่อ:dev:รายการ \
PUBLISHER_ID
พิมพ์รายการส่วนขยายทั้งหมดที่ผู้จัดพิมพ์อัปโหลด
ต่อ:dev:register ลงทะเบียนโครงการ Firebase เป็น โครงการผู้เผยแพร่ส่วนขยาย
ต่อ: dev: เลิกใช้แล้ว \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
เลิกใช้ เวอร์ชันส่วนขยายที่ตรงกับภาคแสดงเวอร์ชัน
เพรดิเคตเวอร์ชันอาจเป็นเวอร์ชันเดียว (เช่น 1.0.0 ) หรือช่วงของเวอร์ชัน (เช่น >1.0.0 )
หากไม่มีการระบุเวอร์ชัน ให้เลิกใช้งานส่วนขยายนั้นทุกเวอร์ชัน
ต่อ: dev: ไม่สนับสนุน \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
ยกเลิกการเลิกใช้ เวอร์ชันส่วนขยายที่ตรงกับภาคแสดงเวอร์ชัน
เพรดิเคตเวอร์ชันอาจเป็นเวอร์ชันเดียว (เช่น 1.0.0 ) หรือช่วงของเวอร์ชัน (เช่น >1.0.0 )
หากไม่มีการระบุเวอร์ชัน ให้ยกเลิกการรองรับเวอร์ชันทั้งหมดของส่วนขยายนั้น
ต่อ: dev: อัพโหลด \
PUBLISHER_ID/EXTENSION_ID
อัปโหลดส่วนขยายเวอร์ชันใหม่
ต่อ: dev: การใช้งาน \
PUBLISHER_ID
แสดงจำนวนการติดตั้งและเมตริกการใช้งานส่วนขยายที่อัปโหลดโดยผู้เผยแพร่

คำสั่งโฮสติ้ง

สั่งการ คำอธิบาย
โฮสติ้ง:ปิดการใช้งาน

หยุดให้บริการการรับส่งข้อมูลโฮสติ้งของ Firebase สำหรับโปรเจ็กต์ Firebase ที่ใช้งานอยู่

URL โฮสติ้งของโปรเจ็กต์ของคุณจะแสดงข้อความ "ไม่พบไซต์" หลังจากรันคำสั่งนี้

การจัดการเว็บไซต์โฮสติ้ง
โฮสติ้ง firebase: ไซต์: สร้าง \
SITE_ID

สร้างไซต์โฮสติ้งใหม่ในโครงการ Firebase ที่ใช้งานอยู่โดยใช้ SITE_ID ที่ระบุ

(ไม่บังคับ) ระบุ Firebase Web App ที่มีอยู่เพื่อเชื่อมโยงกับไซต์ใหม่โดยส่งแฟล็กต่อไปนี้: --app FIREBASE_APP_ID

โฮสติ้ง firebase: ไซต์: ลบ \
SITE_ID

ลบไซต์โฮสติ้งที่ระบุ

CLI จะแสดงข้อความยืนยันก่อนที่จะลบไซต์

(ไม่บังคับ) ข้ามพร้อมท์การยืนยันโดยส่งแฟล็กต่อไปนี้: -f หรือ --force

โฮสติ้ง firebase: ไซต์: รับ \
SITE_ID

ดึงข้อมูลเกี่ยวกับไซต์โฮสติ้งที่ระบุ

โฮสติ้ง firebase: ไซต์: รายการ

แสดงรายการไซต์โฮสติ้งทั้งหมดสำหรับโปรเจ็กต์ Firebase ที่ใช้งานอยู่

การจัดการช่องตัวอย่าง
โฮสติ้ง firebase: ช่อง: สร้าง \
CHANNEL_ID

สร้างช่องแสดงตัวอย่างใหม่ในไซต์โฮสติ้ง เริ่มต้น โดยใช้ CHANNEL_ID ที่ระบุ

คำสั่งนี้ไม่ได้ปรับใช้กับช่องสัญญาณ

โฮสติ้ง firebase: ช่อง: ลบ \
CHANNEL_ID

ลบช่องแสดงตัวอย่างที่ระบุ

คุณไม่สามารถลบช่องถ่ายทอดสดของไซต์ได้

โฮสติ้ง firebase: ช่อง: ปรับใช้ \
CHANNEL_ID

ปรับใช้เนื้อหาโฮสติ้งของคุณและกำหนดค่าไปยังช่องแสดงตัวอย่างที่ระบุ

หากยังไม่มีช่องแสดงตัวอย่าง คำสั่งนี้จะสร้างช่องในไซต์โฮสต์ เริ่มต้น ก่อนที่จะปรับใช้กับช่อง

โฮสติ้ง firebase:ช่อง:รายการ แสดงรายการช่องทั้งหมด (รวมถึงช่อง "สด") ในไซต์โฮสติ้ง เริ่มต้น
โฮสติ้ง firebase: ช่อง: เปิด \
CHANNEL_ID
เปิดเบราว์เซอร์ไปยัง URL ของช่องที่ระบุหรือส่งคืน URL หากไม่สามารถเปิดในเบราว์เซอร์ได้
การโคลนเวอร์ชัน
โฮสติ้ง firebase: โคลน \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

โคลนเวอร์ชันที่ใช้งานล่าสุดในช่อง "ต้นทาง" ที่ระบุไปยังช่อง "เป้าหมาย" ที่ระบุ

คำสั่งนี้ยังใช้กับช่อง "เป้าหมาย" ที่ระบุด้วย หากยังไม่มีช่อง "เป้าหมาย" คำสั่งนี้จะสร้างช่องแสดงตัวอย่างใหม่ในไซต์โฮสติ้ง "เป้าหมาย" ก่อนที่จะปรับใช้กับช่อง

โฮสติ้ง firebase: โคลน \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

โคลนเวอร์ชันที่ระบุไปยังช่อง "เป้าหมาย" ที่ระบุ

คำสั่งนี้ยังใช้กับช่อง "เป้าหมาย" ที่ระบุด้วย หากยังไม่มีช่อง "เป้าหมาย" คำสั่งนี้จะสร้างช่องแสดงตัวอย่างใหม่ในไซต์โฮสติ้ง "เป้าหมาย" ก่อนที่จะปรับใช้กับช่อง

คุณสามารถดู VERSION_ID ใน แดชบอร์ดโฮสติ้ง ของคอนโซล Firebase

คำสั่งฐานข้อมูลเรียลไทม์

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

เมื่อสร้างอินสแตนซ์แล้ว คุณสามารถจัดการได้ตามที่กล่าวไว้ใน จัดการอินสแตนซ์ฐานข้อมูลเรียลไทม์หลายรายการ

สั่งการ คำอธิบาย
ฐานข้อมูล:get ดึงข้อมูลจากฐานข้อมูลของโปรเจ็กต์ที่ใช้งานอยู่และแสดงเป็น JSON รองรับการสืบค้นข้อมูลที่จัดทำดัชนี
ฐานข้อมูล: อินสแตนซ์: สร้าง สร้างอินสแตนซ์ฐานข้อมูลด้วยชื่ออินสแตนซ์ที่ระบุ ยอมรับตัวเลือก --location สำหรับการสร้างฐานข้อมูลในภูมิภาคที่ระบุ สำหรับชื่อภูมิภาคที่จะใช้กับตัวเลือกนี้ โปรดดู สถานที่ที่เลือกสำหรับโครงการของคุณ หากไม่มีอินสแตนซ์ฐานข้อมูลสำหรับโปรเจ็กต์ปัจจุบัน คุณจะได้รับแจ้งให้เรียกใช้โฟลว์ firebase init เพื่อสร้างอินสแตนซ์
ฐานข้อมูล:อินสแตนซ์:รายการ แสดงรายการอินสแตนซ์ฐานข้อมูลทั้งหมดสำหรับโปรเจ็กต์นี้ ยอมรับตัวเลือก --location สำหรับการแสดงรายการฐานข้อมูลในภูมิภาคที่ระบุ สำหรับชื่อภูมิภาคที่จะใช้กับตัวเลือกนี้ โปรดดู สถานที่ตั้งที่เลือกสำหรับโครงการของคุณ
ฐานข้อมูล:โปรไฟล์ สร้างโปรไฟล์การดำเนินงานบนฐานข้อมูลของโครงการที่ใช้งานอยู่ สำหรับรายละเอียดเพิ่มเติม โปรดดู ประเภทการทำงานของฐานข้อมูลเรียลไทม์
ฐานข้อมูล:ผลักดัน ส่งข้อมูลใหม่ไปยังรายการในตำแหน่งที่ระบุในฐานข้อมูลของโครงการที่ใช้งานอยู่ รับอินพุตจากไฟล์, STDIN หรืออาร์กิวเมนต์บรรทัดคำสั่ง
ฐานข้อมูล: ลบ ลบข้อมูลทั้งหมดในตำแหน่งที่ระบุในฐานข้อมูลของโครงการที่ใช้งานอยู่
ฐานข้อมูล:set แทนที่ข้อมูลทั้งหมดในตำแหน่งที่ระบุในฐานข้อมูลของโครงการที่ใช้งานอยู่ รับอินพุตจากไฟล์, STDIN หรืออาร์กิวเมนต์บรรทัดคำสั่ง
ฐานข้อมูล: อัปเดต ดำเนินการอัปเดตบางส่วนในตำแหน่งที่ระบุในฐานข้อมูลของโครงการที่ใช้งานอยู่ รับอินพุตจากไฟล์, STDIN หรืออาร์กิวเมนต์บรรทัดคำสั่ง

คำสั่งการกำหนดค่าระยะไกล

สั่งการ คำอธิบาย
รีโมตคอนฟิก: เวอร์ชัน: รายการ \
--จำกัด NUMBER_OF_VERSIONS
แสดงรายการเทมเพลตสิบเวอร์ชันล่าสุด ระบุ 0 เพื่อส่งคืนเวอร์ชันที่มีอยู่ทั้งหมด หรือเลือกที่จะส่งตัวเลือก --limit เพื่อจำกัดจำนวนเวอร์ชันที่ส่งคืน
การกำหนดค่าระยะไกล: รับ \
--v, version_number VERSION_NUMBER
--o เอาต์พุต FILENAME
รับเทมเพลตตามเวอร์ชัน (ค่าเริ่มต้นเป็นเวอร์ชันล่าสุด) และส่งออกกลุ่มพารามิเตอร์ พารามิเตอร์ และชื่อเงื่อนไขและเวอร์ชันลงในตาราง หรือคุณสามารถเขียนเอาต์พุตไปยังไฟล์ที่ระบุด้วย -o, FILENAME
การกำหนดค่าระยะไกล: ย้อนกลับ \
--v, version_number VERSION_NUMBER
--บังคับ
ย้อนกลับเทมเพลตการกำหนดค่าระยะไกลเป็นหมายเลขเวอร์ชันก่อนหน้าที่ระบุ หรือตั้งค่าเริ่มต้นเป็นเวอร์ชันก่อนหน้าทันที (เวอร์ชันปัจจุบัน -1) เว้นแต่จะผ่าน --force ให้แจ้ง Y/N ก่อนที่จะดำเนินการย้อนกลับ