協助改善此頁面
想要為此使用者指南做出貢獻嗎? 捲動至此頁面底部,然後選取 [編輯此頁面於] GitHub。您的貢獻將有助於使我們的用戶指南更適合所有人。
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 CoreDNS Amazon EKS 附加元件
CoreDNS 是一個靈活、可擴展的 DNS 伺服器,可用來做為 Kubernetes 叢集 DNS。當您啟動具有至少一個節點的 Amazon EKS 叢集時,依預設會部署兩個 CoreDNS 映像複本,而不論叢集中部署的節點數量為何。CoreDNS Pods 為叢集中的所有 Pods 提供名稱解析。如果您的叢集包含使用命名空間與 CoreDNS deployment
的命名空間相匹配的 定義啟動 AWS Fargate 時的Pods用途,則可將 CoreDNS Pods 部署至 Fargate 節點。如需 CoreDNS 的詳細資訊,請參閱 Kubernetes 文件中的使用 CoreDNS 進行服務探索
下表列出適用於每個 Kubernetes 版本的 Amazon EKS 附加元件類型最新版本。
Kubernetes 版本 | 1.30 |
1.29 |
1.28 |
1.27 |
1.26 |
1.25 |
1.24 |
1.23 |
---|---|---|---|---|---|---|---|---|
v1.11.1-eksbuild.9 |
v1.11.1-eksbuild.9 |
v1.10.1-eksbuild.11 |
v1.10.1-eksbuild.11 |
v1.9.3-eksbuild.15 |
v1.9.3-eksbuild.15 |
v1.9.3-eksbuild.15 |
v1.8.7-eksbuild.10 |
重要
如果您要自行管理此附加元件,資料表中的版本可能與可用的自我管理版本不同。如需更新此附加元件之自我管理類型的詳細資訊,請參閱 更新自我管理的附加元件。
重要的 CoreDNS 升級考量
-
為了提高 CoreDNS Deployment 的穩定性與可用性,
v1.9.3-eksbuild.6
及更新版本和v1.10.1-eksbuild.3
隨PodDisruptionBudget
一起部署。如果您已部署現有PodDisruptionBudget
,則可能無法升級至上述版本。如果升級失敗,完成下列其中一項任務即可解決問題:-
升級 Amazon EKS 附加元件時,選擇將覆寫現有設定作為衝突解決方案選項。如果您已對 Deployment 制定自訂設定,則務必在升級前備份設定,以便在升級後重新套用其他自訂設定。
-
移除現有的
PodDisruptionBudget
,然後再次嘗試升級。
-
-
在 EKS 附加元件版本以
v1.9.3-eksbuild.3
及更新版本v1.10.1-eksbuild.6
和更新版本中,將CoreDNSDeployment設定readinessProbe
為使用/ready
端點。此端點已在的Corefile
組態檔案中啟用CoreDNS。如果您使用 Custom
Corefile
,則必須將ready
外掛程式新增至組態,以便在CoreDNS中使用該/ready
端點才能使用探查。 -
在 EKS 附加元件版本以
v1.9.3-eksbuild.7
及更新版本v1.10.1-eksbuild.4
和更新版本中,您可以變更PodDisruptionBudget
。您可以使用下列範例的欄位,在選擇性組態設定中編輯附加元件並變更這些設定。此範例顯示預設值PodDisruptionBudget
。{ "podDisruptionBudget": { "enabled": true, "maxUnavailable": 1 } }
您可以設置
maxUnavailable
或minAvailable
,但不能同時在單一PodDisruptionBudget
進行設置。如需PodDisruptionBudgets
的詳細資訊,請在Kubernetes 文件參閱指定PodDisruptionBudget
。 請注意,如果您設
enabled
定為false
,則PodDisruptionBudget
不會移除。將此欄位設定為false
之後,您必須刪除PodDisruptionBudget
物件。同樣地,如果您在升級至具有的版本之後編輯附加元件以使用較舊版本的附加元件 (降級附加元件)PodDisruptionBudget
,則PodDisruptionBudget
不會移除。執行下列命令以刪除PodDisruptionBudget
:kubectl delete poddisruptionbudget coredns -n kube-system
-
在 EKS 附加元件版本
v1.10.1-eksbuild.5
及更新版本中,將預設容許範圍從變更node-role.kubernetes.io/master:NoSchedule
node-role.kubernetes.io/control-plane:NoSchedule
為符合 KEP 2067。如需 KEP 2067 的詳細資訊,請參閱 GitHub 上 Kubernetes Enhancement Proposals (KEP) 中的 KEP-2067:重新命名 kubeadm「主要」標籤和污點。 在 EKS 附加版本以
v1.8.7-eksbuild.8
及更新版本v1.9.3-eksbuild.9
和更新版本中,兩個容許設置為與每個Kubernetes版本兼容。 -
在 EKS 附加元件版本
v1.9.3-eksbuild.11
v1.10.1-eksbuild.7
和更新版本中,會CoreDNSDeployment設定的預設值。topologySpreadConstraints
如果有多個可用區域中CoreDNSPods的節點可用,預設值可確保分散到可用區域。您可以設定將使用的自訂值,而非預設值。預設值如下:topologySpreadConstraints: - maxSkew: 1 topologyKey: topology.kubernetes.io/zone whenUnsatisfiable: ScheduleAnyway labelSelector: matchLabels: k8s-app: kube-dns
CoreDNSv 1.11
升級考量
-
在 EKS 附加版本
v1.11.1-eksbuild.4
和更高版本中,容器映像是以 Amazon EKS Distro 維護的最小基本映像為基礎,該映像包含最少的套件且沒有殼層。如需詳細資訊,請參閱 Amazon EKS Distro 。CoreDNS圖像的使用和故障排除保持不變。
建立 Amazon EKS 附加元件
建立附加元件的 Amazon EKS 類型。Check
必要條件
-
現有 Amazon EKS 叢集。若要部署叢集,請參閱 開始使用 Amazon EKS。
-
查看叢集上目前安裝了哪些附加元件版本。
kubectl describe deployment coredns --namespace kube-system | grep coredns: | cut -d : -f 3
範例輸出如下。
v1.10.1-eksbuild.11
-
查看叢集上安裝的附加元件類型。視您用來建立叢集的工具而定,您的叢集上目前可能沒有安裝 Amazon EKS 附加元件類型。使用您叢集的名稱取代
my-cluster
。aws eks describe-addon --cluster-name
my-cluster
--addon-name coredns --query addon.addonVersion --output text如果傳回版本編號,則表明已在叢集上安裝 Amazon EKS 類型的附加元件,並且無需完成此程序中的剩餘步驟。如果傳回錯誤,則表明沒有在叢集上安裝 Amazon EKS 類型的附加元件。完成此程序的剩餘步驟以安裝該類型。
-
儲存您目前安裝的附加元件。
kubectl get deployment coredns -n kube-system -o yaml >
aws-k8s-coredns-old.yaml
-
使用 AWS CLI建立附加元件。如果您想要使用 AWS Management Console 或
eksctl
建立附加元件,請參閱創建一個 Amazon EKS 插件並指定coredns
附加元件名稱。將隨後的命令複製到您的裝置。視需要對命令進行下列修改,然後執行修改後的命令。-
使用您叢集的名稱取代
。my-cluster
aws eks create-addon --cluster-name
my-cluster
--addon-name coredns --addon-versionv1.11.1-eksbuild.9
如果您已將自訂設定套用至與 Amazon EKS 附加元件的預設設定衝突的目前附加元件,建立動作可能會失敗。若建立失敗,您會收到錯誤,其中的訊息有助於您解決問題。或者,您可以將
--resolve-conflicts OVERWRITE
新增至上一條命令。這可讓附加元件覆寫任何現有的自訂設定。建立附加元件後,可以使用自訂設定來更新該附加元件。 -
-
確認叢集 Kubernetes 版本的附加元件的最新版本已新增至叢集。使用您叢集的名稱取代
。my-cluster
aws eks describe-addon --cluster-name
my-cluster
--addon-name coredns --query addon.addonVersion --output text建立附加元件的動作可能需要幾秒鐘的時間才能完成。
範例輸出如下。
v1.11.1-eksbuild.9
-
如果您對原始附加元件制定自訂設定,請在建立 Amazon EKS 附加元件之前,使用在上一步中儲存的組態,以您的自訂設定更新 Amazon EKS 附加元件。
更新 Amazon EKS 附加元件
更新 Amazon EKS 類型的附加元件。如果您尚未將 Amazon EKS 類型的附加元件新增至叢集,請新增該類型或查看 更新自我管理的附加元件,而不是完成此程序。
-
查看叢集上目前安裝了哪些附加元件版本。使用您的叢集名稱取代
。my-cluster
aws eks describe-addon --cluster-name
my-cluster
--addon-name coredns --query "addon.addonVersion" --output text範例輸出如下。
v1.10.1-eksbuild.11
如果傳回的版本與最新版本資料表中的叢集 Kubernetes 版本相同,則表明您已經在叢集上安裝最新版本,不需要完成此程序的剩餘步驟。若您收到錯誤而非版本編號,則表明叢集上沒有安裝 Amazon EKS 類型的附加元件。您必須先建立附加元件,才能使用此程序進行更新。
-
儲存您目前安裝的附加元件。
kubectl get deployment coredns -n kube-system -o yaml >
aws-k8s-coredns-old.yaml
-
使用 AWS CLI更新您的附加元件。如果您想要使用 AWS Management Console 或
eksctl
更新附加元件,請參閱更新 Amazon 附EKS加組件。將隨後的命令複製到您的裝置。視需要對命令進行下列修改,然後執行修改後的命令。-
使用您叢集的名稱取代
。my-cluster
-
--resolve-conflicts
PRESERVE
選項會保留附加元件的現有組態值。如果對於附加元件設定,您已設定自訂值,但未使用此選項,Amazon EKS 會以其預設值覆寫您的值。如果您使用此選項,建議您在更新生產叢集上的附加元件之前,測試非生產叢集上的任何欄位和值變更。如果您將此值變更為OVERWRITE
,則所有設定都會變更為 Amazon EKS 預設值。如果您已設定任何設定的自訂值,則可能會使用 Amazon EKS 預設值覆寫這些值。如果您將此值變更為none
,Amazon EKS 不會變更任何設定的值,但更新可能會失敗。若更新失敗,您會收到錯誤訊息,以協助您解決衝突。 -
如果您不更新組態設定,請從命令中移除
--configuration-values '{
。如果您要更新組態設定,請以您要進行的設定取代"replicaCount":3
}'"replicaCount":3
。在此範例中,CoreDNS 的複本數目設定為3
。您指定的值必須對組態結構描述有效。如果您不知道配置模式,請運行aws eks describe-addon-configuration --addon-name coredns --addon-version
並將v1.11.1-eksbuild.9
v1.11.1-eksbuild.9
替換為您要查看其配置的附加元件的版本號碼。結構描述會在輸出中傳回。如果您有任何現有的自訂組態,並且想要全部移除,同時將所有設定的值設定回 Amazon EKS 預設值,請從命令中移除"replicaCount":3
,這樣就會得到空白的
。如需有關 CoreDNS 設定的詳細資訊,請參閱 Kubernetes 文件中的自訂 DNS 服務{}
。 aws eks update-addon --cluster-name
my-cluster
--addon-name coredns --addon-versionv1.11.1-eksbuild.9
\ --resolve-conflictsPRESERVE
--configuration-values '{"replicaCount":3
}'更新動作可能需要幾秒鐘的時間才能完成。
-
-
確認附加元件版本已更新。使用您叢集的名稱取代
。my-cluster
aws eks describe-addon --cluster-name
my-cluster
--addon-name coredns更新動作可能需要幾秒鐘的時間才能完成。
範例輸出如下。
{ "addon": { "addonName": "coredns", "clusterName": "
my-cluster
", "status": "ACTIVE", "addonVersion": "v1.11.1-eksbuild.9
", "health": { "issues": [] }, "addonArn": "arn:aws:eks:region
:111122223333
:addon/my-cluster
/coredns/d2c34f06-1111-2222-1eb0-24f64ce37fa4", "createdAt": "2023-03-01T16:41:32.442000+00:00", "modifiedAt": "2023-03-01T18:16:54.332000+00:00", "tags": {},"configurationValues": "{\"replicaCount\":3}"
} }
更新自我管理的附加元件
重要
建議將附加元件的 Amazon EKS 類型新增到叢集,而不是使用附加元件的自我管理類型。如果您不熟悉類型之間的差異,則請參閱 Amazon EKS 插件。如需將 Amazon EKS 附加元件新增至叢集的詳細資訊,請參閱 創建一個 Amazon EKS 插件。如果您無法使用 Amazon EKS 附加元件,我們建議您提交有關為何無法存取容器藍圖GitHub 儲存庫
-
確認您的叢集上已安裝附加元件的自我管理類型。使用您叢集的名稱取代
my-cluster
。aws eks describe-addon --cluster-name
my-cluster
--addon-name coredns --query addon.addonVersion --output text如果傳回錯誤訊息,則表明您的叢集上安裝了附加元件的自我管理類型。完成此程序的剩餘步驟。如果傳回版本編號,則表明已在叢集上安裝附加元件的 Amazon EKS 類型。若要更新附加元件的 Amazon EKS 類型,請使用 更新 Amazon EKS 附加元件 中的程序,而不是使用此程序。如果您不熟悉附加元件類型之間的差異,請參閱 Amazon EKS 插件。
-
查看叢集上目前安裝了哪些容器映像版本。
kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3
範例輸出如下。
v1.8.7-eksbuild.2
-
如果您目前的 CoreDNS 版本為
v1.5.0
或更新版本,但比 CoreDNS 版本表格中列出的版本還要舊,則略過此步驟。如果您目前的版本比1.5.0
還要舊,則需要修改 CoreDNS 的ConfigMap
,以使用正向附加元件,而不是代理附加元件。-
使用下列命令開啟 ConfigMap。
kubectl edit configmap coredns -n kube-system
-
使用
forward
取代為下列行中的proxy
:儲存檔案,然後退出編輯器。
. /etc/resolv.confproxy
-
-
若您原先在 Kubernetes
1.17
或舊版本上部署叢集,則您可能需要從您的 CoreDNS 清單檔案中移除已終止的行。重要
您必須在升級至 CoreDNS 版本
1.7.0
之前完成此步驟,即使您正在升級至較舊版本,也建議您先完成此步驟。-
檢查您的 CoreDNS 清單檔案是否有這一行。
kubectl get configmap coredns -n kube-system -o jsonpath='{$.data.Corefile}' | grep upstream
如果沒有傳回任何輸出,則清單檔案沒有該行,您可以跳至下一個步驟來更新 CoreDNS。如果傳回輸出,那麼您需要移除該行。
-
使用下列命令編輯
ConfigMap
,移除檔案中有文字upstream
的行。不要變更檔案中的任何其他內容。移除行之後,儲存變更。kubectl edit configmap coredns -n kube-system -o yaml
-
-
擷取您目前的 CoreDNS 映像版本:
kubectl describe deployment coredns -n kube-system | grep Image
範例輸出如下。
602401143452
.dkr.ecr.region-code
.amazonaws.com/eks/coredns:v1.8.7-eksbuild.2
-
若要更新至 CoreDNS
1.8.3
或更新版本,您必須將endpointslices
許可新增至system:coredns
Kubernetesclusterrole
。kubectl edit clusterrole system:coredns -n kube-system
在檔案的
rules
區段的現有許可行下,新增以下行。[...]
- apiGroups: - discovery.k8s.io resources: - endpointslices verbs: - list - watch
[...] -
使用上一步中傳回的輸出值取代
和602401143452
來更新 CoreDNS 附加元件。將region-code
取代為 Kubernetes 版本的最新版本資料表中列出的 CoreDNS 版本。v1.11.1-eksbuild.9
kubectl set image deployment.apps/coredns -n kube-system coredns=
602401143452
.dkr.ecr.region-code
.amazonaws.com/eks/coredns:v1.11.1-eksbuild.9
範例輸出如下。
deployment.apps/coredns image updated
-
再次檢查容器映像版本,以確認其已更新至您在上一步中指定的版本。
kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3
範例輸出如下。
v1.11.1-eksbuild.9