Обзор установки Edge

Edge for Private Cloud v4.18.01

Типичная установка Edge состоит из компонентов Edge, распределенных по нескольким узлам. После установки Edge на узел вы устанавливаете и настраиваете один или несколько компонентов Edge на узле.

Процесс установки

Установка Edge на узел состоит из нескольких шагов:

• Отключите SELinux на узле или установите для него разрешающий режим. Подробнее о том, как установить утилиту apigee-setup для Edge…
• Решите, хотите ли вы включить аутентификацию Cassandra.
• Решите, хотите ли вы настроить репликацию master-standby для Postgres.
• Выберите конфигурацию Edge из списка рекомендуемых топологий. Например, вы можете установить Edge на одном узле для тестирования или на 13 узлах для рабочей среды. Подробнее о топологиях установки…
• На каждом узле в выбранной топологии установите утилиту Edge apigee-setup:
  • Скачайте файл Edge bootstrap_4.18.01.sh в каталог /tmp/bootstrap_4.18.01.sh.
  • Установите утилиту Edge apigee-service и зависимости.
  • Установите утилиту Edge apigee-setup и зависимости.
    
    Подробнее об установке утилиты apigee-setup для Edge…
• Используйте утилиту apigee-setup, чтобы установить один или несколько компонентов Edge на каждом узле в соответствии с выбранной топологией.
  Подробные сведения приведены в статье Как установить компоненты Edge на узел.
• На узле Management Server используйте утилиту apigee-setup, чтобы установить apigee-provision – утилиты, которые вы используете для создания организаций Edge и управления ими.
  Подробнее о том, как зарегистрировать организацию…

Кто может выполнить установку

Файлы дистрибутива Apigee Edge устанавливаются как набор RPM и зависимостей. Для установки, удаления и обновления RPM-пакетов Edge команды должны выполняться пользователем root или пользователем с полным доступом sudo. Полный доступ sudo означает, что пользователь может выполнять те же операции, что и пользователь root.

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

• apigee-service:
  • Команды apigee-service: install, uninstall, update.
  • Команды apigee-all: install, uninstall, update.
• Скрипт setup.sh для установки компонентов Edge (если вы ещё не использовали команду apigee-service install для установки необходимых RPM). Если это не требуется, то корневой доступ или полный доступ с привилегиями администратора.
• Скрипт update.sh для обновления компонентов Edge.

Кроме того, установщик Edge создает в системе нового пользователя с именем apigee. Многие команды Edge вызывают sudo для запуска от имени пользователя apigee.

Для выполнения любых других команд, кроме перечисленных выше, пользователь должен иметь полный доступ sudo к пользователю apigee. К ним относятся:

• Команды утилиты apigee-service, в том числе:
  • Команды apigee-service, такие как start, stop, restart, configure.
  • Команды apigee-all, такие как start, stop, restart, configure.

Создание пользователя с полным доступом sudo к пользователю apigee

Чтобы предоставить пользователю полный доступ sudo к пользователю apigee, используйте команду visudo, чтобы изменить файл sudoers и добавить:

installUser        ALL=(apigee)      NOPASSWD: ALL

где installUser – имя пользователя, работающего с Edge.

Настройка разрешений для файлов конфигурации

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

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

1. Создайте файл в редакторе от имени любого пользователя.
2. Смените владельца файла на apigee:apigee или, если вы изменили пользователя, запускающего сервис Edge, с apigee на другого, смените владельца файла на пользователя, запускающего сервис Edge.

Разделение задач по установке Edge между пользователем root и другими пользователями

Проще всего выполнить весь процесс установки Edge от имени пользователя root или пользователя, у которого есть полный доступ sudo, но это не всегда возможно. Вместо этого вы можете разделить процесс на задачи, выполняемые пользователем root, и задачи, выполняемые пользователем с полным доступом sudo к пользователю apigee.

1. Задачи, выполняемые пользователем root:
   1. Скачайте и запустите файл bootstrap_4.18.01.sh:??
      > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
      
      На этом шаге устанавливается утилита apigee-service и создается пользователь apigee.
   2. Настройте для пользователя полный доступ sudo к пользователю apigee, как описано выше.
   3. Установите утилиту apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. Используйте утилиту apigee-setup, чтобы установить RPM-пакеты Edge на узел:
      > /opt/apigee/apigee-service/bin/apigee-service compName install
      
      RPM-пакеты Edge, которые вы устанавливаете на узел, зависят от вашей топологии. Список доступных компонентов: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.
2. После того как пользователь root установит RPM-пакеты Edge на узел, пользователь с полным доступом sudo к пользователю apigee завершает процесс настройки:
   1. Используйте утилиту setup.sh, чтобы завершить настройку компонентов Edge на узле. Формат команды зависит от компонентов, установленных на узле. Полный список приведен в статье Как установить компоненты Edge на узел.
      Например, чтобы завершить установку ZooKeeper и Cassandra, используйте следующую команду:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
      
      где configFile – файл конфигурации Edge.
      
      Чтобы выполнить полную установку, используйте следующую команду:
      > /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

Расположение файлов конфигурации установки

Вы должны передать утилите apigee-setup файл конфигурации, содержащий информацию об установке Edge. Единственное требование к автоматической установке – файл конфигурации должен быть доступен или доступен для чтения пользователю apigee. Например, поместите файл в каталог /usr/local/var или /usr/local/share на узле и измените владельца на apigee:apigee.

