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

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

Ниже приведены требования к аппаратному и программному обеспечению для установки.

Аппаратное обеспечение

Требования

Операционная система

Эти инструкции и файлы установки были протестированы на операционных системах, перечисленных на странице https://apigee.com/docs/api-services/reference/supported-software.

ОЗУ

1 ГБ

Жесткий диск

10 ГБ

Сетевой интерфейс

Требуется подключение к интернету.

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

Например, запрос к https://drupal.org/ возвращает код статуса HTTP 301 и перенаправляет на https://www.drupal.org/.

Прокси-сервер должен быть настроен так, чтобы возвращать код статуса HTTP 200 с запрошенным контентом из переадресации.

Если в вашей среде SAP настроено проксирование исходящих HTTPS-запросов, то прокси-сервер должен поддерживать TLSv1.0. OpenSSL 0.9.8 не поддерживает TLSv1.1 и TLSv1.2, а только TLSv1.0.

Требования к базе данных MySQL

Если вы решите установить MySQL Server на том же компьютере, что и Developer Channel Services (топология с одним компьютером), установщик Developer Channel Services предложит вам ввести имя базы данных и пользователя базы данных, а затем установит MySQL Server и создаст для вас схему базы данных. Установлена последняя версия, доступная для вашей ОС.

Если вы хотите установить MySQL Server в отдельной системе, сделайте это до запуска установщика Developer Channel Services. У вас должна быть установлена версия MySQL 5.0.15 или более поздняя.

Для установщика Developer Channel Services требуется, чтобы MySQL Server содержал базу данных с пустой схемой базы данных. Программа установки Developer Channel Services запросит имя хоста базы данных, название базы данных и имя пользователя базы данных. Затем программа установки подключается к базе данных, чтобы создать таблицы и данные по умолчанию.

Пользователь базы данных используется сервисами Developer Channel Services для подключения к базе данных и должен иметь следующие привилегии: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Например, чтобы создать базу данных с именем devportal и пользователя с именем devportal, выполните следующие команды:

  1. Установите MySQL Server в системе.
  2. Войдите в MySQL как пользователь root, используя следующую команду:
    > mysql -u root -p
  3. Введите пароль пользователя root.
  4. В командной строке mysql> введите следующие команды, чтобы создать пользователя devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. В командной строке создайте базу данных devportal:
    > mysqladmin -u devportal -p create devportal

    Введите пароль devportal.
  6. Войдите в MySQL и предоставьте доступ к devportal с IP-адреса сервера портала:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    где portalIP – IP-адрес сервера портала, а devportalPW – пароль пользователя devportal.
  7. Отредактируйте файл /etc/my.cnf, чтобы задать для bind-address IP-адрес сервера MySQL.
  8. Перезапустите MySQL:
    > /etc/init.d/mysqld restart
  9. Убедитесь, что на сервере MySQL открыт порт 3306. Процедура зависит от операционной системы. Например, для Linux используйте команду:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

При установке Developer Channel Services укажите, что не нужно устанавливать MySQL Server локально. Затем вам будет предложено ввести IP-адрес, имя пользователя и название удаленной базы данных.

Требования к Red Hat Enterprise Linux (RHEL)

Для RHEL действуют дополнительные требования, поскольку для доступа к скачиванию ПО от Red Hat нужна подписка. Сервер должен иметь возможность подключаться к интернету, чтобы скачивать RPM-пакеты через yum. Если вы используете RHEL, сервер должен быть зарегистрирован в Red Hat Network (RHN) и в дополнительном канале сервера.

Требования Red Hat проверяются во время установки, и установщик портала запрашивает вас, если RHEL еще не зарегистрирован. Если у вас уже есть учетные данные Red Hat, вы можете использовать следующую команду, чтобы зарегистрировать RHEL перед началом установки:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Замените my_username и my_password своими учетными данными Red Hat.

Если вы используете пробную версию RHEL, вы можете получить пробную лицензию на 30 дней. Дополнительную информацию можно найти на странице https://access.redhat.com/solutions/32790.

Требования к SMTP

По умолчанию портал отправляет почту с помощью функции PHP mail(). PHP пытается отправить электронное письмо с помощью sendmail в локальной системе, которую можно настроить в файле php.ini.

В рабочей среде Apigee требует, чтобы вы настроили SMTP-сервер для отправки электронных писем с портала. Поэтому необходимо убедиться, что у Drupal есть доступ к нужному порту на SMTP-сервере. Для SMTP без TLS обычно используется порт 25. Для SMTP с поддержкой TLS часто используется порт 465, но лучше уточнить у поставщика SMTP.

Дополнительные требования

Для установки ПО у пользователя должен быть root-доступ.

Требования к архитектуре развертывания

Developer Channel Services имеет единый интерфейс с сервером управления Apigee через REST API для хранения и извлечения информации о приложениях пользователя. Сервисы каналов Developer должны иметь возможность подключаться к серверу управления по протоколу HTTP или HTTPS в зависимости от типа установки.

Информация, необходимая перед началом установки

Перед началом установки у вас должна быть следующая информация:

  1. Какую платформу вы настраиваете: Red Hat или CentOS? Если вы устанавливаете Red Hat, компьютер должен быть зарегистрирован в сети Red Hat Network, чтобы скачивать RPM.
  2. Вы планируете установить MySQL на локальный компьютер? В некоторых установках высокой доступности MySQL должен находиться на машине, отличной от той, которая обслуживает веб-страницы портала. В этом случае не устанавливайте MySQL локально. Если вы хотите, чтобы все компоненты были установлены на одном компьютере, установите MySQL локально.
  3. Если вы планируете получить доступ к удаленному серверу MySQL, вам понадобятся имя хоста, порт, название базы данных, имя пользователя и пароль удаленного сервера MySQL. Удаленный сервер MySQL должен быть настроен до начала установки.
  4. Какое полное доменное имя у веб-сервера? (Эта информация будет добавлена в файл /etc/hosts.) Это должен быть IP-адрес или имя хоста, например portalserver.example.com. Значение по умолчанию – localhost.
  5. Хотите использовать конфигурацию Apigee по умолчанию для виртуального хоста Apache? Один виртуальный хост создается с именем хоста, указанным на шаге 7.
  6. Для связи портала с сервером управления Apigee Edge используются три элемента информации. Это следующие данные:
    1. URL конечной точки Apigee Management API. Это может быть имя хоста или IP-адрес. Это конечная точка REST, к которой выполняются все вызовы для создания приложений и регистрации разработчиков для получения ключей приложений. Конечная точка по умолчанию – https://api.enterprise.apigee.com/v1.

      Для установки Edge for Private Cloud URL имеет следующий формат:
      http://EdgeIp:8080/v1

      или:
      https://EdgeIp:SSLport/v1

      где EdgeIp – IP-адрес сервера управления Edge, а SSLport – SSL-порт для Edge Management API. Например, 8443.
    2. Название организации Apigee. Порталы связаны с организациями Apigee Edge. Вы настроите организацию по умолчанию при настройке конечной точки Management API. Значение по умолчанию – my-org.
    3. Имя пользователя и пароль для конечной точки Management API. Вызовы из портала в Edge должны выполняться администратором организации.

      Это имя пользователя и пароль администратора вашей организации. Их следует использовать только для подключения к Edge с портала. Например, если вы укажете учетные данные пользователя, а затем удалите его в Edge, портал больше не сможет подключаться к Edge. Поэтому создайте в организации администратора только для этого подключения.

      Пример:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd