한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
개발·오픈소스 · 판정 관망
그림을 글로 풀면
입구와 앱의 포트를 연결하기
Service의 port와 targetPort를 앱의 실제 수신 포트와 대조하세요.
- 대상
- Kubernetes로 AI 앱을 연결하는 개발자
- 무엇이 바뀜
- 접속 포트와 대상 포트는 달라도 됩니다.
- 왜 중요한가
- targetPort를 생략하면 port 값이 사용됩니다.
- 지금 할 일
- 클라이언트·Service·앱의 연결을 따라 확인하세요.
- 한계·미확인
- 가상 예시. 실제 클러스터 접속·성능 시험 없음.
- 공식 출처
- kubernetes.io
- 확인일
- 2026-10-27
접수문 번호와 작업실 번호가 달라도 됩니다
가상의 내부 AI 앱이 8080에서 요청을 받고 클라이언트는 Service의 80으로 접속한다고 생각해 봅니다. 그림의 두 번호는 서로 다른 역할을 표시합니다. AINOW는 오류 조사 때 번호가 모두 같아야 한다고 바꾸기보다, 클라이언트가 부르는 Service 포트와 그 요청을 전달할 대상 포트를 먼저 나란히 적도록 제안합니다.
생략한 대상 포트의 기본값도 점검하기
Kubernetes 공식 문서에서 port는 Service가 받는 포트이고 targetPort는 전달할 대상 포트입니다. 두 값을 다르게 연결할 수 있으며 targetPort를 생략하면 port와 같은 값이 사용됩니다. 예를 들어 위 가상 구성에서 대상 앱은 8080을 쓰는데 port만 80으로 두었다면, 앱의 실제 설정과 대상 포트가 맞는지 확인해야 합니다. 이 번호들은 공식 예제를 복제한 실측값이 아닙니다.
이름으로 연결했을 때도 실제 수신 상태 확인하기
targetPort에는 Pod에서 이름을 붙인 포트를 참조할 수도 있습니다. AINOW는 참조 이름과 숫자 해석, 대상 EndpointSlice와 준비 상태, 앱이 실제로 듣는 포트를 함께 대조하도록 제안합니다. 포트 설정만 맞았다고 모든 통신 문제가 해결됐다고 판단하지 않습니다. 이전 글의 레이블 선택 설명에서 더 나아가 포트 연결과 생략 기본값을 다뤘으며, 이번에는 Service 생성이나 통신 시험을 실행하지 않았습니다.
참고 원문: Kubernetes 공식 Service 문서 — 포트 정의 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-27
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- 2026-10-27 Kubernetes 상시 문서의 port·targetPort·이름 참조 확인. 클러스터 연결 시험 없음
- 확인일
- 2026-10-27
- 검증 상태
- 개발자 주장
- 한계·주의
- 가상 예시. 실제 클러스터 접속·성능 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.