Установка портала служб для разработчиков

Портал услуг для разработчиков, версия 4.16.05

Выполните следующие действия, чтобы установить портал Developer Channel Services.

Прежде чем продолжить установку, сделайте резервную копию всего корневого веб-каталога Drupal. Местоположение установки по умолчанию — /var/www/html , но вы могли изменить его во время установки. После выполнения шагов установки, описанных ниже, вы можете восстановить свои настройки из резервной копии.

1. Получите пакет услуг Developer Channel Services.

Перейдите по адресу http://community.apigee.com/content/apigee-customer-support и выберите «Войти на свой портал поддержки», чтобы запросить файл .tar Developer Channel Services одним из двух способов:

• Запросите доступ к каталогу загрузки Edge for Private Cloud.
• Запросите URL-адрес .tar-файла Developer Channel Services.

2. Убедитесь, что ваша система соответствует системным требованиям.

Перед установкой портала ваш сервер должен соответствовать следующим требованиям:

1. Убедитесь, что вы выполняете установку в 64-разрядной версии поддерживаемой версии Red Hat Enterprise Linux, CentOS или Oracle. Список поддерживаемых версий смотрите здесь .
2. Убедитесь, что Yum установлен.
3. (Для установки на сервер без подключения к Интернету) Сначала необходимо загрузить все необходимые файлы на сервер с подключением к Интернету в виде одного файла .tar.gz. Затем вы копируете этот файл .tar.gz на сервер без подключения к Интернету для выполнения установки.
   1. Войдите на сервер с подключением к Интернету как root или как суперпользователь.
   2. Создайте каталог для установочных файлов, например портал_tar .
   3. Перейдите в новый каталог и загрузите файл DeveloperServices_ x.yz .tar Developer Channel Services_ x.yz .tar , где xyz соответствует номеру версии портала.
   4. Извлеките содержимое .tar-файла Developer Channel Services с помощью команды:
      > tar -xvf <tar-файл>
   5. Компакт-диск с DeveloperServices-4.xyz .
   6. Создайте файл портала .tar.gz с помощью команды:
      > ./non-networked-install.sh
      
      Эта команда загружает все необходимые файлы в один файл .tar.gz. Затем вы копируете этот файл .tar.gz на свой сервер, у которого нет подключения к Интернету, для завершения установки.
4. Проверьте подключение к пограничному серверу управления, выполнив следующую команду cURL из командной строки на сервере портала:
   > curl -u { ЭЛЕКТРОННАЯ ПОЧТА }:{ ПАРОЛЬ } https://{имя хоста}:8080/v1/organizations/{ ИМЯ ОРГАНИЗАЦИИ }
   
   Где EMAIL и PASSWORD — адрес электронной почты и пароль администратора ORGNAME .
   
   Обязательно укажите имя хоста и номер порта, соответствующие вашей установке Edge. Порт 8080 — это порт по умолчанию, используемый Edge. Если вы подключаетесь к облаку организации, URL-адрес запроса:
   https://api.enterprise.apigee.com/v1/organizations/{ИМЯ ОРГАНИЗАЦИИ}
   
   В случае успеха эта команда возвращает ответ, подобный следующему:
   {
   «создано»: 1348689232699,
   "createBy": "ИМЯ ПОЛЬЗОВАТЕЛЯ",
   "displayName": "cg",
   «среды»: [ «тест», «продукт»],
   «lastModifiedAt»: 1348689232699,
   "lastModifiedBy": "foo@bar.com",
   "имя" : "кг",
   "характеристики" : {
   "свойство" : [ ]
   },
   «тип»: «пробная»
   }

3. Установите Developer Channel Services с помощью сценария автоматической установки.

Используйте следующую процедуру для установки портала с помощью сценария автоматической установки. Эта процедура работает для серверов с внешним подключением к Интернету или без него.

1. Войдите на сервер как root или как суперпользователь.
2. Создайте каталог для установочных файлов, например портал .
3. На сервере с подключением к Интернету:
   1. Перейдите в новый каталог портала и загрузите файл DeveloperServices_ x.yz .tar Developer Channel Services_ x.yz .tar , где xyz соответствует номеру версии портала.
      
      Вы можете скачать файл по ссылке, отправленной вам Apigee в браузере, или скопировав его и затем добавив в следующую команду cURL:
      > curl -kOL <вставьте ссылку сюда>
   2. Извлеките содержимое .tar-файла Developer Channel Services с помощью команды:
      > tar -xvf <tar-файл>
   3. Компакт-диск с DeveloperServices-4.xyz .
   4. Запустите сценарий установки, используя следующую команду:
      > ./networked-install.sh
