Mengekspos gateway masuk menggunakan load balancer eksternal
Ringkasan
Dengan Anthos Service Mesh, Anda dapat men-deploy dan mengelola gateway ingress sebagai bagian dari mesh layanan Anda. Anda dapat mengonfigurasi load balancing untuk cluster lebih lanjut dengan Anthos Service Mesh menggunakan load balancer eksternal (load balancer fisik atau software di luar cluster) untuk mengirim traffic ke gateway ingress.
Halaman ini menunjukkan cara mengonfigurasi load balancer eksternal dengan Anthos Service Mesh. Atau, Anda dapat menyiapkan ingress dengan beberapa konfigurasi backend.
Sebelum memulai
Untuk menyelesaikan langkah-langkah dalam dokumen ini, Anda memerlukan referensi berikut:
Cluster Kubernetes dengan Anthos Service Mesh terinstal.
Load balancer eksternal yang dapat mengakses node tempat cluster Anda berjalan. Anda akan mengonfigurasi load balancer eksternal ini untuk menghadap gateway masuk cluster Anda melalui
External IP Address
.
Menyiapkan lingkungan Anda
Jalankan perintah berikut dari workstation yang dapat mengakses cluster yang ingin Anda
gunakan. Pastikan alat kubectl
dikonfigurasi untuk menggunakan
konteks cluster khusus untuk cluster Anda.
Menetapkan variabel lingkungan.
export ASM_INGRESSGATEWAY_NAMESPACE=asm-ingressgateway export ASM_INGRESSGATEWAY_DEPLOYMENT_NAME=asm-ingressgateway export ASM_INGRESSGATEWAY_SERVICE_NAME=asm-ingressgateway export ASM_INGRESSGATEWAY_NODE_LABEL=asm-ingressgateway
Tetapkan
IP address
load balancer eksternal.export EXTERNAL_LB_IP_ADDRESS=EXTERNAL_LB_IP_ADDRESS
[Opsional] Memberi label pada node gateway masuk. Hal ini memastikan bahwa gateway di-deploy ke node tertentu dalam cluster.
kubectl label nodes INGRESSGATEWAY_NODE_IP ${ASM_INGRESSGATEWAY_NODE_LABEL}=
- INGRESSGATEWAY_NODE_IP: adalah node di cluster Kubernetes Anda yang menghosting gateway masuk. Jalankan perintah
kubectl
ini untuk sebanyak node masuk yang Anda miliki.
- INGRESSGATEWAY_NODE_IP: adalah node di cluster Kubernetes Anda yang menghosting gateway masuk. Jalankan perintah
Membuat gateway masuk
Buat namespace. Namespace ini akan digunakan untuk men-deploy gateway masuk.
kubectl create namespace ${ASM_INGRESSGATEWAY_NAMESPACE}
Aktifkan namespace untuk injeksi. Langkah-langkahnya bergantung pada jenis Anthos Service Mesh Anda (baik terkelola atau dalam cluster).
Terkelola
Gunakan perintah berikut untuk menemukan saluran rilis yang tersedia:
kubectl -n istio-system get controlplanerevision
Outputnya mirip dengan hal berikut ini:
NAME AGE asm-managed 6d7h asm-managed-rapid 6d7h
Dalam output, nilai pada kolom
NAME
adalah label revisi yang sesuai dengan saluran rilis yang tersedia untuk versi Anthos Service Mesh.Terapkan label revisi ke namespace:
kubectl label namespace ${ASM_INGRESSGATEWAY_NAMESPACE} \ istio-injection- istio.io/rev=REVISION_LABEL --overwrite
Dalam cluster
Gunakan perintah berikut untuk menemukan label revisi di
istiod
:kubectl get deploy -n istio-system -l app=istiod -o \ jsonpath={.items[*].metadata.labels.'istio\.io\/rev'}'{"\n"}'
Terapkan label revisi ke namespace. Dalam perintah berikut,
REVISION
adalah nilai label revisiistiod
yang Anda catat di langkah sebelumnya.kubectl label namespace ${ASM_INGRESSGATEWAY_NAMESPACE} \ istio-injection- istio.io/rev=REVISION --overwrite
Terapkan file manifes gateway masuk.
kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} apply --filename https://raw.githubusercontent.com/GoogleCloudPlatform/anthos-service-mesh-samples/main/docs/ingress-gateway-external-lb/ingress-gateway.yaml
Output yang diharapkan:
serviceaccount/asm-ingressgateway created role.rbac.authorization.k8s.io/asm-ingressgateway created rolebinding.rbac.authorization.k8s.io/asm-ingressgateway created deployment.apps/asm-ingressgateway created service/asm-ingressgateway created poddisruptionbudget.policy/asm-ingressgateway created horizontalpodautoscaler.autoscaling/asm-ingressgateway created
Lakukan patch pada layanan
ingressgateway
dengan alamat IP load balancer eksternal.cat <<EOF > asm-external-ip-patch.yaml spec: externalIPs: - ${EXTERNAL_LB_IP_ADDRESS} loadBalancerIP: ${EXTERNAL_LB_IP_ADDRESS} EOF kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} patch service/${ASM_INGRESSGATEWAY_SERVICE_NAME} --patch "$(cat asm-external-ip-patch.yaml)"
[Opsional] Terapkan patch pada deployment
ingressgateway
untuk afinitas label node gateway masuk.cat <<EOF > asm-ingress-node-label-patch.yaml spec: template: spec: affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: ${ASM_INGRESSGATEWAY_NODE_LABEL} operator: Exists EOF kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} patch deployment/${ASM_INGRESSGATEWAY_DEPLOYMENT_NAME} --patch "$(cat asm-ingress-node-label-patch.yaml)"
Menyiapkan load balancer eksternal
Di bagian ini, Anda akan mengonfigurasi load balancer eksternal untuk terhubung dengan gateway masuk dari cluster.
Mengambil informasi port Service
gateway masuk
Dapatkan
NodePorts
.export HTTP_INGRESS_PORT=$(kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} get service/${ASM_INGRESSGATEWAY_SERVICE_NAME} --output jsonpath='{.spec.ports[?(@.name=="http2")].nodePort}') export HTTPS_INGRESS_PORT=$(kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} get service/${ASM_INGRESSGATEWAY_SERVICE_NAME} --output jsonpath='{.spec.ports[?(@.name=="https")].nodePort}') export STATUS_PORT=$(kubectl --namespace ${ASM_INGRESSGATEWAY_NAMESPACE} get service/${ASM_INGRESSGATEWAY_SERVICE_NAME} --output jsonpath='{.spec.ports[?(@.name=="status-port")].nodePort}')
Menampilkan
NodePorts
.echo HTTP_INGRESS_PORT=${HTTP_INGRESS_PORT} echo HTTPS_INGRESS_PORT=${HTTPS_INGRESS_PORT} echo STATUS_PORT=${STATUS_PORT}
Mengonfigurasi load balancer eksternal
Gunakan NodePorts
yang ditampilkan di langkah sebelumnya untuk mengonfigurasi konektivitas
antara load balancer eksternal dan gateway masuk.
Mengonfigurasi health check di konfigurasi load balancer Anda.
hosts: CLUSTER_NODE_IP Protocol: HTTP Port: STATUS_PORT Path: /healthz/ready
CLUSTER_NODE_IP: adalah alamat IP node di cluster Kubernetes yang menghosting gateway masuk. Alamat IP ini harus dapat dijangkau dari load balancer eksternal Anda. Anda mungkin harus menyiapkan konfigurasi ini beberapa kali, sekali per node cluster.
STATUS_PORT: adalah
NodePort
yang digunakan untuk menampilkan API status kesehatan gateway masuk. Anda dapat menyalin informasi ini dari langkah sebelumnya. Nilainya akan sama untuk setiap node di cluster.
Konfigurasikan kumpulan node di load balancer untuk merutekan traffic
HTTP
danHTTPS
. Gunakan konfigurasiIP:PORT
berikut untuk traffic di port 80 (HTTP
) dan port 443 (HTTPS
).80 -> CLUSTER_NODE_IP:HTTP_INGRESS_PORT 443 -> CLUSTER_NODE_IP:HTTPS_INGRESS_PORT
CLUSTER_NODE_IP: adalah alamat IP node di cluster Kubernetes yang menghosting gateway masuk. Alamat IP ini harus dapat dijangkau dari load balancer eksternal Anda. Anda mungkin harus menyiapkan konfigurasi ini beberapa kali, sekali per node cluster.
HTTP_INGRESS_PORT: adalah
NodePort
yang digunakan untuk mengekspos traffic HTTP gateway masuk. Anda dapat menyalin informasi ini dari langkah sebelumnya. Nilainya akan sama untuk setiap node di cluster.HTTPS_INGRESS_PORT: adalah
NodePort
yang digunakan untuk mengekspos traffic HTTPS gateway masuk. Anda dapat menyalin informasi ini dari langkah sebelumnya. Nilainya akan sama untuk setiap node di cluster.
Untuk memverifikasi penyiapan Anda, pastikan health check di load balancer Anda lulus.
Langkah selanjutnya
- Baca selengkapnya tentang Menginstal dan mengupgrade gateway