View a markdown version of this page

Amazon EKS Hybrid Nodes 게이트웨이 구성 참조 - Amazon EKS
헬름 차트 값자율 모드 및 관리형 노드 그룹 구성 비교리더 선정 조정관련 주제

이 페이지 개선에 도움 주기

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 GitHub에서 이 페이지 편집 링크를 선택합니다.

Amazon EKS Hybrid Nodes 게이트웨이 구성 참조

이 페이지에서는 Amazon EKS Hybrid Nodes 게이트웨이에 대해 구성 가능한 모든 파라미터를 문서화합니다. 설치 지침은 EKS Hybrid Nodes 게이트웨이 시작하기을 확인하세요. 게이트웨이에 대한 개요는 Amazon EKS Hybrid Nodes 게이트웨이 섹션을 참조하세요.

헬름 차트 값

다음 표에는 eks-hybrid-nodes-gateway 헬름 차트의 모든 값이 나와 있습니다. helm install 또는 helm upgrade 중에 --set 플래그 또는 사용자 지정 values.yaml 파일을 사용하여 이러한 값을 설정할 수 있습니다.

값 유형 기본값 필수 설명

image.repository

문자열

public.ecr.aws/eks/eks-hybrid-nodes-gateway

No

게이트웨이 이미지의 컨테이너 이미지 리포지토리입니다. Amazon ECR 레지스트리에 대해 기본값입니다.

image.tag

문자열

차트 appVersion

아니요

이미지 태그입니다. Chart.yaml에서 정의된 appVersion을 기본값으로 사용합니다.

image.pullPolicy

문자열

IfNotPresent

No

이미지 풀 정책입니다. 유효한 값: Always, IfNotPresent, Never.

replicas

정수

2

아니요

게이트웨이 포드 복제본 수입니다. 두 개의 복제본은 프로덕션 환경에서 고가용성을 위해 권장되는 구성입니다.

nodeLabel

문자열

hybrid-gateway-node

No

게이트웨이 노드를 선택하는 데 사용되는 노드 레이블 키입니다. 노드에서 이 레이블은 "true"로 설정되어 있어야 합니다.

vpcCIDR

문자열

""

예

Cilium VTEP 구성에 대해 사용되는 VPC CIDR 블록입니다. 예시: 10.0.0.0/16.

podCIDRs

문자열

""

예

Cilium이 하이브리드 노드에서 사용하는 포드 CIDR의 쉼표로 구분된 목록입니다. 예시: 10.85.0.0/16,10.86.0.0/16.

routeTableIDs

문자열

""

예

하이브리드 포드 경로로 프로그래밍할 VPC 라우팅 테이블 ID의 쉼표로 구분된 목록입니다. 예시: rtb-0123456789abcdef0,rtb-0123456789abcdef1.

autoMode.enabled

부울

true

아니요

EKS 자율 모드 통합을 활성화합니다. true인 경우 차트는 eks.amazonaws.com/compute-type: auto 노드 선택기를 추가하고 제로 가동 중지 시간 롤링 업데이트 전략을 사용합니다. 관리형 노드 그룹 또는 자체 관리형 노드의 경우 false로 설정합니다.

설치 명령 예제

EKS 자율 모드(기본값):

helm install eks-hybrid-nodes-gateway oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set vpcCIDR=VPC_CIDR \
  --set podCIDRs=POD_CIDRS \
  --set routeTableIDs=ROUTE_TABLE_IDS

관리형 노드 그룹 또는 자체 관리형 노드:

helm install eks-hybrid-nodes-gateway oci://public.ecr.aws/eks/eks-hybrid-nodes-gateway \
  --version 1.0.0 \
  --namespace eks-hybrid-nodes-gateway \
  --create-namespace \
  --set autoMode.enabled=false \
  --set vpcCIDR=VPC_CIDR \
  --set podCIDRs=POD_CIDRS \
  --set routeTableIDs=ROUTE_TABLE_IDS

