Обзор пограничной установки

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

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

Установка Edge на узел — многоэтапный процесс:

1. Отключите SELinux на узле или переведите его в разрешительный режим. Подробнее см. в разделе Установка утилиты Edge apigee-setup .
2. Решите, хотите ли вы включить аутентификацию Cassandra.
3. Решите, хотите ли вы настроить репликацию master-standby для Postgres.
4. Выберите конфигурацию Edge из списка рекомендуемых топологий. Например, вы можете установить Edge на одном узле для тестирования или на 13 узлах для производственной среды. Подробнее см. в разделе «Топологии установки» .
5. На каждом узле выбранной топологии установите утилиту Edge apigee-setup :
   • Загрузите файл Edge bootstrap_4.52.02.sh в /tmp/bootstrap_4.52.02.sh .
   • Установите утилиту Edge apigee-service и ее зависимости.
   • Установите утилиту Edge apigee-setup и зависимости.

     Дополнительные сведения см. в разделе Установка утилиты Edge apigee-setup .

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

   См. раздел Установка компонентов Edge на узле .

7. На узле сервера управления используйте утилиту apigee-setup для установки apigee-provision — утилиты, используемой для создания и управления организациями Edge.

   Более подробную информацию см. в разделе «Присоединение к организации» .

8. Перезапустите компонент Classic UI на каждом узле после завершения установки, как показано в следующем примере:

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

9. (Рекомендуется) После завершения первоначальной установки Apigee рекомендует установить новый Edge UI (имя компонента — edge-management-ui ), представляющий собой расширенный пользовательский интерфейс для разработчиков и администраторов Apigee Edge для частного облака.

   Более подробную информацию см. в разделе Установка нового Edge UI .

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

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

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

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

• утилита apigee-service :
  • Команды apigee-service : install, uninstall, update .
  • команды apigee-all : install, uninstall, update .
• Скрипт setup.sh для установки компонентов Edge (если вы еще не использовали « apigee-service install » для установки необходимых RPM-пакетов. В этом случае вам потребуются права root или полный доступ sudo, если это не требуется.)
• Скрипт 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. chown владельца файла на «apigee:apigee» или, если вы изменили пользователя, от имени которого запущена служба Edge, с пользователя «apigee», измените владельца файла на пользователя, от имени которого запущена служба Edge.

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

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

1. Задачи, выполняемые пользователем root:
   1. Загрузите и запустите файл bootstrap_4.52.02.sh :

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      На этом шаге устанавливается утилита apigee-service и создается пользователь «apigee».

   2. Настройте пользователя с полным доступом sudo к пользователю «apigee», как описано в разделе Создание пользователя с полным доступом 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-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 на узле и chown его на «apigee:apigee».

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

Дополнительную информацию см. в разделе Установка компонентов Edge на узле .

Действия при сбое установки

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

После установки или обновления обязательно перезапустите компонент Edge UI на каждом узле, на котором он запущен.

Установка через Интернет или без Интернета

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

• Узлы с внешним подключением к Интернету

  Узлы с внешним подключением к Интернету получают доступ к репозиторию Apigee для установки RPM-пакетов Edge и зависимостей.

• Узлы без внешнего подключения к Интернету

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

  Для создания внутреннего репозитория 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 поддерживает следующее свойство:

ENABLE_SYSTEM_CHECK=y

Если этому свойству присвоено значение «y», установщик проверит, соответствует ли система требованиям к процессору и памяти для устанавливаемого компонента. Значение по умолчанию — «n», что отключает проверку.