В файле конфигурации необходимо указать все данные, кроме пароля системного администратора Edge. Если вы не укажете пароль, утилита apigee-setup предложит ввести его в командной строке.

Подробнее о том, как установить компоненты Edge на узел…

Что делать, если не удается установить приложение

Если при установке компонента Edge произошел сбой, попробуйте устранить проблему и запустить установщик снова. Установщик предназначен для многократного запуска в случае обнаружения сбоя или если вы захотите изменить или обновить компонент после установки.

Установка с подключением к интернету или без него

Чтобы установить Edge на узел, узел должен иметь доступ к репозиторию Apigee:

• Узлы с внешним подключением к интернету
  
  Узлы с внешним подключением к интернету получают доступ к хранилищу Apigee для установки RPM-пакетов Edge и зависимостей.
• Узлы без внешнего подключения к интернету
  
  Узлы без внешнего подключения к интернету могут получить доступ к зеркальной версии хранилища Apigee, которую вы настроили внутри компании. Это хранилище содержит все RPM-пакеты Edge, но вы должны убедиться, что все остальные зависимости доступны из хранилищ во внутренней сети.
  
  Примечание. Apigee не размещает все сторонние зависимости в наших общедоступных репозиториях. Вам нужно скачать и установить эти зависимости из общедоступных хранилищ.
  
  Чтобы создать внутренний репозиторий Apigee, вам нужен узел с внешним доступом к интернету, чтобы вы могли скачать RPM-пакеты Edge и зависимости. После создания внутреннего репозитория вы можете переместить его на другой узел или сделать этот узел доступным для узлов Edge для установки.

Использование локального репозитория Edge для поддержки версии Edge

Одна из причин использования локального или зеркального репозитория – установка Edge на узлах без внешнего подключения к интернету, как описано в предыдущем разделе.

Как устранить зависимости при установке RPM

Файлы дистрибутива Apigee Edge устанавливаются как набор RPM-файлов, каждый из которых может иметь собственную цепочку зависимостей установки. Многие из этих зависимостей определяются сторонними компонентами, которые находятся вне контроля Apigee и могут измениться в любое время. Поэтому в документации не указаны точные номера версий для каждой зависимости.

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

Основные команды Yum

Инструменты установки Edge для Linux используют Yum для установки и обновления компонентов. Для управления установкой на узле может потребоваться несколько команд Yum.

• Очистите все кеши Yum:
  sudo yum clean all
• Чтобы обновить компонент Edge, выполните следующую команду:
  sudo yum update componentName
  Пример:
  sudo yum update apigee-setup
  sudo yum update edge-management-server

Структура файловой системы

Edge устанавливает все файлы в каталог /opt/apigee.

В этом руководстве и в руководстве по операциям Edge корневой каталог установки обозначается как:

/opt/apigee

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

Файлы журналов

Файл журнала для apigee-setup и скрипт setup.sh записываются в /tmp/setup-root.log.

Файлы журналов для каждого компонента находятся в каталоге /opt/apigee/var/log. Каждый компонент имеет свой подкаталог. Например, журналы для сервера управления находятся в каталоге:

/opt/apigee/var/log/edge-management-server

В таблицах ниже указано расположение файлов журналов.

Данные

Задачи после установки

После завершения установки вы можете выполнить дополнительные действия с компонентами Edge.

Настройка компонентов Edge после установки

Для настройки Edge после установки используются файлы .properties и утилиты Edge. Например, чтобы настроить TLS/SSL в Edge UI, нужно задать необходимые свойства в файлах .properties. После изменения файлов .properties необходимо перезапустить затронутый компонент Edge.

Файлы .properties находятся в каталоге /opt/apigee/customer/application. У каждого компонента в этом каталоге есть собственный файл .properties. Например, router.properties и management-server.properties.

Чтобы задать свойство для компонента, измените соответствующий файл .properties, а затем перезапустите компонент:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Пример:

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

При обновлении Edge считываются файлы .properties в каталоге /opt/apigee/customer/application. Это означает, что при обновлении сохраняются все свойства, заданные для компонента.

Подробнее о том, как настроить Edge…

Вызов команд для компонентов Edge

Edge устанавливает утилиты управления в каталог /opt/apigee/apigee-service/bin. Их можно использовать для управления установкой Edge. Например, вы можете использовать утилиту apigee-all, чтобы запустить, остановить, перезапустить или определить статус всех компонентов Edge на узле:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Для управления отдельными компонентами и их настройки используйте утилиту apigee-service. Утилита apigee-service имеет следующий формат:

/opt/apigee/apigee-service/bin/apigee-service component action

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

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Вы можете определить список компонентов, установленных на узле, изучив каталог /opt/apigee. В этом каталоге есть подкаталог для каждого компонента Edge, установленного на узле. Каждый подкаталог имеет префикс:

• apigee – сторонний компонент, используемый Edge. Например, apigee-cassandra.
• edge – компонент Edge из Apigee. например edge-management-server.
• edge-mint – компонент монетизации. Например, edge-mint-management-server.
• baas – компонент API BaaS. Пример: baas-usergrid.

Полный список действий для компонента зависит от самого компонента, но все компоненты поддерживают следующие действия:

• start, stop, restart
• status, version
• резервное копирование, восстановление
• install, uninstall