کار با پانتئون

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

Apigee از Pantheon ، یک سرویس مدیریت وب سایت، برای میزبانی نسخه های ابری پورتال Developer Services استفاده می کند. Pantheon برای کار با دروپال طراحی شده است تا به شما امکان می دهد پورتال خود را در یک محیط امن توسعه، آزمایش و منتشر کنید. خدمات مدیریت وب سایت Pantheon در دسترس مشتریانی است که نیاز به میزبانی و توسعه عملیات در سراسر جهان دارند.

بخش های زیر نحوه استفاده از Pantheon برای توسعه و مدیریت پورتال خود را شرح می دهد.

دسترسی به داشبورد پانتئون

هنگامی که Apigee URL پورتال شما را برای شما ارسال می کند، شما همچنین URL داشبورد Pantheon را دریافت می کنید: https://dashboard.getpantheon.com/ .

هنگامی که برای اولین بار وارد داشبورد Pantheon می شوید، در صفحه Sites قرار می گیرید که در زیر نشان داده شده است:

از داشبورد می توانید به سایت خود دسترسی داشته باشید، حساب کاربری خود را پیکربندی کنید و سایر عملیات را انجام دهید.

تصویر سایت خود (به عنوان مثال apigeedocs ) را برای باز کردن داشبورد آن سایت انتخاب کنید:

مدیریت محیط های خود

در داشبورد Pantheon سه محیط در بالای صفحه فهرست شده است: Dev، Test و Live. هر کدام در جدول زیر توضیح داده شده اند.

در حال توسعه محتوای پورتال شما

بخش های زیر نحوه توسعه محتوای پورتال خود را شرح می دهد.

• مروری بر مخزن Git
• دسترسی به کد شما
• استقرار کد در محیط های پورتال شما
• اضافه کردن ماژول ها و تم های سفارشی
• نادیده گرفتن ماژول ها و تم های نمایه دروپال

علاوه بر این، برای جزئیات بیشتر در مورد شخصی سازی پورتال خود به بخش های زیر مراجعه کنید.

مروری بر مخزن Git

مخزن Git برای کد دروپال شما حاوی تمام کدهای پورتال شما است و با استفاده از ساختار زیر سازماندهی شده است.

توجه : فقط محتوای داخل فهرست /sites/all را تغییر دهید. اگر محتوای خارج از دایرکتوری /sites/all را تغییر دهید، هنگام ارتقا به نسخه‌های جدید با مشکل مواجه خواهید شد و ممکن است هنگام بررسی تغییرات در Git با تداخل ادغام مواجه شوید.

دسترسی به کد شما

برای دسترسی به مخزن کد خود در Git، باید وظایفی را که در بخش های زیر توضیح داده شده است انجام دهید:

• فعال کردن دسترسی SSH به سرور شما
• دسترسی به مخزن کد خود در Git

همچنین ببینید چگونه می توانم به کد منبع پورتال توسعه دهنده دروپال 7 دسترسی پیدا کنم؟

فعال کردن دسترسی SSH به سرور شما

قبل از اینکه بتوانید از Git برای مدیریت کد دروپال خود استفاده کنید، باید SSH را برای دسترسی به سرور خود با آپلود یک کلید SSH در Pantheon فعال کنید.

برای فعال کردن دسترسی SSH به سرور خود:

1. در https://dashboard.getpantheon.com/ وارد پانتئون شوید.
2. در داشبورد، حساب را انتخاب کنید.
3. کلیدهای SSH را در منوی سمت چپ انتخاب کنید.
4. کلید خود را اضافه کنید و افزودن کلید را انتخاب کنید.
   اگر به کمک نیاز دارید، پیوند آموزش نحوه تولید کلید SSH را انتخاب کنید.

دسترسی به مخزن کد خود در Git

توجه : برای مروری بر ساختار مخزن Git به نمای کلی مخزن Git مراجعه کنید.

برای دسترسی به مخزن کد خود در Git:

1. وارد داشبورد Pantheon شوید.
2. از صفحه اصلی سایت ها، نماد پورتال خود را انتخاب کنید.
3. URL مخزن Git همانطور که در شکل قبل نشان داده شده است در صفحه سمت راست Connection Mode ظاهر می شود.
4. URL مخزن Git خود را کپی کنید و با استفاده از دستور آن را در محیط توسعه محلی خود کلون کنید:
   > git clone نام سایت gitURL
   به عنوان مثال:
   > git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal

