본문으로 건너뛰기

Gateway URL Configuration

개요​

Gateway 인스턴스를 생성한 후, 외부에 노출하기 위해 하나 이상의 Gateway URL을 등록해야 합니다. 여기에는 기본 도메인, TLS 인증서, 인그레스 설정 및 선택적 메타데이터(레이블, 주석)를 정의하는 것이 포함됩니다. 이 튜토리얼에서는 모의 데이터를 사용하여 간단한 방법과 고급 주석 방법 모두를 사용하여 완전한 Gateway URL을 구성하는 방법을 보여줍니다.

전제 조건​

  • Gateway 이(가) 이미 생성되었습니다 (예: gateway-test-01)
  • TLS 인증서 및 개인 키 파일에 대한 접근 권한이 있습니다.
  • 기본 도메인이 DNS에 매핑되어 있습니다 (예: api.sksample.co.kr)
  • 관리자로 로그인되어 있습니다.

단계별 튜토리얼​

단계 1. Gateway URL 구성 열기​

  • Gateway 관리 화면으로 이동합니다.
  • 대상 게이트웨이(예: gateway-test-01)를 선택하여 Gateway 편집 화면에 접근합니다.
  • Gateway URL 섹션으로 스크롤하여 새 Gateway URL을 추가하기 위해 추가 버튼을 클릭합니다.

단계 2. Gateway URL 및 기본 경로 입력​

Field Example
Gateway URLapi.sksample.co.kr
Global BasePath/gateway-test-01

전체 API URL은 https://api.sksample.co.kr/gateway-test-01이 됩니다.

단계 3. HTTPS 활성화 및 인증서 업로드​

  • HTTPS Only을(를) ON으로 전환합니다.
  • TLS Certificate (tls.crt)을(를) 붙여넣습니다. 예:
----BEGIN CERTIFICATE-----
MIIFzjCCBbegAwIBAgISBKKPTR3WPWUG2AcFUD4Dn45iMA0GCSqGSIb3DQEBCwUA
...
-----END CERTIFICATE-----
  • TLS Private Key (tls.key)을(를) 붙여넣습니다. 예:
----BEGIN PRIVATE KEY-----
MIIEv...
...
-----END PRIVATE KEY-----

인증서는 유효해야 하며 지정된 도메인 이름과 일치해야 합니다.

단계 4. 인그레스 클래스 설정​

게이트웨이에서 사용할 인그레스 클래스를 선택합니다:

Field Value
Ingress Classnginx

단계 5. 레이블 정의 (선택 사항)​

식별 또는 자동화를 위해 메타데이터 레이블을 추가할 수 있습니다:

키값
envproduction
regionkr-central

더 추가하려면 더하기 아이콘을 클릭합니다. 추가된 레이블을 제거하려면 X 아이콘을 클릭합니다.

단계 6. 주석 추가​

주석을 입력하는 두 가지 방법이 있습니다:

방법 1: 키-값 입력 (JSON 토글 OFF)

키값
nginx.ingress.kubernetes.io/ssl-redirecttrue
nginx.ingress.kubernetes.io/backend-protocolHTTPS

명확성과 개별 편집을 위해 이 모드를 사용합니다.

방법 2: JSON 모드 (JSON 토글 ON)

JSON 토글을 클릭하고 다음 구조를 입력합니다:

{
"nginx.ingress.kubernetes.io/ssl-redirect": "true",
"nginx.ingress.kubernetes.io/backend-protocol": "HTTPS"
}

이 모드는 대량의 주석 세트를 한 번에 가져올 때 유용합니다.

단계 7. 구성 저장​

GATEWAY URL 저장 버튼을 클릭합니다. 확인을 기다리고 URL이 목록에 나타나는지 확인합니다.

팁 및 모범 사례​

  • HTTPS만 사용하여 보안 트래픽을 강제합니다.
  • 인증서 도메인이 Gateway URL과 정확히 일치하도록 합니다.
  • 주석은 중요한 인그레스 동작을 제어합니다 - 전체 옵션에 대한 Kubernetes 인그레스 컨트롤러 문서를 검토하십시오.
  • 레이블을 사용하여 향후 자동화를 가능하게 합니다 (예: CI/CD 라우팅, 모니터링 필터)