Alauda Service Mesh
  • 简体中文

    • 部署演示应用 Bookinfo

    请参考本文档在服务网格中的多个集群内、同一命名空间中部署 Bookinfo 应用，以验证多集群服务网格的能力。

    目录

    准备项目和命名空间在多个集群中部署 Bookinfo 应用前提条件应用介绍准备镜像和 YAML 文件步骤一键部署应用步骤为应用的服务注入 Sidecar步骤通过 Ingress Gateway 访问 Bookinfo 应用步骤访问验证

    准备项目和命名空间

    准备用于部署应用的项目和命名空间，配置要求如下：

    • 所有集群都必须作为关联集群与平台现有项目关联。

    • 用于部署应用的同名命名空间必须存在于所有集群中。

      说明：基于多集群服务网格的跨地域容灾或负载均衡，只能在服务网格内各集群中同名命名空间下的同名服务之间进行。

    你可以按照以下说明准备项目和命名空间：

    1. 参考 创建项目 在平台上创建一个项目，并将 关联集群 c1 和 c2 包含在内。

    2. 参考 创建命名空间 在集群 c1 和 c2 中创建同名命名空间 ns1。

    在多个集群中部署 Bookinfo 应用

    在集群 c1 和 c2 的同名命名空间 ns1 中部署 Bookinfo 应用。

    前提条件

    你已拥有平台可访问的镜像仓库，并且可以向该仓库推送镜像。

    NOTE

    本文档以 Harbor 为例。你需要在 Harbor 中准备一个用于上传镜像的项目（将 访问级别 设为 public），并将该项目分配给平台上为 Bookinfo 准备的项目使用。你可以在平台上部署或集成镜像管理工具 Harbor，并将 Harbor 中用于上传镜像的项目分配给平台上为 Bookinfo 准备的项目。

    应用介绍

    Bookinfo 是 Istio 提供的一个示例应用，用于模拟在线书店。它由四个独立的服务组成，这些服务共同提供查看书籍描述、书籍详情（ISBN、页数等）以及部分书评的功能。

    构成 Bookinfo 的服务如下：

    服务名称描述
    productpage调用 details 和 reviews 服务生成页面。
    details包含书籍信息。
    reviews包含书评，并调用 ratings 服务。

    reviews 服务有三个版本：
    v1：不调用 ratings 服务。
    v2：调用 ratings 服务，并显示 1 到 5 颗星的评分 。
    v3：调用 ratings 服务，并显示 1 到 5 颗星的评分 。
    提示：默认部署 v2 版本。
    ratings包含由书评组成的评分信息。

    Bookinfo 的端到端架构如下所示。

    准备镜像和 YAML 文件

    在平台上部署 Bookinfo 应用之前，需要先从 Customer Portal 系统下载部署 Bookinfo 应用所需的镜像和 YAML 文件。

    通过执行脚本对镜像打标签并上传到平台可访问的镜像仓库中，同时相应修改 YAML 文件中的镜像地址。确保平台在部署应用时能够顺利拉取所需镜像。

    步骤

    1. 登录 Customer Portal，在 Application Marketplace 中搜索 Bookinfo，并下载提供的产品文件到本地。

      TIP

      如需访问 Customer Portal 系统，请联系技术支持。

    2. 打开本地终端，执行以下命令解压下载的文件并加载镜像。

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

      解压后，你将获得以下文件：

      • images.tar：Bookinfo 的镜像包。
      • bookinfo.yaml：Bookinfo 的 YAML 文件。
      • crictl_script.sh：用于镜像打标签、上传镜像以及修改 YAML 文件中镜像地址的脚本。

    3. 执行以下命令登录平台可访问的镜像仓库。

      NOTE

      请将 <Harbor address> 替换为平台上 Harbor 的实际可访问地址，例如：registry-harbor.example.com。

      crictl login <Harbor address>
      NOTE

      如果在输入用户名和密码后收到以下错误，请修改 container runtime 配置，将 Harbor 地址添加到 insecure-registries，然后重新执行登录命令。

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

    4. 修改 crictl_script.sh 脚本文件。

      将 <Harbor address> 替换为你要上传镜像的 Harbor 项目地址，例如：registry-harbor.example.com/bookinfo。

    5. 依次执行以下命令。

      以下命令将执行 crictl_script.sh 脚本，对镜像打标签、将镜像上传到 Harbor 项目，并修改 bookinfo.yaml 文件中的镜像地址。

      chmod +x crictl_script.sh
./crictl_script.sh

    一键部署应用

    在 Container Platform 平台中，使用 YAML 在集群 c1 和 c2 的命名空间 ns1 中创建一个原生应用，以部署 Bookinfo 应用。

    步骤

    1. 在顶部导航栏中，单击产品视图切换，切换到 Container Platform，并进入集群 c1 下的命名空间 ns1。

    2. 在左侧导航栏中，单击 应用管理 > 原生应用。

    3. 单击 创建原生应用，并选择 通过 YAML 一键创建。

    4. 输入应用名称，在 YAML 编辑器中单击 导入，选择 bookinfo.yaml，然后单击 创建。

    5. 重复上述步骤，在集群 c2 的命名空间 ns1 中部署 Bookinfo 应用。

    为应用的服务注入 Sidecar

    在 Service Mesh 平台中，将构成 Bookinfo 应用的 productpage、details、reviews 和 ratings 服务以 Service Mesh 管理模式 添加到 Service Mesh 平台中。添加服务时，平台会自动为这些服务注入 Sidecar。

    注入 Sidecar 后，Bookinfo 的架构如下所示。

    步骤

    1. 在顶部导航栏中，单击产品视图切换，切换到 Service Mesh。

    2. 在左侧导航栏中，单击 服务列表。

    3. 单击 添加服务，并选择 Service Mesh 管理模式。

    4. 配置相关参数，然后单击 创建。

      NOTE

      除非另有说明，否则请选择 Deployment，并使用界面参数的默认值。

      • 重复上述步骤，将 productpage、details、reviews 和 ratings 服务添加到集群 c1 和 c2 的命名空间 ns1 中的平台。

    通过 Ingress Gateway 访问 Bookinfo 应用

    步骤

    参考 使用 Ingress Gateway 在集群 c1 中部署 ingress gateway，并创建网关配置和路由配置，通过浏览器访问部署在该集群中的 Bookinfo 应用。

    按需配置相关参数，并根据需要配置其他参数。

    • Ingress Gateway：

      • 内部路由类型：LoadBalancer。

      • 端口包含 HTTP 协议端口。

    • 网关配置：选择带有 HTTP 协议的端口。

    • 路由配置：路由目标 选择 namespace ns1 in cluster c1、internal routing productpage 和端口 9080。

    访问验证

    单击路由配置中的 外部访问地址，在打开页面左下角选择模拟用户类型（普通用户/测试用户），然后即可访问 productpage 服务，并查看 productpage 服务调用的 reviews 服务版本所显示的评分信息。

    服务调用拓扑如下所示。