4. На сервере без подключения к Интернету:
   1. Скопируйте файл .tar.gz, который вы создали выше в разделе 2. Убедитесь, что ваша система соответствует системным требованиям.
   2. Извлеките содержимое файла .tar.gz с помощью команды:
      > tar -xvf <tar-файл>
   3. Перейдите в каталог, созданный командой tar.
   4. Установите разрешения для сценария install-from-rpm-bundle.sh :
      > chmod 755 install-from-rpm-bundle.sh
   5. Запустите сценарий install-from-rpm-bundle.sh с помощью команды:
      > ./install-from-rpm-bundle.sh
5. Ответьте на подсказки.
6. После завершения установки перейдите по URL-адресу сервера в браузере, например:
   http://локальный хост . Или, если у вас настроен определенный IP-адрес или DNS, перейдите по адресу http://IP_address или http://DNS_name .
   
   Вы будете перенаправлены на страницу конфигурации базы данных профиля Apigee.
   
   Примечание . Обычно вы уже настроили имя хоста и зарегистрировали его на своем DNS-сервере, поэтому вам не нужно использовать http://localhost .
7. Настройте подключение к MySQL. Если MySQL находится на удаленном компьютере, разверните раздел «Дополнительные параметры» и введите информацию о подключении к этому компьютеру, затем выберите « Сохранить и продолжить» .
8. Настройте соединение с конечной точкой Apigee, введя следующую информацию, а затем выберите «Сохранить» :
   Дополнительные сведения об этих значениях см. в разделе «Информация, необходимая перед началом установки» на странице Требования к порталу служб разработчиков .
   1. Организация портала разработчиков
   2. URL-адрес конечной точки портала разработки
   3. Аутентифицированный пользователь конечной точки
   4. Пароль аутентифицированного пользователя
9. При появлении запроса нажмите кнопку «Установить образец SmartDocs WADL», чтобы установить образец SmartDocs WADL. Если вы пропустите этот шаг, пример API SmartDocs не появится на вашем портале.
   Примечание . Если ваш портал подключается к установке Apigee Edge для частного облака, и эта установка Edge не имеет внешнего подключения к Интернету, вам необходимо выполнить дополнительную настройку модуля SmartDocs, прежде чем вы сможете использовать SmartDocs. Дополнительную информацию о SmartDocs см. на странице http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis .
10. Настройте параметры SMTP-сервера . Apigee требует, чтобы вы настроили SMTP-сервер для отправки сообщений электронной почты с портала.
    Для получения дополнительной информации см. http://apigee.com/docs/developer-services/content/configuring-email .
11. Настройте пользователя-администратора, введя следующую информацию, а затем выберите Сохранить. Обратите внимание, что Drupal по умолчанию создает пользователя-администратора с именем «admin», поэтому не используйте «admin» в качестве имени пользователя.
    Если вы пропустите этот шаг, вы все равно сможете использовать Drush для создания администратора, как описано ниже в разделе 4. Создайте пользователя-администратора.
    1. Имя и фамилия разработчика
    2. Имя пользователя портала разработчика
    3. Пароль
    4. Адрес электронной почты
12. После завершения установки установите права доступа к файлу settings.php :
    > chmod 640 /var/www/html/sites/default/settings.php
13. Перейдите на домашнюю страницу портала по адресу http://localhost/ или DNS-имя вашего портала.
14. Войдите на портал, используя учетные данные администратора.

4. Создайте пользователя-администратора.

Используйте Drush, чтобы создать пользователя с правами администратора для вашей установки Developer Channel Services. Drupal по умолчанию автоматически создает пользователя-администратора с именем «admin», поэтому не используйте «admin» в качестве имени пользователя.

1. Перейдите в каталог drupal_root/sites/default. Стандартное расположение корневого каталога Drupal — /var/www/html:
   > cd <drupal_root>/sites/default
2. Убедитесь, что у вас есть права на запись в частные файлы Drupal:
   > удалить vget file_private_path
   
   Эта команда возвращает путь к частным файлам Drupal, например:
   file_private_path: 'сайты/по умолчанию/частный'
   
   Соответствует /var/www/html/sites/default/private/. Используйте следующую команду, чтобы убедиться, что этот каталог доступен для записи владельцу и группе:
   chmod -R g+w путь_каталога
   chmod -R o+r путь_каталогаИмя
3. Введите следующие команды, чтобы создать пользователя-администратора, заменив команды в «< >» своими значениями:
   > drush user-create <имя пользователя> --mail="<адрес электронной почты>" --password="<пароль>"
   > drush user-add-role Администратор <имя пользователя>
4. Войдите на портал разработчика в качестве администратора, используя имя пользователя и пароль, указанные выше.

5. Установите пароль root MySQL.

Если вы установили MySQL как часть установки портала, сценарий установки оставляет для пароля root MySQL значение по умолчанию, которое является пустым.

Используйте следующую команду, чтобы установить пароль root:

> mysqladmin -u root password NEWPASSWORD

Если вы ранее установили пароль root и хотите его изменить, используйте следующую команду:

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

Вам также необходимо обновить пароль в файле /var/www/html/sites/default/settings.php .

6. Убедитесь, что модуль «Менеджер обновлений» включен.

Чтобы получать уведомления об обновлениях Drupal, убедитесь, что модуль менеджера обновлений Drupal включен. В меню Drupal выберите «Модули» и прокрутите вниз до модуля «Менеджер обновлений» . Если он не включен, включите его.

После включения вы сможете просмотреть доступные обновления, используя пункт меню «Отчеты» > «Доступные обновления» . Вы также можете использовать следующую команду Drush:

> drush pm-info update

Используйте пункт меню «Отчеты» > «Доступные обновления» > «Настройки» , чтобы настроить модуль, чтобы он отправлял вам электронное письмо, когда обновления доступны, и установите частоту проверки обновлений.

7. Необязательно: развертывание на рабочем сервере.

Если вы развертываете портал на рабочем сервере, вам следует выполнить дополнительные меры безопасности, в том числе:

1. Запустите следующий сценарий, чтобы защитить установку MySQL:
   > /usr/bin/mysql_secure_installation
   
   Этот скрипт устанавливает пароль root и дает вам возможность ограничить root-доступ только локальным хостом и удалить тестовые базы данных и анонимного пользователя, созданного по умолчанию. Запуск этого сценария настоятельно рекомендуется для рабочих серверов.
2. Если этого требуют ваши корпоративные политики, включите и настройте SELinux.

8. Необязательно: настройте поисковую систему Apache Solr.

По умолчанию модули Drupal, подключающиеся к поисковой системе Apache Solr, отключены при установке портала. Большинство порталов используют внутреннюю поисковую систему Drupal и поэтому не требуют модулей Drupal Solr.

Если вы решите использовать Solr в качестве поисковой системы, вам необходимо установить Solr локально на свой сервер, а затем включить и настроить модули Drupal Solr на портале.

Чтобы включить модули Drupal Solr:

1. Войдите на свой портал как пользователь с правами администратора или создания контента.
2. Выберите «Модули» в меню Drupal.
3. Включите модуль Apache Solr Framework и модуль поиска Apache Solr .
4. Сохраните изменения.
5. Настройте Solr, как описано на https://drupal.org/node/1999280 .

9. Необязательно — установите mod_ssl для поддержки HTTPS.

Модуль mod_ssl используется HTTP-сервером Apache для обслуживания веб-страниц через HTTPS. Если вы хотите использовать HTTPS, используйте следующую команду для установки mod_ssl :

> yum install mod_ssl

Дополнительную информацию о настройке портала для использования SSL см. на странице http://apigee.com/docs/developer-services/content/using-ssl-portal .

10. Необязательно — установите SmartDocs.

SmartDocs позволяет документировать ваши API на портале Developer Services таким образом, чтобы документация по API была полностью интерактивной. Однако для использования SmartDocs с порталом необходимо сначала установить SmartDocs на Edge.

• Если вы подключаете портал к установке Edge Cloud, SmartDocs уже установлен, и дополнительная настройка не требуется.
• Если вы подключаете портал к установке Edge for Private Cloud, вы должны убедиться, что SmartDocs установлен в Edge. Дополнительные сведения об установке Edge и SmartDocs см. в разделе Установка SmartDocs .

Дополнительную информацию о SmartDocs см. в разделе Использование SmartDocs для документирования API .

11. Что дальше?

Следующие шаги после установки портала Developer Services — его настройка и настройка в соответствии с вашими конкретными требованиями. Документация на веб-сайте Apigee содержит всю информацию по настройке, стилю и управлению порталом. Получите доступ к документации по адресу http://apigee.com/docs/developer-services/content/what-developer-portal .

В следующей таблице перечислены некоторые наиболее распространенные задачи, которые вы выполняете после установки, а также ссылки на документацию Apigee, где вы можете найти дополнительную информацию: