手动安装 Config Connector

本页面介绍了如何手动安装 Config Connector。

如需详细了解不同的安装选项，请参阅选择安装类型。

与使用插件相比，使用手动方法安装可以更快进行更新。

如以下说明中将 Config Connector 配置为集群模式，这意味着将有一个全局 Config Connector 控制器模拟为单个 Google Cloud IAM 服务帐号。当您添加更多 Config Connector 资源并在同一集群中引入更多 Kubernetes 命名空间时，您可能想要考虑切换到命名空间模式，该模式更具可伸缩性，并且可以为多租户用例提供更好的 IAM 权限隔离，例如管理来自多个 Google Cloud 项目的资源。

准备工作

在手动安装 Config Connector Operator 之前，请完成以下步骤：

安装 Config Connector Operator

Config Connector 使用 Kubernetes Operator 使其安装保持最新。如需安装此 Operator，请完成以下步骤：

  1. 下载最新的 Config Connector tar 文件：

    gsutil cp gs://configconnector-operator/latest/release-bundle.tar.gz release-bundle.tar.gz

  2. 解压缩 tar 文件：

    tar zxvf release-bundle.tar.gz

  3. 在集群上安装 Config Connector Operator：

    1. 对于 GKE Autopilot 集群：

      kubectl apply -f operator-system/autopilot-configconnector-operator.yaml

    2. 对于 GKE Standard 集群：

      kubectl apply -f operator-system/configconnector-operator.yaml

创建身份

Config Connector 通过使用 Identity and Access Management (IAM) 服务账号进行身份验证以及使用 GKE 的 Workload Identity 将 IAM 服务账号与 Kubernetes 服务账号绑定来创建和管理 Google Cloud 资源。

如需创建身份，请完成以下步骤：

  1. 创建 IAM 服务账号。 如果您希望使用现有服务账号，则可以使用该账号并跳过此步骤。

    如需创建服务账号，请使用以下命令：
      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
    将 SERVICE_ACCOUNT_NAME 替换为您的服务帐号的名称。

    2. 如需详细了解如何创建服务账号，请参阅创建和管理服务账号。

  2. 向 IAM 服务帐号授予对项目的提升权限：
    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/editor"
    替换以下内容：
    • PROJECT_ID 替换为您的项目 ID。
    • 将 SERVICE_ACCOUNT_NAME 替换为您的服务账号的名称。
  3. 在 IAM 服务帐号与 Config Connector 运行的预定义 Kubernetes 服务帐号之间创建 IAM 政策绑定： 
    gcloud iam service-accounts add-iam-policy-binding \
SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
    --member="serviceAccount:PROJECT_ID.svc.id.goog[cnrm-system/cnrm-controller-manager]" \
    --role="roles/iam.workloadIdentityUser"
    替换以下内容：
    • 将 SERVICE_ACCOUNT_NAME 替换为您的服务账号的名称。
    • PROJECT_ID 替换为您的项目 ID。

配置 Config Connector

要完成安装，请为 ConfigConnector CustomResource 创建配置文件，然后使用 kubectl apply 命令应用该配置文件。Config Connector Operator 会在集群中安装 Google Cloud 资源 CRD 和 Config Connector 组件。

如需将 Operator 配置为集群模式，请完成以下步骤：

  1. 将以下 YAML 文件复制到名为 configconnector.yaml 的文件中： 
    # configconnector.yaml
apiVersion: core.cnrm.cloud.google.com/v1beta1
kind: ConfigConnector
metadata:
  # the name is restricted to ensure that there is only one
  # ConfigConnector resource installed in your cluster
  name: configconnector.core.cnrm.cloud.google.com
spec:
 mode: cluster
 googleServiceAccount: "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
    替换以下内容：
    • 将 SERVICE_ACCOUNT_NAME 替换为您的服务账号的名称。
    • PROJECT_ID 替换为您的项目 ID。
  2. 使用 kubectl apply 将配置应用于您的集群：
      kubectl apply -f configconnector.yaml

指定创建资源的位置

Config Connector 可以按项目、文件夹或组织整理资源，这与使用 Google Cloud 整理资源的方式相同。

在使用 Config Connector 创建资源之前，必须先配置创建资源的位置。为了确定创建资源的位置，Config Connector 会在资源配置或现有命名空间中使用注解。如需了解详情，请参阅整理资源。

如果您没有可用于此目的的命名空间，请使用 kubectl 创建一个命名空间。
kubectl create namespace NAMESPACE

将 NAMESPACE 替换为您的命名空间名称。 例如 config-connector。

选择一个标签页以便选择 Config Connector 创建资源的位置。

项目

如需在特定项目中创建资源，请运行以下命令：

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/project-id=PROJECT_ID

请替换以下内容：

  • 将 NAMESPACE 替换为您的命名空间名称。
  • 将 PROJECT_ID 替换为 Google Cloud 项目 ID。

文件夹

如需在特定文件夹中创建资源，请运行以下命令：

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/folder-id=FOLDER_ID

请替换以下内容：

  • 将 NAMESPACE 替换为您的命名空间名称。
  • 将 FOLDER_ID 替换为您的 Google Cloud 文件夹 ID。

组织

如需在特定组织中创建资源，请运行以下命令：

    kubectl annotate namespace \
    NAMESPACE cnrm.cloud.google.com/organization-id=ORGANIZATION_ID

请替换以下内容：

  • 将 NAMESPACE 替换为您的命名空间名称。
  • 将 ORGANIZATION_ID 替换为您的 Google Cloud 组织 ID。

为命名空间添加注释时，Config Connector 将在相应的项目、文件夹或组织中创建资源。如需详细了解 Config Connector 如何使用 Kubernetes 命名空间，请参阅 Kubernetes 命名空间和 Google Cloud 项目。

验证安装

Config Connector 在命名空间 cnrm-system 中运行其所有组件。您可以通过运行以下命令来验证 Pod 是否准备就绪：

kubectl wait -n cnrm-system \
      --for=condition=Ready pod --all

如果正确安装了 Config Connector，则输出类似于以下内容：

pod/cnrm-controller-manager-0 condition met

升级 Config Connector

下载并安装最新版本的 Config Connector Operator：

gsutil cp gs://configconnector-operator/latest/release-bundle.tar.gz release-bundle.tar.gz
tar zxvf release-bundle.tar.gz
kubectl apply -f operator-system/configconnector-operator.yaml

卸载 Config Connector

请勿按照以下步骤卸载 Config Controller 集群。

使用 kubectl delete 移除 Config Connector CRD 和控制器组件：

kubectl delete ConfigConnector configconnector.core.cnrm.cloud.google.com \
    --wait=true

如需卸载 Config Connector Operator，请运行以下命令：

kubectl delete -f operator-system/configconnector-operator.yaml  --wait=true

从非 Operator 安装升级

Config Connector 1.33.0 版及更高版本仅支持使用 GKE 插件或 Operator 进行安装。

如需升级到 Operator（并保留所有 Config Connector 资源），您必须移除除 CRD 之外的所有 Config Connector 系统组件，然后安装 Operator。

  1. 运行以下命令以移除 Config Connector 系统非 CRD 组件：

    kubectl delete sts,deploy,po,svc,roles,clusterroles,clusterrolebindings --all-namespaces -l cnrm.cloud.google.com/system=true --wait=true
kubectl delete validatingwebhookconfiguration abandon-on-uninstall.cnrm.cloud.google.com --ignore-not-found --wait=true
kubectl delete validatingwebhookconfiguration validating-webhook.cnrm.cloud.google.com --ignore-not-found --wait=true
kubectl delete mutatingwebhookconfiguration mutating-webhook.cnrm.cloud.google.com --ignore-not-found --wait=true

  2. 使用 GKE 插件或 Operator 安装 Config Connector。

从插件切换为手动安装

作为插件安装时，Config Connector 的版本与已安装的 GKE 版本直接相关。

手动安装可以加快更新速度，但需要进行手动升级。

如需在保证安全的同时保留所有资源，请执行以下操作：

  1. 停用插件，而不删除任何 ConfigConnector 或 ConfigConnectorContext 对象：

    gcloud container clusters update CLUSTER_NAME --update-addons ConfigConnector=DISABLED

    将 CLUSTER_NAME 替换为您在其中安装 Config Connector 的集群的名称。

  2. 按照说明安装所需版本的手动 Operator。

后续步骤