پروژه Firebase یک پروژه Google Cloud است که دارای تنظیمات و سرویسهای اضافی مخصوص Firebase است. این معمولاً "افزودن Firebase" به پروژه Google Cloud نامیده می شود. این صفحه نحوه "افزودن Firebase" را به همراه برخی از سوالات متداول (سؤالات متداول) توضیح می دهد.
وقتی Firebase را به پروژه Google Cloud اضافه میکنید، Firebase بهطور خودکار چندین API را فعال میکند و حسابهای سرویس ایجاد میکند تا استفاده از همه سرویسها و رابطهای Firebase را ساده کند. Firebase همچنین یک برچسب firebase:enabled
را در صفحه Labels کنسول Google Cloud به پروژه شما اضافه می کند. جزئیات بیشتری درباره اتفاقاتی که هنگام "افزودن Firebase" رخ می دهد بیاموزید.
رابطه بین پروژه Firebase و پروژه Google Cloud
از آنجایی که یک پروژه Firebase یک پروژه Google Cloud است :
میتوانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIs به پروژه دسترسی داشته باشید و با آن تعامل داشته باشید.
میتوانید با استفاده از Firebase CLI ، gcloud CLI و هر منبع Terraform از Google با پروژه تعامل داشته باشید.
میتوانید از محصولات و APIهای Firebase و Google Cloud در پروژه استفاده کنید.
مجوزها و نقشهای IAM برای پروژه در Firebase و Google Cloud به اشتراک گذاشته میشوند. هر گونه دسترسی یک عضو پروژه (یعنی یک اصل) به پروژه Google Cloud شما برای پروژه Firebase شما نیز اعمال خواهد شد (و بالعکس).
صورتحساب پروژه در Firebase و Google Cloud مشترک است. اگر صورتحساب در پروژه Google Cloud شما فعال باشد، پروژه Firebase شما در طرح قیمتگذاری Blaze بهصورت پرداختی Firebase قرار میگیرد.
شناسههای منحصربهفرد برای پروژه (مانند شماره پروژه و شناسه پروژه ) در Firebase و Google Cloud به اشتراک گذاشته میشوند.
هر گونه سلسله مراتب منابع اعمال شده در پروژه Google Cloud شما (به عنوان مثال، سازمان، پوشه ها و غیره) در پروژه Firebase شما نیز اعمال خواهد شد.
حذف پروژه باعث حذف آن در Firebase و Google Cloud می شود.
حذف یا تغییر یک منبع یا داده در پروژه در Firebase و Google Cloud اعمال میشود.
چگونه Firebase را به پروژه Google Cloud موجود اضافه کنیم
میتوانید Firebase را با استفاده از یکی از گزینههای زیر به پروژه Google Cloud موجود «افزودن» کنید. مطمئن شوید که مجوزهای لازم برای افزودن Firebase به پروژه Google Cloud را دارید.
توجه داشته باشید که وقتی Firebase را به یک پروژه Google Cloud موجود اضافه کنید، آن را نمیتوانید لغو کنید (یعنی نمیتوانید Firebase را به طور کامل از پروژه Google Cloud حذف کنید). در این پرسش متداول بیشتر بیاموزید.
کنسول Firebase
به کنسول Firebase بروید.
با همان حساب Google وارد شوید که به شما امکان می دهد به پروژه Google Cloud موجود دسترسی پیدا کنید.
روی ایجاد پروژه کلیک کنید.
در پایین صفحه، روی پیوند برای قبلاً پروژه Google Cloud دارید کلیک کنید؟
در قسمت متن، شناسه پروژه پروژه موجود را وارد کنید و سپس پروژه را از لیست نمایش داده شده انتخاب کنید.
روی Open project کلیک کنید.
در صورت درخواست، شرایط Firebase را بپذیرید.
دستورالعمل های روی صفحه را برای "افزودن Firebase" و راه اندازی یک پروژه Firebase دنبال کنید.
توجه داشته باشید که فعال کردن Google Analytics اختیاری است.
Firebase CLI
اگر قبلاً این کار را نکردهاید، Firebase CLI را نصب کنید .
با همان حساب Google وارد شوید که به شما امکان می دهد به پروژه Google Cloud موجود دسترسی پیدا کنید.
دستور زیر را اجرا کنید:
firebase projects:addfirebase
وقتی از شما خواسته شد، پروژه موجود Google Cloud را از لیست نمایش داده شده انتخاب کنید.
اگر قبلاً شرایط Firebase را نپذیرفتهاید، یک پروژه Firebase را در کنسول Firebase باز کنید تا شرایط را بپذیرید. در این سؤالات متداول درباره شرایط Firebase بیشتر بدانید.
REST API
Firebase Management API را در پروژه Google Cloud موجود فعال کنید.
کد دسترسی API خود را ایجاد کنید.
با فراخوانی
projects.addFirebase
خدمات Firebase را برای پروژه فعال کنید.توجه داشته باشید که برای برقراری این تماس به نام منبع پروژه خود نیاز دارید.
اگر قبلاً شرایط Firebase را نپذیرفتهاید، یک پروژه Firebase را در کنسول Firebase باز کنید تا شرایط را بپذیرید. در این سؤالات متداول درباره شرایط Firebase بیشتر بدانید.
برای دستورالعمل های دقیق، به افزودن خدمات Firebase به پروژه خود در راهنمای Firebase مراجعه کنید: "راه اندازی و مدیریت یک پروژه Firebase با استفاده از Management REST API". مطمئن شوید که تمام دستورالعملهای موجود در بخش قبل از شروع آن راهنما را دنبال کنید.
Terraform
API مدیریت Firebase (
firebase.googleapis.com
) را در پروژه Google Cloud موجود فعال کنید.با استفاده از منبع
google_firebase_project
، خدمات Firebase را برای پروژه فعال کنید.اگر قبلاً شرایط Firebase را نپذیرفتهاید، یک پروژه Firebase را در کنسول Firebase باز کنید تا شرایط را بپذیرید. در این سؤالات متداول درباره شرایط Firebase بیشتر بدانید.
برای اطلاعات دقیق درباره استفاده از Firebase و Terraform، به شروع کار با Terraform و Firebase مراجعه کنید.
سوالات متداول و عیب یابی
برای دسترسی و استفاده از همه قابلیتهای Firebase در پروژه Google Cloud ، باید شرایط خدمات Firebase را بپذیرید.
صرف نظر از اینکه به چند پروژه دسترسی دارید ، فقط باید یک بار شرایط Firebase را برای حساب Google خود بپذیرید . وقتی شرایط را می پذیرید، آنها را فقط برای حساب Google خود می پذیرید. پذیرش در سطح پروژه برای همه اعضای پروژه نیست .
با باز کردن پروژه Firebase در کنسول Firebase و پیروی از اعلانهای روی صفحه، شرایط Firebase را میپذیرید.
برای «افزودن Firebase» به پروژه Google Cloud موجود، یکی از اعضای پروژه (یعنی یک اصلی) باید مجوزهای IAM زیر را داشته باشد:
-
firebase.projects.update
-
resourcemanager.projects.get
-
serviceusage.services.enable
-
serviceusage.services.get
نقش های IAM ویرایشگر و مالک به طور پیش فرض حاوی این مجوزها هستند.
همه پروژههای Firebase دارای برچسب firebase:enabled
در صفحه برچسبهای کنسول Google Cloud هستند.
با این حال، فقط افزودن برچسب firebase:enabled
به صورت دستی به لیست برچسبهای پروژه، تنظیمات و سرویسهای خاص Firebase را برای پروژه Google Cloud شما فعال نمیکند. برای انجام این کار، باید Firebase را با استفاده از کنسول Firebase اضافه کنید (یا برای موارد استفاده پیشرفته، با استفاده از Firebase CLI، Firebase Management REST API یا Terraform).
پروژه Firebase یک پروژه Google Cloud است که دارای تنظیمات و سرویسهای اضافی مخصوص Firebase است. بنابراین، وقتی Firebase را به پروژه Google Cloud موجود اضافه میکنید، Firebase اقدامات زیر را برای سادهسازی استفاده از تمام سرویسها و رابطهای Firebase انجام میدهد:
برچسب
firebase:enabled
را در صفحه برچسبهای کنسول Google Cloud اضافه میکند.یک کلید API "مرورگر" ایجاد می کند و آن را به طور خودکار به API های مربوط به Firebase محدود می کند.
حساب های خدمات زیر را ایجاد می کند:
-
service- PROJECT_NUMBER @gcp-sa-firebase.iam.gserviceaccount.com
-
firebase-service-account@firebase-sa-management.iam.gserviceaccount.com
-
firebase-adminsdk- random5chars @ PROJECT_ID .iam.gserviceaccount.com
-
API های زیر را فعال می کند:
- App Engine Admin API
- Cloud Pub/Sub API
- Cloud Resource Manager API
- Cloud Runtime Configuration API
- Cloud Testing API
- Firebase Cloud Messaging API
- Firebase Dynamic Links API
- Firebase Hosting API
- Firebase Installations API
- Firebase Management API
- Firebase Remote Config API
- Firebase Remote Config Realtime API
- Firebase Rules API
- Identity Toolkit API
- Token Service API
پس از «افزودن Firebase» به یک پروژه Google Cloud موجود، آن را نمیتوان لغو کرد (یعنی نمیتوانید Firebase را به طور کامل از پروژه Google Cloud حذف کنید).
فرآیند «افزودن Firebase» APIها و خدمات پشتیبان را فعال میکند که ممکن است برای سایر ویژگیهای Google Cloud استفاده شوند. غیرفعال کردن همه این سرویسهای فعال میتواند باعث عواقب غیرمنتظره و ناخواسته به دلیل وابستگیها شود.
با این حال، در صورت انتخاب، این امکان برای شما وجود دارد که بهصورت دستی همه APIها را غیرفعال کنید و برچسب، کلید API و حسابهای سرویس را که بهطور خودکار فعال و ایجاد شدهاند، هنگام «افزودن Firebase» حذف کنید.
بله، میتوانید امکان «افزودن Firebase» را به پروژه Google Cloud موجود مسدود کنید. در اینجا چند گزینه وجود دارد:
فعال کردن
firebase.googleapis.com
API را با استفاده از محدودیت «محدود کردن Google Cloud APIs and services مجاز» مسدود کنید.اعضای پروژه (یعنی مدیران) که دارای مجوز IAM
firebase.projects.update
هستند را محدود کنید، که برای "افزودن Firebase" لازم است. برای انجام کارآمد این کار می توانید از یک خط مشی رد IAM استفاده کنید.
مراحل بعدی
برای کسب اطلاعات بیشتر در مورد پروژه های Firebase، منابع زیر را بررسی کنید:
پروژههای Firebase را درک کنید — مروری کوتاه بر چندین مفهوم مهم در مورد پروژههای Firebase، از جمله ارتباط آنها با Google Cloud و سلسله مراتب اساسی یک پروژه و برنامهها و منابع آن ارائه میکند.
بهترین روشهای عمومی برای راهاندازی پروژههای Firebase - بهترین روشهای عمومی و سطح بالا را برای راهاندازی پروژههای Firebase و ثبت برنامههای خود در یک پروژه ارائه میکند تا گردش کار توسعه واضحی داشته باشید که از محیطهای متمایز استفاده میکند.
با ثبت برنامه های خود در پروژه Firebase و اتصال آنها به Firebase، استفاده از Firebase را در برنامه های تلفن همراه و وب خود شروع کنید: iOS+ | اندروید | وب | فلاتر | وحدت | C++ .