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

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

Перед установкой убедитесь, что:

• Вы выполняете установку в 64-разрядной версии поддерживаемой версии Red Hat Enterprise Linux, CentOS или Oracle. Список поддерживаемых версий смотрите здесь .
• Юм установлен.
• Вы создаете резервную копию существующих установок. Если вы изменили какой-либо код в ядре Drupal или в каких-либо непользовательских модулях, ваши изменения будут перезаписаны. Сюда входят, среди прочего, любые изменения, которые вы могли внести в .htaccess . Вы должны предположить, что все, что находится за пределами каталога /sites , принадлежит Drupal. Исключением из этого правила является файл robots.txt ; если этот файл существует в корне сети, он сохранится для вас. Прежде чем продолжить установку, сделайте резервную копию всего корневого веб-каталога Drupal. Местоположение установки по умолчанию — /var/www/html , но вы могли изменить его во время установки. После выполнения шагов установки, описанных ниже, вы можете восстановить свои настройки из резервной копии.

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

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. Проверьте подключение к Apigee Edge.

Проверьте подключение к пограничному серверу управления, выполнив следующую команду cURL из командной строки на сервере портала:
> curl -u { ЭЛЕКТРОННАЯ ПОЧТА }:{ ПАРОЛЬ } https://{имя хоста}:8080/v1/organizations/{ ИМЯ ОРГАНИЗАЦИИ }

Где EMAIL и PASSWORD — адрес электронной почты и пароль администратора ORGNAME .

Обязательно укажите имя хоста и номер порта, соответствующие вашей установке Edge. Порт 8080 — это порт по умолчанию, используемый Edge. Если вы подключаетесь к организации в облаке, URL-адрес запроса: https://api.enterprise.apigee.com/v1/organizations/ {ORGNAME}.

В случае успеха эта команда возвращает ответ, подобный следующему:
{
«создано»: 1348689232699,
"createBy": "ИМЯ ПОЛЬЗОВАТЕЛЯ",
"displayName": "cg",
«среды»: [ «тест», «продукт»],
«lastModifiedAt»: 1348689232699,
"lastModifiedBy": "foo@bar.com",
"имя" : "кг",
"характеристики" : {
"свойство" : [ ]
},
«тип»: «пробная»
}

3. Удалите версии PHP до 7.0.

Перед началом установки сценарий установки проверяет наличие в системе версий PHP до 7.0. Если существуют версии PHP до 7.0, отображается следующее предупреждающее сообщение:

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>

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

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

На сервере с подключением к Интернету:

Чтобы установить службы Developer Channel Services на сервер с подключением к Интернету:

1. Войдите на сервер как root или суперпользователь.
2. Создайте каталог для установочных файлов, например портал .
3. Перейдите в новый каталог портала и загрузите файл DeveloperServices_x.yz.tar Developer Channel Services_x.yz.tar, где xyz соответствует номеру версии портала.
   
   Вы можете скачать файл по ссылке, отправленной вам Apigee в браузере, или скопировав его и затем добавив в следующую команду cURL:
   > curl -kOL <вставьте ссылку сюда>
4. Извлеките содержимое .tar-файла Developer Channel Services с помощью команды:
   > tar -xvf <tar-файл>
5. Компакт-диск с DeveloperServices-4.xyz .
6. Запустите сценарий установки, используя следующую команду:
   > ./networked-install.sh
7. Отвечайте на подсказки.

На сервере без подключения к Интернету:

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

1. Войдите в систему с подключением к Интернету как root или как суперпользователь.
2. Создайте каталог для установочных файлов, например портал_tar .
3. Перейдите в каталог портал_tar и загрузите файл 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 для установки без сети.

1. Войдите на сервер как root или суперпользователь.
2. Создайте каталог для установочных файлов, например портал .
3. компакт-диск в каталог портала .
4. Скопируйте файл .tar.gz , созданный для автономной установки (в описанной выше процедуре), в каталог портала .
5. Извлеките содержимое файла .tar.gz с помощью команды:
   > tar -xvf <tar-файл>
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. Отвечайте на подсказки.

5. Настройте свой портал разработчика

Большая часть настройки портала выполняется без вашего участия, например установка модуля Drupal и создание контента по умолчанию. Вам будет предложено настроить базу данных, настроить конечную точку Edge и создать нового пользователя-администратора.

Чтобы настроить портал разработчика:

1. Перейдите к URL-адресу сервера в браузере, например:
   http://локальный хост . Или, если у вас настроен определенный IP-адрес или DNS, перейдите по адресу http://IP_address или http://DNS_name .
   
   Вы будете перенаправлены на страницу конфигурации базы данных профиля Apigee.
   
   Примечание . Обычно вы уже настроили имя хоста и зарегистрировали его на своем DNS-сервере, поэтому вам не нужно использовать http://localhost .
2. Настройте подключение к базе данных. Если база данных находится на удаленном компьютере, разверните раздел «Дополнительные параметры» и введите информацию о подключении к этому компьютеру, затем выберите «Сохранить и продолжить» .
3. Настройте соединение с конечной точкой Apigee, введя следующую информацию, а затем выберите «Сохранить».
   Дополнительные сведения об этих значениях см. в разделе «Информация, необходимая перед началом установки» на странице Требования к порталу служб разработчиков .
   1. API управления организацией
   2. URL-адрес конечной точки API управления
   3. Аутентифицированный пользователь конечной точки
   4. Пароль аутентифицированного пользователя
4. Настройте пользователя-администратора, введя следующую информацию, а затем выберите Сохранить. Обратите внимание, что Drupal по умолчанию создает пользователя-администратора с именем «admin», поэтому не используйте «admin» в качестве имени пользователя.
   Если вы пропустите этот шаг, вы все равно сможете использовать Drush для создания администратора, как описано ниже в разделе 4. Создайте пользователя-администратора.
   1. Имя и фамилия разработчика
   2. Имя пользователя портала разработчика
   3. Пароль
   4. Адрес электронной почты
5. После завершения установки установите права доступа к файлу settings.php :
   > chmod 640 /var/www/html/sites/default/settings.php
6. Перейдите на домашнюю страницу портала по адресу http://localhost/ или DNS-имя вашего портала.
7. Войдите на портал, используя учетные данные администратора.

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

Используйте 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, где вы можете найти дополнительную информацию: