Kubernetes Service에 접속할 포트와 AI 앱이 듣는 포트를 나누어 확인하기

한 장의 그림으로 이해하기

가상 작업장의 접수문과 안쪽 작업실을 그린 개념 비유입니다. 입구 80은 클라이언트가 접속하는 Service 포트, 앱 8080은 대상 앱의 포트입니다. 내부 수레와 화살표는 두 포트의 연결을 뜻하며, 오른쪽 지도 확인은 연결 설정을 실제 앱 수신 포트와 대조하는 행동입니다. 번호는 가상 예시이며 외부 공개 포트 설정 지시가 아닙니다. Service가 요청 본문의 택배 표식을 검사한다는 뜻이 아니고, 화살표가 준비 상태·네트워크 정책·접속 성공까지 보장하지 않습니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

개발·오픈소스 · 판정 관망

그림을 글로 풀면

입구와 앱의 포트를 연결하기

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
검증 상태
개발자 주장
한계·주의
가상 예시. 실제 클러스터 접속·성능 시험 없음.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.