第 3 步：安装 ASM

安装 ASM

Apigee Hybrid 使用 Anthos Service Mesh (ASM) 提供的 Istio 发行版。请按照以下步骤在集群中安装 ASM。

支持的 ASM 版本

对于全新的 Hybrid 1.4.4 版安装，请安装 ASM 1.7.x 版。
如果要从以前的 Hybrid 版本升级，请安装 ASM 1.6.x 版。

执行 ASM 设置和配置步骤

如需完成 ASM 安装，首先必须按照 ASM 文档中特定于 ASM 的设置和配置步骤执行操作。然后，您必须返回此处完成特定于混合的配置，然后再将配置应用到集群。

安装和配置 ASM 的说明因平台而异。请在下面选择执行您的平台适用的步骤。

GKE

按照 ASM 设置和配置步骤执行操作：
重要提示：按照 ASM 文档的说明操作时，请勿在系统提示时安装或应用 YAML 配置文件 istio-operator.yaml。在系统提示时，我们要求您返回到此页面，先使用其他特定于混合的配置修改该文件，然后再安装/应用配置。
- 如果这是新安装 Apigee Hybrid，请安装 ASM 1.7.xx 版。转到新安装。
- 如果您要从之前 Hybrid 版本进行升级，请使用 ASM 1.6.x。转到：安装和迁移简介。
完成 ASM 设置和配置步骤后，请转到下一部分以完成混合配置和 ASM 安装步骤。

执行最终混合配置并安装 ASM

最后，将特定于混合的配置添加到 istio-operator.yaml 文件并安装 ASM。

确保您位于 ASM 安装的根目录中。例如 1.7.3-asm.6。
通过编辑器打开 istio-operator.yaml 文件。
- 在 ASM 1.7.x 中：./asm/istio/istio-operator.yaml
- 在 ASM 1.6.x 中：./asm/cluster/istio-operator.yaml

在 istio-operator.yaml 文件中添加（或更新）spec:components 节（位于 meshConfig: 部分下，并且其后紧跟 values:），其中 reserved_static_ip 是您的运行时入站网关可以使用的 IP 地址。如果您没有预留的静态 IP 地址，则在本快速入门中，您可以省略 LoadBalancerIP 属性。

要复制的文本

  components:
    ingressGateways:
    - name: istio-ingressgateway
      enabled: true
      k8s:
        service:
          type: LoadBalancer
          loadBalancerIP: static_ip # If you do not have a reserved static IP, leave this out.
          ports:
          - name: status-port
            port: 15021 # for ASM 1.7.x and above, else 15020
            targetPort: 15021 # for ASM 1.7.x and above, else 15020
          - name: http2
            port: 80
            targetPort: 8080
          - name: https
            port: 443
            targetPort: 8443

显示位置的示例

插入换行符是为了方便阅读

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
metadata:
  clusterName: "hybrid-example/us-central1/example-cluster" # {"$ref":"#/definitions/io.k8s.cli.substitutions.cluster-name"}
spec:
  profile: asm
  hub: gcr.io/gke-release/asm # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.hub"}
  tag: 1.5.7-asm.0 # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.tag"}
  meshConfig:
    defaultConfig:
      proxyMetadata:
        GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
          {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}

  components:
    pilot:
      k8s:
        hpaSpec:
          maxReplicas: 2
    ingressGateways:
    - name: istio-ingressgateway
      enabled: true
      k8s:
        service:
          type: LoadBalancer
          loadBalancerIP: 123.234.56.78
          ports:
          - name: status-port
            port: 15021 # for ASM 1.7.x and above, else 15020
            targetPort: 15021 # for ASM 1.7.x and above, else 15020
          - name: http2
            port: 80
            targetPort: 8080
          - name: https
            port: 443
            targetPort: 8443
        hpaSpec:
          maxReplicas: 2
  values:
    .
    .
    .

现在，返回到您之前使用的 ASM 文档，并完成 ASM 安装（安装 istio-operator.yaml 文件或将其应用到集群）。如果您使用的是 AMS 1.6 且提供了选项，请选择 PerMISSIVE mTLS。
注意：如果您使用的是 ASM 1.6，我们建议您使用 asmctl validate 命令来验证已安装组件的配置和运行状况。ASM 文档中有关验证安装的部分介绍了此命令。只有在您使用 ASM 1.6 时，此命令才有效。

GKE On-Prem

设置和下载 ASM

使用 ASM 文档设置环境并下载 ASM。

开始之前，请仔细阅读以下步骤。我们会要求您执行 ASM 文档中列出的某些步骤，然后返回此处完成安装。
转到在本地安装 Anthos Service Mesh，并执行所有 ASM 步骤（一直执行到创建 istio-system 命名空间），然后停止并转至下面的下一部分应用清单。
重要提示：完成创建 istio-system 命名空间部分中的步骤后，请停止并继续执行下一部分中列出的步骤。我们建议您按照以下说明来应用清单文件。

