در مورد مکان های محصولات و منابع پروژه خود بیاموزید

محصولات یا منابعی که نیاز به تنظیم مکان دارند

چندین محصول یا منبع نیاز به تنظیم مکان دارند.

محصول موقعیت مکانی پیش فرض اطلاعات تکمیلی
Google Analytics مکان پیش فرض وجود ندارد.
شما باید این مکان را تنظیم کنید.		 این مکان، مکان گزارش Analytics 2 است که نشان دهنده کشور یا منطقه سازمان شما است. مکان گزارش Analytics شما به نوبه خود، ارز را برای گزارش درآمد تعیین می کند.
Firebase App Hosting مکان پیش فرض وجود ندارد.
شما باید این مکان را برای هر باطن تنظیم کنید.		 این مکان جایی است که استقرار App Hosting هر یک از منابع باطن شما را ایجاد می کند.
هر بک‌اند می‌تواند در یک مکان متفاوت باشد.
Data Connect مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Cloud Firestore 1 مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Realtime Database مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Cloud Storage for Firebase 1 مکان پیش فرض وجود ندارد.
باید مکان هر سطل را تعیین کنید.		 هر سطل می تواند در یک مکان متفاوت باشد.
Cloud Functions for Firebase 1 اگر مکان تنظیم نشده باشد، منطقه پیش فرض است us-central1 . هر تابع می تواند در یک مکان متفاوت باشد.
Vertex AI in Firebase اگر مکان تنظیم نشده باشد، منطقه پیش فرض است us-central1 . این مکان جایی است که سرویس Vertex AI اجرا می شود و جایی است که شما به مدل دسترسی دارید.

1 بسته به زمانی که در ابتدا استفاده از این محصولات را در پروژه خود شروع کرده اید، ممکن است وابستگی های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی به مکان بیشتر بیاموزید.

2 مکان گزارش Analytics شما بر جایی که Google ممکن است داده های مشتری را برای Firebase پردازش و ذخیره کند، تأثیری ندارد .

مکانی را برای یک محصول یا منابع آن تعیین کنید

برای چند محصول، مکان را در سطح محصول تنظیم می کنید. با این حال، برای اکثر محصولات، مکان را در سطح منبع تنظیم می کنید (به عنوان مثال، برای هر سطل Cloud Storage یا هر عملکرد).

محصول زمان و نحوه تنظیم مکان مکان های موجود
Google Analytics وقتی Google Analytics در پروژه Firebase خود در کنسول Firebase فعال می‌کنید، از شما خواسته می‌شود که یک مکان گزارش Analytics را انتخاب کنید. شما باید کشور یا منطقه ای را انتخاب کنید که نشان دهنده مکان سازمان شما باشد.

اگر مالک یا ویرایشگر پروژه هستید، می‌توانید بعداً منطقه زمانی و واحد پول محل گزارش آنالیتیکس خود را ویرایش کنید. به تنظیمات Google Analytics خود بروید، سپس به صفحه گزارش بروید.

 لیست را در تنظیمات Google Analytics > صفحه گزارش مشاهده کنید.
App Hosting هنگامی که یک برنامه پشتیبان App Hosting ایجاد می کنید، از شما خواسته می شود یک مکان را انتخاب کنید. می‌توانید از کنسول Firebase ، REST API یا Firebase CLI برای ایجاد یک Backend استفاده کنید. مکان های App Hosting
Data Connect هنگامی که یک نمونه سرویس Data Connect را ارائه می کنید، مکان های آن را تنظیم می کنید. همچنین مکان نمونه Google Cloud SQL مرتبط را تنظیم می‌کنید.
می توانید از کنسول Firebase یا Firebase CLI برای ارائه یک نمونه استفاده کنید.		 خدمات Data Connect و مکان‌های نمونه Cloud SQL
Cloud Firestore 1 هنگامی که یک نمونه پایگاه داده Cloud Firestore را ارائه می کنید، مکان آن را تنظیم می کنید. می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای ارائه یک نمونه استفاده کنید. مکان‌های Cloud Firestore
Realtime Database وقتی نمونه Realtime Database را ارائه می کنید، مکان آن را تنظیم می کنید.
می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای ارائه یک نمونه استفاده کنید.		 مکان های Realtime Database
Cloud Storage for Firebase 1 وقتی سطل Cloud Storage را تهیه می کنید، مکان آن را تعیین می کنید.
می‌توانید از کنسول Firebase ، REST API یا Terraform برای تهیه یک سطل استفاده کنید.		 Cloud Storage for Firebase
Cloud Functions for Firebase 1 هنگامی که یک تابع را می نویسید، می توانید به صورت اختیاری منطقه آن را تنظیم کنید.

اگر مکانی را مشخص نکنید، منطقه پیش فرض است us-central1 .

 Cloud Functions for Firebase
Vertex AI in Firebase وقتی سرویس Vertex AI و مدل مولد را در پایگاه کد خود مقداردهی اولیه می کنید، می توانید به صورت اختیاری یک مکان را مشخص کنید.

اگر مکانی را مشخص نکنید، منطقه پیش فرض است us-central1 .

 Vertex AI in Firebase

1 بسته به زمانی که در ابتدا استفاده از این محصولات را در پروژه خود شروع کرده اید، ممکن است وابستگی های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی به مکان بیشتر بیاموزید.

تنظیمات مکان را مشاهده کنید

محصول محل مشاهده تنظیمات مکان
Google Analytics در کنسول Firebase ، به Project settings > Integrations > Google Analytics بروید. روی شماره حساب کلیک کنید تا حساب Google Analytics خود باز شود و سپس به پنل مدیریت بروید تا اطلاعات موقعیت مکانی حساب خود را پیدا کنید.
Data Connect در کنسول Firebase ، به صفحه Data Connect بروید تا لیست نمونه های پایگاه داده خود و مکان آنها را مشاهده کنید.
App Hosting
  • در کنسول Firebase ، به صفحه App Hosting بروید تا لیستی از باطن‌ها و مکان‌های آنها را مشاهده کنید.
  • برای مشاهده مکان یک باطن خاص، می توانید از دستور Firebase CLI استفاده کنید firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Cloud Firestore در کنسول Firebase ، به برگه Cloud Firestore Data بروید تا لیست نمونه های پایگاه داده خود و مکان آنها را مشاهده کنید.
Realtime Database در کنسول Firebase ، به تب Realtime Database Data بروید تا لیست نمونه های پایگاه داده خود و مکان های آنها را مشاهده کنید.
Cloud Storage for Firebase در کنسول Firebase ، به تب Cloud Storage Files بروید تا لیست سطل های خود و مکان آنها را مشاهده کنید.
Cloud Functions for Firebase
  • توابع زمان بندی شده: در کنسول Google Cloud ، به Cloud Scheduler بروید تا لیست موضوعات مربوط به هر کار و عملکرد را مشاهده کنید. مکان آخرین بخش از نام موضوع است.
  • توابع غیر برنامه ریزی شده: در کد منبع تابع خود، به دنبال پارامتر region باشید. اگر منطقه ای مشخص نشده باشد، مکان پیش فرض است us-central1 .
Vertex AI in Firebase در پایگاه کد خود، به دنبال مقداردهی اولیه سرویس Vertex AI و مدل مولد باشید. اگر مکانی مشخص نشده باشد، مکان پیش فرض است us-central1 .

وابستگی‌های احتمالی موقعیت مکانی به دلیل «مکان منابع پیش‌فرض Google Cloud»

«مکان منابع پیش‌فرض Google Cloud » تنظیم مکان برای هر منبع پروژه مرتبط با Google App Engine است، از جمله موارد زیر:

  • نمونه پایگاه داده پیش فرض Cloud Firestore
  • پیش‌فرض Cloud Storage برای سطل Firebase با فرمت نام *.appspot.com
  • Google Cloud Scheduler به طور خاص با توابع برنامه ریزی شده نسل اول استفاده می شود

