准备工作:
这些步骤假定您已在上述步骤中创建了环境变量。您可以使用以下命令进行检查:
echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME
此过程介绍了如何设置在其中运行 Apigee Hybrid 的集群。这些说明因运行 Hybrid 的平台而异。选择您的平台以查看相关说明:
GKE
此步骤介绍了如何在 Google Cloud 项目中设置 Shell 环境和创建 GKE 集群。
创建集群
- 收集 Apigee Hybrid 集群的集群要求:集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 检查 Hybrid 1.6.9 版支持的 GKE 版本:
- 使用以下说明创建至少具有 6 个节点的区域级集群:
- 为集群创建至少两个节点池。节点池最低要求如下:
默认节点池名称 说明 节点数下限 每个节点池的 CPU 数下限 每个节点的 CPU 数下限 apigee-data
有状态节点池。 3 4 4/池中的节点数 apigee-runtime
无状态节点池。 3 4 4/池中的节点数 按照添加和管理节点池中的说明进行操作。
如需详细了解节点池配置,请参阅配置专用节点池
- 创建集群后,使用以下命令在集群上启用 Workload Identity:
gcloud container clusters update ${CLUSTER_NAME} \ --workload-pool=$PROJECT_ID.svc.id.goog \ --region ${CLUSTER_LOCATION}
如需了解详情,请参阅在集群上启用 Workload Identity
- 使用以下命令获取刚刚创建的集群的
gcloud
凭据:gcloud container clusters get-credentials ${CLUSTER_NAME} \ --region ${CLUSTER_LOCATION} \ --project ${PROJECT_ID}
安装并运行集群后,请转到下一步。
GKE On-Prem
创建集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 GKE 版本:
- 使用以下说明创建用户集群:
- 在 GKE On-Prem 文档中创建用户集群(快速入门)。
安装并运行集群后,请转到下一步。
Anthos on Bare Metal
要求和前提条件
Anthos clusters on Bare Metal 允许您直接在自己的机器资源上运行 Kubernetes 集群。
查看以下要求和前提条件:
创建集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 GKE 版本:
- 按照 Anthos clusters on Bare Metal 文档中的以下说明操作,创建用户集群:
- 创建集群:概览。
- Anthos clusters on Bare Metal 文档中的 Anthos clusters on Bare Metal 快速入门。
安装并运行集群后,请转到下一步。
AKS
创建 AKS 集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 AKS 版本:
- 使用以下任何一组说明创建集群:
- 使用 Azure CLI:“快速入门:使用 Azure CLI 部署 Azure Kubernetes Service 集群”。
- 使用 Azure 门户:“快速入门:使用 Azure 门户部署 Azure Kubernetes Service (AKS) 集群”。
EKS
创建集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 EKS 版本:
- 使用以下说明创建用户集群:
安装并运行集群后,请转到下一步。
GKE on AWS
创建集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 GKE 版本:
- 使用以下说明创建用户集群:
安装并运行集群后,请转到下一步。
OpenShift
创建集群
- 收集 Apigee Hybrid 集群的要求:
- 集群的最低配置如下:
配置 有状态节点池 无状态节点池 节点数 每个区域 3 个 每个区域 3 个 CPU 4 4 RAM 15 15 默认标签名称 apigee-data apigee-runtime 存储 动态 通过 ApigeeDeployment CRD 进行管理 如需详细了解最低集群配置,请参阅最低集群配置
- 至少创建两个节点池:
默认节点池名称 说明 apigee-data
有状态节点池。 apigee-runtime
无状态节点池。 如需详细了解节点池配置,请参阅配置专用节点池
- 集群的最低配置如下:
- 检查 Hybrid 1.6.9 版支持的 GKE 版本:
- 请按照以下说明在 OpenShift 用户集群上安装 Apigee,并将其注册到 GKE Hub。
- 安装并配置
oc
CLI 工具。请参阅 OpenShift 文档中的 OpenShift CLI 使用入门。 - 向 GKE Hub 注册
- 创建名为
gke-connect-scc.yaml
且包含以下内容的文件:# Connect Agent SCC apiVersion: v1 kind: SecurityContextConstraints metadata: name: gke-connect-scc allowPrivilegeEscalation: false requiredDropCapabilities: - ALL runAsUser: type: MustRunAsNonRoot seLinuxContext: type: RunAsAny supplementalGroups: type: MustRunAs ranges: - min: 1 max: 65535 fsGroup: type: MustRunAs ranges: - min: 1 max: 65535 volumes: - secret readOnlyRootFilesystem: true seccompProfiles: - docker/default users: groups: - system:serviceaccounts:gke-connect
- 使用以下命令在
oc
中创建组件:oc create -f gke-connect-scc.yaml
- 使用以下命令为上下文创建环境变量:
export KUBECONFIG=<> # Cluster kubeconfig file path
export CONTEXT=admin
- 使用以下命令向 GKE Hub 注册:
gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \ --kubeconfig=${KUBECONFIG} \ --context=${CONTEXT} \ --service-account-key-file=KEY_FILE_PATH
其中:
- PROJECT_ID 是您的 Google Cloud 项目 ID。
- CLUSTER_NAME 是您刚刚创建的集群的名称。
- KUBECONFIG 是集群 kubeconfig 文件的路径。
- CONTEXT 是
gcloud
要在其中注册集群的上下文。对于此命令,CONTEXT 必须是admin
。 - KEY_FILE_PATH 是服务账号密钥文件的路径,例如
./dist/apigee-my-project-ro-sa.json
。 该服务账号必须具有以下两个 IAM 角色:- GKE Hub Admin
- GKE Connect Agent
- 创建名为
- 安装并配置
安装 GKE Hub 并完成注册后,请转到下一步。
1 (下一步)第 2 步:安装 cert-manager 3 4 5 6 7 8 9