Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как установить утилиту apigee-setup для Edge

Edge for Private Cloud версии 4.17.01

To install Edge on a node, you first install the Edge apigee-setup utility. Если у ваших узлов нет внешнего подключения к интернету, вам также необходимо установить локальную копию репозитория Apigee.

Каталог установки по умолчанию: /opt/apigee

Edge устанавливает все файлы в каталог /opt/apigee. Изменить этот каталог нельзя. Однако при желании вы можете создать символическую ссылку, чтобы сопоставить /opt/apigee с другим местоположением. Подробнее о требованиях к установке…

Предварительное требование: отключите SELinux

Прежде чем устанавливать утилиту apigee-setup или любые компоненты Edge, необходимо отключить SELinux или перевести его в разрешающий режим. При необходимости после установки Edge вы можете снова включить SELinux.

Чтобы временно перевести SELinux в разрешающий режим, выполните следующую команду:
1. В операционной системе Linux 6.x:
  echo 0 > /selinux/enforce
  
  Чтобы снова включить SELinux после установки Edge:
  echo 1 > /selinux/enforce
2. В операционной системе Linux 7.x:
  setenforce 0
  
  Чтобы снова включить SELinux после установки Edge:
  setenforce 1
Чтобы навсегда отключить SELinux или перевести его в разрешающий режим:
1. Откройте файл /etc/sysconfig/selinux в редакторе.
2. Установите значение SELINUX=disabled или SELINUX=permissive.
3. Сохраните изменения.
4. Перезапустите узел.
5. При необходимости после установки Edge снова включите SELinux, повторив эту процедуру и задав значение SELINUX=enabled.

Предварительное требование: включите репозиторий EPEL

Чтобы установить или обновить Edge, необходимо включить Extra Packages for Enterprise Linux (EPEL). Команда зависит от версии RedHat/CentOS:

Для RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; sudo rpm -ivh epel-release-latest-7.noarch.rpm
Для RedHat/CentOS 6.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; sudo rpm -ivh epel-release-latest-6.noarch.rpm

Установите утилиту Edge apigee-setup на узел с внешним подключением к Интернету.

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

Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
Войдите в узел как пользователь root, чтобы установить RPM-пакеты Edge.
Примечание. Для установки RPM-пакетов требуется доступ с правами root, но настроить Edge можно и без него.
Отключите SELinux, как описано выше.
Включите репозиторий EPEL, как описано выше.
Скачайте файл Edge bootstrap_4.17.01.sh в каталог /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
Установите утилиту apigee-service для Edge и ее зависимости:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.

По умолчанию установщик проверяет, установлена ли у вас Java 1.8. Если нет, то оно будет установлено. Используйте параметр JAVA_FIX, чтобы указать, как обрабатывать установку Java. JAVA_FIX принимает следующие значения:

I – установить OpenJDK 1.8 (по умолчанию);
C – продолжить без установки Java;
Q – выйти. В этом случае вам нужно будет установить Java самостоятельно.

При установке утилиты apigee-service создается файл /etc/yum.repos.d/apigee.repo, который определяет хранилище Apigee. Чтобы посмотреть файл определения, используйте команду:
> cat /etc/yum.repos.d/apigee.repo

Чтобы посмотреть содержимое хранилища, используйте команду:
> sudo yum -v repolist 'apigee*'
(Только для CentOS-6.x и RedHat-6.x) На всех узлах Qpid выполните следующую команду, чтобы скачать правильную версию Qpid:
> yum install apigee-qpidd --disablerepo=epel
Используйте apigee-service, чтобы установить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Используйте apigee-setup для установки и настройки компонентов Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

Установите утилиту Edge apigee-setup на узел без внешнего подключения к Интернету.

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

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

Примечание. Apigee не размещает все сторонние зависимости в наших общедоступных репозиториях. Их нужно скачать и установить из общедоступных хранилищ.

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

Создание локального хранилища Apigee

Чтобы создать локальное хранилище Apigee:

Получите от Apigee имя пользователя и пароль, которые вы используете для доступа к хранилищу Apigee. Если у вас уже есть имя пользователя и пароль для FTP-сайта Apigee, вы можете использовать их.
Войдите в узел RedHat или CentOS как root, чтобы установить RPM Edge.
Примечание. Для установки RPM требуются права root, но для настройки Edge они не нужны.
Убедитесь, что у вас установлена последняя версия yum-utils:
> sudo yum update yum-utils
Отключите SELinux, как описано выше.
Включите репозиторий EPEL, как описано выше.
Скачайте файл Edge bootstrap_4.17.01.sh в каталог /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
(Только для CentOS-6.x и RedHat-6.x) Чтобы скачать правильную версию Qpid, выполните следующую команду:
> yum install apigee-qpidd --disablerepo=epel
Установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
Установите утилиту apigee-mirror на узел:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

Примечание. Если вы обновляете существующее хранилище до версии 4.17.01, вам нужно только обновить apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Используйте утилиту apigee-mirror, чтобы синхронизировать репозиторий Apigee с каталогом /opt/apigee/data/apigee-mirror/repos/.

Чтобы минимизировать размер репозитория, добавьте --only-new-rpms, чтобы скачать только последние RPM. Для скачивания потребуется около 1,6 ГБ места на диске:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Если вы хотите скачать весь репозиторий, включая старые RPM, не указывайте --only-new-rpms. Для полного скачивания потребуется около 6 ГБ места на диске:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Теперь у вас есть локальная копия репозитория Apigee. В следующем разделе описывается, как установить утилиту Edge apigee-setup из локального репозитория.
(Необязательно.) Если вы хотите установить Edge из локального репозитория на тот же узел, на котором размещен локальный репозиторий, сначала выполните следующие команды:
1. Запустите bootstrap_4.17.01.sh из локального хранилища, чтобы установить утилиту apigee-service:
  > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
