本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 EKS 連接器註冊非 EKS 叢集
<a name="eks-connector"></a>

您可以使用 [EKS 連接器](https://docs.aws.amazon.com/eks/latest/userguide/eks-connector.html)在 EKS 主控台中檢視 AWS 外部的叢集。此程序需要向 EKS 註冊叢集，並在外部 Kubernetes 叢集上執行 EKS Connector 代理程式。

 `eksctl` 透過建立所需的 AWS 資源和為 EKS Connector 產生 Kubernetes 資訊清單以套用至外部叢集，簡化註冊非 EKS 叢集。

## 註冊叢集
<a name="_register_cluster"></a>

若要註冊或連接非 EKS Kubernetes 叢集，請執行

```
eksctl register cluster --name <name> --provider <provider>
2021-08-19 13:47:26 [ℹ]  creating IAM role "eksctl-20210819194112186040"
2021-08-19 13:47:26 [ℹ]  registered cluster "<name>" successfully
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-clusterrole.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-console-dashboard-full-access-group.yaml to <current directory>
2021-08-19 13:47:26 [!]  note: "eks-connector-clusterrole.yaml" and "eks-connector-console-dashboard-full-access-group.yaml" give full EKS Console access to IAM identity "<aws-arn>", edit if required; read https://eksctl.io/usage/eks-connector for more info
2021-08-19 13:47:26 [ℹ]  run `kubectl apply -f eks-connector.yaml,eks-connector-clusterrole.yaml,eks-connector-console-dashboard-full-access-group.yaml` before <expiry> to connect the cluster
```

此命令會註冊叢集，並寫入三個檔案，其中包含 EKS Connector 的 Kubernetes 資訊清單，這些資訊清單必須在註冊到期之前套用至外部叢集。

**注意**  
 `eks-connector-clusterrole.yaml` 和 為所有命名空間中的 Kubernetes 資源`eks-connector-console-dashboard-full-access-clusterrole.yaml`提供呼叫 IAM 身分`get`的 和 `list`許可，如果需要，必須在將其套用至叢集之前進行相應編輯。若要設定更多限制存取，請參閱[授予使用者檢視叢集的存取權](https://docs.aws.amazon.com/eks/latest/userguide/connector-grant-access.html)。

若要提供用於 EKS 連接器的現有 IAM 角色，請依照下列`--role-arn`方式透過 傳遞：

```
eksctl register cluster --name <name> --provider <provider> --role-arn=<role-arn>
```

如果叢集已存在，eksctl 會傳回錯誤。

## 取消註冊叢集
<a name="_deregister_cluster"></a>

若要取消註冊或中斷連接已註冊的叢集，請執行

```
eksctl deregister cluster --name <name>
2021-08-19 16:04:09 [ℹ]  unregistered cluster "<name>" successfully
2021-08-19 16:04:09 [ℹ]  run `kubectl delete namespace eks-connector` and `kubectl delete -f eks-connector-binding.yaml` on your cluster to remove EKS Connector resources
```

此命令會取消註冊外部叢集並移除其相關聯的 AWS 資源，但您必須從叢集中移除 EKS 連接器 Kubernetes 資源。

## 詳細資訊
<a name="_further_information"></a>
+  [EKS 連接器](https://docs.aws.amazon.com/eks/latest/userguide/eks-connector.html)