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

Edge for Private Cloud версии 4.17.01

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

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

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

  • Отключите SELinux на узле или установите для него разрешающий режим. Подробнее о том, как установить утилиту apigee-setup для Edge…
  • Решите, хотите ли вы включить аутентификацию Cassandra.
  • Решите, хотите ли вы настроить репликацию master-standby для Postgres.
  • Выберите конфигурацию Edge из списка рекомендуемых топологий. Например, вы можете установить Edge на одном узле для тестирования или на 13 узлах для рабочей среды. Подробнее о том, как настроить репликацию Master-Standby для Postgres…
  • На каждом узле в выбранной топологии установите утилиту Edge apigee-setup:
    • Скачайте файл Edge bootstrap_4.17.01.sh в каталог /tmp/bootstrap_4.17.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 и зависимостей. Чтобы установить, удалить или обновить Edge, команды 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, добавьте в файл sudoers следующую строку:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

Вы должны передать утилите 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 на узлах без внешнего подключения к интернету, как описано в предыдущем разделе.

Однако у локального репозитория есть ещё одно преимущество, даже для узлов с внешним подключением к интернету. При установке Edge из общедоступного репозитория Apigee вы всегда устанавливаете последние версии RPM Edge. Поэтому, если вы хотите загрузить и сохранить RPM Edge для определенной версии Edge, вам следует создать локальный репозиторий для этой версии Edge. Затем вы сможете использовать это локальное хранилище для установки любой версии Edge.

Например, сначала вы используете локальный репозиторий для установки среды разработки Edge. Затем, когда вы будете готовы перейти в рабочую среду, вы снова установите Edge из локального репозитория. Установка из локального репозитория гарантирует, что среды разработки и производства будут совпадать.

Зеркальный репозиторий очень гибкий. Например, вы можете создать зеркальный репозиторий из последних RPM-пакетов Edge или из определенной версии Edge. После создания репозитория вы также можете обновить его, чтобы добавить RPM из разных версий Edge. Подробнее о том, как установить утилиту apigee-setup для 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 корневой каталог установки обозначается как:

<inst_root>/apigee

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

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

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

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

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

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

Компоненты

Местоположение

Сервер управления

<inst_root>/apigee/var/log/edge-management-server

Маршрутизатор

<inst_root>/apigee/var/log/edge-router

Message Processor

<inst_root>/apigee/var/log/edge-message-processor

Сервер Apigee Qpid

<inst_root>/apigee/var/log/edge-qpid-server

Сервер Apigee Postgres

<inst_root>/apigee/var/log/edge-postgres-server

Интерфейс Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

База данных PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

Данные

Компоненты

Местоположение

Сервер управления

<data_root>/apigee/data/edge-management-server

Маршрутизатор

<data_root>/apigee/data/edge-router

Message Processor

<data_root>/apigee/data/edge-message-processor

Агент Apigee Qpid

<data_root>/apigee/data/edge-qpid-server

Агент Apigee Postgres

<data_root>/apigee/data/edge-postgres-server

ZooKeeper

<data_root>/apigee/data/apigee-zookeeper

OpenLDAP

<data_root>/apigee/data/apigee-openldap

Cassandra

<data_root>/apigee/data/apigee-cassandra/data

Qpidd

<data_root>/apigee/data/apigee-qpid/data

База данных PostgreSQL

<data_root>/apigee/data/apigee-postgres/pgdata

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

После завершения установки вы можете выполнить дополнительные действия с компонентами 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