Skip to content

Commit 6229b89

Browse files
committed
docs(hybrid): 아키텍처 결정 가이드 재구성 — 6가지 설계 결정 지도로 확장 KO+EN
- Pod CIDR 노출 단일 주제 → 6-결정 구조(연결·토폴로지·Pod CIDR 노출·CNI·노드 인증·워크로드 노출) - 옵션 번호 ①②③ → A/B/C 개칭(결정 번호와 충돌 방지), 결정 간 의존 관계 mermaid 추가 - DX vs VPN 판단표(터널당 1.25Gbps, DX 전용 1·10·100Gbps 등 팩트 앵커) 신설 - 허브 카드·overview 인덱스·fundamentals 참조 문구 동기화(KO+EN 8곳)
1 parent cd99483 commit 6229b89

8 files changed

Lines changed: 242 additions & 68 deletions

File tree

docs/eks-hybrid-nodes/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Amazon EKS Hybrid Nodes는 온프레미스·엣지 인프라의 서버를 AWS
2929
to="/docs/eks-hybrid-nodes/overview-architecture"
3030
icon="🧭"
3131
title="개요 & 아키텍처"
32-
description="Hybrid Nodes 개념·동작 원리·주요 기술 특징, Routable Pod CIDR vs Gateway 아키텍처 결정 프레임워크"
32+
description="Hybrid Nodes 개념·동작 원리·주요 기술 특징, 연결·토폴로지·Pod CIDR 노출 등 6가지 설계 결정 가이드"
3333
color="#667eea"
3434
/>
3535
<DocCard

docs/eks-hybrid-nodes/overview-architecture/architecture-decision-guide.md

Lines changed: 115 additions & 28 deletions
Large diffs are not rendered by default.