این «مکان منابع پیش‌فرض Google Cloud » یک تنظیم غیرقابل تغییر است. همچنین، هنگامی که مکان یکی از منابع مرتبط را تنظیم می کنید، به دلیل ارتباط مشترک آنها با App Engine به طور غیر مستقیم مکان را برای همه آنها تنظیم می کنید.

با این حال، با تغییرات بسیاری در اکوسیستم Firebase و Google Cloud در طول سال‌ها، ارتباط منابع با App Engine تغییر کرده است. مهم‌تر از همه، از 30 اکتبر 2024 ، همه Cloud Storage پیش‌فرض جدید برای سطل‌های Firebase دارای قالب نام هستند. *.firebasestorage.app ، و با App Engine مرتبط نیستند .

در اینجا جزئیات تغییراتی در وابستگی‌های مکان احتمالی وجود دارد:

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore و پیش‌فرض Cloud Storage برای سطل Firebase هنوز ارائه نشده باشد:

    • تهیه نمونه پیش‌فرض Cloud Firestore مکان هر برنامه App Engine آینده را که در پروژه ارائه می‌شود، تعیین می‌کند. با این حال، مکان سطل Cloud Storage پیش فرض آینده را تعیین نمی کند.

    • تهیه سطل پیش‌فرض Cloud Storage دیگر برنامه App Engine را ارائه نمی‌کند . بنابراین، مکان سطل پیش‌فرض Cloud Storage مکان نمونه پیش‌فرض Cloud Firestore آینده را تعیین نمی‌کند .

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore قبلاً ارائه شده باشد، اما پیش‌فرض Cloud Storage برای سطل Firebase ارائه نشده باشد:

    • نمونه پیش‌فرض Cloud Firestore مکان سطل Cloud Storage پیش‌فرض آینده را تعیین نمی‌کند ( *.firebasestorage.app ).

  • از 30 اکتبر 2024 ، اگر Cloud Storage پیش‌فرض برای سطل Firebase قبلاً ارائه شده باشد (به ویژه، *.appspot.com سطل) ، اما نمونه پیش‌فرض Cloud Firestore ارائه نشده است:

    • زمانی که سطل پیش‌فرض Cloud Storage ابری ( *.appspot.com ) ارائه شد، یک برنامه App Engine نیز ارائه شد، و بنابراین مکان نمونه پیش‌فرض Cloud Firestore در آن زمان تنظیم شد. حتی اگر آن را حذف کنید سطل *.appspot.com ، نمی‌توانید برنامه App Engine را حذف کنید، بنابراین تنظیمات مکان نمونه پیش‌فرض Cloud Firestore در آینده تنظیم شده است.

اگر از توابع برنامه‌ریزی‌شده نسل اول استفاده کرده‌اید، مکان آن‌ها روی مکان منابع پیش‌فرض Google Cloud تنظیم می‌شود. این به این دلیل است که Cloud Scheduler و App Engine قبلاً با یکدیگر ارتباط داشتند. همچنین، اگر توابع برنامه‌ریزی‌شده نسل اول را قبل از تهیه منابع دیگری که این تنظیمات مکان را به اشتراک می‌گذارند تنظیم کنید، مکان آنها را نیز تنظیم می‌کنید.

مراحل بعدی

  • برای اطلاعات بیشتر در مورد ساخت برنامه‌های کاربردی برای برآوردن نیازهای تأخیر، در دسترس بودن و دوام شما، به جغرافیا و مناطق مراجعه کنید.
،

محصولات یا منابعی که نیاز به تنظیم مکان دارند

چندین محصول یا منبع نیاز به تنظیم مکان دارند.

