شروع به کار با Terraform و Firebase
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Firebase درحال شروع پشتیبانی از
Terraform است.
اگر در تیمی هستید که میخواهد ایجاد پروژههای Firebase را با منابع خاص ارائهشده و سرویسهای فعالشده خودکار و استاندارد کند، استفاده از Terraform با Firebase میتواند برای شما مناسب باشد.
گردش کار اصلی برای استفاده از Terraform با Firebase شامل موارد زیر است:
ایجاد و سفارشیسازی فایل پیکربندی Terraform (فایل .tf) که
زیرساختی را که میخواهید تأمین کنید مشخص میکند (یعنی منابعی که
میخواهید تأمین کنید و سرویسهایی که میخواهید فعال کنید).
بااستفاده از فرمانهای gcloud CLI که با Terraform تعامل دارند،
زیرساخت مشخصشده در فایل .tf را فراهم میکند.
با Terraform و Firebase چه کارهایی میتوانید انجام دهید؟
نمونه گردش کار تعمیمیافته در این راهنما
یک پروژه Firebase جدید با برنامه Android ایجاد میکند. اما میتوانید کارهای بسیار بیشتری
با Terraform انجام دهید، ازجمله:
Delete and modify existing infrastructure using Terraform.
مدیریت کردن پیکربندی و تکالیف مختص محصول بااستفاده از Terraform، مثل:
درحال فعال کردن ارائهدهندگان ورود به سیستم Firebase Authentication.
درحال ایجاد کردن Cloud Storage سطل یا نمونه پایگاه داده و استقرار
Firebase Security Rules برای آنها.
درحال ایجاد Firebase App Hosting پسزمینه، ساخت، و دیگر
منابع مرتبط.
میتوانید از فایلها و فرمانهای پیکربندی استاندارد Terraform برای انجام همه این
کارها استفاده کنید. و برای کمک به شما در این زمینه،
نمونه فایلهای پیکربندی Terraform را برای چند مورد استفاده رایج
ارائه کردهایم.
گردش کار تعمیمیافته برای استفاده از Terraform با Firebase
پیشنیازها
این راهنما مقدمهای بر استفاده از Terraform با Firebase است، بنابراین فرض میکند که
مهارت پایهای در Terraform دارید. پیشاز شروع این گردش کار، مطمئن شوید که پیشنیازهای زیر را تکمیل کردهاید.
اگر از حساب کاربری استفاده میکنید، باید «شرایط خدمات Firebase» را پذیرفته باشید. اگر میتوانید پروژه Firebase را در
کنسول Firebase مشاهده کنید،
«شرایط خدمات Firebase» را پذیرفتهاید
برای اینکه Terraform بتواند کنشهای خاصی را انجام دهد (برای مثال، ایجاد پروژهها)،
موارد زیر باید درست باشد:
کاربر یا حساب سرویس باید دسترسی IAM مربوطه را برای
آن کنشها داشته باشد.
اگر کاربر یا حساب سرویس بخشی از سازمان Google Cloud باشد،
خطمشیهای سازمان باید به حساب اجازه دهد این کنشها را انجام دهد.
مرحله ۱: ایجاد و سفارشیسازی کردن فایل پیکربندی Terraform
فایل پیکربندی Terraform به دو بخش اصلی نیاز دارد (که در زیر بهطور مفصل شرح داده شده است):
راهاندازی provider صرفنظر از اینکه کدام محصولات یا سرویسهای Firebase درگیر هستند، الزامی است.
فایل پیکربندی Terraform (مثل فایل main.tf) در فهرست راهنمای محلیتان ایجاد کنید.
در این راهنما، از این فایل پیکربندی برای مشخص کردن هم راهاندازی provider
و هم کل زیرساختی که میخواهید Terraform ایجاد کند استفاده خواهید کرد. اما توجه داشته باشید که گزینههایی برای نحوه گنجاندن راهاندازی ارائهدهنده دارید.
مشاهده گزینههای نحوه
گنجاندن راهاندازی provider
برای نحوه گنجاندن راهاندازی provider در بقیه پیکربندی Terraform، گزینههای زیر را دارید:
گزینه ۱: آن را در بالای یک فایل پیکربندی Terraform .tf تکی قرار دهید (همانطور که در این راهنما نشان داده شده است).
اگر تازه کار با Terraform را شروع کردهاید یا فقط میخواهید Terraform را با Firebase امتحان کنید، از این گزینه استفاده کنید.
گزینه ۲: آن را در فایل .tf جداگانهای (مثل فایل provider.tf) قرار دهید، جدا از فایل .tf که در آن زیرساخت را برای ایجاد مشخص میکنید (مثل فایل main.tf).
اگر عضو تیم بزرگتری هستید که باید راهاندازی را استانداردسازی کند، از این گزینه استفاده کنید.
هنگام اجرای فرمانهای Terraform، هم فایل provider.tf و هم فایل main.tf باید در یک فهرست راهنما باشند.
راهاندازی provider زیر را در بالای فایل main.tf اضافه کنید.
باید از ارائهدهنده google-beta استفاده کنید چون این نسخه بتا برای
استفاده از Firebase با Terraform است. هنگام استفاده در تولید احتیاط کنید.
# Terraform configuration to set up providers by version.terraform{required_providers{google-beta={source="hashicorp/google-beta"version="~> 6.0"}}}# Configures the provider to use the resource block's specified project for quota checks.provider"google-beta"{user_project_override=true}# Configures the provider to not use the resource block's specified project for quota checks.# This provider should only be used during project creation and initializing services.provider"google-beta"{alias="no_user_project_override"user_project_override=false}
هنگام استفاده از Terraform با Firebase، درباره
انواع مختلف مشخصههای مرتبط با پروژه
(ازجمله آنچه این راهنما «پروژه بررسی سهمیه» مینامد) بیشتر بدانید.
برای تکمیل فایل پیکربندی و مشخص کردن زیرساخت موردنظر برای ایجاد، به بخش بعدی بروید.
مشخص کردن اینکه چه زیرساختی بااستفاده از بلوکهای resource ایجاد شود
در فایل پیکربندی Terraform (برای این راهنما، فایل main.tf)، باید تمام زیرساختهایی را که میخواهید Terraform ایجاد کند (یعنی تمام منابعی که میخواهید فراهم کنید و تمام سرویسهایی که میخواهید فعال کنید) مشخص کنید. در
این راهنما، فهرست کامل همه
منابع Firebase که از Terraform پشتیبانی میکنند را پیدا کنید.
فایل main.tf را باز کنید.
در راهاندازی provider، پیکربندی زیر را برای بلوکهای resource
اضافه کنید.
این مثال پایه یک پروژه Firebase جدید ایجاد میکند و سپس یک
برنامه Firebase Android در آن پروژه ایجاد میکند.
# Terraform configuration to set up providers by version....# Configures the provider to use the resource block's specified project for quota checks....# Configures the provider to not use the resource block's specified project for quota checks....# Creates a new Google Cloud project.resource"google_project""default"{provider=google-beta.no_user_project_overridename="Project Display Name"project_id="project-id-for-new-project" # Required for any service that requires the Blaze pricing plan # (like Firebase Authentication with GCIP)billing_account="000000-000000-000000" # Required for the project to display in any list of Firebase projects.labels={"firebase"="enabled"}}# Enables required APIs.resource"google_project_service""default"{provider=google-beta.no_user_project_overrideproject=google_project.default.project_idfor_each=toset(["cloudbilling.googleapis.com","cloudresourcemanager.googleapis.com","firebase.googleapis.com", # Enabling the ServiceUsage API allows the new project to be quota checked from now on."serviceusage.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""default"{provider=google-betaproject=google_project.default.project_id # Waits for the required APIs to be enabled.depends_on=[google_project_service.default]}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""default"{provider=google-betaproject=google_project.default.project_iddisplay_name="My Awesome Android app"package_name="awesome.package.name" # Wait for Firebase to be enabled in the Google Cloud project before creating this App.depends_on=[google_firebase_project.default,]}
مشاهده نسخه بسیار
حاشیهنویسیشده این فایل پیکربندی نمونه
اگر با زیرساخت پروژهها و برنامهها بهعنوان منابع آشنا نیستید، سند زیر را مرور کنید:
# Terraform configuration to set up providers by version....# Configures the provider to use the resource block's specified project for quota checks....# Configures the provider to not use the resource block's specified project for quota checks....# Creates a new Google Cloud project.resource"google_project""default"{ # Use the provider that enables the setup of quota checks for a new projectprovider=google-beta.no_user_project_overridename="Project Display Name" // learn more about the project nameproject_id="project-id-for-new-project" // learn more about the project ID # Required for any service that requires the Blaze pricing plan # (like Firebase Authentication with GCIP)billing_account="000000-000000-000000" # Required for the project to display in any list of Firebase projects.labels={"firebase"="enabled" // learn more about the Firebase-enabled label}}# Enables required APIs.resource"google_project_service""default"{ # Use the provider without quota checks for enabling APISprovider=google-beta.no_user_project_overrideproject=google_project.default.project_idfor_each=toset(["cloudbilling.googleapis.com","cloudresourcemanager.googleapis.com","firebase.googleapis.com", # Enabling the ServiceUsage API allows the new project to be quota checked from now on."serviceusage.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.# This action essentially "creates a Firebase project" and allows the project to use# Firebase services (like Firebase Authentication) and# Firebase tooling (like the Firebase console).# Learn more about the relationship between Firebase projects and Google Cloud.resource"google_firebase_project""default"{ # Use the provider that performs quota checks from now onprovider=google-betaproject=google_project.default.project_id # Waits for the required APIs to be enabled.depends_on=[google_project_service.default]}# Creates a Firebase Android App in the new project created above.# Learn more about the relationship between Firebase Apps and Firebase projects.resource"google_firebase_android_app""default"{provider=google-betaproject=google_project.default.project_iddisplay_name="My Awesome Android app" # learn more about an app's display namepackage_name="awesome.package.name" # learn more about an app's package name # Wait for Firebase to be enabled in the Google Cloud project before creating this App.depends_on=[google_firebase_project.default,]}
مرحله ۲: اجرای فرمانهای Terraform برای ایجاد زیرساخت مشخصشده
برای تأمین منابع و فعال کردن سرویسهای مشخصشده در فایل main.tf،
دستورات زیر را از همان دایرکتوری فایل main.tf اجرا کنید.
برای اطلاعات دقیق درباره این فرمانها،
اسناد Terraform را ببینید.
اگر این اولینباری است که فرمانهای Terraform را در دایرکتوری اجرا میکنید،
باید دایرکتوری پیکربندی را مقداردهی اولیه کنید و ارائهدهنده Google Terraform را
نصب کنید. این کار را با اجرای فرمان زیر انجام دهید:
terraform init
با اجرای فرمان زیر، زیرساخت مشخصشده در فایل main.tf را
ایجاد کنید:
terraform apply
تأیید کنید که همه موارد طبق انتظار آمادهسازی یا فعال شده باشد:
گزینه ۱: با اجرای دستور زیر،
پیکربندی چاپشده در پایانه را ببینید:
terraform show
گزینه ۲: پروژه Firebase خود را در
کنسول Firebase مشاهده کنید.
منابع Firebase با پشتیبانی Terraform
منابع Firebase و Google زیر از Terraform پشتیبانی میکنند. و ما همواره درحال افزودن منابع بیشتر هستیم! بنابراین اگر منبعی را که میخواهید با Terraform مدیریت کنید نمیبینید، بهزودی دوباره بررسی کنید تا ببینید دردسترس است یا نه، یا آن را با
ثبت مشکل در مخزن GitHub درخواست کنید.
google_identity_platform_config —
Google Cloud Identity Platform (GCIP) (که پسای برای Firebase Authentication است) را فعال کنید
و تنظیمات اصالتسنجی سطح پروژه را ارائه دهید
پروژهای که Terraform در آن GCIP و/یا Firebase Authentication را فعال میکند باید در طرح قیمتگذاری Blaze باشد (یعنی پروژه باید حساب Cloud Billing مرتبط داشته باشد). میتوانید این کار را بهصورت برنامهنویسی با تنظیم کردن مشخصه billing_account در منبع google_project انجام دهید.
این منبع همچنین پیکربندیهای بیشتری را فعال میکند، مانند روشهای ورود به سیستم محلی،
مانند اصالتسنجی ناشناس، ایمیل/گذرواژه، و تلفن، و همچنین
توابع مسدودسازی و دامنههای مجاز.
google_firestore_document —
seed a Cloud Firestore instance with a specific document in a collection
مهم: از دادههای واقعی کاربر نهایی یا دادههای تولید در این سند
بذر استفاده نکنید.
Cloud Storage for Firebase
google_firebase_storage_bucket —
دسته Cloud Storage موجود را برای کیتهای توسعه نرمافزار Firebase،
اصالتسنجی، و Firebase Security Rules دردسترس قرار دهید
نمونه فایلهای پیکربندی Terraform برای موارد استفاده رایج
راهاندازی Firebase Authentication با
GCIP
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
پروژه را با حساب Cloud Billing مرتبط میکند (طرح قیمتگذاری Blaze
برای Firebase Authentication با GCIP لازم است)،
سرویسهای Firebase را برای پروژه فعال میکند،
Firebase Authentication را با GCIP راهاندازی میکند،
و سه نوع برنامه مختلف را در پروژه ثبت میکند.
توجه داشته باشید که برای راهاندازی Firebase Authentication ازطریق Terraform، فعال کردن GCIP الزامی است.
# Creates a new Google Cloud project.resource"google_project""auth"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required for Firebase Authentication with GCIP).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""auth"{provider=google-beta.no_user_project_overrideproject=google_project.auth.project_idfor_each=toset(["cloudbilling.googleapis.com","cloudresourcemanager.googleapis.com","serviceusage.googleapis.com","identitytoolkit.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""auth"{provider=google-betaproject=google_project.auth.project_iddepends_on=[google_project_service.auth,]}# Creates an Identity Platform config.# Also enables Firebase Authentication with Identity Platform in the project if not.resource"google_identity_platform_config""auth"{provider=google-betaproject=google_firebase_project.auth.project # Auto-deletes anonymous usersautodelete_anonymous_users=true # Configures local sign-in methods, like anonymous, email/password, and phone authentication.sign_in{allow_duplicate_emails=trueanonymous{enabled=true}email{enabled=truepassword_required=false}phone_number{enabled=truetest_phone_numbers={"+11231231234"="000000"}}} # Sets an SMS region policy.sms_region_config{allowlist_only{allowed_regions=["US","CA",]}} # Configures blocking functions.blocking_functions{triggers{event_type="beforeSignIn"function_uri="https://us-east1-${google_project.auth.project_id}.cloudfunctions.net/before-sign-in"}forward_inbound_credentials{refresh_token=trueaccess_token=trueid_token=true}} # Configures a temporary quota for new signups for anonymous, email/password, and phone number.quota{sign_up_quota_config{quota=1000start_time=""quota_duration="7200s"}} # Configures authorized domains.authorized_domains=["localhost","${google_project.auth.project_id}.firebaseapp.com","${google_project.auth.project_id}.web.app",]}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""auth"{provider=google-betaproject=google_firebase_project.auth.projectdisplay_name="My Android app"package_name="android.package.name"}# Creates a Firebase Apple-platforms App in the new project created above.resource"google_firebase_apple_app""auth"{provider=google-betaproject=google_firebase_project.auth.projectdisplay_name="My Apple app"bundle_id="apple.app.12345"}# Creates a Firebase Web App in the new project created above.resource"google_firebase_web_app""auth"{provider=google-betaproject=google_firebase_project.auth.projectdisplay_name="My Web app"}
ارائه سرویس
Firebase SQL Connect
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند، و
سرویس SQL Connect را فراهم میکند.
# Creates a new Google Cloud project.resource"google_project""dataconnect"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required to use Firebase Data Connect).billing_account="000000-000000-000000" # Required for the project to display in a list of Firebase projects.labels={"firebase"="enabled"}}# Enables required APIs.resource"google_project_service""services"{provider=google-beta.no_user_project_overrideproject=google_project.dataconnect.project_idfor_each=toset(["serviceusage.googleapis.com","cloudresourcemanager.googleapis.com","firebasedataconnect.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created earlier.resource"google_firebase_project""dataconnect"{provider=google-betaproject=google_project.dataconnect.project_iddepends_on=[google_project_service.services]}# Create a Firebase Data Connect serviceresource"google_firebase_data_connect_service""dataconnect-default"{project=google_firebase_project.dataconnect.projectlocation="name-of-region-for-service"service_id="${google_firebase_project.dataconnect.project}-default-fdc"deletion_policy="DEFAULT"}
تأمین کردن
نمونه پیشفرض Firebase Realtime Database
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند،
نمونه Realtime Database پیشفرض پروژه را تأمین میکند،
و سه نوع برنامه مختلف را در پروژه ثبت میکند.
# Creates a new Google Cloud project.resource"google_project""rtdb"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project"}# Enables required APIs.resource"google_project_service""rtdb"{provider=google-beta.no_user_project_overrideproject=google_project.rtdb.project_idfor_each=toset(["serviceusage.googleapis.com","cloudresourcemanager.googleapis.com","firebasedatabase.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""rtdb"{provider=google-betaproject=google_project.rtdb.project_iddepends_on=[google_project_service.rtdb]}# Provisions the default Realtime Database default instance.resource"google_firebase_database_instance""database"{provider=google-betaproject=google_firebase_project.rtdb.project # See available locations: https://firebase.google.com/docs/database/locationsregion="name-of-region" # This value will become the first segment of the database's URL.instance_id="${google_project.rtdb.project_id}-default-rtdb"type="DEFAULT_DATABASE"}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""rtdb"{provider=google-betaproject=google_firebase_project.rtdb.projectdisplay_name="My Android app"package_name="android.package.name"}# Creates a Firebase Apple-platforms App in the new project created above.resource"google_firebase_apple_app""rtdb"{provider=google-betaproject=google_firebase_project.rtdb.projectdisplay_name="My Apple app"bundle_id="apple.app.12345"}# Creates a Firebase Web App in the new project created above.resource"google_firebase_web_app""rtdb"{provider=google-betaproject=google_firebase_project.rtdb.projectdisplay_name="My Web app"}
ارائه دسترسی به چند
نمونه Firebase Realtime Database
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
پروژه را با حساب Cloud Billing مرتبط میکند (طرح قیمتگذاری Blaze
برای چندین نمونه Realtime Database لازم است)،
سرویسهای Firebase را برای پروژه فعال میکند،
چندین نمونه Realtime Database را تأمین میکند
(ازجمله نمونه Realtime Database پیشفرض پروژه)،
و سه نوع برنامه مختلف را در پروژه ثبت میکند.
# Creates a new Google Cloud project.resource"google_project""rtdb-multi"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associate the project with a Cloud Billing account # (required for multiple Realtime Database instances).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""rtdb-multi"{provider=google-beta.no_user_project_overrideproject=google_project.rtdb-multi.project_idfor_each=toset(["cloudbilling.googleapis.com","serviceusage.googleapis.com","cloudresourcemanager.googleapis.com","firebasedatabase.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""rtdb-multi"{provider=google-betaproject=google_project.rtdb-multi.project_iddepends_on=[google_project_service.rtdb-multi]}# Provisions the default Realtime Database default instance.resource"google_firebase_database_instance""database-default"{provider=google-betaproject=google_firebase_project.rtdb-multi.project # See available locations: https://firebase.google.com/docs/database/locationsregion="name-of-region" # This value will become the first segment of the database's URL.instance_id="${google_project.rtdb-multi.project_id}-default-rtdb"type="DEFAULT_DATABASE"}# Provisions an additional Realtime Database instance.resource"google_firebase_database_instance""database-additional"{provider=google-betaproject=google_firebase_project.rtdb-multi.project # See available locations: https://firebase.google.com/docs/projects/locations#rtdb-locations # This location doesn't need to be the same as the default database instance.region="name-of-region" # This value will become the first segment of the database's URL.instance_id="name-of-additional-database-instance"type="USER_DATABASE"}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""rtdb-multi"{provider=google-betaproject=google_firebase_project.rtdb-multi.projectdisplay_name="My Android app"package_name="android.package.name"}# Creates a Firebase Apple-platforms App in the new project created above.resource"google_firebase_apple_app""rtdb-multi"{provider=google-betaproject=google_firebase_project.rtdb-multi.projectdisplay_name="My Apple app"bundle_id="apple.app.12345"}# Creates a Firebase Web App in the new project created above.resource"google_firebase_web_app""rtdb-multi"{provider=google-betaproject=google_firebase_project.rtdb-multi.projectdisplay_name="My Web app"}
تأمین نمونه پیشفرض
Cloud Firestore
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند،
نمونه Cloud Firestore پیشفرض پروژه را فراهم میکند،
و سه نوع برنامه مختلف را در پروژه ثبت میکند.
همچنین Firebase Security Rules را برای نمونه پیشفرض Cloud Firestore فراهم میکند،
نمایه Cloud Firestore ایجاد میکند،
و سند Cloud Firestore را با دادههای اولیه اضافه میکند.
# Creates a new Google Cloud project.resource"google_project""firestore"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project"}# Enables required APIs.resource"google_project_service""firestore"{provider=google-beta.no_user_project_overrideproject=google_project.firestore.project_idfor_each=toset(["cloudresourcemanager.googleapis.com","serviceusage.googleapis.com","firestore.googleapis.com","firebaserules.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""firestore"{provider=google-betaproject=google_project.firestore.project_iddepends_on=[google_project_service.firestore]}# Provisions the Firestore database instance.resource"google_firestore_database""firestore"{provider=google-betaproject=google_firebase_project.firestore.projectname="(default)" # See available locations: https://firebase.google.com/docs/firestore/locationslocation_id="name-of-region" # "FIRESTORE_NATIVE" is required to use Firestore with Firebase SDKs, authentication, and Firebase Security Rules.type="FIRESTORE_NATIVE"concurrency_mode="OPTIMISTIC"}# Creates a ruleset of Firestore Security Rules from a local file.resource"google_firebaserules_ruleset""firestore"{provider=google-betaproject=google_firestore_database.firestore.projectsource{files{name="firestore.rules" # Write security rules in a local file named "firestore.rules". # Learn more: https://firebase.google.com/docs/firestore/security/get-startedcontent=file("firestore.rules")}}}# Releases the ruleset for the Firestore instance.resource"google_firebaserules_release""firestore"{provider=google-betaname="cloud.firestore" # must be cloud.firestoreruleset_name=google_firebaserules_ruleset.firestore.nameproject=google_firestore_database.firestore.project}# Adds a new Firestore index.resource"google_firestore_index""indexes"{provider=google-betaproject=google_firestore_database.firestore.projectcollection="quiz"query_scope="COLLECTION"fields{field_path="question"order="ASCENDING"}fields{field_path="answer"order="ASCENDING"}}# Adds a new Firestore document with seed data.# Don't use real end-user or production data in this seed document.resource"google_firestore_document""doc"{provider=google-betaproject=google_firestore_database.firestore.projectcollection="quiz"document_id="question-1"fields="{\"question\":{\"stringValue\":\"Favorite Database\"},\"answer\":{\"stringValue\":\"Firestore\"}}"}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""firestore"{provider=google-betaproject=google_firebase_project.firestore.projectdisplay_name="My Android app"package_name="android.package.name"}# Creates a Firebase Apple-platforms App in the new project created above.resource"google_firebase_apple_app""firestore"{provider=google-betaproject=google_firebase_project.firestore.projectdisplay_name="My Apple app"bundle_id="apple.app.12345"}# Creates a Firebase Web App in the new project created above.resource"google_firebase_web_app""firestore"{provider=google-betaproject=google_firebase_project.firestore.projectdisplay_name="My Web app"}
این مجموعه قوانین Cloud Firestore Security Rules است که باید در فایل محلی
بهنام firestore.rules باشد.
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /some_collection/{document} {
allow read, create, update: if request.auth != null;
}
}
}
تأمین سطل Cloud Storage پیشفرض
ارائه
Cloud Storage دسته اضافی
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
پروژه را با حساب Cloud Billing مرتبط میکند (طرح قیمتگذاری Blaze
برای دستههای اضافی لازم است)،
سرویسهای Firebase را برای پروژه فعال میکند،
دستههای Cloud Storage اضافی غیرپیشفرض را تأمین میکند،
و سه نوع برنامه مختلف را در پروژه ثبت میکند.
همچنین Firebase Security Rules را برای هر دسته Cloud Storage فراهم میکند،
و فایلی را در یکی از دستههای Cloud Storage بارگذاری میکند.
# Creates a new Google Cloud project.resource"google_project""storage-multi"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required for multiple Cloud Storage buckets).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""storage-multi"{provider=google-beta.no_user_project_overrideproject=google_project.storage-multi.project_idfor_each=toset(["cloudbilling.googleapis.com","serviceusage.googleapis.com","cloudresourcemanager.googleapis.com","firebaserules.googleapis.com","firebasestorage.googleapis.com","storage.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""storage-multi"{provider=google-betaproject=google_project.storage-multi.project_iddepends_on=[google_project_service.storage-multi]}# Provisions a Cloud Storage bucket.resource"google_storage_bucket""bucket-1"{provider=google-betaproject=google_firebase_project.storage-multi.projectname="name-of-storage-bucket" # See available locations: https://cloud.google.com/storage/docs/locations#available-locationslocation="name-of-region-for-bucket"}# Provisions an additional Cloud Storage bucket.resource"google_storage_bucket""bucket-2"{provider=google-betaproject=google_firebase_project.storage-multi.projectname="name-of-additional-storage-bucket" # See available locations: https://cloud.google.com/storage/docs/locations#available-locations # This location does not need to be the same as the existing Storage bucket.location="name-of-region-for-additional-bucket"}# Makes the first Storage bucket accessible for Firebase SDKs, authentication, and Firebase Security Rules.resource"google_firebase_storage_bucket""bucket-1"{provider=google-betaproject=google_firebase_project.storage-multi.projectbucket_id=google_storage_bucket.bucket-1.name}# Makes the additional Storage bucket accessible for Firebase SDKs, authentication, and Firebase Security Rules.resource"google_firebase_storage_bucket""bucket-2"{provider=google-betaproject=google_firebase_project.storage-multi.projectbucket_id=google_storage_bucket.bucket-2.name}# Creates a ruleset of Firebase Security Rules from a local file.resource"google_firebaserules_ruleset""storage-multi"{provider=google-betaproject=google_firebase_project.storage-multi.projectsource{files{ # Write security rules in a local file named "storage.rules" # Learn more: https://firebase.google.com/docs/storage/security/get-startedname="storage.rules"content=file("storage.rules")}}}# Releases the ruleset to the first Storage bucket.resource"google_firebaserules_release""bucket-1"{provider=google-betaname="firebase.storage/${google_storage_bucket.bucket-1.name}"ruleset_name="projects/${google_project.storage-multi.project_id}/rulesets/${google_firebaserules_ruleset.storage-multi.name}"project=google_firebase_project.storage-multi.project}# Releases the ruleset to the additional Storage bucket.resource"google_firebaserules_release""bucket-2"{provider=google-betaname="firebase.storage/${google_storage_bucket.bucket-2.name}"ruleset_name="projects/${google_project.storage-multi.project_id}/rulesets/${google_firebaserules_ruleset.storage-multi.name}"project=google_firebase_project.storage-multi.project}# Uploads a new file to the first Storage bucket.# Do not use real end-user or production data in this file.resource"google_storage_bucket_object""cat-picture-multi"{provider=google-betaname="cat.png"source="path/to/cat.png"bucket=google_storage_bucket.bucket-1.name}# Creates a Firebase Android App in the new project created above.resource"google_firebase_android_app""storage-multi"{provider=google-betaproject=google_firebase_project.storage-multi.projectdisplay_name="My Android app"package_name="android.package.name"}# Creates a Firebase Apple-platforms App in the new project created above.resource"google_firebase_apple_app""storage-multi"{provider=google-betaproject=google_firebase_project.storage-multi.projectdisplay_name="My Apple app"bundle_id="apple.app.12345"}# Creates a Firebase Web App in the new project created above.resource"google_firebase_web_app""storage-multi"{provider=google-betaproject=google_firebase_project.storage-multi.projectdisplay_name="My Web app"}
این مجموعه قوانین Cloud Storage Security Rules است که باید در فایل محلی
بهنام storage.rules باشد.
rules_version = '2';
service firebase.storage {
match /b/{bucket}/o {
match /some_folder/{fileName} {
allow read, write: if request.auth != null;
}
}
}
محافظت از منبع میانای برنامهسازی کاربردی
با Firebase App Check
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند، و
اجرای Firebase App Check را برای Cloud Firestore راهاندازی و فعال میکند
تا فقط ازطریق برنامه Android شما قابلدسترسی باشد.
# Creates a new Google Cloud project.resource"google_project""appcheck"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project"}# Enables required APIs.resource"google_project_service""services"{provider=google-beta.no_user_project_overrideproject=google_project.appcheck.project_idfor_each=toset(["cloudresourcemanager.googleapis.com","firebase.googleapis.com","firebaseappcheck.googleapis.com","firestore.googleapis.com","serviceusage.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created earlier.resource"google_firebase_project""appcheck"{provider=google-betaproject=google_project.appcheck.project_iddepends_on=[google_project_service.services]}# Provisions the Firestore database instance.resource"google_firestore_database""database"{provider=google-betaproject=google_firebase_project.appcheck.projectname="(default)" # See available locations: https://firebase.google.com/docs/projects/locations#default-cloud-locationlocation_id="name-of-region" # "FIRESTORE_NATIVE" is required to use Firestore with Firebase SDKs, authentication, and Firebase Security Rules.type="FIRESTORE_NATIVE"concurrency_mode="OPTIMISTIC"}# Creates a Firebase Android App in the new project created earlier.resource"google_firebase_android_app""appcheck"{provider=google-betaproject=google_firebase_project.appcheck.projectdisplay_name="Play Integrity app"package_name="package.name.playintegrity"sha256_hashes=[ # TODO: insert your Android app's SHA256 certificate]}# Register the Android app with the Play Integrity providerresource"google_firebase_app_check_play_integrity_config""appcheck"{provider=google-betaproject=google_firebase_project.appcheck.projectapp_id=google_firebase_android_app.appcheck.app_iddepends_on=[google_firestore_database.database]lifecycle{precondition{condition=length(google_firebase_android_app.appcheck.sha256_hashes) > 0error_message="Provide a SHA-256 certificate on the Android App to use App Check"}}}# Enable enforcement of App Check for Firestoreresource"google_firebase_app_check_service_config""firestore"{provider=google-betaproject=google_firebase_project.appcheck.projectservice_id="firestore.googleapis.com"depends_on=[google_project_service.services]}
نصب کردن
نمونهای از Firebase Extension
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند، و
نمونه جدیدی از Firebase Extension را
در پروژه نصب میکند. اگر نمونه ازقبل وجود داشته باشد،
پارامترهای آن براساس مقادیر ارائهشده در پیکربندی بهروزرسانی میشود.
# Creates a new Google Cloud project.resource"google_project""extensions"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required to use Firebase Extensions).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""extensions"{provider=google-beta.no_user_project_overrideproject=google_project.extensions.project_idfor_each=toset(["cloudbilling.googleapis.com","cloudresourcemanager.googleapis.com","serviceusage.googleapis.com","firebase.googleapis.com","firebaseextensions.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created above.resource"google_firebase_project""extensions"{provider=google-betaproject=google_project.extensions.project_iddepends_on=[google_project_service.extensions,]}# Installs an instance of the "Translate Text in Firestore" extension.# Or updates the extension if the specified instance already exists.resource"google_firebase_extensions_instance""translation"{provider=google-betaproject=google_firebase_project.extensions.projectinstance_id="translate-text-in-firestore"config{extension_ref="firebase/firestore-translate-text"params={COLLECTION_PATH="posts/comments/translations"DO_BACKFILL=trueLANGUAGES="ar,en,es,de,fr"INPUT_FIELD_NAME="input"LANGUAGES_FIELD_NAME="languages"OUTPUT_FIELD_NAME="translated"}system_params={"firebaseextensions.v1beta.function/location"="us-central1""firebaseextensions.v1beta.function/memory"="256""firebaseextensions.v1beta.function/minInstances"="0""firebaseextensions.v1beta.function/vpcConnectorEgressSettings"="VPC_CONNECTOR_EGRESS_SETTINGS_UNSPECIFIED"}}}
فعال کردن و محافظت از Firebase AI Logic
این پیکربندی پروژه Google Cloud جدیدی ایجاد میکند،
سرویسهای Firebase را برای پروژه فعال میکند، ازجمله Firebase AI Logic، و
اجرای Firebase App Check را برای Firebase AI Logic راهاندازی و فعال میکند تا فقط ازطریق برنامههای شما قابلدسترسی باشد.
# Creates a new Google Cloud project.resource"google_project""vertex"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associate the project with a Cloud Billing account # (required for Vertex AI in Firebase).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""services"{provider=google-beta.no_user_project_overrideproject=google_project.vertex.project_idfor_each=toset(["cloudresourcemanager.googleapis.com","firebase.googleapis.com","serviceusage.googleapis.com", # Required APIs for Vertex AI in Firebase"aiplatform.googleapis.com","firebasevertexai.googleapis.com", # App Check is recommended to protect Vertex AI in Firebase from abuse"firebaseappcheck.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created earlier.resource"google_firebase_project""vertex"{provider=google-betaproject=google_project.vertex.project_iddepends_on=[google_project_service.services]}# Creates a Firebase Web App in the new project created earlier.resource"google_firebase_web_app""app"{provider=google-betaproject=google_firebase_project.vertex.projectdisplay_name="My Web App"}# Creates a Firebase Android App in the new project created earlier.resource"google_firebase_android_app""app"{provider=google-betaproject=google_firebase_project.vertex.projectdisplay_name="My Android App"package_name="package.name.playintegrity"sha256_hashes=[ # TODO: insert your Android app's SHA256 certificate]}# Creates a Firebase Apple App in the new project created earlier.resource"google_firebase_apple_app""app"{provider=google-betaproject=google_firebase_project.vertex.projectdisplay_name="My Apple App"bundle_id="bundle.id"team_id="1234567890"}### Protects Vertex AI in Firebase with App Check.# Turns on enforcement for Vertex AI in Firebaseresource"google_firebase_app_check_service_config""vertex"{provider=google-betaproject=google_firebase_project.vertex.projectservice_id="firebaseml.googleapis.com"enforcement_mode="ENFORCED"}# Enables the reCAPTCHA Enterprise APIresource"google_project_service""recaptcha_enterprise"{provider=google-betaproject=google_firebase_project.vertex.projectservice="recaptchaenterprise.googleapis.com" # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables the Play Integrity APIresource"google_project_service""play_integrity"{provider=google-betaproject=google_firebase_project.vertex.projectservice="playintegrity.googleapis.com" # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Allows the web app to use reCAPTCHA Enterprise with App Checkresource"google_firebase_app_check_recaptcha_enterprise_config""appcheck"{provider=google-betaproject=google_firebase_project.vertex.projectapp_id=google_firebase_web_app.app.app_idsite_key="your site key"token_ttl="7200s" # Optionaldepends_on=[google_project_service.recaptcha_enterprise]}# Registers the Android app with the Play Integrity providerresource"google_firebase_app_check_play_integrity_config""appcheck"{provider=google-betaproject=google_firebase_project.vertex.projectapp_id=google_firebase_android_app.app.app_idtoken_ttl="7200s" # Optionallifecycle{precondition{condition=length(google_firebase_android_app.app.sha256_hashes) > 0error_message="Provide a SHA-256 certificate on the Android App to use App Check"}}depends_on=[google_project_service.play_integrity]}# Registers the Apple app with the AppAttest providerresource"google_firebase_app_check_app_attest_config""appcheck"{provider=google-betaproject=google_firebase_project.vertex.projectapp_id=google_firebase_apple_app.app.app_idtoken_ttl="7200s" # Optionallifecycle{precondition{condition=google_firebase_apple_app.app.team_id!=""error_message="Provide a Team ID on the Apple App to use App Check"}}}
تأمین دستی باطن App Hosting
این پیکربندی نشان میدهد که چگونه بااستفاده از Terraform، یک باطن App Hosting را بهصورت دستی تأمین کنید. این رویکرد به شما کنترل دقیقی بر منابع ایجادشده میدهد، اما لازم است هر منبع را بهصورت جداگانه تعریف کنید. این
گزینه زمانی مفید است که لازم باشد باطن را فراتر از گزینههای پیشفرض سفارشیسازی کنید.
# Creates a new Google Cloud project.resource"google_project""apphosting"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required to use Firebase App Hosting).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""services"{provider=google-beta.no_user_project_overrideproject=google_project.apphosting.project_idfor_each=toset(["cloudresourcemanager.googleapis.com","firebase.googleapis.com","firebaseapphosting.googleapis.com","serviceusage.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created earlier.resource"google_firebase_project""apphosting"{provider=google-betaproject=google_project.apphosting.project_iddepends_on=[google_project_service.services]}# Creates a Firebase Web App in the new project created earlier.resource"google_firebase_web_app""apphosting"{provider=google-betaproject=google_firebase_project.apphosting.projectdisplay_name="My web app"}# Creates a Firebase App Hosting Backendresource"google_firebase_app_hosting_backend""example"{provider=google-betaproject=google_firebase_project.apphosting.project # Choose the region closest to your userslocation="name-of-region-for-service"backend_id="name-of-backend-for-service"app_id=google_firebase_web_app.apphosting.app_iddisplay_name="My Backend"serving_locality="GLOBAL_ACCESS"service_account=google_service_account.service_account.email}# Creates the service account for Firebase App Hostingresource"google_service_account""service_account"{provider=google-betaproject=google_firebase_project.apphosting.project # Must be firebase-app-hosting-computeaccount_id="firebase-app-hosting-compute"display_name="Firebase App Hosting compute service account" # Do not throw if already existscreate_ignore_already_exists=true}# Adds permission to the App Hosting service accountresource"google_project_iam_member""app_hosting_sa"{provider=google-betaproject=google_firebase_project.apphosting.projectfor_each=toset(["roles/firebase.sdkAdminServiceAgent","roles/firebaseapphosting.computeRunner"])role=each.keymember=google_service_account.service_account.member}# Creates a Buildresource"google_firebase_app_hosting_build""example"{provider=google-betaproject=google_firebase_app_hosting_backend.example.projectlocation=google_firebase_app_hosting_backend.example.locationbackend=google_firebase_app_hosting_backend.example.backend_idbuild_id="my-build"source{container{ # TODO: use your own imageimage="us-docker.pkg.dev/cloudrun/container/hello"}}}# Rolls out the Buildresource"google_firebase_app_hosting_traffic""example"{provider=google-betaproject=google_firebase_app_hosting_backend.example.projectlocation=google_firebase_app_hosting_backend.example.locationbackend=google_firebase_app_hosting_backend.example.backend_idtarget{splits{build=google_firebase_app_hosting_build.example.namepercent=100}}}
تدارک دیدن
App Hosting بااستفاده از GitHub
این پیکربندی نشان میدهد که چگونه میتوان بااستفاده از کد برنامه ذخیرهشده در مخزن GitHub،
یک پسوند App Hosting را تأمین کرد. این رویکرد به شما امکان میدهد
زیرساخت خود را ازطریق درخواستهای GitHub pull و خطوط لوله CI/CD
مطابق با مدل معمول برای استقرارهای App Hosting مدیریت و بهروزرسانی کنید.
# Creates a new Google Cloud project.resource"google_project""apphosting"{provider=google-beta.no_user_project_overridefolder_id="folder-id-for-new-project"name="Project Display Name"project_id="project-id-for-new-project" # Associates the project with a Cloud Billing account # (required to use Firebase App Hosting).billing_account="000000-000000-000000"}# Enables required APIs.resource"google_project_service""services"{provider=google-beta.no_user_project_overrideproject=google_project.apphosting.project_idfor_each=toset(["cloudresourcemanager.googleapis.com","firebase.googleapis.com","firebaseapphosting.googleapis.com","serviceusage.googleapis.com","developerconnect.googleapis.com",])service=each.key # Don't disable the service if the resource block is removed by accident.disable_on_destroy=false}# Enables Firebase services for the new project created earlier.resource"google_firebase_project""apphosting"{provider=google-betaproject=google_project.apphosting.project_iddepends_on=[google_project_service.services]}# Creates a Firebase Web App in the new project created earlier.resource"google_firebase_web_app""apphosting"{provider=google-betaproject=google_firebase_project.apphosting.projectdisplay_name="My web app"}### Setting up Firebase App Hosting #### Creates a Firebase App Hosting Backendresource"google_firebase_app_hosting_backend""example"{provider=google-betaproject=google_firebase_project.apphosting.project # Choose the region closest to your userslocation="name-of-region-for-service"backend_id="name-of-backend-for-service"app_id=google_firebase_web_app.apphosting.app_iddisplay_name="My Backend"serving_locality="GLOBAL_ACCESS"service_account=google_service_account.service_account.emailcodebase{repository=google_developer_connect_git_repository_link.my-repository.nameroot_directory="/"}}# Creates the service account for Firebase App Hostingresource"google_service_account""service_account"{provider=google-betaproject=google_firebase_project.apphosting.project # Must be firebase-app-hosting-computeaccount_id="firebase-app-hosting-compute"display_name="Firebase App Hosting compute service account" # Do not throw if already existscreate_ignore_already_exists=true}# Adds permission to the App Hosting service accountresource"google_project_iam_member""app_hosting_sa"{provider=google-betaproject=google_firebase_project.apphosting.projectfor_each=toset(["roles/developerconnect.readTokenAccessor","roles/firebase.sdkAdminServiceAgent","roles/firebaseapphosting.computeRunner"])role=each.keymember=google_service_account.service_account.member}# Configures auto rollout from GitHubresource"google_firebase_app_hosting_traffic""example"{provider=google-betaproject=google_firebase_app_hosting_backend.example.projectlocation=google_firebase_app_hosting_backend.example.locationbackend=google_firebase_app_hosting_backend.example.backend_idrollout_policy{codebase_branch="main" # Or another branch}}###### Setting up a connection to GitHub #### Provisions Service Agent for Developer Connectresource"google_project_service_identity""devconnect-p4sa"{provider=google-betaproject=google_firebase_project.apphosting.projectservice="developerconnect.googleapis.com"}# Adds permission to Developer Connect Service Agent to manager GitHub tokensresource"google_project_iam_member""devconnect-secret"{provider=google-betaproject=google_firebase_project.apphosting.projectrole="roles/secretmanager.admin"member=google_project_service_identity.devconnect-p4sa.member}# Connects to a GitHub accountresource"google_developer_connect_connection""my-connection"{provider=google-betaproject=google_firebase_project.apphosting.project # Must match the google_firebase_app_hosting_backend's locationlocation="name-of-region-for-service" # Must be `firebase-app-hosting-github-oauth`connection_id="firebase-app-hosting-github-oauth"github_config{github_app="FIREBASE"}depends_on=[google_project_iam_member.devconnect-secret]}# Follow the next steps to set up the GitHub connection# Tip: Run terraform refresh to obtain the outputoutput"next_steps"{description="Follow the action_uri if present to continue setup"value=google_developer_connect_connection.my-connection.installation_state}# Links a GitHub repo to the projectresource"google_developer_connect_git_repository_link""my-repository"{provider=google-betaproject=google_firebase_project.apphosting.projectlocation=google_developer_connect_connection.my-connection.locationgit_repository_link_id="my-repo-id"parent_connection=google_developer_connect_connection.my-connection.connection_idclone_uri="https://github.com/myuser/myrepo.git"}###
عیبیابی و پرسشگان
میخواهید
درباره همه مشخصههای مختلف مربوط به پروژه (مثل
project و user_project_override) بیشتر بدانید
این راهنما از مشخصههای Terraform زیر هنگام کار با «پروژهها» استفاده میکند.
project در محدوده resource
توصیه میشود: هرجا ممکن بود، مشخصه project را در هر بلوک resource اضافه کنید
با گنجاندن مشخصه پروژه، Terraform زیرساخت مشخصشده در بلوک منبع را در پروژه مشخصشده ایجاد خواهد کرد. این راهنما و
همه فایلهای پیکربندی نمونه ما از این روال استفاده میکنند.
برای تأمین اکثر منابع، باید از
user_project_override = true استفاده کنید، یعنی سهمیه را درمقابل پروژه Firebase خودتان
بررسی کنید. بااینحال، برای راهاندازی پروژه جدیدتان بهگونهای که بتواند
بررسیهای سهمیه را بپذیرد، ابتدا باید از user_project_override = false استفاده کنید.
این خطا را دریافت میکنید:
generic::permission_denied: Firebase Tos Not Accepted.
مطمئن شوید حساب کاربریای که از آن برای اجرای فرمانهای gcloud CLI استفاده میکنید،
«شرایط خدمات Firebase» را پذیرفته باشد.
میتوانید این بررسی را بااستفاده از مرورگری که به سیستم حساب کاربری وارد شده است انجام دهید و
سعی کنید پروژه Firebase موجودی را در
کنسول Firebase مشاهده کنید. اگر میتوانید پروژه Firebase موجودی را مشاهده کنید، یعنی حساب کاربری «شرایط خدمات Firebase» را پذیرفته است.
اگر نمیتوانید هیچ پروژه Firebase موجودی را مشاهده کنید، احتمالاً حساب کاربری
شرایط خدمات Firebase را نپذیرفته است. برای رفع این مشکل، پروژه Firebase جدیدی
ازطریق کنسول Firebase ایجاد کنید و
«شرایط خدمات Firebase» را بهعنوان بخشی از ایجاد پروژه بپذیرید. میتوانید این پروژه را فوراً ازطریق تنظیمات پروژه در کنسول حذف کنید.
پساز اجرای
terraform apply، این خطا را دریافت میکنید:
generic::permission_denied: IAM authority does not have the
permission.
چند دقیقه صبر کنید و سپس دوباره terraform apply را اجرا کنید.
ایجاد
منبع ناموفق بود، اما وقتی terraform apply را دوباره اجرا میکنید،
ALREADY_EXISTS میگوید.
این امر ممکن است بهدلیل تأخیر انتشار در سیستمهای مختلف باشد. با اجرای terraform import، منبع را به حالت Terraform وارد کنید تا این مشکل برطرف شود. سپس terraform apply را دوباره اجرا کنید.
هنگام کار با
Cloud Firestore، این خطا را دریافت میکنید: Error creating Index: googleapi:
Error 409;...Concurrent access -- try again
همانطور که خطا نشان میدهد، Terraform ممکن است در تلاش برای آمادهسازی چندین نمایه
و/یا ایجاد یک سند بهطور همزمان باشد و با خطای همزمانی مواجه شده باشد.
terraform apply را دوباره اجرا کنید.
این خطا را دریافت میکنید:
"you may need to specify 'X-Goog-User-Project' HTTP header for quota and
billing purposes".
این خطا به این معنی است که Terraform نمیداند سهمیه کدام پروژه را باید بررسی کند. برای عیبیابی، موارد زیر را در بلوک resource بررسی کنید:
مطمئن شوید که مقداری برای مشخصه project تعیین کردهاید.
مطمئن شوید که از ارائهدهنده با user_project_override = true
(بدون نام مستعار) استفاده میکنید، که در نمونههای Firebase google-beta است.
هنگام ایجاد
پروژه Google Cloud جدید، خطایی دریافت میکنید که میگوید شناسه پروژه مشخصشده برای
پروژه جدید ازقبل وجود دارد.
دلایل احتمالی اینکه شناسه پروژه ممکن است ازقبل وجود داشته باشد عبارتند از:
پروژه مرتبط با آن شناسه متعلق به شخص دیگری است.
برای حل مشکل: شناسه پروژه دیگری را انتخاب کنید.
پروژه مرتبط با آن شناسه اخیراً حذف شده است (در وضعیت حذف نرم).
برای حل مشکل: اگر فکر میکنید پروژه مرتبط با شناسه متعلق به شما است،
وضعیت پروژه را بااستفاده از
projects.get REST API بررسی کنید.
پروژه مرتبط با آن شناسه بهدرستی تحت کاربر فعلی وجود دارد. یک
دلیل احتمالی برای این خطا میتواند این باشد که terraform apply قبلی
قطع شده است.
برای حل مشکل: فرمانهای زیر را اجرا کنید: terraform import google_project.default PROJECT_ID
و سپس terraform import google_firebase_project.default PROJECT_ID
چرا باید نمونه پیشفرض Cloud Firestore را قبلاز سطل پیشفرض Cloud Storage تدارک ببینید؟
اگر پیشاز تلاش برای تدارک دیدن نمونه
Cloud Firestore پیشفرض، سطل Cloud Storage پیشفرض را (ازطریق
google_app_engine_application) تدارک دیده باشید، خواهید دید که نمونه
Cloud Firestore پیشفرض ازقبل تدارک دیده شده است. توجه داشته باشید که
نمونه پایگاه داده ارائهشده در حالت Datastore است، یعنی
برای کیتهای توسعه نرمافزار Firebase، اصالتسنجی، یا Firebase Security Rulesقابلدسترسی نیست. اگر میخواهید از
Cloud Firestore با این سرویسهای Firebase استفاده کنید، باید پایگاه داده را خالی کنید و سپس نوع پایگاه داده آن را در
کنسول Google Cloud تغییر دهید.
هنگام تلاش برای تأمین Cloud Storage (ازطریق google_app_engine_application) و سپس نمونه پیشفرض Cloud Firestore، این خطا را دریافت میکنید: Error: Error creating Database: googleapi: Error 409: Database already
exists. Please use another database_id.
وقتی که مخزن پیشفرض Cloud Storage پروژه را (ازطریق
google_app_engine_application) تأمین میکنید و پروژه هنوز نمونه پیشفرض
Cloud Firestore خود را ندارد، google_app_engine_application بهطور خودکار
نمونه پیشفرض Cloud Firestore پروژه را تأمین میکند.
بنابراین، ازآنجاییکه نمونه پیشفرض Cloud Firestore پروژه شما ازقبل
تأمین شده است، اگر بخواهید دوباره آن نمونه پیشفرض را بهطور صریح تأمین کنید، google_firestore_database خطا خواهد داد.
وقتی نمونه پیشفرض Cloud Firestore پروژه تأمین شد، نمیتوانید آن را «دوباره تأمین» کنید یا مکان آن را تغییر دهید. توجه داشته باشید که نمونه پایگاه داده ارائهشده در حالت Datastore است، یعنی برای کیتهای توسعه نرمافزار Firebase، اصالتسنجی، یا Firebase Security Rules قابلدسترسی نیست. اگر میخواهید از Cloud Firestore
با این سرویسهای Firebase استفاده کنید، باید پایگاه داده را خالی کنید و سپس
نوع پایگاه داده آن را در
کنسول Google Cloud تغییر دهید.
تاریخ آخرین بهروزرسانی 2026-11-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-11-10 بهوقت ساعت هماهنگ جهانی."],[],[]]