Установка служб IBM® Cloud Pak for Data

По сравнению с автономным продуктом Cloud Pak for Data, Cloud Pak for Data System поставляется заранее сконфигурированным с кластером OpenShift, Portworx и базовым программным обеспечением Cloud Pak for Data. Начиная с версии системы 1.0.4.0, службы (надстройки) устанавливаются отдельно при помощи команды cpd.

Прежде чем начать

Некоторым службам, которые выполняются для Cloud Pak for Data, требуются конкретные параметры в узлах кластера. Чтобы убедиться, что у кластера есть необходимые параметры для этих служб, администратор операционной системы с привилегиями root должен проверить и настроить параметры на соответствующих узлах кластера, как описано в разделе Изменение обязательных параметров узла.

Об этой задаче

Ниже приведен обзор процесса установки служб в среде с физической изоляцией.
Рис. 1. Поток при выполнении команды cpd для кластера с физической изоляцией
Начало альтернативного текста. Процесс установки в кластере с физической изоляцией. Этот процесс объяснен в предыдущем тексте. Конец альтернативного текста.

Cloud Pak for Data определяет модульные компоненты установки следующим образом:

Сборка
Отдельная служба Cloud Pak for Data (и ее зависимые сборки) для внедрения в проект в Red Hat OpenShift. Сборки для панели управления и служб Cloud Pak for Data и для служб хранятся на общедоступном файловом сервере IBM; их не обязательно устанавливать вместе.
Конфигурация репозитория
Файл YAML определений сервера, который вы скачиваете на вашу рабочую станцию клиента под Linux или Mac OS и затем настраиваете. Он задает:
  • URL и идентификационные данные для файл-сервера, откуда будут скачиваться схемы Helm.
  • URL и идентификационные данные для сервера реестров, откуда будут скачиваться образы.

Файл определений сервера по умолчанию - это repo.yaml.

Когда вы запускаете команду скачивания cpd с рабочей станции клиента, она скачивает все образы и диаграммы Helm с общедоступного файл-сервера IBM на рабочую станцию клиента. Далее вы перемещаете интерфейс командной строки Cloud Pak for Data и скачанные файлы на узел Cloud Pak for Data System e1n1. Введите с него команду cpd, чтобы передать образы на ваш сервер реестров. Наконец, вы запускаете команду установки cpd, которая внедряет схемы Helm в проект в вашем кластере OpenShift.

В среде Cloud Pak for Data System образы служб нужно поместить в реестр docker-registry.default.svc:5000/zen.

В следующей процедуре вы скачиваете изображения на вашу локальную рабочую станцию (ноутбук или локальный компьютер), откуда можно напрямую соединиться с кластером Cloud Pak for Data System.

Процедура

  1. На локальной рабочей станции с доступом к интернету:
    1. Скачайте утилиту cpd и программу установки oc с сайта IBM Passport Advantage. Дополнительную информацию смотрите в разделе Получение файлов установки.
    2. Получите ключ правообладания.
      Получить ключ API лицензии правообладания можно из Container software library on My IBM (программной библиотеки контейнеров на сайте My IBM).
      После заказа службы ключ правообладания для программного обеспечения будет связан с вашей учетной записью My IBM. Чтобы получить ключ правообладания:
      1. Авторизуйтесь на сайте Container software library on My IBM с ID IBM и паролем, связанным с правомочным программным обеспечением.
      2. На вкладке Получить ключ правообладания выберите опцию Копировать ключ, чтобы скопировать ключ правообладания в буфер обмена.
      3. Сохраните ключ API в текстовом файле.
    3. Отредактируйте файл определений сервера repo.yaml в скачанном пакете. Этот файл задает репозитории, откуда команда cpd будет скачивать файлы установки. Внесите в этот файл следующие изменения:
      Параметр Значение
      username Укажите cp.
      apikey Укажите ключ API вашей лицензии правообладания.
    4. Перейдите в каталог, куда вы извлекли интерфейс командной строки установки Cloud Pak for Data.
    5. Для скачивания необходимых файлов на ваш локальный компьютер введите следующую команду, убедившись, что имя каталога скачивания совпадает с именем сборки: 
      ./cpd-операционная_система preloadImages --assembly <имя сборки> --action download -r repo.yaml --download-path=<каталог>
      Замените следующие значения:
      Переменная Заменить на
      операционная_система В случае Linux укажите linux. В случае Mac OS укажите darwin.
      Пример: 
      ./cpd-linux preloadImages --assembly wsl --action download -r ../repo.yaml --download-path=wsl
  2. На узле управления e1n1 создайте каталог /opt/ibm/appliance/storage/platform/appmgt/installers/services для сборок: 
    [root@e1n1 ~]# mkdir /opt/ibm/appliance/storage/platform/appmgt/installers/services
  3. Передайте файлы, которые вы скачали на шаге 1.e, на узел управления e1n1 в кластере Cloud Pak for Data System в каталоге /opt/ibm/appliance/storage/platform/appmgt/installers/services. Если файлы не находятся в формате tar.gz, убедитесь, что структура папок сохранена.
  4. Если требуется, распакуйте скачанные файлы: 
    [root@e1n1 ~]# tar -xzvf <файл-tar-gz>
  5. Скопируйте двоичный файл cpd-linux в тот же каталог services: 
    [root@e1n1 ~]# cp /opt/ibm/appliance/storage/platform/appmgt/installers/cpdimages/cpd-linux  /opt/ibm/appliance/storage/platform/appmgt/installers/services
  6. Создайте класс хранения Portworx override.yaml с содержимым, как описано на шаге 2 в разделе Создание файлов переопределения класса хранения для установки: 
    [root@e1n1 ~]#  cd /opt/ibm/appliance/storage/platform/appmgt/installers/services
[root@e1n1 ~]#  vi override.yaml
  7. Войдите по протоколу ssh на e1n1-1-control: 
    [root@e1n1 ~]#  ssh  e1n1-1-control
  8. Перейдите в каталог services и введите команду cpd-linux adm: 
    ./cpd-linux adm

           --assembly <имя-сборки>

           --namespace zen
           
           --load-from ./<имя-сборки>

           --version <версия-сборки>

           --apply
    Пример:
    [root@e1n1-1-control ~]# cd /opt/ibm/appmgt/installers/services
[root@e1n1-1-control ~]# ./cpd-linux adm --assembly wsl --namespace zen --load-from ./wsl --version 2.1.0 --apply
  9. Переместите образы в реестр: 
    ./cpd-linux preloadImages

           --action push

           --load-from <имя-каталога-сборки>

           --assembly <имя-сборки>

           --version <версия-сборки>

           --target-registry-password=$(oc whoami -t)

           --target-registry-username=apadmin

           --transfer-image-to docker-registry.default.svc:5000/zen
    Пример:
    [root@e1n1-1-control ~]# ./cpd-linux preloadImages --action push --load-from ./wsl --assembly wsl --version 2.1.0 --target-registry-password=$(oc whoami -t) --target-registry-username=apadmin --transfer-image-to=docker-registry.default.svc:5000/zen
  10. Перед запуском окончательной установки переместите каталог images из сборки. Если пропустить этот шаг, можно столкнуться с нехваткой дискового пространства для pod-блока оператора: 
    mv  <имя-сборки>/assembly/<имя-сборки>/x86_64/<версия-сборки>/images   images.<имя-сборки>
    Пример:
    В каталоге /opt/ibm/appliance/storage/platform/appmgt/installers/services введите команду: 
    [root@e1n1-1-control]  mv wsl/assembly/wsl/x86_64/2.1.0/images images.wsl
  11. Установите службу с помощью следующей команды:
    Прим.: При установке служб рекомендуется использовать класс хранения portworx-shared-gp2 или portworx-shared-gp3 для обеспечения высокой доступности и исключения потери данных с томом хранения единственной реплики. Не используйте класс portworx-shared-gp.
    ./cpd-linux 

           --assembly <имя-сборки>

           --namespace zen 

           --storageclass portworx-shared-gp3 

           --cluster-pull-prefix docker-registry.default.svc:5000/zen 

           --load-from ./<имя-сборки>
 
           --version <версия-сборки>

           --override /opt/ibm/appmgt/installers/services/override.yaml
    Пример:
    [root@e1n1-1-control ~]# ./cpd-linux --assembly wsl --namespace zen --storageclass portworx-shared-gp3 --cluster-pull-prefix docker-registry.default.svc:5000/zen --load-from ./wsl --version 2.1.0 --override /opt/ibm/appmgt/installers/services/override.yaml

Дальнейшие действия

Подробные инструкции по установке конкретной службы приведены в разделе Службы и интеграции.
Важное замечание: Документация по этой ссылке относится к автономному продукту Cloud Pak for Data. Cloud Pak for Data System поставляется заранее сконфигурированным с кластером OpenShift и Portworx, поэтому не все описанные шаги применимы.

Обратитесь к представителю IBM по продажам за новейшим списком поддерживаемых служб в Cloud Pak for Data System и их размеров.