Skip to main content

인그레스

인그레스(Ingress)는 클러스터 외부에서 내부 서비스로의 HTTP/HTTPS 트래픽 라우팅 규칙을 정의하는 리소스입니다. 호스트 기반 또는 경로 기반 라우팅을 통해 여러 서비스를 단일 진입점으로 노출할 수 있습니다.

인그레스 목록​

사이드바에서 네트워크 > 인그레스를 선택하면 인그레스 목록이 표시됩니다. 목록에서는 다음 정보를 확인할 수 있습니다.

  • 이름: 인그레스 리소스의 이름
  • 네임스페이스: 소속 네임스페이스
  • 클래스: 사용 중인 인그레스 클래스
  • 호스트: 매핑된 호스트네임 목록
  • 주소: 인그레스 컨트롤러가 할당한 IP 또는 호스트네임
  • 생성 시간: 리소스가 생성된 시각

인그레스 상세​

인그레스 상세 화면에서는 라우팅 규칙의 전체 구성을 확인할 수 있습니다.

규칙 (Rules)​

인그레스의 핵심은 라우팅 규칙입니다. 각 규칙은 호스트와 경로의 조합으로 구성됩니다.

  • 호스트(Host): 요청의 호스트 헤더와 매칭됩니다. 예를 들어 app.example.com으로 설정하면 해당 도메인으로 들어오는 요청만 이 규칙에 적용됩니다.
  • 경로(Path): URL 경로 패턴과 매칭됩니다. 예를 들어 /api로 설정하면 /api로 시작하는 요청을 지정된 서비스로 전달합니다.
  • 경로 타입(Path Type): Prefix, Exact, ImplementationSpecific 중 하나를 선택합니다.
  • 백엔드(Backend): 매칭된 요청을 전달할 서비스 이름과 포트 번호입니다.

호스트/경로 매핑​

콘솔에서는 인그레스 규칙을 테이블 형태로 표시하여 호스트와 경로가 어떤 서비스로 매핑되는지 한눈에 파악할 수 있습니다. TLS가 설정된 경우 관련 시크릿 이름과 적용 호스트 목록도 함께 표시됩니다.

기본 백엔드 (Default Backend)​

어떤 규칙에도 매칭되지 않는 요청을 처리할 기본 백엔드 서비스를 설정할 수 있습니다. 설정된 경우 상세 화면에 표시됩니다.

인그레스 생성 및 편집​

인그레스를 생성하거나 편집할 때는 호스트, 경로, 백엔드 서비스를 정의해야 합니다. YAML 편집기를 통해 세밀한 설정이 가능하며, 폼 편집기를 통해 직관적으로 규칙을 추가할 수 있습니다.