#Развертывание демонстрационного приложения Bookinfo

Обратитесь к этому документу, чтобы развернуть приложение Bookinfo в одном и том же namespace в нескольких кластерах внутри service mesh и проверить возможности multi-cluster service mesh.

#Подготовка проектов и namespace

Подготовьте проекты и namespace для развертывания приложения со следующими требованиями к конфигурации:

• Все кластеры должны быть связаны с существующими проектами платформы в качестве associated clusters.

• Namespace с одинаковым именем для развертывания приложения должен существовать во всех кластерах.

  Примечание: Межрегиональное аварийное восстановление или балансировка нагрузки на основе multi-cluster service mesh может выполняться только между сервисами с одинаковыми именами в namespace с одинаковыми именами во всех кластерах внутри service mesh.

Подготовить проекты и namespace можно следующим образом:

1. Обратитесь к Create a Project и создайте на платформе проект, который включает associated clusters c1 и c2.

2. Обратитесь к Create a Namespace и создайте namespace ns1 с одинаковым именем в кластерах c1 и c2.

#Развертывание приложения Bookinfo в нескольких кластерах

Разверните приложение Bookinfo в namespace ns1 с одинаковым именем в кластерах c1 и c2.

#Предварительные требования

У вас должен быть доступный для платформы image repository, в который можно загружать images.

#Описание приложения

Bookinfo — это пример приложения, предоставляемый Istio, который имитирует интернет-магазин книг. Он состоит из четырех отдельных сервисов, которые совместно обеспечивают просмотр описания книги, сведений о книге (ISBN, количество страниц и т. д.) и некоторых отзывов о книге.

Сервисы, из которых состоит Bookinfo, перечислены ниже.

Ниже показана сквозная архитектура Bookinfo.

#Подготовка images и YAML-файлов

Перед развертыванием приложения Bookinfo на платформе необходимо скачать images и YAML-файлы, требуемые для развертывания приложения Bookinfo, из системы Customer Portal.

Выполнив script, пометьте images тегами и загрузите их в image repository, доступный платформе, а также соответствующим образом измените адреса images в YAML-файлах. Убедитесь, что платформа может без проблем извлекать необходимые images при развертывании приложения.

#Шаги

1. Войдите в Customer Portal, найдите Bookinfo в Application Marketplace и загрузите предоставленные файлы продукта на локальный компьютер.

   TIP

   Для доступа к системе Customer Portal обратитесь в техническую поддержку.

2. Откройте локальный терминал и выполните следующие команды, чтобы распаковать загруженные файлы и загрузить images.

   unzip <file_name>.zip
   docker load -i images.tar
   NOTE

   После распаковки вы получите следующие файлы:

   • images.tar: Пакет images для Bookinfo.
   • bookinfo.yaml: YAML-файл Bookinfo.
   • docker_script.sh: Script для назначения тегов images, загрузки images и изменения адресов images в YAML-файле.

3. Выполните следующую команду, чтобы войти в image repository, доступный платформе.

   NOTE

   Замените <Harbor address> фактическим доступным адресом Harbor на платформе, например: registry-harbor.example.com.

   docker login <Harbor address>
   NOTE

   Если после ввода имени пользователя и пароля вы получите следующую ошибку, измените конфигурацию Docker Engine, добавив адрес Harbor в insecure-registries, а затем повторно выполните команду входа.

   Error response from daemon: Get "https://<Harbor address>/v2/": http: server gave HTTP response to HTTPS client

4. Измените файл script docker_script.sh.

   Замените <Harbor address> на адрес Harbor project, в который вы хотите загрузить images, например: registry-harbor.example.com/bookinfo.

5. Последовательно выполните следующие команды.

   Следующие команды запускают script docker_script.sh для назначения тегов images, загрузки images в Harbor project и изменения адресов images в файле bookinfo.yaml.

   chmod +x docker_script.sh
   ./docker_script.sh

#Однокликовое развертывание приложения

На платформе Container Platform используйте YAML для создания native application в namespace ns1 кластеров c1 и c2, чтобы развернуть приложение Bookinfo.

#Шаги

1. В верхней панели навигации нажмите переключатель представления продукта, чтобы перейти в Container Platform, и войдите в namespace ns1 в кластере c1.

2. В левой панели навигации нажмите Application Management > Native Application.

3. Нажмите Create Native Application и выберите One-Click Create with YAML.

4. Введите имя приложения, нажмите Import в редакторе YAML, выберите bookinfo.yaml и нажмите Create.

5. Повторите приведенные выше шаги, чтобы развернуть приложение Bookinfo в namespace ns1 кластера c2.

#Внедрение Sidecar в сервисы приложения

На платформе Service Mesh добавьте сервисы productpage, details, reviews и ratings, из которых состоит приложение Bookinfo, на платформу Service Mesh в режиме Service Mesh governance mode. При добавлении сервисов платформа автоматически внедряет Sidecar в сервисы.

После внедрения Sidecar архитектура Bookinfo выглядит следующим образом.

#Шаги

1. В верхней панели навигации нажмите переключатель представления продукта, чтобы перейти в Service Mesh.

2. В левой панели навигации нажмите Service List.

3. Нажмите Add Service и выберите Service Mesh Governance Mode.

4. Настройте соответствующие параметры и нажмите Create.

   NOTE

   Если не указано иное, выберите Deployment и используйте значения параметров по умолчанию на интерфейсе.

   • Повторите приведенные выше шаги, чтобы добавить сервисы productpage, details, reviews и ratings на платформу в namespace ns1 кластеров c1 и c2.

#Доступ к приложению Bookinfo через Ingress Gateway

#Шаги

Обратитесь к Using Ingress Gateway для развертывания ingress gateway в кластере c1 и создания конфигурации gateway и конфигурации маршрутизации для доступа к приложению Bookinfo, развернутому в кластере, через браузер.

Настройте соответствующие параметры по необходимости и задайте остальные параметры при необходимости.

• Ingress Gateway:

  • Internal Routing Type: LoadBalancer.

  • Port включает порт протокола HTTP.

• Gateway Configuration: Выберите порт с протоколом HTTP.

• Routing Configuration: В Routing Destination выберите namespace ns1 in cluster c1, internal routing productpage и порт 9080.

#Проверка доступа

Нажмите External Access Address в конфигурации маршрутизации, внизу слева на открывшейся странице выберите тип имитируемого пользователя (Normal user/Test user), после чего вы сможете получить доступ к сервису productpage и увидеть информацию о рейтинге, отображаемую версией сервиса reviews, вызываемой сервисом productpage.

Ниже показана топология вызовов сервисов.