شروع به کار با Application Design Center (ADC) و Firebase

Firebase با Application Design Center (ADC) از Google Cloud ادغام می‌شود تا به مشتریان سازمانی اجازه دهد نیازهای استانداردسازی و حاکمیت را برآورده کنند و درعین‌حال توسعه‌دهندگان نرم‌افزار خود را توانمند سازند تا با سرعت ارسال کنند. استفاده از ADC تضمین می‌کند که زیرساخت ازطریق الگوهای ازپیش‌تعریف‌شده که حفاظ‌هایی را برای تأمین منابع، اعطای اجازه‌های IAM، و غیره تعریف می‌کنند، از استانداردهای سازمانی و روال‌های مطلوب پیروی می‌کند.

در این صفحه، با موارد زیر آشنا می‌شوید:

نمای کلی ADC و Firebase

توصیه می‌کنیم برای دریافت نمای کلی ADC، اسناد Google Cloud را مرور کنید. اسناد Google Cloud همچنین چندین راهنمای عمیق برای ADC ارائه می‌دهد، ازجمله مفاهیم کلیدی و راهنمای راه‌اندازی اولیه.

هنگام استفاده از ADC، «برنامه» به‌عنوان گروه‌بندی منطقی منابع و سرویس‌هایی تعریف می‌شود که باهم عملکردی تجاری را ارائه می‌دهند. برای توسعه‌دهندگان Firebase، می‌توانید ADC «برنامه» را معادل پروژه Firebase درنظر بگیرید، که در آن برنامه‌های iOS،‏ Android، و وب ثبت‌شده شما همگی به منابع و سرویس‌های یکسان برای پروژه دسترسی دارند و آن‌ها را هم‌رسانی می‌کنند.

برای شروع، توصیه می‌کنیم با ADC بااستفاده از تجربه GUI آن‌ها به‌نام بوم طراحی که در کنسول Google Cloud دردسترس است کار کنید. بوم طراحی به شما امکان می‌دهد نمودارهای معماری زیرساختی را که می‌خواهید برای برنامه‌هایتان دردسترس باشد تجسم و ایجاد کنید.

توجه داشته باشید که ADC توسط Terraform پشتیبانی می‌شود، بنابراین همیشه به تعریف کد زیرساختی که بااستفاده از ADC تعریف شده است دسترسی خواهید داشت.

محصولات Firebase پشتیبانی‌شده

در اینجا مجموعه اولیه محصولات Firebase پشتیبانی‌شده که می‌توانند با ADC استفاده شوند آورده شده است:

شخصیت‌های کلیدی برای استفاده از ADC

یک روش رایج برای درک و استفاده از ADC این است که تکالیف مرتبط با ADC را براساس دو شخصیت تقسیم کنید:

  • مهندس پلاتفرم: این شخصیت الگوهای ADC قابل‌استفاده مجدد و با اجرای خط‌مشی را طراحی، درستی‌سنجی، و در کاتالوگ ADC منتشر می‌کند.

  • توسعه‌دهنده برنامه: این شخصیت از الگوهای منتشرشده ADC (مثلاً از کاتالوگ تیم ADC) برای پیکربندی و استقرار زیرساخت استفاده می‌کند. آن‌ها همچنین پایگاه کد و ویژگی‌های واقعی برنامه را توسعه می‌دهند.

نقش‌های IAM لازم برای کنترل دسترسی

با واگذاری نقش‌های IAM، می‌توانید کنترل کنید کدام‌یک از اعضای پروژه (یا اصول) می‌توانند کارهای خاصی را انجام دهند.

برای مثال، می‌توانید نقش سرپرست مرکز طراحی برنامه (roles/designcenter.admin) را به «مهندس پلاتفرم» که باید فضاها را ایجاد و اختصاص دهد، کاتالوگ‌ها را مدیریت کند، و الگوها را طراحی کند اختصاص دهید. بااین‌حال، احتمالاً فقط نقش ویرایشگر برنامه (roles/designcenter.applicationEditor) را به «توسعه‌دهنده برنامه» اختصاص می‌دهید تا بتواند از الگوها استفاده کند، اما نتواند الگو ایجاد کند.

جدول زیر تکالیف مربوط به ADC، شخصیت موردنظر آن‌ها، و نقش‌های الزامی آن‌ها را شرح می‌دهد:

تکلیف شخصیت نقش IAM ۱
ایجاد و مدیریت الگوها
مدیریت کل ADCچرخه حیات
(ازجمله مدیریت فضاها، کاتالوگ‌ها، الگوها، پیکربندی و استقرار برنامه‌ها)
مهندس پلاتفرم سرپرست Application Design Center
(roles/designcenter.admin) در پروژه مدیریت
ایجاد و مدیریت الگوها و همچنین پیکربندی و استقرار برنامه‌ها مهندس پلاتفرم کاربر Application Design Center
(roles/designcenter.user) در پروژه مدیریت
ایجاد حساب سرویس برای استقرار ADC برنامه‌ها
ایجاد حساب‌های خدمات مهندس پلاتفرم ایجاد حساب‌های سرویس
(roles/iam.serviceAccountCreator) در پروژه مدیریت
اعطای دسترسی حساب سرویس به پروژه مورداستفاده برای ADC استقرار مهندس پلاتفرم سرپرست IAM پروژه
(roles/resourcemanager.projectIamAdmin) در پروژه استقرار
پیکربندی و استقرار ADC برنامه‌ها
کنترل کل چرخه حیات برنامه
(ازجمله ادغام با کد منبع و سیستم‌های CI/CD)
توسعه‌دهنده نرم‌افزار سرپرست برنامه
(roles/designcenter.applicationAdmin) در پروژه مدیریت
پیکربندی و استقرار برنامه‌ها براساس الگوها و اتصالات موجود راه‌اندازی‌شده توسط سرپرست توسعه‌دهنده نرم‌افزار ویرایشگر برنامه
(roles/designcenter.applicationEditor) در پروژه مدیریت

۱ چند مورد از این نقش‌ها باید در پروژه مدیریت تنظیم شود، که منبعی در سطح بالا در سلسله‌مراتب Google Cloud است.

گردش کار عمومی

این بخش گردش کار کلی برای ایجاد و استفاده از الگوی ADC را شرح می‌دهد. مراحل با شخصیتی که معمولاً آن مرحله را انجام می‌دهد برچسب‌گذاری شده است.

  1. مرحله ۱: راه‌اندازی ADC (مهندس پلاتفرم)
  2. مرحله ۲: ایجاد الگو (مهندس پلاتفرم)
  3. مرحله ۳: استفاده از الگو (توسعه‌دهنده نرم‌افزار)
  4. مرحله ۴: توسعه برنامه واقعی (توسعه‌دهنده برنامه)

مرحله ۱: راه‌اندازی ADC (مهندس پلاتفرم)

شخصیت «مهندس پلاتفرم» (یا بالاتر) این تکالیف را برای راه‌اندازی ADC تکمیل می‌کند. این تکالیف معمولاً فقط یک‌بار باید تکمیل شوند تا همه‌چیز برای استفاده از ADC راه‌اندازی شود.

  1. راه‌اندازی اولیه ADC.

    مراحل و راهنمایی‌های موجود در راهنمای راه‌اندازی اولیه برای ADC را در اسناد Google Cloud دنبال کنید. توجه داشته باشید که این راهنما فرض می‌کند که شما مرزهای سطح پوشه را تنظیم خواهید کرد.

    پس‌از تکمیل این راه‌اندازی، باید یک فضا داشته باشید که منطقه‌ای اختصاصی برای همکاری تیم، ایجاد الگو، و استقرار برنامه‌ها است. مطمئن شوید این فضا (و پوشه و کاتالوگ) با همه افرادی که می‌خواهید با آن‌ها کار کنید هم‌رسانی شده باشد ADC.

  2. دسترسی و کاربران فضا را تنظیم کنید.

    مراحل مدیریت کاربران فضا را برای ADC در سند Google Cloud دنبال کنید. از راهنمایی‌های شرح‌داده‌شده در بخش‌های قبلی این صفحه درباره نقش‌های IAM لازم برای کنترل دسترسی استفاده کنید.

  3. پروژه‌ها را ازپیش آماده کنید.

    یک یا چند پروژه جدید Google Cloud در پوشه ایجاد کنید. مطمئن شوید که حساب Cloud Billing را به این پروژه‌ها پیوند دهید. وقتی «توسعه‌دهنده نرم‌افزار» شما زیرساخت تعریف‌شده در الگو را مستقر می‌کند، از این پروژه‌ها استفاده خواهد شد.

  4. حساب سرویس استقرار را پیکربندی کنید.

    ADC تدارک خودکار منابع را بااستفاده از حساب سرویس با دامنه محدود مدیریت می‌کند. این کار مانع از آن می‌شود که «توسعه‌دهنده نرم‌افزار» از حساب خودش برای استقرار زیرساخت استفاده کند.

    ADC می‌تواند به‌طور خودکار یک حساب سرویس با محدوده دقیق ازطرف شما ایجاد کند تا بتوانید استقرار الگوهایی را که ایجاد می‌کنید آزمایش کنید. همچنین این گزینه را دارید که حساب سرویس خودتان را که دارای اجازه‌هایی است که برای «توسعه‌دهندگان نرم‌افزار» مناسب می‌دانید، بیاورید.

مرحله ۲: ایجاد الگو (مهندس پلاتفرم)

شخصیت «مهندس پلاتفرم» از بوم طراحی یا حتی Gemini Cloud Assist برای ایجاد الگوی ADC جدید استفاده می‌کند.

  1. منابع را تعریف کنید.

    بااستفاده از بوم طراحی، مؤلفه‌ها را روی بوم بکشید و رها کنید و بین آن‌ها ارتباط برقرار کنید. این مؤلفه‌ها نحوه تعریف سرویس‌های Firebase (و Google Cloud) هستند که می‌خواهید «توسعه‌دهندگان نرم‌افزار» از آن‌ها استفاده کنند.

    برای مثال، الگو می‌تواند منابعی مانند موارد زیر را تعریف کند:

    • توسعه‌دهندگان نرم‌افزار می‌توانند برنامه‌های iOS،‏ Android، و وب را توسعه دهند که همگی از منابع استفاده می‌کنند.
    • توسعه‌دهندگان برنامه می‌توانند از Firebase AI Logic، Firebase Authentication، Cloud Firestore، و Firebase Security Rules در برنامه خود استفاده کنند (فهرست همه محصولات Firebase پشتیبانی‌شده برای ADC را ببینید).
    • Firebase Security Rules در ابتدا به‌طور پیش‌فرض برای رد کردن همه درخواست‌های دسترسی تنظیم شده است. سپس، وقتی «توسعه‌دهنده برنامه» از این الگو برای استقرار خودش استفاده می‌کند، می‌تواند این Security Rules را تغییر دهد تا با مدل دسترسی موردنیازش مطابقت داشته باشد.
  2. خط‌مشی‌ها را تعریف کنید.

    اگر می‌خواهید خط‌مشی‌هایی مثل نقش‌های IAM برای زیرساخت مستقرشده یا مناطق مجاز برای منابع تعریف کنید، باید آن‌ها را در میاناهای مربوط به آن خط‌مشی‌ها تنظیم کنید. ADC درحال‌حاضر از تعریف خط‌مشی‌ها در سطح الگو پشتیبانی نمی‌کند.

    می‌توانید نقش‌های خاص Firebase IAM را به اعضای پروژه اختصاص دهید، بسته به اینکه می‌خواهید چه کاری انجام دهند. برای مثال، اگر فقط نیاز دارند منابع را در کنسول Firebase مشاهده کنند، نقش Firebase Viewer (roles/firebase.viewer) را به آن‌ها اختصاص دهید.

    می‌توانید محدودیت‌های منطقه‌ای را برای منابع در سطح پوشه یا سازمان تنظیم کنید.

  3. الگو را به کاتالوگ اضافه کنید.

    پس‌از آزمایش کردن الگو، آن را به کاتالوگ ADC تیمتان اضافه کنید. این کاتالوگ باید با افراد مناسب، به‌ویژه «توسعه‌دهندگان برنامه»، هم‌رسانی شود تا بتوانند از الگوها استفاده کنند (مرحله ۱: راه‌اندازی ADC را در بالا ببینید).

مرحله ۳: استفاده از الگو (توسعه‌دهنده برنامه)

شخصیت «توسعه‌دهنده برنامه» الگوی ازپیش‌تعریف‌شده‌ای را انتخاب می‌کند، آن را برای مورد استفاده خاص خود پیکربندی می‌کند، و سپس زیرساخت را مستقر می‌کند.

  1. الگویی را انتخاب و آن را پیکربندی کنید.

    از کاتالوگ ADC، الگویی را انتخاب کنید و آن را برای ایجاد پیش‌نویس برنامه پیکربندی کنید. پیکربندی‌های دردسترس (مانند مناطق احتمالی برای منابع) به مواردی محدود می‌شوند که «مهندس پلاتفرم» هنگام ایجاد الگو تنظیم کرده است.

  2. زیرساخت را مستقر کنید.

    پس‌از ایجاد پیش‌نویس برنامه، برنامه ADC را در یکی از پروژه‌های ازپیش آماده‌شده که برای استقرار زیرساخت ایجاد شده است مستقر کنید (به مرحله ۱: راه‌اندازی ADC در بالا مراجعه کنید)

    می‌توانید به کنسول Firebase بروید و منابع تأمین‌شده و سرویس‌های فعال‌شده برای پروژه‌تان را مشاهده کنید.

مرحله ۴: توسعه برنامه واقعی (توسعه‌دهنده برنامه)

‫ADC به راه‌اندازی Firebase و Google Cloud زیرساخت (مثل تأمین منابع و فعال کردن میاناهای برنامه‌سازی کاربردی) کمک می‌کند. بااین‌حال، این ابزار کدنویسی برنامه واقعی را که از آن منابع و میاناهای برنامه‌سازی کاربردی استفاده می‌کند انجام نمی‌دهد.

در اینجا چند کار مهمی که شخصیت «توسعه‌دهنده برنامه» باید انجام دهد آورده شده است:

  1. پایگاه کد برنامه‌تان را به Firebase متصل کنید.

    پیکربندی Firebase را دریافت و سپس به پایگاه کد هر برنامه اضافه کنید.

    برای مثال، اگر الگو برنامه Android را مجاز می‌کند، باید فایل google-services.json را به دایرکتوری مناسب در پروژه Android خود اضافه کنید.

  2. کد و منابع را هم‌راستا نگه دارید.

    (اگر از Cloud Firestore استفاده می‌کنید) حتماً Firebase Security Rules را به‌روزرسانی و منتشر کنید تا با مدل داده Cloud Firestore برای برنامه مطابقت داشته باشد.

چه کارهای دیگری می‌توانید انجام دهید؟

  • ADC «برنامه‌های» مستقرشده را نظارت کنید، که به‌طور خودکار در App Hub ثبت می‌شوند. این کار امکان نظارت، مشاهده هزینه، و عیب‌یابی یکپارچه را برای منابع Firebase در بافت استقرارهای گسترده‌تر Google Cloud فراهم می‌کند.