第 2 步:安装 cert-manager 和 ASM

此步骤介绍如何下载和安装 cert-managerAnthos Service Mesh (ASM)。Apigee Hybrid 需要这些服务才能运行。

安装 cert-manager

使用以下两个命令之一从 GitHub 安装 cert-manager v0.14.2。要查找您的 kubectl 版本,请使用 kubectl version 命令。

  • 如果您使用的是 Kubernetes 1.15 或更高版本:
    kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v0.14.2/cert-manager.yaml
  • 低于 1.15 的 Kubernetes 版本:
    kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v0.14.2/cert-manager-legacy.yaml

您将看到一个响应,表明已创建了 cert-manager 命名空间,并且在该命名空间中创建了多个 cert-manager 资源。

前提条件

  1. 使用以下命令检查您的 Cloud SDK 配置设置:
    gcloud config list
    [compute]
    region = us-central1
    [core]
    account = user@acme.com
    disable_usage_reporting = False
    project = my-hybrid-project
    
    Your active configuration is: [default]
  2. 确保将计算地区或区域设置为您在创建集群时使用的地区或区域。如果您创建了区域级集群,请使用 unset 清除计算/地区属性(如果已设置)。如果您创建了地区级集群,请使用 unset 清除计算/区域属性(如果已设置该属性)。配置必须设置计算地区或区域,但不能同时设置两者。例如,如需使用 unset 清除 compute/zone property,请使用以下命令:
    gcloud config unset compute/zone
  3. 使用以下命令,使用 KDUBECONFIG 文件路径设置变量。此文件是您创建集群时在管理机上创建的:
    export KUBECONFIG=KUBECONFIG_PATH

    例如:

    export KUBECONFIG=~/.kube/my-config

设置和下载 ASM

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

开始之前,请仔细阅读以下步骤。我们会要求您执行 ASM 文档中列出的某些步骤,然后返回此处完成安装。

  1. 转到 ASM 安装说明部分,为您的 Hybrid 设置安装相应的 ASM 版本:

应用清单

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

  1. 确保您位于下载并解压缩的 Istio 目录中。例如:1.6.11-asm.1
  2. 根据您安装的 Istio 版本执行以下命令:
    • 如果您安装了 ASM 1.6 或更高版本(推荐 1.7 版),请执行以下命令:
      ./bin/istioctl install --set profile=asm-multicloud \
       --set meshConfig.enableAutoMtls=false \
       --set meshConfig.accessLogFile=/dev/stdout \
       --set meshConfig.accessLogEncoding=1 \
       --set meshConfig.accessLogFormat='{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
  3. 最后,返回到 ASM 文档来检查控制平面组件以验证安装。

自定义 ASM 安装

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

摘要

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

1 2 (下一步)第 3 步:安装 apigeectl 4 5