محصول موقعیت مکانی پیش فرض اطلاعات تکمیلی
Google Analytics مکان پیش فرض وجود ندارد.
شما باید این مکان را تنظیم کنید.		 این مکان، مکان گزارش Analytics 2 است که نشان دهنده کشور یا منطقه سازمان شما است. مکان گزارش Analytics شما به نوبه خود، ارز را برای گزارش درآمد تعیین می کند.
Firebase App Hosting مکان پیش فرض وجود ندارد.
شما باید این مکان را برای هر باطن تنظیم کنید.		 این مکان جایی است که استقرار App Hosting هر یک از منابع باطن شما را ایجاد می کند.
هر بک‌اند می‌تواند در یک مکان متفاوت باشد.
Data Connect مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Cloud Firestore 1 مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Realtime Database مکان پیش فرض وجود ندارد.
شما باید مکان را برای هر نمونه تنظیم کنید.		 هر نمونه می تواند در یک مکان متفاوت باشد.
Cloud Storage for Firebase 1 مکان پیش فرض وجود ندارد.
باید مکان هر سطل را تعیین کنید.		 هر سطل می تواند در یک مکان متفاوت باشد.
Cloud Functions for Firebase 1 اگر مکان تنظیم نشده باشد، منطقه پیش فرض است us-central1 . هر تابع می تواند در یک مکان متفاوت باشد.
Vertex AI in Firebase اگر مکان تنظیم نشده باشد، منطقه پیش فرض است us-central1 . این مکان جایی است که سرویس Vertex AI اجرا می شود و جایی است که شما به مدل دسترسی دارید.

1 بسته به زمانی که در ابتدا استفاده از این محصولات را در پروژه خود شروع کرده اید، ممکن است وابستگی های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی به مکان بیشتر بیاموزید.

2 مکان گزارش Analytics شما بر جایی که Google ممکن است داده های مشتری را برای Firebase پردازش و ذخیره کند، تأثیری ندارد .

مکانی را برای یک محصول یا منابع آن تعیین کنید

برای چند محصول، مکان را در سطح محصول تنظیم می کنید. با این حال، برای اکثر محصولات، مکان را در سطح منبع تنظیم می کنید (به عنوان مثال، برای هر سطل Cloud Storage یا هر عملکرد).

محصول زمان و نحوه تنظیم مکان مکان های موجود
Google Analytics وقتی Google Analytics در پروژه Firebase خود در کنسول Firebase فعال می‌کنید، از شما خواسته می‌شود که یک مکان گزارش Analytics را انتخاب کنید. شما باید کشور یا منطقه ای را انتخاب کنید که نشان دهنده مکان سازمان شما باشد.

اگر مالک یا ویرایشگر پروژه هستید، می‌توانید بعداً منطقه زمانی و واحد پول محل گزارش آنالیتیکس خود را ویرایش کنید. به تنظیمات Google Analytics خود بروید، سپس به صفحه گزارش بروید.

 لیست را در تنظیمات Google Analytics > صفحه گزارش مشاهده کنید.
App Hosting هنگامی که یک برنامه پشتیبان App Hosting ایجاد می کنید، از شما خواسته می شود یک مکان را انتخاب کنید. می‌توانید از کنسول Firebase ، REST API یا Firebase CLI برای ایجاد یک Backend استفاده کنید. مکان های App Hosting
Data Connect هنگامی که یک نمونه سرویس Data Connect را ارائه می کنید، مکان های آن را تنظیم می کنید. همچنین مکان نمونه Google Cloud SQL مرتبط را تنظیم می‌کنید.
می توانید از کنسول Firebase یا Firebase CLI برای ارائه یک نمونه استفاده کنید.		 خدمات Data Connect و مکان‌های نمونه Cloud SQL
Cloud Firestore 1 هنگامی که یک نمونه پایگاه داده Cloud Firestore را ارائه می کنید، مکان آن را تنظیم می کنید. می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای ارائه یک نمونه استفاده کنید. مکان‌های Cloud Firestore
Realtime Database وقتی نمونه Realtime Database را ارائه می کنید، مکان آن را تنظیم می کنید.
می‌توانید از کنسول Firebase ، REST API، Firebase CLI یا Terraform برای ارائه یک نمونه استفاده کنید.		 مکان های Realtime Database
Cloud Storage for Firebase 1 وقتی سطل Cloud Storage را تهیه می کنید، مکان آن را تعیین می کنید.
می‌توانید از کنسول Firebase ، REST API یا Terraform برای تهیه یک سطل استفاده کنید.		 Cloud Storage for Firebase
Cloud Functions for Firebase 1 هنگامی که یک تابع را می نویسید، می توانید به صورت اختیاری منطقه آن را تنظیم کنید.

اگر مکانی را مشخص نکنید، منطقه پیش فرض است us-central1 .

 Cloud Functions for Firebase
Vertex AI in Firebase وقتی سرویس Vertex AI و مدل مولد را در پایگاه کد خود مقداردهی اولیه می کنید، می توانید به صورت اختیاری یک مکان را مشخص کنید.

اگر مکانی را مشخص نکنید، منطقه پیش فرض است us-central1 .

 Vertex AI in Firebase

1 بسته به زمانی که در ابتدا استفاده از این محصولات را در پروژه خود شروع کرده اید، ممکن است وابستگی های مکانی بین این محصولات وجود داشته باشد. ممکن است این وابستگی را به عنوان «مکان منابع پیش‌فرض Google Cloud » ببینید. درباره این وابستگی به مکان بیشتر بیاموزید.

مشاهده تنظیمات مکان

محصول محل مشاهده تنظیمات مکان
Google Analytics در کنسول Firebase ، به Project settings > Integrations > Google Analytics بروید. روی شماره حساب کلیک کنید تا حساب Google Analytics خود باز شود و سپس به پنل مدیریت بروید تا اطلاعات موقعیت مکانی حساب خود را پیدا کنید.
Data Connect در کنسول Firebase ، به صفحه Data Connect بروید تا لیست نمونه های پایگاه داده خود و مکان آنها را مشاهده کنید.
App Hosting
  • در کنسول Firebase ، به صفحه App Hosting بروید تا لیستی از باطن‌ها و مکان‌های آنها را مشاهده کنید.
  • برای مشاهده مکان یک باطن خاص، می توانید از دستور Firebase CLI استفاده کنید firebase apphosting:backends:get --project PROJECT_ID BACKEND_ID
Cloud Firestore در کنسول Firebase ، به برگه Cloud Firestore Data بروید تا لیست نمونه های پایگاه داده خود و مکان آنها را مشاهده کنید.
Realtime Database در کنسول Firebase ، به تب Realtime Database Data بروید تا لیست نمونه های پایگاه داده خود و مکان های آنها را مشاهده کنید.
Cloud Storage for Firebase در کنسول Firebase ، به تب Cloud Storage Files بروید تا لیست سطل های خود و مکان آنها را مشاهده کنید.
Cloud Functions for Firebase
  • توابع زمان بندی شده: در کنسول Google Cloud ، به Cloud Scheduler بروید تا لیست موضوعات مربوط به هر کار و عملکرد را مشاهده کنید. مکان آخرین بخش از نام موضوع است.
  • توابع غیر برنامه ریزی شده: در کد منبع تابع خود، به دنبال پارامتر region باشید. اگر منطقه ای مشخص نشده باشد، مکان پیش فرض است us-central1 .
Vertex AI in Firebase در پایگاه کد خود، به دنبال مقداردهی اولیه سرویس Vertex AI و مدل مولد باشید. اگر مکانی مشخص نشده باشد، مکان پیش فرض است us-central1 .

وابستگی‌های احتمالی موقعیت مکانی به دلیل «مکان منابع پیش‌فرض Google Cloud»

