Firebase CLI ( GitHub ) มีเครื่องมือที่หลากหลายสำหรับการจัดการ ดู และปรับใช้กับโปรเจ็กต์ Firebase
ก่อนที่จะใช้ Firebase CLI ให้ตั้งค่าโปรเจ็กต์ Firebase
ตั้งค่าหรืออัปเดต CLI
ติดตั้ง Firebase CLI
คุณสามารถติดตั้ง Firebase CLI โดยใช้วิธีการที่ตรงกับระบบปฏิบัติการ ระดับประสบการณ์ และ/หรือกรณีการใช้งานของคุณ ไม่ว่าคุณจะติดตั้ง CLI อย่างไร คุณสามารถเข้าถึงฟังก์ชันการทำงานเดียวกันและคำสั่ง firebase
ได้
หน้าต่าง
คุณติดตั้ง Firebase CLI สำหรับ Windows ได้โดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
ตัวเลือก | คำอธิบาย | แนะนำสำหรับ... |
---|---|---|
ไบนารีแบบสแตนด์อโลน | ดาวน์โหลดไบนารีแบบสแตนด์อโลนสำหรับ CLI จากนั้นคุณสามารถเข้าถึงไฟล์ปฏิบัติการเพื่อเปิดเชลล์ที่คุณสามารถรันคำสั่ง firebase ได้ | นักพัฒนาใหม่ นักพัฒนาไม่ได้ใช้หรือไม่คุ้นเคยกับ Node.js |
เวลา 22.00 น | ใช้ npm (Node Package Manager) เพื่อติดตั้ง CLI และเปิดใช้งานคำสั่ง firebase ที่พร้อมใช้งานทั่วโลก | นักพัฒนาที่ใช้ Node.js |
ไบนารีแบบสแตนด์อโลน
หากต้องการดาวน์โหลดและเรียกใช้ไบนารีสำหรับ Firebase CLI ให้ทำตามขั้นตอนเหล่านี้:
ดาวน์โหลด ไบนารี Firebase CLI สำหรับ Windows
เข้าถึงไบนารีเพื่อเปิดเชลล์ที่คุณสามารถเรียกใช้คำสั่ง
firebase
ได้ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI
เวลา 22.00 น
หากต้องการใช้ npm
(Node Package Manager) เพื่อติดตั้ง Firebase CLI ให้ทำตามขั้นตอนเหล่านี้:
ติดตั้ง Node.js โดยใช้ nvm-windows (Node Version Manager) การติดตั้ง Node.js จะติดตั้งเครื่องมือคำสั่ง
npm
โดยอัตโนมัติติดตั้ง Firebase CLI ผ่าน
npm
โดยรันคำสั่งต่อไปนี้:npm install -g firebase-tools
คำสั่งนี้เปิดใช้งานคำสั่ง
firebase
ที่พร้อมใช้งานทั่วโลกดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ 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 โดยใช้สคริปต์การติดตั้งอัตโนมัติ ให้ทำตามขั้นตอนเหล่านี้:
รันคำสั่ง cURL ต่อไปนี้:
curl -sL https://firebase.tools | bash
สคริปต์นี้จะตรวจจับระบบปฏิบัติการของคุณโดยอัตโนมัติ ดาวน์โหลด Firebase CLI รุ่นล่าสุด จากนั้นเปิดใช้งานคำสั่ง
firebase
ที่พร้อมใช้งานทั่วโลกดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI
สำหรับตัวอย่างและรายละเอียดเพิ่มเติมเกี่ยวกับสคริปต์การติดตั้งอัตโนมัติ โปรดดูซอร์สโค้ดของสคริปต์ที่ firebase.tools
ไบนารีแบบสแตนด์อโลน
หากต้องการดาวน์โหลดและเรียกใช้ไบนารีสำหรับ Firebase CLI เฉพาะสำหรับระบบปฏิบัติการของคุณ ให้ทำตามขั้นตอนเหล่านี้:
ดาวน์โหลดไบนารี Firebase CLI สำหรับระบบปฏิบัติการของคุณ: macOS | ลินุกซ์
(ไม่บังคับ) ตั้งค่าคำสั่ง
firebase
ที่ใช้ได้ทั่วโลก- ทำให้ไบนารีปฏิบัติการได้โดยการรัน
chmod +x ./firebase_tools
- เพิ่มเส้นทางของไบนารีให้กับ PATH ของคุณ
- ทำให้ไบนารีปฏิบัติการได้โดยการรัน
ดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI
เวลา 22.00 น
หากต้องการใช้ npm
(Node Package Manager) เพื่อติดตั้ง Firebase CLI ให้ทำตามขั้นตอนเหล่านี้:
ติดตั้ง Node.js โดยใช้ nvm (Node Version Manager)
การติดตั้ง Node.js จะติดตั้งเครื่องมือคำสั่งnpm
โดยอัตโนมัติติดตั้ง Firebase CLI ผ่าน
npm
โดยรันคำสั่งต่อไปนี้:npm install -g firebase-tools
คำสั่งนี้เปิดใช้งานคำสั่ง
firebase
ที่พร้อมใช้งานทั่วโลกดำเนินการต่อเพื่อ เข้าสู่ระบบและทดสอบ CLI
เข้าสู่ระบบและทดสอบ Firebase CLI
หลังจากติดตั้ง CLI คุณต้องรับรองความถูกต้อง จากนั้น คุณจะยืนยันการตรวจสอบสิทธิ์ได้โดยแสดงรายการโปรเจ็กต์ Firebase ของคุณ
เข้าสู่ระบบ Firebase โดยใช้บัญชี Google ของคุณโดยเรียกใช้คำสั่งต่อไปนี้:
firebase login
คำสั่งนี้จะเชื่อมต่อเครื่องในเครื่องของคุณกับ Firebase และให้สิทธิ์คุณในการเข้าถึงโปรเจ็กต์ Firebase ของคุณ
ทดสอบว่า CLI ได้รับการติดตั้งอย่างถูกต้องและเข้าถึงบัญชีของคุณโดยแสดงรายการโปรเจ็กต์ Firebase ของคุณ รันคำสั่งต่อไปนี้:
firebase projects:list
รายการที่แสดงควรเหมือนกับโครงการ Firebase ที่แสดงอยู่ใน คอนโซล Firebase
อัปเดตเป็นเวอร์ชัน CLI ล่าสุด
โดยทั่วไป คุณต้องการใช้ Firebase CLI เวอร์ชันล่าสุด
วิธีที่คุณอัปเดตเวอร์ชัน CLI ขึ้นอยู่กับระบบปฏิบัติการของคุณและวิธีการติดตั้ง CLI
หน้าต่าง
- ไบนารี่แบบสแตนด์อโลน : ดาวน์โหลดเวอร์ชันใหม่ จากนั้นแทนที่ในระบบของคุณ
- npm : รัน
npm install -g firebase-tools
ระบบปฏิบัติการ 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 และสภาพแวดล้อมที่ไม่มีส่วนหัวอื่นๆ ได้อย่างสมบูรณ์
บนเครื่องที่มีเบราว์เซอร์ ให้ติดตั้ง Firebase CLI
เริ่มกระบวนการลงชื่อเข้าใช้โดยการรันคำสั่งต่อไปนี้:
firebase login:ci
ไปที่ URL ที่ให้ไว้ จากนั้นเข้าสู่ระบบโดยใช้บัญชี Google
พิมพ์ โทเค็นการรีเฟรช ใหม่ เซสชัน CLI ปัจจุบันจะไม่ได้รับผลกระทบ
จัดเก็บโทเค็นเอาต์พุตด้วยวิธีที่ปลอดภัยแต่สามารถเข้าถึงได้ในระบบ CI ของคุณ
ใช้โทเค็นนี้เมื่อรันคำสั่ง
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 \ | สั่งให้คำสั่งทั้งหมดทำงานกับโปรเจ็กต์ Firebase ที่ระบุ CLI ใช้โปรเจ็กต์นี้เป็น "โปรเจ็กต์ที่ใช้งานอยู่" ในปัจจุบัน |
firebase use --clear | ล้างโปรเจ็กต์ที่ใช้งานอยู่ เรียกใช้ |
firebase use \ | ลบนามแฝงออกจากไดเรกทอรีโครงการของคุณ |
คุณสามารถแทนที่สิ่งที่ถูกใช้เป็นโปรเจ็กต์ที่ใช้งานอยู่ในปัจจุบันได้โดยส่งแฟล็ก --project
ด้วยคำสั่ง CLI ตามตัวอย่าง: คุณสามารถตั้งค่า CLI ของคุณให้ทำงานกับโปรเจ็กต์ Firebase ที่คุณกำหนดนามแฝง staging
หากคุณต้องการรันคำสั่งเดียวกับโปรเจ็กต์ Firebase ที่คุณกำหนด prod
alias คุณสามารถรันได้ เช่น
การควบคุมแหล่งที่มาและนามแฝงของโครงการ
โดยทั่วไป คุณควรตรวจสอบไฟล์ .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 ของคุณ คำสั่งรับแฟล็กต่อไปนี้:
|
firestore:ฐานข้อมูล:รายการ | แสดงรายการฐานข้อมูลในโครงการ Firebase ของคุณ |
firestore: ฐานข้อมูล: รับ DATABASE_ID | รับการกำหนดค่าฐานข้อมูลสำหรับฐานข้อมูลที่ระบุในโปรเจ็กต์ Firebase ของคุณ |
firestore: ฐานข้อมูล: อัปเดต DATABASE_ID | อัปเดตการกำหนดค่าฐานข้อมูลของฐานข้อมูลที่ระบุในโปรเจ็กต์ Firebase ของคุณ ต้องมีอย่างน้อยหนึ่งแฟล็ก คำสั่งรับแฟล็กต่อไปนี้:
|
firestore: ฐานข้อมูล: ลบ DATABASE_ID | ลบฐานข้อมูลในโครงการ Firebase ของคุณ |
firestore:ดัชนี | แสดงรายการดัชนีสำหรับฐานข้อมูลในโครงการ Firebase ของคุณ คำสั่งรับแฟล็กต่อไปนี้:
|
ที่เก็บไฟ: ลบ | ลบเอกสารในฐานข้อมูลของโครงการที่ใช้งานอยู่ เมื่อใช้ CLI คุณสามารถลบเอกสารทั้งหมดในคอลเลกชันแบบวนซ้ำได้ โปรดทราบว่าการลบข้อมูล Cloud Firestore ด้วย CLI จะทำให้เกิดค่าใช้จ่ายในการอ่านและลบ สำหรับข้อมูลเพิ่มเติม โปรดดู ที่ ทำความเข้าใจการเรียกเก็บเงิน Cloud Firestore คำสั่งรับแฟล็กต่อไปนี้:
|
ฟังก์ชั่นคลาวด์สำหรับคำสั่ง 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 ที่ใช้งานอยู่โดยใช้ (ไม่บังคับ) ระบุ Firebase Web App ที่มีอยู่เพื่อเชื่อมโยงกับไซต์ใหม่โดยส่งแฟล็กต่อไปนี้: |
โฮสติ้ง firebase: ไซต์: ลบ \ SITE_ID | ลบไซต์โฮสติ้งที่ระบุ CLI จะแสดงข้อความยืนยันก่อนที่จะลบไซต์ (ไม่บังคับ) ข้ามพร้อมท์การยืนยันโดยส่งแฟล็กต่อไปนี้: |
โฮสติ้ง firebase: ไซต์: รับ \ SITE_ID | ดึงข้อมูลเกี่ยวกับไซต์โฮสติ้งที่ระบุ |
โฮสติ้ง firebase: ไซต์: รายการ | แสดงรายการไซต์โฮสติ้งทั้งหมดสำหรับโปรเจ็กต์ Firebase ที่ใช้งานอยู่ |
การจัดการช่องตัวอย่าง | |
โฮสติ้ง firebase: ช่อง: สร้าง \ 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 | โคลนเวอร์ชันที่ระบุไปยังช่อง "เป้าหมาย" ที่ระบุ คำสั่งนี้ยังใช้กับช่อง "เป้าหมาย" ที่ระบุด้วย หากยังไม่มีช่อง "เป้าหมาย" คำสั่งนี้จะสร้างช่องแสดงตัวอย่างใหม่ในไซต์โฮสติ้ง "เป้าหมาย" ก่อนที่จะปรับใช้กับช่อง คุณสามารถดู |
คำสั่งฐานข้อมูลเรียลไทม์
โปรดทราบว่าคุณสามารถสร้างอินสแตนซ์ฐานข้อมูลเรียลไทม์เริ่มต้นเริ่มต้นได้ในคอนโซล 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 ก่อนที่จะดำเนินการย้อนกลับ |