2. Используйте apigee-service, чтобы установить утилиту apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
3. Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

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

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

Создайте TAR-файл репозитория, скопируйте его на узел и установите Edge из этого файла.
Установите веб-сервер на узел с локальным репозиторием, чтобы другие узлы могли получить к нему доступ. Apigee предоставляет веб-сервер Nginx, но вы можете использовать и собственный.

Установите из файла TAR:

На узле с локальным хранилищем используйте следующую команду, чтобы упаковать локальное хранилище в один TAR-файл с названием /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
Скопируйте TAR-файл на узел, где вы хотите установить Edge. Например, скопируйте его в каталог /tmp на новом узле.
На новом узле отключите SELinux, как описано выше.
На новом узле распакуйте файл в каталог /tmp:
> tar -xzf apigee-4.17.01.tar.gz

Эта команда создает новый каталог с названием repos в каталоге, содержащем TAR-файл. Например, /tmp/repos.
Установите утилиту apigee-service и зависимости из каталога /tmp/repos:
> sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Обратите внимание, что в этой команде вы указываете путь к каталогу repos.
Используйте apigee-service, чтобы установить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Используйте apigee-setup, чтобы установить и настроить компоненты Edge на узле. Подробнее о том, как установить компоненты Edge на узел…

Установите из репозитория с помощью веб-сервера Nginx:

Установите веб-сервер Nginx на узел репозитория:
> opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
По умолчанию Nginx настроен на использование localhost в качестве имени сервера и порта 3939. Чтобы изменить эти значения:
1. Откройте файл /opt/apigee/customer/application/mirror.properties в редакторе. Если файла нет, создайте его.
2. При необходимости задайте следующие значения:
  conf_apigee_mirror_listen_port=3939
  conf_apigee_mirror_server_name=localhost
3. Перезапустите Nginx:
  > /opt/nginx/scripts/apigee-nginx restart
По умолчанию для репозитория требуется имя пользователя и пароль admin:admin. Чтобы изменить эти учетные данные, задайте следующие переменные среды:
MIRROR_USERNAME=uName
MIRROR_PASSWORD=pWord
На новом узле отключите SELinux, как описано выше.
На удаленном узле скачайте файл bootstrap_4.17.01.sh для Edge в каталог /tmp/bootstrap_4.17.01.sh:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh

где uName:pWord – имя пользователя и пароль, заданные выше для хранилища, а remoteRepo – IP-адрес или DNS-имя узла хранилища.
На удаленном узле установите утилиту Edge apigee-service и зависимости:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

где uName:pWord – имя пользователя и пароль для доступа к хранилищу.
На удаленном узле используйте apigee-service, чтобы установить утилиту apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
Используйте apigee-setup, чтобы установить и настроить компоненты Edge на удаленном узле. Подробнее о том, как установить компоненты Edge на узел…

Как обновить локальное хранилище Apigee

Чтобы обновить репозиторий, скачайте последнюю версию файла bootstrap_4.17.01.sh и выполните синхронизацию:

Скачайте файл bootstrap_4.17.01.sh для Edge в каталог /tmp/bootstrap_4.17.01.sh:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
Запустите файл Edge bootstrap_4.17.01.sh:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

где uName:pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
Обновите apigee-mirror:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
Выполните синхронизацию:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
Если вы хотите скачать весь репозиторий:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Очистка локального репозитория Apigee

При очистке локального репозитория удаляются /opt/apigee/data/apigee-mirror и /var/tmp/yum-apigee-*.

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

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Добавление или обновление Edge 4.16.01/4.16.05/4.16.09 в репозитории 4.17.01

Если вам нужно поддерживать установки для Edge 4.16.0x в хранилище 4.17.01, вы можете поддерживать хранилище, содержащее все версии. Из этого репозитория можно установить любую версию Edge.

Чтобы добавить 4.16.0x в репозиторий 4.17.01:

Убедитесь, что у вас установлена утилита apigee-mirror версии 4.17.01:
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

Вы должны увидеть результат в указанном ниже формате, где xyz – это номер сборки:
apigee-mirror-4.17.01-0.0.xyz
Используйте утилиту apigee-mirror, чтобы скачать Edge 4.16.01/4.16.05/4.16.09 в свое хранилище. Обратите внимание, что в начале команды нужно указать apigeereleasever=4.16.01 или apigeereleasever=4.16.05:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

Используйте эту же команду, чтобы обновить хранилища 4.16.05/4.16.09, указав нужные номера версий.
Проверьте структуру файлов в каталоге /opt/apigee/data/apigee-mirror/repos:
> ls /opt/apigee/data/apigee-mirror/repos

Вы должны увидеть следующие файлы и каталоги:
apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.17.01.sh thirdparty

Обратите внимание, что у вас есть файл начальной загрузки для всех версий Edge. Каталог apigee также содержит отдельные каталоги для каждой версии Edge.
Чтобы упаковать репозиторий в файл TAR, используйте следующую команду:
> apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

Эта команда упаковывает репозитории 4.17.01 и 4.16.0x в один файл TAR. Нельзя упаковать только часть репозитория.

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

Если вы устанавливаете Edge из TAR-файла, запустите нужный файл начальной загрузки из хранилища:
> sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

Чтобы завершить установку, выполните оставшиеся шаги из раздела "Установка из TAR-файла" выше.
Если вы используете веб-сервер Nginx, скачайте и запустите нужный файл начальной загрузки из репозитория:
> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
> sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

Чтобы завершить установку, выполните остальные шаги из раздела "Установка из репозитория с помощью веб-сервера Nginx" выше.