هر تغییر کدی که به مخزن Git فشار دهید بلافاصله در محیط Dev پورتال شما ظاهر می شود.

استقرار کد در محیط های پورتال شما

برای کدنویسی در محیط های پورتال خود:

1. به روز رسانی کد خود را به Git فشار دهید، که بلافاصله محیط Dev را به روز می کند.
2. وارد پنتئون شوید و سایت خود را انتخاب کنید.
3. محیط Dev را انتخاب کنید.
4. برای مشاهده پیامی در مورد تغییر کد خود در Commit Log ، </>Code را در منوی سمت چپ انتخاب کنید:
   
5. محیط تست را در بالای صفحه انتخاب کنید.
   1. اگر هنوز برنامه‌نویس را در تست آپلود نکرده‌اید، اکنون از شما خواسته می‌شود این کار را انجام دهید.
   2. اگر قبلاً یک محیط تست دارید، پیامی ظاهر می‌شود که نشان می‌دهد یک commit از سوی Dev آماده استقرار است:
      
6. اگر قبلاً یک سایت را به محیط Live فشار داده‌اید، می‌توانید به‌صورت اختیاری کادر سوم را برای کپی کردن پایگاه داده زنده و هر فایلی که توسط توسعه‌دهندگان به آزمایش از Live آپلود شده است انتخاب کنید. اگر می‌خواهید تغییرات کد خود را با جدیدترین داده‌های موجود در Live آزمایش کنید، مفید است.
7. دکمه Deploy Code from Development را انتخاب کنید.
8. پورتال را در محیط تست تست کنید.
9. هر گونه تصحیح کد را در محیط Dev انجام دهید و فایل ها را مجدداً برای تست فشار دهید.
10. پس از اتمام تست، محیط Live را در بالای صفحه انتخاب کنید.
    1. اگر هنوز تست را در Live آپلود نکرده‌اید، اکنون از شما خواسته می‌شود آن را انجام دهید.
    2. اگر قبلاً یک محیط Live دارید، پیامی ظاهر می شود که نشان می دهد یک commit از Test آماده استقرار است. آن تغییرات را به همان روشی که در Test from Dev اجرا کردید، اجرا کنید. پس از اتمام تست، کد را به محیط Live فشار دهید.

بیشتر بدانید:

• Pantheon مجموعه ای از مقالات Going Live را در این فرآیند ارائه می دهد که می توانید مشاهده کنید. یکی از مهمترین آنها مقاله Using the Pantheon Workflow است که نمای کلی از نحوه توسعه، آزمایش و ارائه سایت شما را ارائه می دهد.

اضافه کردن ماژول ها و تم های سفارشی

می توانید با افزودن ماژول ها و تم های سفارشی خود به پوشه های فهرست شده در جدول زیر، عملکرد پورتال را گسترش دهید.

توجه : فقط محتوای داخل فهرست /sites/all را تغییر دهید. اگر محتوایی را تغییر دهید که خارج از فهرست /sites/all است، ممکن است هنگام بررسی تغییرات در Git با تداخل ادغام مواجه شوید.

پس از افزودن ماژول یا تم سفارشی در محیط Dev ، می‌توانید آن را در Test برای آزمایش و سپس در محیط Live برای تولید، همانطور که در Deploying code to محیط‌های پورتال شما توضیح داده شده است، اجرا کنید.

نادیده گرفتن ماژول ها و تم های نمایه دروپال

ماژول‌ها و مضامین موجود در فهرست‌های زیر، ماژول‌ها و مضامین نمایه دروپال را که توسط Apigee در /profiles/apigee نگهداری و توزیع می‌شوند، لغو می‌کنند. به نمای کلی مخزن Git خود مراجعه کنید.

برای مثال، ممکن است بخواهید یک ماژول در توزیع Apigee Drupal را در سناریوهای زیر لغو کنید:

• شما می خواهید از یک نسخه متفاوت از یک ماژول خاص استفاده کنید.
• شما می خواهید قبل از انتشار برنامه ریزی شده بعدی Apigee یک به روز رسانی امنیتی اجرا کنید.

درباره فایل settings.php

