**이 페이지 개선에 도움 주기** 

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

# Amazon EKS Hybrid Nodes 게이트웨이 구성 참조
<a name="hybrid-nodes-gateway-configuration"></a>

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

## 헬름 차트 값
<a name="hybrid-nodes-gateway-helm-values"></a>

다음 표에는 `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`로 설정합니다. | 

### 설치 명령 예제
<a name="hybrid-nodes-gateway-install-examples"></a>

 **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}}
```

## 자율 모드 및 관리형 노드 그룹 구성 비교
<a name="hybrid-nodes-gateway-auto-vs-mng"></a>

`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 게이트웨이 시작하기](hybrid-nodes-gateway-getting-started.md) 섹션을 참조하세요. 관리형 노드 그룹 또는 자체 관리형 노드를 사용하는 경우 차트를 설치하기 전에 사용자가 직접 노드를 프로비저닝하고 레이블을 지정해야 합니다.

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

## 리더 선정 조정
<a name="hybrid-nodes-gateway-leader-tuning"></a>

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


| 파라미터 | 기본값 | 설명 | 
| --- | --- | --- | 
|  `--leader-election-lease-duration`  |  `3s`  | 리더가 아닌 포드가 마지막으로 관찰된 리스 갱신 후 리스를 획득하려고 시도하기 전에 대기하는 시간입니다. 값이 낮을수록 리더 장애를 더 빠르게 감지하지만 일시적인 네트워크 문제 발생 시 잘못된 장애 조치의 위험이 증가합니다. | 
|  `--leader-election-renew-deadline`  |  `2s`  | 활성 리더가 리더십을 포기하기 전에 리스를 갱신하는 데 소비하는 최대 시간입니다. 리스 기간보다 작아야 합니다. | 
|  `--leader-election-retry-period`  |  `1s`  | 후보가 리스 획득 또는 갱신을 재시도하는 빈도입니다. | 

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

### 리더 선정 파라미터를 조정해야 하는 경우
<a name="hybrid-nodes-gateway-leader-tuning-guidance"></a>
+  게이트웨이 포드와 Kubernetes API 서버 간 일시적인 네트워크 지연 시간으로 인해 리더 전환이 빈번하게 관찰되는 경우 **리스 기간을 늘립니다**.
+  더 빠른 장애 조치 감지가 필요하고 게이트웨이 노드와 API 서버 간 네트워크가 신뢰할 수 있고 지연 시간이 짧은 경우 **리스 기간을 줄입니다**.
+  대규모 클러스터에서 리더 선정으로 인한 API 서버 부하를 줄이려면 **재시도 기간을 늘립니다**.

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

## 관련 주제
<a name="hybrid-nodes-gateway-configuration-related"></a>
+  [Amazon EKS Hybrid Nodes 게이트웨이](hybrid-nodes-gateway-overview.md) 
+  [EKS Hybrid Nodes 게이트웨이 시작하기](hybrid-nodes-gateway-getting-started.md) 
+  [Amazon EKS Hybrid Nodes 게이트웨이 작업](hybrid-nodes-gateway-operations.md) 
+  [Amazon EKS Hybrid Nodes 게이트웨이 문제 해결](hybrid-nodes-gateway-troubleshooting.md)