Gateway URL Configuration
Tổng Quan
Sau khi tạo một phiên bản Gateway, bạn phải đăng ký một hoặc nhiều URL Gateway để công khai nó ra thế giới bên ngoài. Điều này bao gồm việc xác định miền cơ sở, chứng chỉ TLS, cài đặt ingress và siêu dữ liệu tùy chọn (nhãn, chú thích). Hướng dẫn này sẽ trình bày cách cấu hình một URL Gateway hoàn chỉnh với cả phương pháp chú thích đơn giản và nâng cao bằng cách sử dụng dữ liệu giả.
Điều Kiện Tiên Quyết
- Một Gateway đã được tạo (ví dụ: gateway-test-01)
- Bạn có quyền truy cập vào các tệp chứng chỉ TLS và khóa riêng
- Miền cơ sở đã được ánh xạ trong DNS (ví dụ: api.sksample.co.kr)
- Bạn đã đăng nhập với tư cách là quản trị viên
Hướng Dẫn Từng Bước
Bước 1. Mở Cấu Hình URL Gateway
- Đi đến màn hình Quản lý Gateway
- Chọn gateway mục tiêu (ví dụ: gateway-test-01) để truy cập màn hình Chỉnh sửa Gateway
- Cuộn xuống phần URL Gateway và nhấp vào nút Thêm để thêm một URL Gateway mới
Bước 2. Nhập URL Gateway & Đường Dẫn Cơ Bản
| Field | Example |
|---|---|
| URL Gateway | api.sksample.co.kr |
| Đường Dẫn Cơ Bản Toàn Cầu | /gateway-test-01 |
URL API đầy đủ sẽ trở thành https://api.sksample.co.kr/gateway-test-01
Bước 3. Bật HTTPS và Tải Lên Chứng Chỉ
- Chuyển HTTPS Only sang BẬT
- Dán TLS Certificate (tls.crt) của bạn. Ví dụ:
----BEGIN CERTIFICATE-----
MIIFzjCCBbegAwIBAgISBKKPTR3WPWUG2AcFUD4Dn45iMA0GCSqGSIb3DQEBCwUA
...
-----END CERTIFICATE-----
- Dán TLS Private Key (tls.key) của bạn. Ví dụ:
----BEGIN PRIVATE KEY-----
MIIEv...
...
-----END PRIVATE KEY-----
Chứng chỉ phải hợp lệ và khớp với tên miền đã chỉ định.
Bước 4. Đặt Lớp Ingress
Chọn lớp ingress sẽ được sử dụng bởi gateway:
| Field | Value |
|---|---|
| Lớp Ingress | nginx |
Bước 5. Định Nghĩa Nhãn (Tùy Chọn)
Bạn có thể thêm nhãn siêu dữ liệu để nhận diện hoặc tự động hóa:
| Khóa | Giá trị |
|---|---|
| env | production |
| region | kr-central |
Để thêm nhiều hơn, nhấp vào biểu tượng cộng. Nhấp vào biểu tượng dấu chéo để xóa nhãn đã thêm.
Bước 6. Thêm Chú Thích
Có hai phương pháp để nhập chú thích:
- Nhập Khóa-Giá Trị (Tắt JSON) | Khóa | Giá trị | | --- | --- | | nginx.ingress.kubernetes.io/ssl-redirect | true | | nginx.ingress.kubernetes.io/backend-protocol | HTTPS |
Sử dụng chế độ này để rõ ràng và chỉnh sửa riêng lẻ.
- Chế Độ JSON (Bật JSON)
Nhấp vào chuyển đổi JSON và nhập cấu trúc sau:
{
"[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"
}
Chế độ này hữu ích khi nhập một tập hợp chú thích lớn cùng một lúc.
Bước 7. Lưu cấu hình
Nhấn nút Lưu URL GATEWAY. Chờ xác nhận và đảm bảo URL xuất hiện trong danh sách.
Mẹo & Thực hành tốt nhất
- Chỉ sử dụng HTTPS để đảm bảo lưu lượng truy cập an toàn
- Khớp chính xác các miền chứng chỉ với URL Gateway
- Chú thích kiểm soát các hành vi truy cập quan trọng—xem tài liệu của bộ điều khiển truy cập Kubernetes của bạn để biết đầy đủ tùy chọn
- Sử dụng nhãn để kích hoạt tự động hóa trong tương lai (ví dụ: định tuyến CI/CD, bộ lọc giám sát)