settings.php دروپال. اگر می خواهید در فایل sites/default/settings.php تغییراتی ایجاد کنید، فایل را مستقیماً ویرایش نکنید. در عوض، یک فایل با نام sites/default/settings.local.php ایجاد کنید و کد سفارشی خود را در آنجا قرار دهید. sites/default/settings.local.php توسط فایل settings.php گنجانده شده است.

به عنوان مثال، هنگام تنظیم یک دامنه سفارشی برای یک سایت زنده به دنبال دستورالعمل های ارائه شده توسط Pantheon، به جای تغییر مستقیم فایل settings.php ، به روز رسانی های مورد نیاز را در sites/default/settings.local.php اضافه کنید.

ایمن سازی پورتال شما

سایت‌های پورتال مرتبط با محیط‌های Dev ، Test و Live به طور پیش‌فرض در دسترس عموم هستند. این بدان معناست که هر کسی که URL سایت را داشته باشد می تواند به آن دسترسی داشته باشد، اگرچه ممکن است نتواند یک حساب کاربری ثبت کند یا وارد سایت شود. برای اطلاعات بیشتر در مورد کنترل ثبت نام کاربر، به افزودن و مدیریت حساب های کاربری مراجعه کنید.

احتمالاً می خواهید سایت Dev and Test خود را از عموم پنهان کنید و می خواهید سایت Live خود را تا زمانی که توسعه کامل انجام دهید پنهان کنید. Pantheon به شما امکان می دهد کنترل نام کاربری/رمز عبور را برای قفل کردن سایت اضافه کنید تا فقط افرادی که دارای اعتبار مناسب هستند بتوانند به آن دسترسی داشته باشند.

با انتخاب Security در منوی سمت چپ محیط، قفل را به هر یک از سه محیط اضافه کنید. برای اطلاعات بیشتر، قفل کردن سایت خود را ببینید.

اگر می‌خواهید TLS/SSL را برای سایت خود فعال کنید، به استفاده از TLS در پورتال مراجعه کنید.

اعمال به روز رسانی Apigee در پورتال شما

هنگامی که Apigee نسخه جدیدی از پورتال را منتشر می کند، پیامی در داشبورد Pantheon ظاهر می شود.

شما معمولاً به‌روزرسانی را در محیط Dev اعمال می‌کنید و سپس آن تغییرات را به همان روشی که تغییرات کد خود را آزمایش می‌کنید، آزمایش می‌کنید. به عنوان مثال، محیط Dev را برای تست فشار دهید، داده‌های زنده را از Live به Test فشار دهید و سپس به‌روزرسانی را آزمایش کنید.

برای اعمال به روز رسانی:

1. در https://dashboard.getpantheon.com/ وارد پانتئون شوید و سایت خود را انتخاب کنید.
2. محیط Dev را انتخاب کنید.
3. ورودی منوی کد </> در سمت چپ را انتخاب کنید. اگر هر گونه به روز رسانی Apigee در دسترس باشد، فهرست شده است.
4. به روز رسانی را اعمال کنید:
   1. چک باکس Run update.php را پس از کشیدن کد انتخاب کنید.
   2. در صورت وجود، کادر بررسی پاک کردن کش ها پس از کشیدن کد را انتخاب کنید.
   3. دکمه Deploy Code را انتخاب کنید.
5. پس از تکمیل به‌روزرسانی، آیتم منوی وضعیت را در سمت چپ داشبورد انتخاب کنید.
6. در قسمت Status یک محیط، ممکن است متوجه خطای به‌روزرسانی پایگاه داده، مانند شکل زیر شوید:

   

   اگر این خطا را در هر محیطی مشاهده کردید، پایگاه داده را به صورت دستی به روز کنید:

   1. به عنوان یک کاربر با امتیازات مدیریت یا ایجاد محتوا وارد پورتال خود شوید.
   2. نماد Home > Run updates را در گوشه سمت چپ بالای پورتال انتخاب کنید.
   3. دستورالعمل ها را برای به روز رسانی پایگاه داده خود دنبال کنید.
7. تغییرات کد را به محیط Test فشار دهید و سپس همانطور که در بالا توضیح داده شد به Live فشار دهید.

انتقال ویژگی های سفارشی شما