«مکان منابع پیش‌فرض Google Cloud » تنظیم مکان برای هر منبع پروژه مرتبط با Google App Engine است، از جمله موارد زیر:

  • نمونه پایگاه داده پیش فرض Cloud Firestore
  • پیش‌فرض Cloud Storage برای سطل Firebase با فرمت نام *.appspot.com
  • Google Cloud Scheduler به طور خاص با توابع برنامه ریزی شده نسل اول استفاده می شود

این «مکان منابع پیش‌فرض Google Cloud » یک تنظیم غیرقابل تغییر است. همچنین، هنگامی که مکان یکی از منابع مرتبط را تنظیم می کنید، به دلیل ارتباط مشترک آنها با App Engine به طور غیر مستقیم مکان را برای همه آنها تنظیم می کنید.

با این حال، با تغییرات بسیاری در اکوسیستم Firebase و Google Cloud در طول سال‌ها، ارتباط منابع با App Engine تغییر کرده است. مهم‌تر از همه، از 30 اکتبر 2024 ، همه Cloud Storage پیش‌فرض جدید برای سطل‌های Firebase دارای قالب نام هستند. *.firebasestorage.app ، و با App Engine مرتبط نیستند .

در اینجا جزئیات تغییراتی در وابستگی‌های مکان احتمالی وجود دارد:

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore و پیش‌فرض Cloud Storage برای سطل Firebase هنوز ارائه نشده باشد:

    • تهیه نمونه پیش‌فرض Cloud Firestore مکان هر برنامه App Engine آینده را که در پروژه ارائه می‌شود، تعیین می‌کند. با این حال، مکان سطل Cloud Storage پیش فرض آینده را تعیین نمی کند.

    • تهیه سطل پیش‌فرض Cloud Storage دیگر برنامه App Engine را ارائه نمی‌کند . بنابراین، مکان سطل پیش‌فرض Cloud Storage مکان نمونه پیش‌فرض Cloud Firestore آینده را تعیین نمی‌کند .

  • از 30 اکتبر 2024 ، اگر نمونه پیش‌فرض Cloud Firestore قبلاً ارائه شده باشد، اما پیش‌فرض Cloud Storage برای سطل Firebase ارائه نشده باشد:

    • نمونه پیش‌فرض Cloud Firestore مکان سطل Cloud Storage پیش‌فرض آینده را تعیین نمی‌کند ( *.firebasestorage.app ).

  • از 30 اکتبر 2024 ، اگر Cloud Storage پیش‌فرض برای سطل Firebase قبلاً ارائه شده باشد (به ویژه، *.appspot.com سطل) ، اما نمونه پیش‌فرض Cloud Firestore ارائه نشده است:

    • زمانی که سطل پیش‌فرض Cloud Storage ابری ( *.appspot.com ) ارائه شد، یک برنامه App Engine نیز ارائه شد، و بنابراین مکان نمونه پیش‌فرض Cloud Firestore در آن زمان تنظیم شد. حتی اگر آن را حذف کنید سطل *.appspot.com ، نمی‌توانید برنامه App Engine را حذف کنید، بنابراین تنظیمات مکان نمونه پیش‌فرض Cloud Firestore در آینده تنظیم شده است.

اگر از توابع برنامه‌ریزی‌شده نسل اول استفاده کرده‌اید، مکان آن‌ها روی مکان منابع پیش‌فرض Google Cloud تنظیم می‌شود. این به این دلیل است که Cloud Scheduler و App Engine قبلاً با یکدیگر ارتباط داشتند. همچنین، اگر توابع برنامه‌ریزی‌شده نسل اول را قبل از تهیه منابع دیگری که این تنظیمات مکان را به اشتراک می‌گذارند تنظیم کنید، مکان آنها را نیز تنظیم می‌کنید.

مراحل بعدی

  • برای اطلاعات بیشتر در مورد ساخت برنامه‌های کاربردی برای برآوردن نیازهای تأخیر، در دسترس بودن و دوام شما، به جغرافیا و مناطق مراجعه کنید.