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

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

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

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

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

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

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

    Вы можете подготовить проекты и namespaces, выполнив следующие действия:

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

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

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

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

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

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

    NOTE

    В этом документе Harbor используется в качестве примера. Вам необходимо подготовить проект в Harbor для загрузки образов (с access level public) и назначить этот проект для использования проекту, подготовленному для Bookinfo на платформе. Вы можете развернуть или интегрировать инструмент управления образами Harbor на платформе и назначить проект в Harbor для загрузки образов проекту, подготовленному для Bookinfo на платформе.

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

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

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

    Service NameDescription
    productpageВызывает сервисы details и reviews для формирования страницы.
    detailsСодержит информацию о книге.
    reviewsСодержит отзывы о книге и вызывает сервис ratings.

    Сервис reviews имеет три версии:
    v1: Не вызывает сервис ratings.
    v2: Вызывает сервис ratings и отображает рейтинг в виде 1–5 звезд .
    v3: Вызывает сервис ratings и отображает рейтинг в виде 1–5 звезд .
    Совет: По умолчанию развертывается версия v2.
    ratingsСодержит информацию о рейтинге, сформированную на основе оценок книги.

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

    Подготовка образов и YAML-файлов

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

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

    Шаги

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

      TIP

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

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

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

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

      • images.tar: пакет образов Bookinfo.
      • bookinfo.yaml: YAML-файл Bookinfo.
      • docker_script.sh: скрипт для добавления тегов к образам, загрузки образов и изменения адресов образов в 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. Измените файл скрипта docker_script.sh.

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

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

      Следующие команды запускают скрипт docker_script.sh для добавления тегов к образам, загрузки образов в проект Harbor и изменения адресов образов в файле 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.

      • Порт включает порт протокола 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.

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