docs/eks-hybrid-nodes/overview-architecture/hybrid-nodes-fundamentals.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -295,7 +295,7 @@ EKS Hybrid Nodes는 온프레미스 데이터 플레인을 AWS 관리형 컨트
295295
- [Deep dive into cluster networking for Amazon EKS Hybrid Nodes — AWS Containers Blog](https://aws.amazon.com/blogs/containers/deep-dive-into-cluster-networking-for-amazon-eks-hybrid-nodes/) — BGP·정적 라우팅 구성 상세
296296

297297
### 관련 문서 (내부)
298-
- [아키텍처 결정 가이드](./architecture-decision-guide.md) — Routable Pod CIDR vs Gateway 의사결정 프레임워크
298+
- [아키텍처 결정 가이드](./architecture-decision-guide.md) — 6가지 설계 결정의 판단 기준과 의존 관계
299299
- [CIDR 설계와 대역 최소화](../networking/cidr-network-design.md) — VPC 사이징, ENI 전용 서브넷, 멀티 환경 주소 계획
300300
- [Hybrid Nodes Gateway 구축과 운영](../networking/hybrid-nodes-gateway.md) — Gateway 동작 메커니즘·설치·운영
301301
- [방화벽·DNS 사전 등록 가이드](../networking/firewall-connectivity.md) — 5존 방화벽 룰과 TGW 토폴로지

docs/eks-hybrid-nodes/overview-architecture/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: 개요 & 아키텍처
3-
description: EKS Hybrid Nodes의 개념·동작 원리·주요 기술 특징과 Routable Pod CIDR vs Hybrid Nodes Gateway 아키텍처 결정 프레임워크를 다룹니다.
3+
description: EKS Hybrid Nodes의 개념·동작 원리·주요 기술 특징과 연결·토폴로지·Pod CIDR 노출·CNI·인증·워크로드 노출 6가지 설계 결정 가이드를 다룹니다.
44
created: "2026-08-25"
55
last_update:
66
date: "2026-08-25"
@@ -18,7 +18,7 @@ category: hybrid
1818

1919
import { DocCard, DocCardGrid } from '@site/src/components/DocCards';
2020

21-
EKS Hybrid Nodes가 무엇이고 어떻게 동작하는지, 그리고 하이브리드 설계의 핵심 결정인 "Pod 대역을 라우팅 가능하게 만들 것인가"를 어떤 기준으로 판단하는지를 다룹니다.
21+
EKS Hybrid Nodes가 무엇이고 어떻게 동작하는지, 그리고 하이브리드 아키텍처를 구성하는 6가지 설계 결정 — 연결 방식, 클러스터 토폴로지, Pod CIDR 노출, CNI·라우팅, 노드 인증, 워크로드 노출 — 을 어떤 기준과 순서로 판단하는지를 다룹니다.
2222

2323
---
2424

@@ -34,7 +34,7 @@ EKS Hybrid Nodes가 무엇이고 어떻게 동작하는지, 그리고 하이브
3434
to="/docs/eks-hybrid-nodes/overview-architecture/architecture-decision-guide"
3535
icon="🧭"
3636
title="아키텍처 결정 가이드"
37-
description="Routable Pod CIDR(BGP) vs CNI NAT vs Hybrid Nodes Gateway — 3가지 옵션의 의사결정 기준과 판정 플로우"
37+
description="연결(DX/VPN)·토폴로지(Mixed mode)·Pod CIDR 노출·CNI·노드 인증·워크로드 노출 — 6가지 설계 결정의 판단 기준과 의존 관계"
3838
color="#4a90d9"
3939
/>
4040
</DocCardGrid>

i18n/en/docusaurus-plugin-content-docs/current/eks-hybrid-nodes/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Amazon EKS Hybrid Nodes connects servers in on-premises and edge infrastructure
2929
to="/docs/eks-hybrid-nodes/overview-architecture"
3030
icon="🧭"
3131
title="Overview & Architecture"
32-
description="Hybrid Nodes concepts, how it works, key technical characteristics, and the Routable Pod CIDR vs Gateway architecture decision framework"
32+
description="Hybrid Nodes concepts, how it works, key technical characteristics, and a guide to the six design decisions — connectivity, topology, Pod CIDR exposure, and more"
3333
color="#667eea"
3434
/>
3535
<DocCard

i18n/en/docusaurus-plugin-content-docs/current/eks-hybrid-nodes/overview-architecture/architecture-decision-guide.md

Lines changed: 117 additions & 30 deletions
Large diffs are not rendered by default.

i18n/en/docusaurus-plugin-content-docs/current/eks-hybrid-nodes/overview-architecture/hybrid-nodes-fundamentals.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -295,7 +295,7 @@ EKS Hybrid Nodes connects an on-premises data plane to an AWS-managed control pl
295295
- [Deep dive into cluster networking for Amazon EKS Hybrid Nodes — AWS Containers Blog](https://aws.amazon.com/blogs/containers/deep-dive-into-cluster-networking-for-amazon-eks-hybrid-nodes/) — Detailed BGP and static routing configuration
296296

297297
### Related Documents (Internal)
298-
- [Architecture Decision Guide](./architecture-decision-guide.md) — Decision framework for Routable Pod CIDR vs Gateway
298+
- [Architecture Decision Guide](./architecture-decision-guide.md) — Decision criteria and dependencies for the six design decisions
299299
- [CIDR Design and Range Minimization](../networking/cidr-network-design.md) — VPC sizing, dedicated ENI subnets, multi-environment address planning
300300
- [Hybrid Nodes Gateway Deployment and Operations](../networking/hybrid-nodes-gateway.md) — Gateway mechanism, installation, and operations
301301
- [Firewall and DNS Pre-registration Guide](../networking/firewall-connectivity.md) — 5-zone firewall rules and TGW topology

i18n/en/docusaurus-plugin-content-docs/current/eks-hybrid-nodes/overview-architecture/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Overview & Architecture
3-
description: Covers EKS Hybrid Nodes concepts, how it works, key technical characteristics, and the Routable Pod CIDR vs Hybrid Nodes Gateway architecture decision framework.
3+
description: Covers EKS Hybrid Nodes concepts, how it works, key technical characteristics, and a guide to the six design decisions — connectivity, topology, Pod CIDR exposure, CNI, authentication, and workload exposure.
44
created: "2026-08-25"
55
last_update:
66
date: "2026-08-25"
@@ -18,7 +18,7 @@ category: hybrid
1818

1919
import { DocCard, DocCardGrid } from '@site/src/components/DocCards';
2020

21-
This section covers what EKS Hybrid Nodes is and how it works, along with the criteria for the core decision in hybrid design: whether to make the Pod address range routable.
21+
This section covers what EKS Hybrid Nodes is and how it works, along with the criteria and ordering for the six design decisions that make up a hybrid architecture — connectivity, cluster topology, Pod CIDR exposure, CNI and routing, node authentication, and workload exposure.
2222

2323
---
2424

@@ -34,7 +34,7 @@ This section covers what EKS Hybrid Nodes is and how it works, along with the cr
3434
to="/docs/eks-hybrid-nodes/overview-architecture/architecture-decision-guide"
3535
icon="🧭"
3636
title="Architecture Decision Guide"
37-
description="Routable Pod CIDR (BGP) vs CNI NAT vs Hybrid Nodes Gateway — decision criteria and a decision flow for the three options"
37+
description="Connectivity (DX/VPN), topology (mixed mode), Pod CIDR exposure, CNI, node authentication, workload exposure — decision criteria and dependencies for the six design decisions"
3838
color="#4a90d9"
3939
/>
4040
</DocCardGrid>

0 commit comments

Comments
 (0)