跳至內容

如何透過 Amazon Linux 2023 工作節點自動化 Amazon EKS 的 HTTP 代理組態?

3 分的閱讀內容
0

我想要透過 Amazon Linux 2023 (AL2023) 工作節點自動化 Amazon Elastic Kubernetes Service (Amazon EKS) 的 HTTP 代理組態。

解決方法

在 AL2023 中,NodeConfig 使用 nodeadm 來調整代理設定。

重要事項: 若要透過 AL2023 中的 NodeConfig 規格設定 HTTP 代理設定,您必須擁有 Amazon Machine Image (AMI) 發行版本 20251120 或更高版本。

建立自訂啟動範本

注意: 如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息,請參閱 Troubleshooting errors for the AWS CLI (對 AWS CLI 錯誤進行疑難排解)。此外,請務必使用最新版 AWS CLI。

請完成下列步驟:

  1. 使用 AL2023 AMI ID 建立自訂啟動範本。
    注意: 如果您未在自訂啟動範本中指定 AMI,則受管節點群組會自動合併使用者資料。
  2. 請在使用者資料內設定代理設定,並使用下列欄位建構您的使用者資料:
    MIME-Version: 1.0
    Content-Type: multipart/mixed; boundary="//"
    --//
    Content-Type: application/node.eks.aws
    ---
    apiVersion: node.eks.aws/v1alpha1
    kind: NodeConfig
    spec:
      cluster:
        apiServerEndpoint: API_SERVER_ENDPOINT
        certificateAuthority: YOUR_CLUSTER_CA
        cidr: KUBERNETES_SERVICE_CIDR_RANGE
        name: EKS_CLUSTER_NAME
      instance:
        environment:
          default:
            HTTP_PROXY: http://PROXY_SERVER_IP_ADDRESS:PORT
            HTTPS_PROXY: http://PROXY_SERVER_IP_ADDRESS:PORT
            NO_PROXY: localhost,127.0.0.1,169.254.169.254,VPC_CIDR_RANGE,.internal,.eks.amazonaws.com
    --//--

注意: 請將下列預留位置替換為您的數值:

  • 將 API_SERVER_ENDPOINT 替換為您的 API 伺服器端點
  • 將 YOUR_CLUSTER_CA 自換為您的叢集憑證認證機構 (CA)
  • 將 KUBERNETES_SERVICE_CIDR_RANGE 替換為您的服務 CIDR 範圍
  • 將 EKS_CLUSTER_NAME 替換為您的叢集名稱
  • 將 PROXY_SERVER_IP_ADDRESS:PORT 替換為您的 Proxy 伺服器位址與通訊埠
  • VPC_CIDR_RANGE 替換為您的虛擬私有雲端 (VPC) CIDR 範圍

如果您使用 VPC 端點,請將 AWS 服務端點新增至 NO_PROXY。如果您的叢集端點存取僅限公開,請從 NO_PROXY 中排除 .eks.amazonaws.com。如需 NodeConfig 中環境變數的更多資訊,請參閱 EnvironmentOptions。

為 aws-node 與 kube-proxy 設定代理

請完成下列步驟:

  1. 根據您的叢集端點存取設定代理。如果您的叢集端點存取僅限公開,請為 aws-node 與 kube-proxy 設定代理。如果您的叢集端點存取為私有,或是公開且私有但沒有 Amazon Elastic Compute Cloud (Amazon EC2) VPC 端點,請為 aws-node 設定代理。
  2. 若要建立 ConfigMap 以設定環境變數,請使用下列範例指令碼:
    apiVersion: v1
    kind: ConfigMap
    metadata:
       name: proxy-environment-variables
       namespace: kube-system
    data:
       HTTP_PROXY: http://PROXY_SERVER_IP_ADDRESS:PORT
       HTTPS_PROXY: http://PROXY_SERVER_IP_ADDRESS:PORT
       NO_PROXY: KUBERNETES_SERVICE_CIDR_RANGE,localhost,127.0.0.1,169.254.169.254,VPC_CIDR_RANGE,.internal,.eks.amazonaws.com
    注意: 請將 PROXY_SERVER_IP_ADDRESS:PORT 替換為您的代理伺服器位址與通訊埠、將 KUBERNETES_SERVICE_CIDR_RANGE 替換為您的服務 CIDR 範圍,並將 VPC_CIDR_RANGE 替換為您的 VPC CIDR 範圍。如果您使用 VPC 端點,請將 AWS 服務端點新增至 NO_PROXY。如果您的叢集端點存取僅限公開,請從 NO_PROXY 中排除 .eks.amazonaws.com。
  3. 將 ConfigMap 套用至您的叢集。
  4. 若要將您的 HTTP 代理組態設定至 aws-node 與 kube-proxy,請執行下列命令:
    kubectl patch -n kube-system -p '{ "spec": {"template":{ "spec": { "containers": [ { "name": "aws-node", "envFrom": [ { "configMapRef": {"name": "proxy-environment-variables"} } ] } ] } } } }' daemonset aws-node
    kubectl patch -n kube-system -p '{ "spec": {"template":{ "spec": { "containers": [ { "name": "kube-proxy", "envFrom": [ { "configMapRef": {"name": "proxy-environment-variables"} } ] } ] } } } }' daemonset kube-proxy

建立受管理節點群組

為您的叢集建立新的受管節點群組,該群組使用您所建立的自訂啟動範本。

測試您的代理

若要確認代理是否運作正常,請完成下列步驟:

  1. 若要檢查節點狀態,請執行下列命令:

    kubectl get nodes
    kubectl run test-pod --image=amazonlinux:2023 --restart=Never -- sleep 300
    kubectl get pods -A

    輸出範例:

    kubectl get nodes
    NAME                           STATUS   ROLES    AGE    VERSION
    ip-10-0-139-233.ec2.internal   Ready       7m7s   v1.32.9-eks-ecaa3a6
    kubectl run test-pod --image=amazonlinux:2023 --restart=Never -- sleep 300
    pod/test-pod created
    kubectl get pods -A
    NAMESPACE     NAME                       READY   STATUS    RESTARTS   AGE
    default       test-pod                   1/1     Running   0          24s
    kube-system   aws-node-h999l             2/2     Running   0          7m40s
    kube-system   coredns-69bf5c796c-2q478   1/1     Running   0          18h
    kube-system   coredns-69bf5c796c-7lwvt   1/1     Running   0          18h
    kube-system   kube-proxy-sxgn8           1/1     Running   0          7m40s
  2. 檢查您的代理日誌,以取得更多節點連線能力的資訊。
    日誌範例:

    10.0.139.233 TCP_TUNNEL/200 10425 CONNECT auth.docker.io:443 - HIER_DIRECT/XX.XX.XX.XX -
    10.0.139.233 TCP_TUNNEL/200 5285 CONNECT registry-1.docker.io:443 - HIER_DIRECT/XX.XX.XX.XX -
    10.0.139.233 TCP_TUNNEL/200 10424 CONNECT auth.docker.io:443 - HIER_DIRECT/XX.XX.XX.XX -
    10.0.139.233 TCP_TUNNEL/200 54112823 CONNECT docker-images-prod.s3.dualstack.us-east-1.amazonaws.com:443 - HIER_DIRECT/XX.XX.XX.XX -
    10.0.139.233 TCP_TUNNEL/200 5675 CONNECT registry-1.docker.io:443 - HIER_DIRECT/XX.XX.XX.XX -

相關資訊

Upgrade from Amazon Linux 2 to Amazon Linux 2023 (從 Amazon Linux 2 升級至 Amazon Linux 2023)

Node bootstrapping (節點啟動)

AWS 官方已更新 8 個月前