شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات
Apigee از Acquia ، یک سرویس مدیریت وب سایت، برای میزبانی نسخه های ابری پورتال Developer Services استفاده می کند. Acquia برای کار با دروپال طراحی شده است تا به شما امکان توسعه، آزمایش و انتشار پورتال خود را در یک محیط امن بدهد.
بخش های زیر نحوه استفاده از Acquia برای توسعه و مدیریت پورتال خود را شرح می دهد.
دسترسی به رابط Acquia Cloud
پس از راهاندازی حساب Acquia Cloud، میتوانید از طریق رابط Acquia Cloud در https://cloud.acquia.com/ به پورتال خود دسترسی داشته باشید.
همانطور که در شکل زیر نشان داده شده است، هنگامی که برای اولین بار وارد سیستم می شوید، صفحه برنامه ها نمایش داده می شود.
صفحه برنامه ها همه برنامه هایی را که شما به آنها دسترسی دارید و در Acquia Cloud میزبانی می شوند را نشان می دهد. نرم افزار موجودیت نرم افزاری است که شما در Acquia Cloud مدیریت می کنید، مانند سایت پورتال مبتنی بر دروپال.
بخشهای زیر نحوه استفاده از رابط Acquia Cloud برای مدیریت محتوای پورتال را شرح میدهند.
برای اطلاعات بیشتر در مورد رابط Acquia Cloud، به ورود به رابط Acquia Cloud و مدیریت برنامه ها با Acquia Cloud در اسناد Acquia Cloud مراجعه کنید.
مدیریت محیط های خود
به رابط Acquia Cloud دسترسی پیدا کنید و در صفحه Applications روی مدیریت مرتبط با سایت پورتال خود کلیک کنید تا به داشبورد آن دسترسی پیدا کنید.
برای مدیریت گردش کار، سه محیط برای توسعه، آزمایش و انتشار پورتال شما ارائه شده است که در جدول زیر مشخص شده است. پورتال شما در هر محیطی مستقر است، اما ممکن است در وضعیت متفاوتی با شاخه یا برچسب کد منحصر به فرد، پایگاه داده و غیره باشد. به استقرار کد در محیط های پورتال خود مراجعه کنید.
محیط زیست | توضیحات | URL پیش فرض |
توسعه دهنده | ویژگی های جدید را توسعه دهید و پورتال خود را سفارشی کنید. | http://{ application-name } xxxxxx .devcloud.acquia-sites.com/ جایی که |
مرحله | آخرین کد را قبل از فشار دادن به محیط تولید تست کنید. | http://{ application-name } yyyyyy .devcloud.acquia-sites.com/ جایی که |
تولید | پورتال خود را برای تولید (زنده) منتشر کنید. | http://{ application-name }.devcloud.acquia-sites.com/ جایی که توجه: به پیکربندی دامنه سفارشی نیز مراجعه کنید. |
برای اطلاعات بیشتر، به کار با محیطها در مستندات Acquia Cloud مراجعه کنید.
در حال توسعه پورتال شما
بخش های زیر نحوه توسعه پورتال خود را شرح می دهد.
- مروری بر مخزن Git
- دسترسی به کد شما
- استقرار کد در محیط های پورتال شما
- اضافه کردن ماژول ها و تم های سفارشی
- نادیده گرفتن ماژول ها و تم های نمایه دروپال
علاوه بر این، برای جزئیات بیشتر در مورد شخصی سازی پورتال خود به بخش های زیر مراجعه کنید.
اگر می خواهید به ... | شما می توانید | اطلاعات بیشتر |
---|---|---|
ظاهر و ظاهر سایت را تغییر دهید | پایه - از ورودی منوی ظاهر در سایت پورتال برای ایجاد تغییراتی مانند تغییر لوگو و رنگ های سایت استفاده کنید. | به سفارشی کردن ظاهر مراجعه کنید |
پیشرفته - برای ایجاد تغییرات در ظاهر و ظاهر کامل سایت، تم پاسخگوی Apigee را گسترش دهید. | سفارشی کردن تم را ببینید | |
تغییر رفتار عملکرد سایت | پایه - از تنظیمات مدیریت در پورتال برای تغییر/پیکربندی نحوه رفتار سایت استفاده کنید. | مستندات Apigee را از اینجا ببینید |
پیشرفته - یک ماژول سفارشی برای تغییر هر رفتار سایت ایجاد کنید. | به ایجاد ماژول های سفارشی در اسناد دروپال مراجعه کنید |
مروری بر مخزن Git
مخزن Git برای کد دروپال شما حاوی تمام کدهای پورتال شما است و با استفاده از ساختار زیر سازماندهی شده است.
توجه : فقط محتوای داخل فهرست /sites/all را تغییر دهید. اگر محتوای خارج از دایرکتوری /sites/all
را تغییر دهید، هنگام ارتقا به نسخههای جدید با مشکل مواجه خواهید شد و ممکن است هنگام بررسی تغییرات در Git با تداخل ادغام مواجه شوید.
پوشه در Git repo | توضیحات |
---|---|
/profiles/apigee | Apigee ماژول ها و مضامین را حفظ کرد، از جمله:
توجه : محتوای دایرکتوری /profiles/apigee را تغییر ندهید، در غیر این صورت هنگام ارتقا به نسخه های جدید با مشکل مواجه خواهید شد و ممکن است هنگام بررسی تغییرات در Git با تداخل ادغام مواجه شوید. برای بهترین روشهای دروپال، هرگز هسته اصلی را هک نکنید . |
/sites/all | ماژول ها و تم های سفارشی دروپال شما. برای اطلاعات در مورد مدیریت محتوای این پوشه، به افزودن ماژولها و تمهای سفارشی و لغو ماژولها و تمهای نمایه دروپال مراجعه کنید. توجه : فقط محتوای داخل فهرست /sites/all را تغییر دهید. |
دسترسی به کد شما
برای دسترسی به مخزن کد خود در Git، باید وظایفی را که در بخش های زیر توضیح داده شده است انجام دهید:
همچنین ببینید چگونه می توانم به کد منبع پورتال توسعه دهنده دروپال 7 دسترسی پیدا کنم؟
فعال کردن دسترسی SSH به سرور شما
قبل از اینکه بتوانید از Git برای مدیریت کد دروپال خود استفاده کنید، باید SSH را برای دسترسی به سرور خود فعال کنید. برای اطلاعات بیشتر، به فعال کردن دسترسی SSH در اسناد Acquia Cloud مراجعه کنید.
برای فعال کردن دسترسی SSH:
- وارد رابط Acquia Accounts در https://accounts.acquia.com شوید.
- روی اعتبارنامه کلیک کنید.
- در صورت درخواست، رمز عبور خود را دوباره وارد کنید تا هویت خود را تأیید کنید.
- در زیر کلیدهای SSH، روی افزودن کلید SSH کلیک کنید.
- اطلاعات زیر را وارد کنید:
میدان توضیحات نام مستعار نام مستعار برای کلید SSH. نام مستعار میتواند شامل نویسههای الفبایی عددی و زیرخط باشد. کلید عمومی کلید عمومی برای اطلاعات در مورد تولید کلید عمومی SSH، به ایجاد کلید عمومی SSH در مستندات Acquia Cloud مراجعه کنید.
- روی افزودن کلید کلیک کنید.
دسترسی به مخزن کد خود در Git
مخزن Git حاوی تمام کدهای سایت پورتال شما است. می توانید کد جدید اضافه کنید یا کدهای موجود را برای پیکربندی پورتال خود سفارشی کنید. برای اطلاعات بیشتر، به استفاده از مخزن کد خود در اسناد Acquia Cloud مراجعه کنید.
برای دسترسی به مخزن کد خود در مخزن Git:
- وارد رابط Acquia Cloud در https://cloud.acquia.com/ شوید.
- در صفحه برنامه ها، روی Manage کلیک کنید تا جزئیات پورتال را مشاهده کنید.
- روی Application Info در نوار پیمایش کلیک کنید.
- دستور کلون را در گفتگوی Application Information کپی کنید.
- با اجرای یکی از دستورات Git زیر، مخزن Git را در محیط محلی خود کلون کنید:
برای کلون کردن مخزن Git و ایجاد یک شاخه جدید:
> git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
برای شبیه سازی مخزن Git از شاخه اصلی :
> git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
- این مراحل را زمانی که آماده مرحلهبندی، انجام و فشار دادن تغییرات خود به مخزن Git با استفاده از دستورات مربوطه در پنجره Application هستید، تکرار کنید.
هنگامی که یک شاخه را به مخزن خود متعهد می کنید، Acquia Cloud محیطی را که آن شاخه کد را اجرا می کند به روز می کند. همانطور که در بخش بعدی توضیح داده شد می توانید کد را در محیط های پورتال خود مستقر کنید.
استقرار کد در محیط های پورتال شما
برای استقرار، جابجایی یا برگرداندن کد در یک محیط پورتال، جابجایی کد خود بین محیطها، یا کسب اطلاعات بیشتر در مورد ساختار مخزن و گردش کار توصیه شده، به کار با سایتها در Aquia Cloud در مستندات Acquia Cloud مراجعه کنید. هنگامی که کد جدیدی را در یک محیط مستقر می کنید، باید update.php
اجرا کنید تا به روز رسانی های مورد نیاز پایگاه داده را انجام دهید.
اضافه کردن ماژول ها و تم های سفارشی
می توانید با افزودن ماژول ها و تم های سفارشی خود به پوشه های فهرست شده در جدول زیر، عملکرد پورتال را گسترش دهید.
توجه : فقط محتوای داخل فهرست /sites/all را تغییر دهید. اگر محتوایی را تغییر دهید که خارج از فهرست /sites/all است، ممکن است هنگام بررسی تغییرات در Git با تداخل ادغام مواجه شوید.
ماژول/موضوع | پوشه در مخزن Git | اطلاعات بیشتر (اسناد دروپال) |
ماژول های سفارشی | sites/all/modules/custom | ایجاد ماژول های سفارشی |
تم های سفارشی | sites/all/themes | سفارشی کردن تم قالب بندی دروپال 7 |
پس از افزودن ماژول یا تم سفارشی در محیط Dev ، میتوانید آن را در Test برای آزمایش و سپس در محیط Live برای تولید، همانطور که در Deploying code to محیطهای پورتال شما توضیح داده شده است، اجرا کنید.
نادیده گرفتن ماژول ها و تم های نمایه دروپال
ماژولها و مضامین موجود در فهرستهای زیر، ماژولها و مضامین نمایه دروپال را که توسط Apigee در /profiles/apigee
نگهداری و توزیع میشوند، لغو میکنند. به نمای کلی مخزن Git خود مراجعه کنید.
برای مثال، ممکن است بخواهید یک ماژول در توزیع Apigee Drupal را در سناریوهای زیر لغو کنید:
- شما می خواهید از یک نسخه متفاوت از یک ماژول خاص استفاده کنید.
- شما می خواهید قبل از انتشار برنامه ریزی شده بعدی Apigee یک به روز رسانی امنیتی اجرا کنید.
ماژول/موضوع | پوشه در مخزن Git | اطلاعات بیشتر (اسناد دروپال) |
ماژول های کمک دروپال | sites/all/modules/contrib توجه : ماژولهایی که در هر جایی در زیر | ماژول های ارائه شده توجه : ماژولهای کمکشده دروپال در این فهرست، ماژولهای معادلی را که توسط Apigee در |
دروپال تم های کمکی | sites/all/themes | تم های مشارکتی توجه : تم های ارائه شده دروپال در این دایرکتوری ماژول های معادل نگهداری و توزیع شده توسط Apigee در |
فعال کردن SSL
برای فعال کردن دسترسی ایمن به سایت خود با استفاده از HTTPS، باید SSL را فعال کنید.
برای فعال کردن SSL :
- گواهی SSL را از یک مرجع صدور گواهی (CA) یا فروشنده گواهی SSL دریافت کنید. فعال کردن SSL را ببینید.
- گواهی SSL را در صفحه SSL در رابط Acquia Cloud آپلود کنید. به مدیریت گواهیهای SSL مراجعه کنید.
امنیت محیط تولید شما
هنگامی که برای اولین بار یک برنامه را ایجاد می کنید، می توانید آزادانه محیط تولید را مدیریت کنید و تغییرات را از محیط های توسعه و مرحله پخش کنید. پس از انتشار محتوای خود، ممکن است بخواهید محیط تولید را قفل کنید تا از بروز رسانی غیرمجاز یا تصادفی محتوا جلوگیری کنید. برای اطلاعات بیشتر، به استفاده از حالت تولید برای محافظت از برنامه زنده خود در اسناد Acquia Cloud مراجعه کنید.
برای ایمن سازی محیط تولید خود:
- وارد رابط Acquia Cloud در https://cloud.acquia.com/ شوید.
- در صفحه برنامه ها، روی Manage کلیک کنید تا جزئیات سایت پورتال خود را مشاهده کنید.
- برای مشاهده جزئیات محیط تولید روی Prod کلیک کنید.
- روی گزینه Production Mode در نوار ناوبری کلیک کنید.
- روی Enable کلیک کنید تا حالت تولید فعال شود.
اعمال به روز رسانی ماژول و تم در پورتال
Apigee به صورت دورهای ماژولها و مضامین موجود در پورتال شما را بهطور خودکار به آخرین نسخه بهروزرسانی میکند. بهروزرسانیها فقط در محیط Dev انجام میشوند و برچسبگذاری میشوند تا نشان دهند که باید به محیطهای پورتال دیگر منتقل شوند.
اگر سایت شما بخشی از سازمان صورتحساب Apigee Acquia نیست (مثلاً یک سایت جدید از یک ارائه دهنده میزبانی دیگر به سازمان شما مهاجرت کرده است) باید به Apigee اجازه دسترسی به مخزن Git خود را بدهید تا فشارهای به روز رسانی Devportal خودکار را دریافت کند. برای اطلاعات بیشتر با پشتیبانی Apigee تماس بگیرید.
اگر ماژول ها یا تم های سفارشی اضافه کرده اید، باید آنها را به صورت دستی به روز کنید.
جدول زیر مراحل مورد نیاز برای اعمال به روز رسانی ماژول و تم در پورتال را خلاصه می کند.
ماژول ها/موضوعات | توضیحات |
ماژول های Apigee Edge | Apigee بهروزرسانیها را بهطور خودکار فقط در محیط Dev اعمال میکند. پس از آزمایش بهروزرسانیها، آنها را از Dev به Stage به محیطهای Prod منتقل کنید، همانطور که در Deploying code به محیطهای پورتال خود توضیح داده شده است. |
تم پاسخگو Apigee | Apigee بهروزرسانیها را بهطور خودکار فقط در محیط Dev اعمال میکند. پس از آزمایش بهروزرسانیها، آنها را از Dev به Stage به محیطهای Prod منتقل کنید، همانطور که در Deploying code به محیطهای پورتال خود توضیح داده شده است. |
هسته دروپال و ماژول های کمکی | Apigee بهروزرسانیها را بهطور خودکار فقط در محیط Dev اعمال میکند. پس از آزمایش بهروزرسانیها، آنها را از Dev به Stage به محیطهای Prod منتقل کنید، همانطور که در Deploying code به محیطهای پورتال خود توضیح داده شده است. |
ماژول ها و تم های سفارشی | اگر ماژولها و تمهای سفارشی را به پورتال خود اضافه کردهاید، همانطور که در افزودن ماژولها و تمهای سفارشی توضیح داده شده است، باید بهروزرسانیها را به صورت دستی نصب کنید. آخرین نسخه را به صورت دستی یا با استفاده از Drush در فهرست محلی خود دانلود کنید. سپس به روز رسانی ها را مرحله بندی، commit و به مخزن Git فشار دهید. پس از آزمایش بهروزرسانیها، آنها را از Dev به Stage به محیطهای Prod منتقل کنید، همانطور که در Deploying code به محیطهای پورتال خود توضیح داده شده است. |
انتقال ویژگی های سفارشی شما
اگر کد یا پیکربندی های سفارشی را به پورتال اضافه می کنید، باید آنها را از Dev به Stage به محیط های Prod نگهداری و انتقال دهید.
برای کد موجود در مخزن Git، میتوانید از فرآیند توضیح داده شده در Deploying code به محیطهای پورتال خود برای انتقال کد از Dev به Stage به Prod استفاده کنید.
اگر پیکربندی های سفارشی ایجاد کرده اید، از یکی از روش های زیر برای انتقال آنها استفاده کنید:
روش | توضیحات |
پیکربندی خود را به کد صادر کنید | بسیاری از پیکربندیهای رایج برای کدگذاری با استفاده از ماژول Features "قابل صادرات" هستند. به عنوان مثال، نماها، پانل ها، حافظه پنهان تصویر و غیره. |
تابع hook_update_N() را پیاده سازی کنید | دروپال با استفاده از تابع hook_update_N() تغییرات پایگاه داده و پیکربندی را مدیریت می کند. اگر یک ماژول سفارشی دارید، می توانید:
|
پیکربندی دامنه سفارشی
همانطور که در مدیریت محیطهای شما ذکر شد، نامهای دامنه پیشفرض برای محیطهای پورتال همگی به acquia-sites.com
ختم میشوند. توصیه می شود نام دامنه سفارشی خود را که شخصی سازی می کند و هدف سایت شما را بهتر بیان می کند، ارائه دهید. به عنوان مثال، یک جایگزین محبوب این است:
https://developers.mycompany.com
برای پیکربندی دامنه سفارشی :
- دامنه خود را به محیط سایت پورتال خود اضافه کنید. به مدیریت دامنه ها در اسناد Acquia Cloud مراجعه کنید.
- دامنه سفارشی خود را با ارائهدهنده DNS خود با اشاره به ورودی رکورد DNS نام دامنه خود به آدرس IP عمومی (نه به دامنه
acquia-sites.com
) تنظیم کنید. اشاره کردن رکوردهای DNS به آدرس های IP عمومی خود را در اسناد Acquia Cloud ببینید.توجه : ورودی CNAME نام دامنه را روی دامنه
acquia-sites.com
تنظیم نکنید. انجام این کار ممکن است باعث مشکلات تأخیر یا خرابی سایت پورتال شما شود.
نظارت بر پورتال خود با استفاده از Acquia Insight
Acquia Insight مجموعه ای از ابزارها است که به شما امکان می دهد سایت پورتال خود را با نظارت بر عملکرد، امنیت و بهینه سازی موتور جستجو بهینه سازی کنید. برای اطلاعات بیشتر، Acquia Insight را ببینید.
پشتیبان گیری از پورتال شما
جداول زیر گزینه های موجود برای پشتیبان گیری از اجزای پورتال را خلاصه می کند.
جزء | جزئیات پشتیبان | اطلاعات بیشتر در Acquia Cloud Docs |
کد |
| |
پایگاه داده |
| |
فایل ها | پشتیبان گیری دستی انجام دهید یا یک کار cron را برنامه ریزی کنید. | |
برنامه کامل | با استفاده از Drush پشتیبان گیری دستی انجام دهید. . | |
سیستم فایل دروپال | با استفاده از یکی از گزینه های زیر پشتیبان گیری دستی را انجام دهید:
توجه: ماژول Backup and Migrate در Acquia Cloud پشتیبانی نمی شود. برای اطلاعات بیشتر، ماژول پشتیبانگیری و انتقال را ببینید که در Acquia Cloud پشتیبانی نمیشود . |
مشاهده اعلانهای فعالیت
میتوانید اعلانهای فعالیت را مشاهده کنید تا اقدامات مهمی را که در سایت پورتال شما رخ میدهد، مانند نصب یا کپی کد بین محیطها، بهروزرسانیها و پشتیبانگیری پایگاه داده، تغییرات سرور، و غیره مشاهده کنید. برای اطلاعات بیشتر، مشاهده اعلانهای فعالیت در مستندات Acquia Cloud را ببینید.
برای مشاهده لیست اعلان ها:
- وارد رابط Acquia Cloud در https://cloud.acquia.com/ شوید.
- در صفحه برنامه ها، روی Manage کلیک کنید تا جزئیات سایت پورتال خود را مشاهده کنید.
- روی نماد زنگ در گوشه سمت راست بالای نوار پیمایش کلیک کنید تا آخرین اعلانهای خود را مشاهده کنید.
- برای مشاهده اطلاعات بیشتر درباره فعالیت، روی فلش کنار اعلان کلیک کنید.
اشتراک در به روز رسانی وضعیت
میتوانید در status.apigee.com مشترک نسخه Apigee و بهروزرسانیهای وضعیت شوید. روی اشتراک در بهروزرسانیها کلیک کنید، اطلاعات تماس خود مانند آدرس ایمیل را در صورت درخواست وارد کنید و روی اشتراک کلیک کنید. در صفحه مدیریت اعلان ایمیل، مطمئن شوید که Developer Portal انتخاب شده است، سایر تنظیمات اعلان را در صورت لزوم تغییر دهید و روی Update Preferences کلیک کنید.
میتوانید در بهروزرسانیهای وضعیت Acquia مشترک شوید تا اعلانهایی درباره هرگونه وقفه در سرویس، تعمیر و نگهداری اضطراری یا بهروزرسانیهای امنیتی که در این پلتفرم ایجاد میشود، دریافت کنید. برای اشتراک در بهروزرسانیهای Acquia Cloud:
- به صفحه وضعیت Acquia بروید.
- روی اشتراک در به روز رسانی ها کلیک کنید.
- روشی را که می خواهید برای دریافت به روز رسانی ها استفاده کنید (ایمیل، پیامک و غیره) انتخاب کنید.
- در صفحه اعلانها، محصولاتی را که میخواهید بهروزرسانیهای وضعیت را دریافت کنید، انتخاب کنید. به عنوان مثال، Acquia Cloud Enterprise.
- روی Update Preferences کلیک کنید.