اگر کد یا ویژگی های سفارشی را به پورتال اضافه می کنید، باید تصمیم بگیرید که چگونه آنها را حفظ کنید و چگونه آنها را از Dev به Test به محیط های Live منتقل کنید.

برای کد موجود در مخزن Git، می‌توانید از فرآیند توضیح داده شده در Deploying code به محیط‌های پورتال خود برای انتقال کد از Dev به Test به Live استفاده کنید.

اگر پیکربندی های سفارشی ایجاد کرده اید، از یکی از روش های زیر برای انتقال آنها استفاده کنید:

همچنین به استفاده از گردش کار Pantheon مراجعه کنید که نمای کلی از نحوه توسعه، آزمایش و فشار دادن سایت شما را ارائه می دهد. بخش مربوط به مدیریت پیکربندی در آن مقاله گنجانده شده است.

پیکربندی دامنه سفارشی

نام‌های دامنه‌ای که Apigee برای پورتال پیش‌فرض به apigee.io ارائه می‌کند، همانطور که در مدیریت محیط‌های شما توضیح داده شده است، که ممکن است آن چیزی نباشد که می‌خواهید در معرض دید مشتریان خود قرار دهید.

طرح‌های پورتال پولی می‌توانند یک نام دامنه سفارشی را برای پورتال پیکربندی کنند (توسعه‌دهنده یا حساب‌های رایگان نمی‌توانند یک دامنه سفارشی ایجاد کنند). برای استفاده از یک دامنه سفارشی، یک CNAME در DNS خود ایجاد کنید و دامنه خود را به edge.apigee.getpantheon.com هدایت کنید.

به عنوان مثال، برای پیکربندی دامنه سفارشی برای شرکتی به نام Mytech:

1. تنظیمات DNS زیر را پیکربندی کنید:
   developer.mytech.com. 3600 در CNAME edge.apigee.getpantheon.com
   ممکن است تا 48 ساعت طول بکشد تا این تغییر DNS برای همه دستگاه های سرویس گیرنده اعمال شود.
2. از ورودی منوی Domains / SSL در سمت چپ داشبورد استفاده کنید تا این دامنه را فقط برای محیط Live به داشبورد Pantheon خود اضافه کنید.
   در بیشتر موارد، DNS را فقط برای محیط Live پیکربندی می‌کنید، نه برای Dev and Test . شما نباید از محیط های Dev یا Test برای تولید استفاده کنید.

برای اطلاعات بیشتر، مستندات پانتئون را اینجا ببینید.

افزودن مدیران پورتال

هنگامی که ایمیلی از Apigee دریافت کردید که پورتال شما آماده است، Apigee قبلاً لیست مدیران پورتال را پیکربندی کرده است. با انتخاب پیوند تیم در سمت راست بالای داشبورد سایت می توانید آن لیست را مشاهده کنید.

برای افزودن سرپرست‌های اضافی، به ایجاد کاربران سرپرست مراجعه کنید.

پشتیبان گیری از پورتال شما

برای تهیه نسخه پشتیبان از پورتال خود، از تب Backups در داشبورد Pantheon استفاده کنید. می توانید یک نسخه پشتیبان بر اساس درخواست یا خودکار ایجاد کنید. در Pantheon، یک نسخه پشتیبان از سه آرشیو مجزا تشکیل شده است: پایگاه داده، فایل ها و کد.

برای اطلاعات بیشتر، به ابزار پشتیبان گیری در اسناد Pantheon مراجعه کنید.

اشتراک در به روز رسانی وضعیت

می‌توانید در status.apigee.com مشترک نسخه Apigee و به‌روزرسانی‌های وضعیت شوید. روی اشتراک در به‌روزرسانی‌ها کلیک کنید، اطلاعات تماس خود مانند آدرس ایمیل را در صورت درخواست وارد کنید و روی اشتراک کلیک کنید. در صفحه مدیریت اعلان ایمیل، مطمئن شوید که Developer Portal انتخاب شده است، سایر تنظیمات اعلان را در صورت لزوم تغییر دهید و روی Update Preferences کلیک کنید.

می‌توانید در http://status.getpantheon.com مشترک به‌روزرسانی‌های وضعیت Pantheon و گزارش‌های رویداد، مانند زمانی که قطعی برق رخ می‌دهد، شوید. برای ثبت نام روی Subscribe to Updates کلیک کنید.