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 URL | api.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 |
|---|---|
| 인그레스 클래스 | nginx |
단계 5. 레이블 정의 (선택 사항)
식별 또는 자동화를 위해 메타데이터 레이블을 추가할 수 있습니다:
| 키 | 값 |
|---|---|
| env | production |
| region | kr-central |
더 추가하려면 더하기 아이콘을 클릭합니다. 추가된 레이블을 제거하려면 빼기 아이콘을 클릭합니다.
단계 6. 주석 추가
주석을 입력하는 두 가지 방법이 있습니다:
- 키-값 입력 (JSON 토글 OFF) | 키 | 값 | | --- | --- | | nginx.ingress.kubernetes.io/ssl-redirect | true | | nginx.ingress.kubernetes.io/backend-protocol | HTTPS |
명확성과 개별 편집을 위해 이 모드를 사용합니다.
- JSON 모드 (JSON 토글 ON)
JSON 토글을 클릭하고 다음 구조를 입력합니다:
{
"[nginx.ingress.kubernetes.io/ssl-redirect](http://nginx.ingress.kubernetes.io/ssl-redirect)": "true",
"[nginx.ingress.kubernetes.io/backend-protocol](http://nginx.ingress.kubernetes.io/backend-protocol)": "HTTPS"
}
이 모드는 대량의 주석 세트를 한 번에 가져올 때 유용합니다.
7단계. 구성 저장하기
GATEWAY URL 저장 버튼을 클릭하세요.
확인을 기다리고 URL이 목록에 나타나는지 확인하세요.
팁 및 모범 사례
- HTTPS만 사용하여 보안 트래픽을 강제하세요.
- 인증서 도메인을 Gateway URL과 정확히 일치시켜야 합니다.
- 주석은 중요한 인그레스 동작을 제어합니다. 전체 옵션에 대한 Kubernetes 인그레스 컨트롤러 문서를 검토하세요.
- 레이블을 사용하여 향후 자동화를 가능하게 하세요 (예: CI/CD 라우팅, 모니터링 필터).