Halaman ini menjelaskan parameter untuk manifes Service yang mengontrol perilaku dan konfigurasi Service LoadBalancer. Sebelum membaca halaman ini, pastikan Anda sudah memahami konsep Service LoadBalancer Google Kubernetes Engine (GKE).
Parameter layanan
GKE mendukung parameter berikut untuk Layanan LoadBalancer.
| Parameter | Kolom dan deskripsi Layanan | Internal | Eksternal | Dukungan Versi |
|---|---|---|---|---|
| Load Balancer Jaringan passthrough internal |
Menginstruksikan GKE untuk membuat Load Balancer Jaringan passthrough internal. Load balancer menggunakan backend NEG
Dalam semua situasi lainnya, load balancer menggunakan backend grup instance. Untuk mengetahui informasi selengkapnya, lihat Pengelompokan node. |
Sebaiknya gunakan |
||
| Load Balancer Jaringan passthrough eksternal regional berbasis layanan backend |
Menginstruksikan GKE untuk membuat Load Balancer Jaringan passthrough eksternal regional. Load balancer menggunakan backend NEG
Dalam semua situasi lainnya, load balancer menggunakan backend grup instance. Untuk mengetahui informasi selengkapnya, lihat Pengelompokan node. |
Sebaiknya gunakan |
||
| Load Balancing Berbobot | networking.gke.io/weighted-load-balancing: "pods-per-node"
Memungkinkan node yang memiliki lebih banyak Pod penayangan untuk menerima proporsi koneksi baru yang lebih besar dibandingkan dengan node yang memiliki lebih sedikit Pod penayangan. |
GKE 1.31.0+ | ||
| Kebijakan Traffic Internal | spec.internalTrafficPolicy
Jika ditetapkan ke nilai Parameter ini tidak didukung di cluster yang menjalankan GKE Dataplane V2. |
GKE 1.22+ | ||
| Kebijakan Traffic Eksternal | spec.externalTrafficPolicy
Mengontrol VM node mana yang lulus health check load balancer dan bagaimana paket dirutekan ke Pod yang siap dan sedang melakukan penyajian di cluster. Selain itu,
mengontrol cara node dikelompokkan ke dalam NEG Untuk mengetahui detailnya, silakan melihat Konsep Service LoadBalancer. |
GKE 1.14+ (1.23.4-gke.400+ untuk node pool Windows). | ||
| Afinitas zona | spec.trafficDistribution: PreferSameZone
Mengaktifkan afinitas zona untuk Service LoadBalancer internal. Afinitas zona mengontrol zona tempat Load Balancer Jaringan passthrough internal merutekan traffic masuk untuk klien yang kompatibel saat pencocokan zona memungkinkan. Untuk menggunakan afinitas zona, Anda harus mengaktifkan subsetelan GKE (diaktifkan secara default dari GKE versi 1.36 dan yang lebih baru). Untuk mengetahui informasi selengkapnya, lihat Afinitas zona dan distribusi traffic. | Pratinjau di GKE 1.33.3-gke.1392000 dan yang lebih baru. Tersedia secara umum di GKE versi 1.36 dan yang lebih baru. | ||
| Port health check | spec.healthCheckNodePort
Men-deploy health check load balancer untuk Service LoadBalancer. Parameter
ini hanya valid jika |
Semua versi yang didukung. | ||
| Aturan firewall dan daftar alamat IP sumber yang diizinkan | spec.loadBalancerSourceRanges
Mengonfigurasi aturan firewall opsional di GKE dan di
jaringan VPC untuk hanya mengizinkan rentang sumber tertentu.
|
Semua versi yang didukung. | ||
| Alamat IP statis |
Menentukan alamat IPv4 statis, rentang alamat IPv6 statis, atau keduanya, yang ditetapkan ke aturan penerusan load balancer. Lihat Pertimbangan untuk berbagi alamat IP umum untuk mengetahui persyaratan konfigurasi dan detail implementasi yang penting. |
|
||
| Network Service Tiers | cloud.google.com/network-tier
Menentukan
Network Service Tiers
yang digunakan GKE untuk aturan penerusan eksternal dan alamat
IP. Nilai anotasi yang valid adalah |
GKE 1.19 dan yang lebih baru. | ||
| Subnet kustom | networking.gke.io/load-balancer-subnet |
(hanya berlaku untuk IPv6) |
GKE 1.29 dan yang lebih baru. Untuk persyaratan tambahan, lihat Anotasi subnet kustom. | |
| Bring your own IPv6 address (BYOIPv6) | networking.gke.io/ip-collection-v6: "projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME"
Menentukan sub-awalan IPv6 regional dari awalan yang didelegasikan publik (PDP) dalam mode Untuk Service LoadBalancer internal, konfigurasikan BYOIPv6 dengan menentukan subnet internal BYOIPv6 dengan anotasi |
(hanya berlaku untuk IPv6 stack tunggal) |
GKE versi 1.37.1-gke.2097000 dan yang lebih baru | |
| Akses global | networking.gke.io/internal-load-balancer-allow-global-access: "true"
Memungkinkan agar alamat IP aturan penerusan dapat diakses oleh klien di region jaringan VPC mana pun atau jaringan yang terhubung. |
Pratinjau di GKE 1.16+. Tersedia secara umum di GKE 1.17.9-gke.600+. | ||
| Semua port | GKE otomatis mengonfigurasi aturan penerusan untuk menggunakan semua port jika lebih dari lima (maksimal 100) port unik ditentukan di |
GKE versi 1.18.19-gke.1400 atau yang lebih baru | ||
| ipFamilyPolicy |
Menentukan cara GKE mengalokasikan alamat IP ke Service.
Anda dapat menentukan Untuk membuat Layanan LoadBalancer IPv6 stack tunggal di cluster stack ganda, tetapkan nilai kolom ini ke |
Cluster GKE pada versi 1.29 atau yang lebih baru mendukung jaringan stack ganda untuk Layanan LoadBalancer.
Layanan LoadBalancer IPv6 stack tunggal tersedia dalam Pratinjau di GKE versi 1.36.0-gke.2646000 dan yang lebih baru. |
||
| ipFamilies (Opsional) |
Menentukan kelompok alamat IP untuk mengalokasikan Layanan stack tunggal atau ganda. Gunakan salah satu nilai berikut:
Untuk Service LoadBalancer IPv6 stack tunggal di cluster stack ganda, tetapkan nilai kolom ini ke |
Cluster GKE pada versi 1.29 atau yang lebih baru mendukung jaringan stack ganda untuk Layanan LoadBalancer.
Pratinjau di GKE versi 1.36.0-gke.2646000 dan yang lebih baru untuk Layanan LoadBalancer IPv6 stack tunggal. |
Port health check
Seperti yang dijelaskan dalam Health check load balancer, GKE selalu men-deploy health check load balancer saat membuat Load Balancer Jaringan passthrough eksternal regional atau Load Balancer Jaringan passthrough internal.
Apakah Anda dapat menyiapkan parameter healthCheckNodePort atau tidak bergantung pada
konfigurasi externalTrafficPolicy berikut:
externalTrafficPolicy |
Port health check |
|---|---|
Cluster |
Anda tidak dapat menggunakan |
Local |
Anda dapat memilih port kustom menggunakan
|
Aturan firewall dan daftar alamat IP sumber yang diizinkan
Kecuali jika Anda telah mengonfigurasi cluster untuk melewati pembuatan aturan firewall VPC untuk Service LoadBalancer, GKE akan membuat aturan firewall VPC izinkan traffic masuk untuk setiap Service.
Setiap aturan firewall yang dibuat secara otomatis memiliki karakteristik berikut:
- Arah aturan firewall adalah masuk, dan tindakannya adalah mengizinkan. Aturan firewall tolak traffic masuk yang tersirat di Google Cloud berarti GKE menggunakan model daftar yang diizinkan saat membuat aturan firewall masuk.
- GKE menetapkan protokol dan port tujuan aturan firewall sesuai dengan yang tercantum dalam daftar
spec.ports[]Layanan. - GKE mengonfigurasi aturan firewall untuk Layanan LoadBalancer dengan menetapkan parameter tujuan secara eksplisit ke alamat IP virtual LoadBalancer (aturan penerusan load balancer).
- GKE menetapkan parameter target aturan firewall untuk menyertakan semua node cluster.
- Jika Service menyertakan
spec.loadBalancerSourceRanges[], GKE akan menetapkan parameter sumber aturan firewall ke alamat IP dalam daftar tersebut. Selain itu, GKE mengonfigurasi rute dan aturan dalam sistem operasi node untuk membatasi alamat IP sumber untuk traffic yang di-load balanced, menggunakankube-proxydaniptables(pada cluster yang tidak menggunakan GKE Dataplane V2) atau aturancilium-agentdan eBPF (pada cluster dengan GKE Dataplane V2). Jika Service tidak menyertakanloadBalancerSourceRanges[], GKE akan menetapkan parameter sumber aturan firewall ke semua alamat IP(0.0.0.0/0). - Untuk Service LoadBalancer IPv6, tentukan rentang CIDR IPv6 di kolom
spec.loadBalancerSourceRanges[](misalnya, rentang2001:db8::/32). GKE membuat aturan firewall terpisah untuk aturan penerusan IPv6 Service. Jika Service tidak menyertakan kolomloadBalancerSourceRanges[], GKE akan menetapkan parameter sumber aturan firewall tersebut ke semua alamat IPv6(::/0).
Alamat IP statis
Anda dapat membuat alamat IP statis dan mengonfigurasi GKE untuk menetapkan alamat statis tersebut ke aturan penerusan load balancer. Penggunaan alamat IP statis membantu memastikan bahwa alamat IP load balancer tetap sama meskipun Anda melakukan perubahan pada Layanan LoadBalancer.
Tanpa alamat IP statis, GKE mungkin menetapkan alamat IP yang berbeda ke aturan penerusan load balancer saat Anda mengupdate Service LoadBalancer. Alamat IP aturan penerusan tidak sama dengan alamat spec.clusterIP Service. Alamat ClusterIP untuk Service tidak pernah berubah saat Anda mengupdate Service LoadBalancer.
Parameter alamat IP statis
Untuk menginstruksikan Service LoadBalancer agar menggunakan alamat IP statis, gunakan parameter spec.loadBalancerIP atau anotasi networking.gke.io/load-balancer-ip-addresses. Di GKE
versi 1.29 dan yang lebih baru, anotasi lebih diutamakan daripada
spec.loadBalancerIP jika manifes Service berisi parameter dan
anotasi.
| Parameter atau anotasi dan nilai | Persyaratan dan kemampuan |
|---|---|
spec.loadBalancerIP:IPv4_ADDRESS
|
Anda dapat menentukan alamat IPv4 internal statis untuk Layanan LoadBalancer Internal khusus IPv4. Anda dapat menentukan alamat IPv4 eksternal statis untuk Service LoadBalancer Eksternal khusus IPv4. Parameter ini berfungsi dengan semua versi GKE yang didukung. |
networking.gke.io/load-balancer-ip-addresses:IP_ADDRESS_RESOURCE_NAME
|
Anda dapat menentukan alamat IPv4 statis, rentang alamat IPv6 statis, atau keduanya untuk Layanan LoadBalancer Internal dan Eksternal khusus IPv4, khusus IPv6, dan dual-stack. Anotasi ini memerlukan GKE 1.29 atau yang lebih baru dan persyaratan tambahan berikut:
|
Pertimbangan untuk berbagi alamat IP umum
Dua atau beberapa Service LoadBalancer dapat merujuk ke alamat IP statis yang sama jika aturan penerusan untuk setiap load balancer menggunakan kombinasi unik alamat IP, protokol, spesifikasi port, dan spesifikasi Network Service Tiers, seperti yang ditunjukkan dalam tabel di bagian ini. Selain itu:
Alamat IPv6 statis sebenarnya adalah rentang alamat IPv6
/96, tetapi GKE hanya mengonfigurasi node untuk menerima paket pada alamat IPv6 pertama (/128) dalam rentang/96.Agar dua atau beberapa Service LoadBalancer Internal dapat menggunakan alamat IPv4 internal yang sama, alamat IP statis harus dibuat dengan tujuan
SHARED_LOADBALANCER_VIP.
| Service LoadBalancer Internal | Service LoadBalancer Eksternal | |
|---|---|---|
| Spesifikasi port | Aturan penerusan untuk Load Balancer Jaringan passthrough internal mendukung hingga lima nomor port individual, atau dapat dikonfigurasi untuk menggunakan semua port. Jika Service LoadBalancer Internal memiliki lebih dari lima
Aturan penerusan dengan alamat IP dan protokol yang sama tidak boleh memiliki port yang tumpang-tindih. Artinya, Anda tidak dapat membuat beberapa Service LoadBalancer Internal yang menggunakan alamat IP, protokol, dan port yang sama. Contoh:
Untuk mengetahui informasi selengkapnya, lihat: aturan penerusan Load Balancer Jaringan passthrough internal yang menggunakan alamat IP umum. |
Untuk cluster yang menjalankan GKE versi sebelum 1.37, GKE akan membuat Load Balancer Jaringan passthrough eksternal regional berbasis kumpulan target jika
manifes Service LoadBalancer tidak memiliki kolom Aturan penerusan untuk Load Balancer Jaringan passthrough eksternal regional berbasis kumpulan target harus menggunakan rentang port berurutan. Rentang port yang berurutan mencakup semua port yang diperlukan Service, tetapi rentang tersebut mungkin juga mencakup port tambahan yang tidak digunakan oleh Service. Misalnya, Service LoadBalancer Eksternal yang didukung oleh Load Balancer Jaringan passthrough eksternal regional berbasis kumpulan target yang menentukan port 80 dan 443 dalam manifes Service-nya menggunakan aturan penerusan load balancer dengan rentang port 80-443. Rentang port ini mencegah Layanan LoadBalancer Eksternal lainnya menggunakan port 80, 443, dan nomor apa pun antara 80 dan 443. GKE membuat Load Balancer Jaringan passthrough eksternal regional berbasis layanan backend secara default di versi 1.37 atau yang lebih baru. Pada versi sebelumnya, GKE membuat load balancer jika
manifes Service LoadBalancer menyertakan
kolom |
| Network Service Tiers | Tidak dapat dikonfigurasi—alamat internal selalu merupakan Paket Premium. | Dapat dikonfigurasi untuk alamat IPv4 eksternal regional statis. Rentang alamat IPv6 eksternal regional statis hanya dapat dibuat di paket Premium. Spesifikasi Network Service Tiers dari alamat IP eksternal statis harus cocok dengan:
Paket default project adalah Premium, kecuali jika Anda telah mengonfigurasinya secara berbeda. |
Reservasi alamat IP
GKE tidak mencadangkan alamat IP statis yang dikonfigurasi menggunakan anotasi spec.loadBalancerIP atau networking.gke.io/load-balancer-ip-addresses.
Artinya, alamat IP yang Anda tetapkan ke Service dapat dirilis saat Service dihapus.
Agar alamat IP tetap direservasi, Anda harus membuat resource alamat secara manual di project Anda. Alamat IP statis harus memiliki atribut berikut:
- Hanya bersifat regional.
- Berada di region yang sama dengan cluster.
- Berada di Network Service Tiers yang sama dengan Layanan LoadBalancer.
- Memiliki nama yang tidak menggunakan nama LoadBalancer, awalan seperti
k8s-, atau UUID layanan.
Jika Anda tidak mencadangkan alamat sendiri, log project dapat berisi entri tentang resource alamat yang dibuat dan segera dihapus. Hal ini adalah bagian dari penyediaan layanan normal dan sudah diperkirakan.
Subnet LoadBalancer
Anda dapat mengonfigurasi Layanan LoadBalancer Internal untuk menggunakan alamat IPv4, rentang alamat IPv6, atau keduanya, yang bersifat sementara atau statis, di subnet kustom yang terletak di region dan jaringan VPC yang sama dengan cluster. Gunakan subnet kustom untuk Service LoadBalancer Internal guna:
- Kelompokkan Load Balancer Jaringan passthrough internal yang dibuat oleh Service LoadBalancer Internal dari dua atau beberapa cluster GKE di jaringan VPC dan region yang sama.
- Membuat Service LoadBalancer Internal yang Load Balancer Jaringan passthrough internalnya memiliki alamat IPv4 yang terpisah dari alamat IPv4 node cluster.
- Membuat Service LoadBalancer Internal yang Load Balancer Jaringan passthrough internalnya memiliki rentang alamat IPv6 yang terpisah dari alamat IPv6 node dan Pod cluster. Subnet LoadBalancer kustom wajib ada untuk mendukung Service LoadBalancer Internal jika subnet cluster memiliki rentang alamat IPv6 eksternal.
Anda dapat mengonfigurasi External LoadBalancer Service untuk menggunakan rentang alamat IPv6 sementara atau statis di subnet kustom yang terletak di region dan jaringan VPC yang sama dengan cluster. Gunakan subnet kustom untuk membuat Layanan LoadBalancer Eksternal yang Load Balancer Jaringan passthrough eksternal regionalnya memiliki rentang alamat IPv6 yang terpisah dari alamat IPv6 node dan Pod cluster. Subnet LoadBalancer kustom wajib ada untuk mendukung Service LoadBalancer Eksternal jika subnet cluster memiliki rentang alamat IPv6 internal.
Alamat IPv6 untuk Load Balancer Jaringan passthrough internal dan Load Balancer Jaringan passthrough eksternal regional biasanya berasal dari rentang subnet di jaringan VPC Anda. Untuk Service LoadBalancer eksternal IPv6 stack tunggal di GKE versi 1.37.1-gke.2097000 dan yang lebih baru, alamat IPv6 dapat berasal dari awalan yang didelegasikan publik BYOIPv6. Jika alamat berasal dari subnet, jenis akses IPv6 subnet tersebut harus cocok dengan jenis load balancer yang Anda buat: Service LoadBalancer internal memerlukan subnet dengan rentang alamat IPv6 internal (termasuk subnet yang disediakan dari awalan BYOIPv6), dan Service LoadBalancer eksternal memerlukan subnet dengan rentang alamat IPv6 eksternal. Untuk ringkasan kapan subnet LoadBalancer kustom diperlukan, lihat Service LoadBalancer IPv6.
Anotasi subnet kustom
Gunakan anotasi networking.gke.io/load-balancer-subnet:
SUBNET_RESOURCE_NAME untuk menginstruksikan Service LoadBalancer agar menggunakan alamat IP sementara atau statis di subnet kustom, dengan SUBNET_RESOURCE_NAME adalah nama subnet kustom.
Anda dapat menggunakan anotasi ini untuk menentukan subnet kustom untuk Layanan LoadBalancer Internal khusus IPv4, khusus IPv6, atau dual-stack, atau untuk Layanan LoadBalancer Eksternal khusus IPv6 atau dual-stack.
Untuk menggunakan anotasi networking.gke.io/load-balancer-subnet, Anda harus memenuhi
persyaratan berikut:
- Cluster Anda harus menjalankan GKE versi 1.29 atau yang lebih baru.
- Untuk menentukan subnet kustom untuk Service LoadBalancer Internal, cluster Anda harus mengaktifkan subsetelan GKE. Subsetelan GKE diaktifkan secara default di versi 1.36 dan yang lebih baru.
- Untuk menentukan subnet kustom untuk Layanan LoadBalancer Eksternal, Anda harus mengonfigurasi load balancer berbasis layanan backend. Di GKE
versi 1.37 dan yang lebih baru, konfigurasi ini adalah perilaku default. Pada
versi sebelumnya, Anda harus menyertakan kolom
spec.loadBalancerClassyang ditetapkan ke nilainetworking.gke.io/l4-regional-externaldalam manifes Service saat membuat Service LoadBalancer Eksternal. - Untuk cluster IPv6 stack tunggal (dibuat dengan flag
--stack-type=ipv6), Anda harus menggunakan anotasi ini jika jenis akses load balancer berbeda dengan jenis akses subnetwork node Anda. Misalnya, gunakan anotasi ini saat Anda men-deploy Service LoadBalancer Eksternal di cluster yang subnetwork node-nya menggunakan jenis akses IPv6INTERNAL(ULA), atau saat Anda men-deploy Service LoadBalancer Internal di cluster yang subnetwork node-nya menggunakan jenis akses IPv6EXTERNAL(GUA). Subnetwork yang ditentukan oleh anotasi ini harus memiliki jenis akses IPv6 (EXTERNALatauINTERNAL) yang cocok dengan jenis load balancer yang sesuai. Atau, Service LoadBalancer eksternal dapat mengambil rentang alamat IPv6-nya dari awalan yang didelegasikan secara publik BYOIPv6, bukan subnet; dalam hal ini, jangan gunakan anotasi ini.
Subnet dan alamat IPv4 untuk Service LoadBalancer Internal
Tabel berikut menjelaskan spesifikasi subnet dan kombinasi alamat IPv4 yang valid untuk Layanan LoadBalancer Internal khusus IPv4 atau dual-stack.
Alamat IPv4 statis
|
Alamat IPv4 sementara | |
|---|---|---|
Subnet kustom
|
Subnet kustom dan alamat IPv4 statis: Alamat IPv4 internal statis harus dibuat dalam rentang alamat IPv4 utama subnet kustom. | Subnet kustom dan alamat IPv4 sementara: GKE menggunakan alamat IPv4 internal yang tidak dialokasikan dalam rentang alamat IPv4 utama subnet kustom. |
| Subnet cluster | Subnet cluster dan alamat IPv4 statis: Alamat IPv4 internal statis harus dibuat dalam rentang alamat IPv4 utama subnet cluster. | Subnet cluster dan alamat IPv4 sementara: GKE menggunakan alamat IPv4 internal yang tidak dialokasikan dalam rentang alamat IPv4 utama subnet cluster. |
Subnet dan rentang alamat IPv6 untuk Service LoadBalancer Internal
Tabel berikut menjelaskan spesifikasi subnet dan kombinasi rentang alamat IPv6 yang valid untuk Layanan LoadBalancer Internal khusus IPv6 atau dual-stack. Meskipun aturan penerusan IPv6 Load Balancer Jaringan passthrough internal menggunakan rentang alamat IPv6 /96 internal, GKE hanya mengonfigurasi node untuk menerima paket yang tujuannya cocok dengan alamat IPv6 pertama (/128) dari rentang /96 aturan penerusan.
Rentang alamat IPv6 statis
|
Rentang alamat IPv6 efemeral | |
|---|---|---|
Subnet dual-stack atau khusus IPv6 kustom
|
Subnet kustom dan rentang alamat IPv6 statis: Rentang alamat IPv6 /96 internal statis harus telah dibuat dalam rentang alamat IPv6 /64 internal subnet kustom.
|
Subnet kustom dan rentang alamat IPv6 sementara:
GKE menggunakan rentang alamat IPv6 /96 internal yang belum dialokasikan
dari rentang alamat IPv6 /64 internal subnet kustom.
|
Subnet dual-stack atau khusus IPv6 cluster
|
Subnet cluster dan rentang alamat IPv6 statis: Rentang alamat IPv6 /96 internal statis harus telah dibuat dalam rentang alamat IPv6 /64 internal subnet cluster.
|
Subnet cluster dan rentang alamat IPv6 sementara:
GKE menggunakan rentang alamat IPv6 /96 internal yang belum dialokasikan dari rentang alamat IPv6 /64 internal subnet cluster.
|
Subnet dan alamat IPv4 untuk Service LoadBalancer Eksternal
Untuk Layanan LoadBalancer Eksternal khusus IPv4 dan dual-stack, alamat IPv4 eksternal—baik alamat IPv4 eksternal statis maupun alamat IPv4 eksternal sementara—tidak berasal dari subnet.
Subnet dan rentang alamat IPv6 untuk Service LoadBalancer Eksternal
Tabel berikut menjelaskan kombinasi subnet atau sub-awalan
dan rentang alamat IPv6 yang valid untuk Service LoadBalancer eksternal
stack tunggal IPv6 atau stack ganda. Meskipun aturan penerusan IPv6 Load Balancer Jaringan passthrough eksternal regional menggunakan rentang alamat IPv6 /96 eksternal, GKE hanya mengonfigurasi node untuk menerima paket yang tujuannya cocok dengan alamat IPv6 pertama (/128) dari rentang /96 aturan penerusan.
Rentang alamat IPv6 statis
|
Rentang alamat IPv6 efemeral | |
|---|---|---|
Subnet dual-stack atau khusus IPv6 kustom
|
Subnet kustom dan rentang alamat IPv6 statis: Rentang alamat IPv6 /96 eksternal statis harus telah dibuat di rentang alamat IPv6 /64 eksternal subnet kustom. Rentang alamat IPv6 eksternal statis hanya dapat dibuat di Paket Premium.
|
Subnet kustom dan rentang alamat IPv6 sementara:
GKE menggunakan rentang alamat IPv6 /96 eksternal yang belum dialokasikan
dari rentang alamat IPv6 /64 eksternal subnet kustom.
|
Subnet dual-stack atau khusus IPv6 cluster
|
Subnet cluster dan rentang alamat IPv6 statis: Rentang alamat IPv6 /96 eksternal statis harus telah dibuat dalam rentang alamat IPv6 /64 eksternal subnet cluster. Rentang alamat IPv6 eksternal statis hanya dapat dibuat di Paket Premium.
|
Subnet cluster dan rentang alamat IPv6 sementara:
GKE menggunakan rentang alamat IPv6 /96 eksternal yang belum dialokasikan
dari rentang alamat IPv6 /64 eksternal subnet cluster.
|
Awalan yang didelegasikan publik BYOIPv6
|
Awalan BYOIPv6 dan rentang alamat IPv6 statis: Anda harus mencadangkan rentang alamat IPv6 /96 eksternal statis dari sub-awalan regional menggunakan flag --endpoint-type=NETLB dan --ip-collection, serta mereferensikan alamat statis menggunakan anotasi networking.gke.io/load-balancer-ip-addresses. Secara opsional, Anda juga dapat menyertakan anotasi networking.gke.io/ip-collection-v6; jika Anda melakukannya, anotasi ini harus merujuk ke sub-awalan yang sama dengan alamat statis yang Anda reservasi.
|
Awalan BYOIPv6 dan rentang alamat IPv6 sementara: Tentukan sub-awalan regional menggunakan anotasi networking.gke.io/ip-collection-v6.
GKE mengalokasikan rentang alamat IPv6 /96 eksternal yang tersedia dari sub-awalan.
|
Akses global
Jika anotasi networking.gke.io/internal-load-balancer-allow-global-access
adalah false atau tidak ditentukan untuk Service LoadBalancer Internal,
GKE akan membuat Load Balancer Jaringan passthrough internal yang aturan penerusannya
menonaktifkan akses global. Jika akses global dinonaktifkan, klien yang perlu
mengakses load balancer harus berada di region dan
jaringan VPC yang sama, atau jaringan yang terhubung ke jaringan VPC
cluster.
Jika anotasi networking.gke.io/internal-load-balancer-allow-global-access
adalah true untuk Service LoadBalancer Internal, GKE
akan mengaktifkan opsi akses global pada aturan penerusan Load Balancer Jaringan passthrough internal.
Klien yang berada di region jaringan VPC mana pun atau jaringan yang terhubung ke jaringan VPC cluster dapat mengakses load balancer.
Untuk informasi selengkapnya tentang cara akses global diterapkan pada klien dalam jaringan yang terhubung, silakan melihat:
- Akses klien dalam dokumentasi Load Balancer Jaringan passthrough internal
- Load Balancer Jaringan passthrough internal dan jaringan yang terhubung
Aturan penerusan semua port
Aturan penerusan untuk Load Balancer Jaringan passthrough internal mendukung lima nomor port unik atau semua port.
Di GKE, Service LoadBalancer Internal hanya dapat mendukung hingga 100 port di
spec.ports[].port Service. Jika Service LoadBalancer Internal menentukan hingga lima port, aturan penerusan akan menyertakan port tertentu tersebut. Namun, jika Service menentukan lebih dari lima port, aturan penerusan akan otomatis dikonfigurasi untuk mencocokkan semua port. Saat mengonfigurasi aturan penerusan agar menggunakan semua port, GKE hanya membuat aturan firewall izinkan traffic masuk untuk port tertentu yang dikonfigurasi dalam spec.ports[].port pada Service.
Untuk mengetahui informasi selengkapnya tentang aturan penerusan Load Balancer Jaringan passthrough internal dan spesifikasi port yang valid, silakan melihat Aturan penerusan dan spesifikasi port.
Layanan LoadBalancer stack ganda IPv4/IPv6
Anda dapat membuat Layanan LoadBalancer Internal atau Eksternal yang dapat berupa stack tunggal (khusus IPv4 atau IPv6) atau stack ganda. Layanan LoadBalancer stack tunggal membuat satu aturan penerusan dengan alamat IPv4 atau alamat IPv6. Layanan LoadBalancer stack ganda membuat dua aturan penerusan: satu dengan alamat IPv4, dan satu lagi dengan alamat IPv6. Untuk membuat Layanan LoadBalancer stack ganda IPv4/IPv6, deploy Layanan di cluster stack ganda IPv4/IPv6 dan selesaikan salah satu tindakan berikut ini, bergantung pada jenis load balancer yang Anda gunakan:
- Untuk Service LoadBalancer Internal, Anda harus mengaktifkan subsetelan GKE. Subsetelan GKE diaktifkan secara default untuk cluster IPv6 stack tunggal dan stack ganda. Untuk mengetahui informasi selengkapnya, lihat mengaktifkan Subsetelan load balancer internal.
- Untuk Service LoadBalancer Eksternal, Anda harus menggunakan Load Balancer Jaringan passthrough eksternal regional berbasis layanan backend. Untuk mengetahui informasi selengkapnya, lihat Load Balancer Jaringan eksternal berbasis layanan backend.
Untuk setiap
Service, Anda dapat menentukan spesifikasi ipFamilyPolicy dan ipFamilies. Untuk mempelajari lebih lanjut,
silakan melihat Stack ganda IPv4/IPv6.
Batasan Layanan LoadBalancer stack ganda
- Service LoadBalancer dengan alamat IPv6 tidak didukung di cluster dengan jenis stack
ipv4. Untuk mengetahui informasi selengkapnya, lihat Menggunakan alamat IP stack ganda untuk cluster VPC native atau Mengonfigurasi cluster IPv6 stack tunggal. Layanan LoadBalancer yang dibuat dengan alamat stack tunggal tidak dapat diupgrade ke Layanan stack ganda.
Layanan LoadBalancer yang dibuat dengan alamat stack ganda dapat diubah menjadi stack tunggal sesuai dengan kondisi berikut:
- Layanan dengan ipFamilies
["IPv4","IPv6"]dapat diubah menjadi Layanan dengan ipFamiliesIPv4, tetapi tidakIPv6. - Layanan dengan ipFamilies
["IPv6","IPv4"]dapat diubah menjadi Layanan dengan ipFamiliesIPv6, tetapi tidakIPv4.
- Layanan dengan ipFamilies
Service LoadBalancer IPv6
Service LoadBalancer IPv6 adalah Service LoadBalancer yang aturan penerusannya memiliki alamat IPv6. Service dapat berupa IPv6 stack tunggal, atau stack ganda dengan aturan penerusan IPv4 dan IPv6. Untuk membuat Layanan LoadBalancer IPv6 stack tunggal di cluster stack ganda, tetapkan nilai kolom spec.ipFamilyPolicy ke SingleStack dan tetapkan nilai kolom spec.ipFamilies ke IPv6. Dalam cluster khusus IPv6, ini adalah nilai default dan Anda dapat menghilangkannya.
Layanan LoadBalancer IPv6 selalu menggunakan backend NEG GCE_VM_IP, dan alamat IPv6-nya berasal dari rentang subnet di jaringan VPC Anda atau dari bawa IPv6 Anda sendiri (BYOIPv6) awalan yang didelegasikan publik.
Layanan LoadBalancer IPv6 stack tunggal tersedia dalam Pratinjau di GKE versi 1.36.0-gke.2646000 dan yang lebih baru.
Batasan Service LoadBalancer IPv6
- Anda tidak dapat menggunakan kolom
spec.loadBalancerIPuntuk menentukan alamat IPv6. Gunakan anotasinetworking.gke.io/load-balancer-ip-addresses. - Layanan LoadBalancer IPv6 eksternal, termasuk rentang alamat IPv6 eksternal statis, hanya didukung di Paket Premium. GKE menolak
Service LoadBalancer IPv6 eksternal yang menetapkan
anotasi
cloud.google.com/network-tier: Standard. - Anda tidak dapat mengubah Layanan LoadBalancer IPv6 stack tunggal untuk menggunakan alamat IPv4. Menetapkan nilai kolom
spec.ipFamilieskeIPv4atau menetapkan nilai kolomspec.ipFamilyPolicykeRequireDualStackakan ditolak. - Anda hanya dapat menggunakan anotasi
networking.gke.io/ip-collection-v6pada Service LoadBalancer eksternal IPv6 single-stack di GKE versi 1.37.1-gke.2097000 dan yang lebih baru. GKE tidak mendukung anotasinetworking.gke.io/ip-collection-v6untuk Service dual-stack, Service IPv4, atau Service LoadBalancer internal, dan Anda tidak dapat menggabungkan anotasi ini dengan anotasinetworking.gke.io/load-balancer-subnet.
Memilih subnet untuk load balancer
Jenis akses IPv6 subnet yang menyediakan alamat IP load balancer harus cocok dengan jenis load balancer. Jika subnet cluster sudah memiliki jenis akses yang diperlukan, GKE akan menggunakan subnet cluster. Jika tidak, Anda harus membuat subnet LoadBalancer kustom dengan jenis akses yang diperlukan dan menentukan subnet ini dengan anotasi networking.gke.io/load-balancer-subnet. Satu-satunya pengecualian adalah Service LoadBalancer eksternal yang menggunakan
awalan yang didelegasikan publik BYOIPv6 karena awalan tersebut menyediakan
rentang alamat IPv6, terlepas dari jenis akses subnet cluster.
Tabel berikut merangkum subnet atau awalan yang menyediakan rentang alamat IPv6 load balancer:
| Jenis Service LoadBalancer | Jenis akses IPv6 subnet cluster | Sumber rentang alamat IPv6 load balancer |
|---|---|---|
| Internal | INTERNAL |
Subnet cluster. Tidak diperlukan anotasi. |
| Internal | EXTERNAL |
Subnet LoadBalancer kustom dengan jenis akses IPv6 INTERNAL, yang ditentukan dengan anotasi networking.gke.io/load-balancer-subnet. |
| Internal dengan BYOIPv6 | INTERNAL atau EXTERNAL |
Subnet yang rentang alamat IPv6 internalnya berasal dari awalan yang didelegasikan secara publik BYOIPv6 dalam mode INTERNAL_IPV6_SUBNETWORK_CREATION, yang ditentukan dengan anotasi networking.gke.io/load-balancer-subnet (tidak diperlukan anotasi jika subnet tersebut adalah subnet cluster). |
| Eksternal | EXTERNAL |
Subnet cluster. Tidak diperlukan anotasi. |
| Eksternal | INTERNAL |
Subnet LoadBalancer kustom dengan jenis akses IPv6 EXTERNAL, yang ditentukan dengan anotasi networking.gke.io/load-balancer-subnet. |
| Eksternal dengan BYOIPv6 (GKE 1.37.1-gke.2097000 dan yang lebih baru) |
INTERNAL atau EXTERNAL |
Awalan yang didelegasikan secara publik BYOIPv6 dalam mode EXTERNAL_IPV6_FORWARDING_RULE_CREATION, yang ditentukan dengan anotasi networking.gke.io/ip-collection-v6 atau dengan alamat IPv6 statis yang direservasi dari awalan. Jangan tentukan anotasi networking.gke.io/load-balancer-subnet. |
Untuk kombinasi subnet dan rentang alamat IPv6 yang valid, lihat Subnet dan rentang alamat IPv6 untuk Service LoadBalancer Internal dan Subnet dan rentang alamat IPv6 untuk Service LoadBalancer Eksternal.
Bring your own IPv6 address (BYOIPv6)
Anda dapat menggunakan bring your own IPv6 addresses (BYOIPv6) dengan Service LoadBalancer IPv6 internal dan eksternal.
Untuk Service LoadBalancer eksternal, yang mengalokasikan alamat langsung dari
awalan yang didelegasikan secara publik,
agen layanan GKE
(service-PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com)
memerlukan izin Identity and Access Management (IAM) tertentu. Berikan peran Compute Public IP Admin (roles/compute.publicIpAdmin) kepada agen ini di project yang memiliki awalan yang didelegasikan secara publik. Peran ini mencakup
izin compute.publicDelegatedPrefixes.use.
GKE memerlukan izin ini selama pembuatan Service awal dan setiap kali menyinkronkan Service.
Service LoadBalancer eksternal (GKE versi 1.37.1-gke.2097000 dan yang lebih baru):
Service LoadBalancer eksternal IPv6 stack tunggal
(spec.ipFamilyPolicy: SingleStack dan spec.ipFamilies: ["IPv6"]) mengalokasikan
rentang alamat BYOIPv6 /96 eksternal langsung dari sub-prefix IPv6 regional
dari awalan yang didelegasikan publik (PDP). GKE mendukung fitur ini di cluster IPv6 stack tunggal dan cluster stack ganda, asalkan Service-nya adalah IPv6 stack tunggal. Subnet cluster dapat memiliki jenis akses IPv6 internal atau eksternal, karena rentang alamat berasal dari sub-awalan, bukan subnet.
Sub-awalan IPv6 regional harus memenuhi persyaratan berikut:
- Dikonfigurasi dengan mode
EXTERNAL_IPV6_FORWARDING_RULE_CREATION - Dikonfigurasi dengan panjang awalan yang dapat dialokasikan sebesar
/96 - Dalam status
ANNOUNCED
Untuk mengalokasikan rentang alamat BYOIPv6 eksternal sementara, tentukan sub-awalan
dalam anotasi networking.gke.io/ip-collection-v6 (disediakan sebagai URL resource lengkap atau jalur resource parsial
projects/PROJECT_ID/regions/REGION/publicDelegatedPrefixes/SUB_PREFIX_NAME).
Atau, untuk menggunakan rentang alamat BYOIPv6 eksternal statis yang Anda cadangkan
dari sub-awalan, gunakan anotasi
networking.gke.io/load-balancer-ip-addresses.
Jika Anda mengubah anotasi networking.gke.io/ip-collection-v6, GKE akan membuat ulang aturan penerusan IPv6 dengan alamat baru dari awalan baru, yang akan mengganggu traffic untuk sementara. Jika Anda menghapus anotasi,
Service akan kembali ke alamat yang disediakan Google dari subnet dengan rentang alamat IPv6 eksternal. Jika subnet cluster Anda menggunakan rentang alamat IPv6 internal,
untuk menghindari error, Anda harus menambahkan anotasi
networking.gke.io/load-balancer-subnet secara bersamaan. Untuk mengetahui informasi selengkapnya, lihat
Menggunakan bawa alamat IPv6 Anda sendiri (BYOIPv6) untuk Layanan LoadBalancer
eksternal.
Service LoadBalancer internal: Service LoadBalancer internal IPv6 menggunakan alamat BYOIPv6 dari subnet IPv6 internal. Anda membuat subnet ini dari sub-awalan IPv6 regional dari awalan yang didelegasikan secara publik (PDP) yang dikonfigurasi dalam mode INTERNAL_IPV6_SUBNETWORK_CREATION. Untuk mengetahui informasi selengkapnya, lihat
Membuat dan menggunakan sub-awalan IPv6.
Untuk mengonfigurasi Service, tentukan subnet BYOIPv6 menggunakan anotasi networking.gke.io/load-balancer-subnet, atau gunakan subnet tersebut sebagai subnet default cluster. Secara opsional, tentukan alamat BYOIPv6 internal statis yang dicadangkan menggunakan anotasi networking.gke.io/load-balancer-ip-addresses.
Service LoadBalancer internal tidak mendukung anotasi networking.gke.io/ip-collection-v6. Jika Anda menerapkan anotasi ini, GKE akan mengabaikannya dan memunculkan peristiwa peringatan IPCollectionV6Error.
Untuk mengetahui informasi selengkapnya, lihat Menggunakan bawa alamat IPv6 Anda sendiri (BYOIPv6) untuk Service LoadBalancer internal.
Langkah berikutnya
- Pelajari Service LoadBalancer.
- Pelajari cara menyiapkan load balancer internal.
- Baca ringkasan Ingress untuk Load Balancer Aplikasi.
- Pelajari cara menggunakan NEG mandiri.
- Pelajari lebih lanjut aturan firewall VPC.