نصب درگاه «سرویس‌های توسعه‌دهنده»

Developer Services Portal نسخه ۴.۱۶.۰۹

قبل‌از نصب، مطمئن شوید که:

  • نصب را در نسخه ۶۴ بیتی نسخه پشتیبانی‌شده Red Hat Enterprise Linux،‏ CentOS، یا Oracle انجام می‌دهید. فهرست نسخه‌های پشتیبانی‌شده را در اینجا ببینید.
  • Yum نصب شده باشد.
  • از نصب‌های موجود پشتیبان‌گیری می‌کنید. اگر کدی را در هسته Drupal یا در هریک از ماژول‌های غیرسفارشی اصلاح کرده باشید، اصلاحات شما رونویسی خواهد شد. این شامل، ازجمله موارد دیگر، هرگونه تغییری است که ممکن است در .htaccess ایجاد کرده باشید. باید فرض کنید که هر چیزی خارج از فهرست راهنمای /sites متعلق به Drupal است. استثنای این قانون robots.txt است؛ اگر این فایل در ریشه وب وجود داشته باشد، برای شما حفظ خواهد شد. قبل‌از ادامه نصب، از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان نصب پیش‌فرض /var/www/html است، اما ممکن است آن را در زمان نصب تغییر داده باشید. پس‌از انجام مراحل نصب شرح‌داده‌شده در زیر، می‌توانید سفارشی‌سازی‌هایتان را از نسخه پشتیبان بازیابی کنید.

برای نصب درگاه «سرویس‌های کانال توسعه‌دهنده»، این مراحل را دنبال کنید.

۱. دریافت بسته Developer Channel Services

به http://community.apigee.com/content/apigee-customer-support بروید و «ورود به سیستم درگاه پشتیبانی» را انتخاب کنید تا فایل tar. «سرویس‌های کانال توسعه‌دهنده» را به یکی از دو روش زیر درخواست کنید:

  • درخواست دسترسی به فهرست راهنمای بارگیری Edge for Private Cloud.
  • درخواست نشانی وب برای فایل tar. «سرویس‌های کانال توسعه‌دهنده».

۲. اتصال به Apigee Edge را آزمایش کنید

اتصال خود به سرور مدیریت Edge را با اجرای فرمان cURL زیر از خط فرمان در سرور پورتال آزمایش کنید:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

که در آن EMAIL و PASSWORD نشانی ایمیل و گذرواژه سرپرست برای ORGNAME هستند.

حتماً نام میزبان و شماره درگاه مختص نصب Edge خود را مشخص کنید. درگاه 8080 درگاه پیش‌فرضی است که Edge استفاده می‌کند. اگر به سازمانی در فضای ابری متصل می‌شوید، نشانی وب درخواست این است: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

اگر موفقیت‌آمیز باشد، این فرمان پاسخی مشابه پاسخ زیر برمی‌گرداند:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

۳. برداشتن نسخه‌های PHP قدیمی‌تر از ۷.۰

اسکریپت نصب قبل‌از شروع نصب، نسخه‌های PHP قدیمی‌تر از ۷.۰ را در سیستم بررسی می‌کند. اگر نسخه‌های PHP قدیمی‌تر از ۷.۰ وجود داشته باشد، پیام هشدار زیر نمایش داده می‌شود:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

برای CentOS و Red Hat Enterprise Linux (RHEL)، بسته‌های PHP را بااستفاده از فرمان زیر بردارید:

yum remove <package-name>

۴. نصب «سرویس‌های کانال توسعه‌دهنده» بااستفاده از دستورگان نصب خودکار

از یکی از روش‌های زیر برای نصب پورتال استفاده کنید، بسته به اینکه آیا نصب را روی سروری با یا بدون اتصال اینترنت انجام می‌دهید.

در سروری با اتصال اینترنت:

برای نصب «سرویس‌های کانال توسعه‌دهنده» در سروری که اتصال اینترنت دارد:

  1. به‌عنوان کاربر ریشه یا اَبَرکاربر به سیستم سرور وارد شوید.
  2. فهرست راهنمایی برای فایل‌های نصب ایجاد کنید، مثلاً portal.
  3. به دایرکتوری پورتال جدید بروید و فایل DeveloperServices_x.y.z.tar مربوط به «سرویس‌های کانال توسعه‌دهنده» را بارگیری کنید. در اینجا x.y.z با شماره نسخه پورتال مطابقت دارد.

    می‌توانید فایلی را از پیوندی که Apigee برایتان ارسال کرده است در مرورگر بارگیری کنید یا آن را کپی کنید و سپس به فرمان cURL زیر اضافه کنید:
    > curl -kOL <paste link here>
  4. محتویات فایل tar .مربوط به Developer Channel Services را بااستفاده از این فرمان استخراج کنید:
    > tar -xvf <tar file>
  5. به DeveloperServices-4.x.y.z بروید.
  6. دستورگان نصب را بااستفاده از فرمان زیر اجرا کنید:
    > ./networked-install.sh
  7. به پیام‌واره‌ها پاسخ دهید.

در سروری بدون اتصال اینترنت:

ابتدا، یک اسکریپت نصب غیرشبکه‌ای در سیستمی که اتصال اینترنت دارد ایجاد کنید:

  1. به‌عنوان کاربر ریشه یا کاربر ممتاز به سیستم دارای اتصال اینترنت وارد شوید.
  2. فهرست راهنمایی برای فایل‌های نصب ایجاد کنید، مثلاً portal_tar.
  3. به دایرکتوری portal_tar بروید و فایل Developer Channel Services DeveloperServices_x.y.z.tar را بارگیری کنید، که در آن x.y.z با شماره نسخه پورتال مطابقت دارد.
  4. محتوای فایل tar. «سرویس‌های کانال توسعه‌دهنده» را بااستفاده از این فرمان استخراج کنید:
    > tar -xvf <tar file>
  5. به DeveloperServices-4.x.y.z بروید.
  6. فایل .tar.gz درگاه را بااستفاده از این فرمان ایجاد کنید:
    > ./non-networked-install.sh

فایل .tar.gz جدیدی برای نصب غیرشبکه‌ای ایجاد می‌شود.

برای نصب «سرویس‌های کانال توسعه‌دهنده» در سروری که اتصال اینترنت ندارد:

      1. به‌عنوان کاربر ریشه یا اَبَرکاربر به سیستم سرور وارد شوید.
      2. فهرست راهنمایی برای فایل‌های نصب ایجاد کنید، مثلاً portal.
      3. CD به دایرکتوری درگاه.
      4. فایل .tar.gz را که برای نصب غیرشبکه‌ای (در روال بالا) ایجاد کردید در دایرکتوری portal کپی کنید.
      5. محتویات فایل .tar.gz را بااستفاده از این فرمان استخراج کنید:
        > tar -xvf <tar file>
      6. به دایرکتوری ایجادشده توسط فرمان tar بروید.
      7. اجازه‌ها را در اسکریپت install-from-rpm-bundle.sh تنظیم کنید:
        > chmod 755 install-from-rpm-bundle.sh
      8. دستورگان install-from-rpm-bundle.sh را بااستفاده از این فرمان اجرا کنید:
        > ./install-from-rpm-bundle.sh
      9. به پیام‌واره‌ها پاسخ دهید.

      ۵. پیکربندی درگاه توسعه‌دهندگان

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

      برای پیکربندی درگاه توسعه‌دهندگان:

      1. در مرورگر به نشانی وب سرور بروید، مثلاً:
        http://localhost. یا اگر IP یا ساناد خاصی پیکربندی شده است، به http://IP_address یا http://DNS_name بروید.

        به صفحه پیکربندی پایگاه داده نمایه Apigee هدایت می‌شوید.

        توجه: معمولاً قبلاً نام میزبان را پیکربندی کرده‌اید و آن را در سرور ساناد خود ثبت کرده‌اید تا مجبور نباشید از http://localhost استفاده کنید.
      2. اتصال به پایگاه داده را پیکربندی کنید. اگر پایگاه داده در دستگاهی ازراه‌دور است، بخش گزینه‌های پیشرفته را ازهم باز کنید و اطلاعات اتصال به آن دستگاه را وارد کنید، سپس ذخیره و ادامه را انتخاب کنید.
      3. با وارد کردن اطلاعات زیر، اتصال به «نقطه پایانی Apigee» را پیکربندی کنید، سپس ذخیره را انتخاب کنید.
        برای اطلاعات بیشتر درباره این مقادیر، به «اطلاعات موردنیاز قبل‌از شروع نصب» در الزامات درگاه سرویس‌های توسعه‌دهنده مراجعه کنید.
        1. Management API Org
        2. نشانی وب نقطه پایانی Management API
        3. کاربر اصالت‌سنجی‌شده نقطه پایان
        4. گذرواژه کاربران اصالت‌سنجی‌شده
      4. کاربر سرپرست را با وارد کردن اطلاعات زیر پیکربندی کنید، سپس «ذخیره» را انتخاب کنید. توجه داشته باشید که Drupal به‌طور پیش‌فرض کاربر سرپرستی به‌نام «admin» ایجاد می‌کند، بنابراین از «admin» به‌عنوان نام کاربری استفاده نکنید.
        اگر این مرحله را رد کنید، همچنان می‌توانید از Drush برای ایجاد سرپرست استفاده کنید، همان‌طور که در زیر در بخش ۴ توضیح داده شده است. کاربر سرپرست ایجاد کنید.
        1. نام و نام خانوادگی توسعه‌دهنده
        2. نام کاربری درگاه توسعه‌دهنده
        3. گذرواژه
        4. نشانی ایمیل
      5. پس‌از تکمیل نصب، اجازه‌ها را در فایل settings.php تنظیم کنید:
        > chmod 640 /var/www/html/sites/default/settings.php
      6. به صفحه اصلی درگاه در http://localhost/ یا به نام ساناد درگاهتان بروید.
      7. بااستفاده از اطلاعات کاربری سرپرست، به سیستم درگاه وارد شوید.

      ‫۶. ایجاد کاربر سرپرست (اختیاری)

      از Drush برای ایجاد کاربر سرپرست برای نصب «سرویس‌های کانال توسعه‌دهنده» استفاده کنید. Drupal به‌طور خودکار کاربر سرپرستی به‌نام «admin» به‌طور پیش‌فرض ایجاد می‌کند، بنابراین از «admin» به‌عنوان نام کاربری استفاده نکنید.

      1. CD به دایرکتوری drupal_root/sites/default. مکان استاندارد برای دایرکتوری ریشه Drupal ‎ /var/www/html است:
        > cd <drupal_root>/sites/default
      2. مطمئن شوید که در فایل‌های خصوصی Drupal اجازه نوشتن دارید:
        > drush vget file_private_path

        این فرمان مسیر فایل‌های خصوصی Drupal را برمی‌گرداند، برای مثال:
        file_private_path: 'sites/default/private'

        مطابق با /var/www/html/sites/default/private/. از فرمان زیر استفاده کنید تا مطمئن شوید که این دایرکتوری توسط مالک و گروه قابل‌نوشتن است:
        chmod -R g+w dirPathAndName
        chmod -R o+r dirPathAndName
      3. فرمان‌های زیر را برای ایجاد کاربر سرپرست وارد کنید و فرمان‌های داخل «< >» را با مقادیر خودتان جایگزین کنید:
        > drush user-create <username> --mail="<email-address>" --password="<password>"
        > drush user-add-role Administrator <username>
      4. بااستفاده از نام کاربری و گذرواژه مشخص‌شده در بالا، به‌عنوان سرپرست به درگاه توسعه‌دهندگان وارد شوید.

      ۵. تنظیم گذرواژه ریشه MySQL

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

      از فرمان زیر برای تنظیم گذرواژه ریشه استفاده کنید:

      > mysqladmin -u root password NEWPASSWORD

      اگر قبلاً گذرواژه ریشه را تنظیم کرده‌اید و می‌خواهید آن را تغییر دهید، از فرمان زیر استفاده کنید:

      > mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

      همچنین باید گذرواژه را در فایل /var/www/html/sites/default/settings.php به‌روز کنید.

      ‫۶. مطمئن شوید واحد «مدیر به‌روزرسانی» فعال باشد

      برای دریافت اعلان‌های به‌روزرسانی‌های Drupal، مطمئن شوید که ماژول Drupal Update manager فعال است. از منو Drupal، Modules (واحدها) را انتخاب کنید و به پایین پیمایش کنید تا به واحد Update manager (مدیر به‌روزرسانی) برسید. اگر فعال نیست، آن را فعال کنید.

      پس‌از فعال کردن، می‌توانید بااستفاده از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس، به‌روزرسانی‌های دردسترس را ببینید. همچنین می‌توانید از فرمان Drush زیر استفاده کنید:

      > drush pm-info update

      از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس > تنظیمات برای پیکربندی ماژول استفاده کنید تا وقتی به‌روزرسانی‌ها دردسترس هستند برایتان ایمیل ارسال شود و تناوب بررسی به‌روزرسانی‌ها را تنظیم کنید.

      ‫۷. پیاده‌سازی در سرور تولید (اختیاری)

      اگر درحال استقرار درگاه در سرور تولید هستید، باید مراحل امنیتی بیشتری را انجام دهید، ازجمله:

      1. اسکریپت زیر را برای ایمن کردن نصب MySQL اجرا کنید:
        > /usr/bin/mysql_secure_installation

        این اسکریپت گذرواژه ریشه را تنظیم می‌کند و به شما این امکان را می‌دهد که دسترسی ریشه را فقط به میزبان محلی محدود کنید و پایگاه‌های داده آزمایشی و کاربر ناشناس ایجادشده به‌طور پیش‌فرض را بردارید. اجرای این دستورگان برای سرورهای تولید به‌شدت توصیه می‌شود.
      2. اگر خط‌مشی‌های شرکتی شما ایجاب می‌کند، SELinux را فعال و پیکربندی کنید.

      ‫۸. پیکربندی موتور جستجوی Apache Solr (اختیاری)

      به‌طور پیش‌فرض، ماژول‌های Drupal که به موتور جستجوی Apache Solr متصل می‌شوند، هنگام نصب درگاه غیرفعال هستند. اکثر درگاه‌ها از موتور جستجوی داخلی Drupal استفاده می‌کنند و بنابراین به مدول‌های Drupal Solr نیاز ندارند.

      اگر تصمیم گرفتید از Solr به‌عنوان موتور جستجو استفاده کنید، باید Solr را به‌طور محلی در سرورتان نصب کنید و سپس پیمانه‌های Drupal Solr را در پورتال فعال و پیکربندی کنید.

      برای فعال کردن واحدهای Drupal Solr:

      1. به‌عنوان کاربری با امتیازات سرپرست یا ایجاد محتوا به سیستم درگاهتان وارد شوید.
      2. Modules (واحدها) را در منو Drupal انتخاب کنید.
      3. واحد Apache Solr Framework و واحد Apache Solr Search را فعال کنید.
      4. تغییراتتان را ذخیره کنید.
      5. Solr را همان‌طور که در https://drupal.org/node/1999280 شرح داده شده است پیکربندی کنید.

      ‫۹. برای پشتیبانی از HTTPS،‏ mod_ssl را نصب کنید (اختیاری)

      «سرور اچ‌تی‌تی‌پی آپاچی» از ماژول mod_ssl برای ارائه صفحه‌های وب ازطریق HTTPS استفاده می‌کند. اگر می‌خواهید از HTTPS استفاده کنید، از فرمان زیر برای نصب mod_ssl استفاده کنید:

      > yum install mod_ssl

      برای اطلاعات بیشتر درباره پیکربندی درگاه برای استفاده از SSL، به http://apigee.com/docs/developer-services/content/using-ssl-portal مراجعه کنید.

      ‫۱۰. نصب SmartDocs (اختیاری)

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

      • اگر درحال اتصال پورتال به نصب Edge Cloud هستید، SmartDocs ازقبل نصب شده است و پیکربندی بیشتری لازم نیست.
      • اگر درحال اتصال پورتال به نصب Edge for Private Cloud هستید، باید مطمئن شوید که SmartDocs در Edge نصب شده باشد. برای اطلاعات بیشتر درباره نصب Edge و SmartDocs، به نصب SmartDocs مراجعه کنید.

      برای کسب اطلاعات بیشتر درباره SmartDocs، به استفاده از SmartDocs برای مستندسازی میاناهای برنامه‌سازی کاربردی مراجعه کنید.

      ‫۱۱. گام بعدی چیست؟

      مراحل بعدی شما پس‌از نصب درگاه «خدمات توسعه‌دهنده» پیکربندی و سفارشی‌سازی آن برای الزامات خاص شما است. اسناد موجود در وب‌سایت Apigee حاوی همه اطلاعات مربوط به پیکربندی، سبک‌بندی، و مدیریت درگاه است. به اسناد در http://apigee.com/docs/developer-services/content/what-developer-portal دسترسی پیدا کنید.

      جدول زیر برخی‌از رایج‌ترین کارهایی را که پس‌از نصب انجام می‌دهید فهرست می‌کند، و شامل پیوندهایی به اسناد Apigee است که در آنجا می‌توانید اطلاعات بیشتری پیدا کنید:

      تکلیف

      شرح

      سفارشی‌سازی کردن زمینه

      زمینه ظاهر درگاه را تعریف می‌کند، ازجمله رنگ‌ها، سبک، و دیگر جنبه‌های بصری.

      سفارشی‌سازی کردن ظاهر

      صفحه اصلی شامل منو اصلی، پیام خوشامدگویی، سرصفحه، پاصفحه، و عنوان است.

      افزودن و مدیریت حساب‌های کاربری

      فرایند ثبت‌نام نحوه ثبت حساب توسعه‌دهندگان جدید را در درگاه کنترل می‌کند. برای مثال، آیا توسعه‌دهندگان جدید بلافاصله به درگاه دسترسی پیدا می‌کنند یا باید توسط سرپرست تأیید شوند. این فرایند همچنین نحوه مطلع شدن سرپرست درگاه را هنگام ایجاد حساب جدید کنترل می‌کند.

      درحال پیکربندی ایمیل

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

      افزودن و مدیریت حساب‌های کاربری

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

      افزودن و مدیریت حساب‌های کاربری

      این درگاه مدل مجوزدهی نقش‌محور را اجرا می‌کند. قبل‌از اینکه به توسعه‌دهندگان اجازه دهید ثبت‌نام کنند، اجازه‌ها و نقش‌های مورداستفاده در درگاه را تعریف کنید.

      افزودن پست‌های وبلاگ و تالار گفتمان

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

      مطمئن شوید که از پایگاه داده پشتیبان‌گیری می‌کنید

      مطمئن شوید که از پایگاه داده Drupal پشتیبان‌گیری می‌کنید. توجه داشته باشید که چون هر نصب متفاوت است، تعیین بهترین روش برای پشتیبان‌گیری از پایگاه داده به شما بستگی دارد.

      راه‌اندازی نام میزبان

      اگر نام میزبان را در سرور ساناد خود راه‌اندازی نکنید، همیشه می‌توانید ازطریق نشانی IP سرور به سایت دسترسی پیدا کنید. اگر می‌خواهید از نام میزبان استفاده کنید، می‌توانید ساناد را برای سرور پیکربندی کنید، که باید بدون هیچ پیکربندی دیگری در راه‌اندازی پایه به‌درستی کار کند.

      اگر متعادل‌کننده بار راه‌اندازی کرده‌اید یا به دلیل دیگری نشانی‌های وب نادرست در سایتتان دریافت می‌کنید، می‌توانید $base_url را در فایل settings.php «درگاه توسعه» تنظیم کنید که به‌طور پیش‌فرض در دایرکتوری /var/www/html/sites/default قرار دارد.