应用清单

下载并解压缩 ASM 安装文件后，请继续执行以下步骤：

确保您位于下载并解压缩的 Istio 目录中。例如：1.7.3-asm.6。
执行以下命令，其中 your_static_ip 是 Istio Ingress 组件可以使用的静态 IP 地址。如果您没有预留静态 IP 地址，请省略 --set values.gateways.istio-ingressgateway.loadBalancerIP 行：
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
最后，返回到 ASM 文档来检查控制平面组件以验证安装。

自定义 ASM 安装

您刚刚执行的 ASM 安装是最简安装，足够测试和使用 Apigee Hybrid 基本用例。如需了解如何处理更高级的用例（例如添加、移除或修改负载均衡器端口号），请参阅启用可选功能。

摘要

现在，您已经安装了 cert-manager 和 ASM，可以在本地机器上安装 Apigee Hybrid 命令行工具了。

AKS

设置和下载 ASM

使用 ASM 文档设置环境并下载 ASM。

开始之前，请仔细阅读以下步骤。我们会要求您执行 ASM 文档中列出的某些步骤，然后返回此处完成安装。
转到在挂接的集群上安装 Anthos Service Mesh，并执行所有 ASM 步骤（一直执行到创建 istio-system 命名空间），然后停止并转至下面的下一部分应用清单。
重要提示：完成创建 istio-system 命名空间部分中的步骤后，请停止并继续执行下一部分中列出的步骤。我们建议您按照以下说明来应用清单文件。

应用清单

下载并解压缩 ASM 安装文件后，请继续执行以下步骤：

确保您位于下载并解压缩的 Istio 目录中。例如：1.7.3-asm.6。
执行以下命令，其中 your_static_ip 是 Istio Ingress 组件可以使用的静态 IP 地址。如果您没有预留静态 IP 地址，请省略 --set values.gateways.istio-ingressgateway.loadBalancerIP 行：
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
最后，返回到 ASM 文档来检查控制平面组件以验证安装。

自定义 ASM 安装

摘要

现在，您已经安装了 cert-manager 和 ASM，可以在本地机器上安装 Apigee Hybrid 命令行工具了。

GKE on AWS

设置和下载 ASM

使用 ASM 文档设置环境并下载 ASM。

开始之前，请仔细阅读以下步骤。我们会要求您执行 ASM 文档中列出的某些步骤，然后返回此处完成安装。
转到在 GKE on AWS 上安装 Anthos Service Mesh，并执行直至下载安装文件（包括该步骤）的所有 ASM 步骤，然后停止并转到下面的应用清单部分。
重要提示：完成下载安装文件部分中的步骤后，停止并继续执行下一部分中列出的步骤。我们建议您按照以下说明来应用清单文件。

应用清单

下载并解压缩 ASM 安装文件后，请继续执行以下步骤：

确保您位于下载并解压缩的 Istio 目录中。例如：1.7.3-asm.6。
执行以下命令，其中 your_static_ip 是 Istio Ingress 组件可以使用的静态 IP 地址。如果您没有预留静态 IP 地址，请省略 --set values.gateways.istio-ingressgateway.loadBalancerIP 行：
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
最后，返回到 ASM 文档来检查控制平面组件以验证安装。

自定义 ASM 安装

摘要

现在，您已经安装了 cert-manager 和 ASM，可以在本地机器上安装 Apigee Hybrid 命令行工具了。

EKS

设置和下载 ASM

使用 ASM 文档设置环境并下载 ASM。

开始之前，请仔细阅读以下步骤。我们会要求您执行 ASM 文档中列出的某些步骤，然后返回此处完成安装。
转到在挂接的集群上安装 Anthos Service Mesh，并执行所有 ASM 步骤（一直执行到创建 istio-system 命名空间），然后停止并转至下面的下一部分应用清单。
重要提示：完成创建 istio-system 命名空间部分中的步骤后，请停止并继续执行下一部分中列出的步骤。我们建议您按照以下说明来应用清单文件。

应用清单

下载并解压缩 ASM 安装文件后，请继续执行以下步骤：

确保您位于下载并解压缩的 Istio 目录中。例如：1.7.3-asm.6。
执行以下命令，其中 your_static_ip 是 Istio Ingress 组件可以使用的静态 IP 地址。如果您没有预留静态 IP 地址，请省略 --set values.gateways.istio-ingressgateway.loadBalancerIP 行：
```
./bin/istioctl install --set profile=asm-multicloud \
 --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
```
最后，返回到 ASM 文档来检查控制平面组件以验证安装。

自定义 ASM 安装

摘要

现在，您已经安装了 cert-manager 和 ASM，可以在本地机器上安装 Apigee Hybrid 命令行工具了。

摘要

现在，您已经安装了 cert-manager 和 ASM，可以在本地机器上安装 Apigee Hybrid 命令行工具了。

1 2 3 （下一步）第 4 步：安装 apigeectl 5 6 7