跳到主要内容
版本:v2.8

先决条件

1. 设置许可证管理器和购买支持

首先,完成许可证管理器设置的第一步。 然后,转到 AWS Marketplace。找到 “Rancher Premium Support Billing Container Starter Pack”。最后,购买至少一项 Entitlement。

如果你已使用 “Rancher Setup” AWS Marketplace 产品安装了 Rancher,请跳至步骤 4

注意:每项 Entitlement 都对一定数量的节点授予访问支持的权限。你可以后续根据需要购买更多许可证。

2. 创建 EKS 集群

按照 Rancher 文档创建 EKS 集群。进行到安装 Rancher Helm Chart(最后一步)时,停止并返回此页面。该集群需要满足以下要求:

  • EKS 1.22 版本。
  • 集群中的每个节点都可以访问包含 Rancher 及其相关镜像的镜像仓库。
  • 集群中的每个节点都可以访问存储 CSP Adapter 的 ECR 仓库。
  • 集群中的每个节点都可以访问许可证管理器服务。
  • 集群中的每个节点都可以访问 STS 服务的全局端点。

3. 安装 Rancher

除了在 Rancher 文档中指定的 Rancher 安装选项外,你还需要启用其它指标。 你可以通过 Helm CLI 使用以下选项来完成:

--set extraEnv\[0\].name="CATTLE_PROMETHEUS_METRICS" --set-string extraEnv\[0\].value=true

你还可以使用 values.yaml,如下所示:

extraEnv:
- name: "CATTLE_PROMETHEUS_METRICS"
value: "true"

你还需要安装 Rancher 2.6.7 或更高版本。

4. 创建 OIDC 提供程序

按照 AWS 文档为上一节中指定的集群创建 OIDC 提供程序。

5. 创建 IAM 角色

CSP Adapter 需要 IAM 角色才能签入/签出 Entitlement。

首先,配置如下的信任策略。你需要将 MY_AWS_ACC 替换为你的 AWS 帐号,将 MY_AWS_REGION 替换为你的 AWS 区域,并将 MY_OIDC_PROVIDER 替换为你的 OIDC 提供商 ID:

{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Federated": "arn:aws:iam::${MY_AWS_ACC}:oidc-provider/oidc.eks.${MY_AWS_REGION}.amazonaws.com/id/${MY_OIDC_PROVIDER}"
},
"Action": "sts:AssumeRoleWithWebIdentity",
"Condition": {
"StringEquals": {
"oidc.eks.${MY_AWS_REGION}.amazonaws.com/id/${MY_OIDC_PROVIDER}:sub": "system:serviceaccount:cattle-csp-adapter-system:rancher-csp-adapter",
"oidc.eks.${MY_AWS_REGION}.amazonaws.com/id/${MY_OIDC_PROVIDER}:aud": "sts.amazonaws.com"
}
}
}
]
}

接下来,为具有以下权限的角色使用策略:

{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "RancherCSPAdapterPermissions",
"Effect": "Allow",
"Action": [
"license-manager:ListReceivedLicenses",
"license-manager:CheckoutLicense",
"license-manager:ExtendLicenseConsumption",
"license-manager:CheckInLicense",
"license-manager:GetLicense",
"license-manager:GetLicenseUsage"
],
"Resource": "*"
}
]
}

保存角色的名称。稍后安装 CSP Adapter 时将需要它。