자율 모드 및 관리형 노드 그룹 구성 비교

autoMode.enabled 헬름 값은 배포 템플릿에서 두 가지 동작을 제어합니다.

동작 autoMode.enabled=true(기본값) autoMode.enabled=false

노드 선택기

게이트웨이 노드 레이블 외에 eks.amazonaws.com/compute-type: auto를 추가합니다.

게이트웨이 노드 레이블(hybrid-gateway-node: "true")만 사용합니다.

롤링 업데이트 전략

maxSurge: 1, maxUnavailable: 0 - 이전 포드를 종료하기 전에 새 포드를 시작하여 업그레이드 중에 제로 가동 중지 시간을 유지합니다.

maxSurge: 0, maxUnavailable: 1 - 노드 용량이 사전 프로비저닝되어 있으므로 새 포드를 시작하기 전에 이전 포드를 종료합니다.

EKS 자율 모드를 사용하는 경우 헬름 차트를 설치하기 전에 NodePool 및 NodeClass를 생성해야 합니다. NodePool은 올바른 레이블, 테인트 및 소스/대상 확인 구성을 통해 EC2 인스턴스를 프로비저닝합니다. 필수 YAML은 EKS Hybrid Nodes 게이트웨이 시작하기 섹션을 참조하세요. 관리형 노드 그룹 또는 자체 관리형 노드를 사용하는 경우 차트를 설치하기 전에 사용자가 직접 노드를 프로비저닝하고 레이블을 지정해야 합니다.

모든 배포 대상에 대해 배포는 hostNetwork: true를 사용하며, NET_ADMIN 기능이 필요합니다. 포드 비선호도는 두 게이트웨이 포드가 별도의 노드에서 실행되도록 보장합니다.

리더 선정 조정

게이트웨이는 Kubernetes 리스 기반 리더 선정을 사용하여 활성-대기 모델을 유지 관리합니다. 기본 파라미터는 빠른 장애 조치를 위해 조정됩니다.

파라미터 기본값 설명

--leader-election-lease-duration

3s

리더가 아닌 포드가 마지막으로 관찰된 리스 갱신 후 리스를 획득하려고 시도하기 전에 대기하는 시간입니다. 값이 낮을수록 리더 장애를 더 빠르게 감지하지만 일시적인 네트워크 문제 발생 시 잘못된 장애 조치의 위험이 증가합니다.

--leader-election-renew-deadline

2s

활성 리더가 리더십을 포기하기 전에 리스를 갱신하는 데 소비하는 최대 시간입니다. 리스 기간보다 작아야 합니다.

--leader-election-retry-period

1s

후보가 리스 획득 또는 갱신을 재시도하는 빈도입니다.

기본값을 사용하는 경우 활성 게이트웨이에서 장애가 발생할 때 예상되는 장애 조치 시간은 약 3~5초입니다. 여기에는 대기 포드가 리스 만료를 감지하고, 리스를 획득하며, 리더 설정 시퀀스(VPC 라우팅 테이블 업데이트 및 Cilium VTEP 구성)를 실행하는 시간이 포함됩니다.

리더 선정 파라미터를 조정해야 하는 경우

  • 게이트웨이 포드와 Kubernetes API 서버 간 일시적인 네트워크 지연 시간으로 인해 리더 전환이 빈번하게 관찰되는 경우 리스 기간을 늘립니다.

  • 더 빠른 장애 조치 감지가 필요하고 게이트웨이 노드와 API 서버 간 네트워크가 신뢰할 수 있고 지연 시간이 짧은 경우 리스 기간을 줄입니다.

  • 대규모 클러스터에서 리더 선정으로 인한 API 서버 부하를 줄이려면 재시도 기간을 늘립니다.

참고

--leader-election-renew-deadline은 항상 --leader-election-lease-duration보다 작아야 합니다. 갱신 기한이 리스 기간을 초과하는 경우 리더는 갱신하기 전에 리스를 잃을 수 있습니다.