建立 kubeconfig 檔案，將 kubectl 連接至 EKS 叢集

在本主題中，您將為您的叢集建立 kubeconfig 檔案 (或更新現有的檔案)。

kubectl 命令列工具會使用 kubeconfig 檔案中的組態資訊，以與叢集的 API 伺服器進行通訊。如需詳細資訊，請參閱 Kubernetes 文件中的使用 kubeconfig 檔案組織叢集存取。

Amazon EKS 使用 aws eks get-token 命令搭配 kubectl 進行叢集身分驗證。根據預設，CLI AWS 會使用與下列命令傳回的相同登入資料：

aws sts get-caller-identity

• 現有 Amazon EKS 叢集。若要部署叢集，請參閱 開始使用 Amazon EKS。

• kubectl 命令列工具安裝在您的裝置或 AWS CloudShell 上。該版本可與叢集的 Kubernetes 版本相同，或最多可以比您叢集的 Kubernetes 版本早或晚一個次要版本。例如，如果您的叢集版本為 1.29，則可以搭配使用 kubectl 1.28、1.29 或 1.30 版。若要安裝或升級 kubectl，請參閱 設定 kubectl和 eksctl。

• 在您的裝置或 AWS CloudShell 上安裝和設定的 AWS 命令列界面 (AWS CLI) 版本 1.27.160 2.12.3或更新版本。若要檢查您目前的版本，請使用 aws --version | cut -d / -f2 | cut -d ' ' -f1。適用於 macOS 的 yum、 apt-get或 Homebrew 等套件管理員通常是最新版本 CLI AWS 後面的幾個版本。若要安裝最新版本，請參閱《 AWS 命令列界面使用者指南》中的使用 aws 設定安裝 和 Quick configuration。 https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config安裝在 AWS CloudShell 中的 AWS CLI 版本也可能是最新版本後面的幾個版本。若要更新它，請參閱 CloudShell AWS 使用者指南中的將 CLI 安裝到您的主目錄。 AWS CloudShell

• 具有對您指定的叢集使用 eks:DescribeCluster API 動作許多的 IAM 使用者或角色。如需詳細資訊，請參閱Amazon EKS 身分型政策範例。如果您使用自己的 OpenID Connect 提供者身分來存取叢集，請參閱 Kubernetes 文件中的使用 kubectl 來建立或更新您的kube config檔案。

自動建立 kubeconfig 檔案

• 在您的裝置或 AWS CloudShell 上安裝和設定的 AWS 命令列界面 (AWS CLI) 版本 1.27.160 2.12.3或更新版本。若要檢查您目前的版本，請使用 aws --version | cut -d / -f2 | cut -d ' ' -f1。適用於 macOS 的 yum、 apt-get或 Homebrew 等套件管理員通常是最新版本 CLI AWS 後面的幾個版本。若要安裝最新版本，請參閱《 AWS 命令列界面使用者指南》中的使用 aws 設定安裝 和 Quick configuration。 https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config安裝在 AWS CloudShell 中的 AWS CLI 版本也可能是最新版本後面的幾個版本。若要更新它，請參閱 CloudShell AWS 使用者指南中的將 CLI 安裝到您的主目錄。 AWS CloudShell

• 對您指定的叢集使用 eks:DescribeCluster API 動作的許可。如需詳細資訊，請參閱Amazon EKS 身分型政策範例。

  1. 為您的叢集建立或更新 kubeconfig 檔案。將 region-code 取代為您的叢集所在的 AWS 區域，並將 my-cluster 取代為您的叢集名稱。

     aws eks update-kubeconfig --region region-code --name my-cluster

     根據預設，產生的組態檔案會在主目錄預設的 kubeconfig 路徑下 (.kube)，或與位在該處的現有 config 檔案合併。您可以使用 --kubeconfig 選項指定其他路徑。

     您可以使用 --role-arn 選項指定 IAM 角色 ARN，用於在您發出 kubectl 命令時進行身分驗證。否則，會使用預設 CLI 或 SDK 登入資料鏈中的 IAM 主體。 AWS 您可以執行 AWS aws sts get-caller-identity命令來檢視預設的 CLI 或 SDK 身分。

     如需所有可用的選項，請執行 aws eks update-kubeconfig help命令，或參閱 AWS CLI 命令參考中的 update-kubeconfig。

  2. 測試組態。

     kubectl get svc

     範例輸出如下。

     NAME             TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
     svc/kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   1m

     如果您收到任何授權或資源類型錯誤，請參閱故障診斷主題中的未經授權或存取遭拒 (kubectl)。