Langkah 3: Instal ASM

GKE

Bersiap menginstal ASM

1. Periksa variabel lingkungan yang Anda perlukan untuk langkah-langkah berikut, dan tetapkan jika Anda Anda harus:

   echo $PROJECT_ID
   echo $CLUSTER_NAME
   echo $CLUSTER_LOCATION

2. Buat file overlay bernama overlay.yaml dengan konten berikut:

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   spec:
     components:
       ingressGateways:
         - name: istio-ingressgateway
           enabled: true
           k8s:
             nodeSelector:
               # default node selector, if different or not using node selectors, change accordingly.
               cloud.google.com/gke-nodepool: apigee-runtime
             resources:
               requests:
                 cpu: 1000m
             service:
               type: LoadBalancer
               loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
               ports:
                 - name: http-status-port
                   port: 15021
                 - name: http2
                   port: 80
                   targetPort: 8080
                 - name: https
                   port: 443
                   targetPort: 8443
     meshConfig:
       accessLogFormat:
         '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

   • apigee-runtime adalah nilai default untuk pemilih node. Ini adalah apigee-runtime kumpulan node yang Anda buat di Langkah 1: Membuat cluster. Jika Anda menggunakan pemilih node yang berbeda atau tidak menggunakannya, ubah atau hapus nodeSelector.
   • STATIC_IP adalah alamat IP untuk load balancer Anda. Jika Anda belum mengaturnya, hapus properti loadBalancerIP, tetapi pertahankan type dan ports.
3. Ikuti petunjuk untuk mempersiapkan penginstalan ASM:
   1. Anthos prasyarat.
   2. Izin yang diperlukan untuk instal Anthos Service Mesh.
   3. Rencanakan penginstalan.
4. Instal asmcli dan alat apa pun yang diperlukan seperti git, kubectl, dan jq, dengan mengikuti petunjuk dalam Menginstal alat yang diperlukan.
5. Lanjutkan langkah untuk Berikan izin admin cluster Anda dan berhenti. Jangan menjalankan "Validasi project dan cluster" langkah waktu ini.
6. Instal ASM dengan fitur opsional. Tentukan gateway masuk lama dengan --option legacy-default-ingressgateway. misalnya:

   ./asmcli install \
     --verbose \
     --project_id $PROJECT_ID \
     --cluster_name $CLUSTER_NAME \
     --cluster_location $CLUSTER_LOCATION \
     --output_dir dir_path \
     --custom_overlay overlay.yaml \
     --enable_all \
     --option legacy-default-ingressgateway

   • dir_path adalah direktori output tempat Anda ingin menyiapkan asmcli instalasi ASM Anda, termasuk semua subdirektori.
   • overlay.yaml adalah file overlay yang Anda buat di langkah sebelumnya.

   Gunakan setelan ini saat mengikuti petunjuk di Instal dengan fitur opsional.

Pemecahan masalah

Jika Anda mengalami error pada merujuk ke gcloud container hub memberships register, Anda mungkin telah melampaui jumlah maksimum cluster yang terdaftar dengan GKE Hub. Contoh:

asmcli_1.12: [WARNING]:  Command 'run_command gcloud
container hub memberships register my-hybrid-example
...' failed.

Coba langkah-langkah berikut untuk memperbaiki error ini, lalu jalankan asmcli install lagi:

1. Buat daftar keanggotaan GKE Hub untuk project Anda:

   gcloud container hub memberships list --project=$PROJECT_ID

2. Hapus keanggotaan GKE Hub:

   gcloud container hub memberships delete "membership" --project=$PROJECT_ID

Untuk mengetahui informasi selengkapnya tentang batas GKE Hub, lihat Kuota dan batas.

Di luar Google Cloud

Petunjuk ini ditujukan untuk menginstal dan menyiapkan ASM untuk instance hybrid Apigee menggunakan Anthos untuk dijalankan di:

• Cluster Anthos di VMware (GKE lokal)
• Anthos on bare metal
• Cluster Anthos di AWS
• Amazon EKS

Bersiap menginstal ASM

1. Periksa variabel lingkungan yang Anda perlukan untuk langkah-langkah berikut, dan tetapkan jika Anda Anda harus:

   echo ${PROJECT_ID}
   echo ${CLUSTER_NAME}
   echo ${CLUSTER_LOCATION}

2. Catat nilai yang akan Anda perlukan dengan ASMCLI. Inilah nilai-nilai yang Anda akan diminta untuk memberikan saat mengikuti langkah-langkah dalam dokumentasi ASM:
   • FLEET_PROJECT_ID nama project yang akan dikaitkan dengan cluster Anda. Gunakan project yang Anda buat untuk penginstalan ini, yang disimpan di ${PROJECT_ID} variabel lingkungan.
   • KUBECONFIG_FILE Jalur lengkap ke file kubeconfig. Jalur defaultnya adalah $HOME/.kube/config. untuk informasi selengkapnya, lihat Pengorganisasian Akses Cluster Menggunakan File kubeconfig dalam dokumentasi Kubernetes.
   • DIR_PATH direktori output untuk ASMCLI. Ini adalah jalur di mana ia akan membuat file konfigurasi Istio. Contoh: ./asm.
   • GATEWAY_NAMESPACE namespace untuk gateway masuk Istio Anda, misalnya: istio.
   • REVISION label revisi untuk rilis ASM ini. Gunakan asm-1129-3
   • CONTEXT konteks Kubernetes. Memastikan kubernetes menggunakan konteks untuk cluster Anda dengan perintah berikut:

     kubectl config get-contexts

     Jika cluster Anda saat ini bukan konteks saat ini, Anda dapat menyetelnya dengan perintah berikut berikut:

     kubectl config use-context CONTEXT

   • USER_ACCOUNT akun dengan izin admin cluster yang Anda gunakan untuk mengelola cluster.
3. Tetapkan konteks ke project dan region Anda dengan perintah berikut:

   Setel project ID default Anda:

   gcloud config set project ${PROJECT_ID}

   Jika Anda menggunakan cluster regional, tetapkan region komputasi default:

   gcloud config set compute/region ${CLUSTER_LOCATION}

4. Dapatkan kredensial dengan perintah berikut:

   gcloud container clusters get-credentials ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID}

5. Buat file overlay bernama overlay.yaml dengan konten berikut:

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   spec:
     components:
       ingressGateways:
         - name: istio-ingressgateway
           enabled: true
           k8s:
             nodeSelector:
               # default node selector, if different or not using node selectors, change accordingly.
               cloud.google.com/gke-nodepool: apigee-runtime
             resources:
               requests:
                 cpu: 1000m
             service:
               type: LoadBalancer
               loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
               ports:
                 - name: http-status-port
                   port: 15021
                 - name: http2
                   port: 80
                   targetPort: 8080
                 - name: https
                   port: 443
                   targetPort: 8443
     meshConfig:
       accessLogFormat:
         '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

   • apigee-runtime adalah nilai default untuk pemilih node. Ini adalah apigee-runtime kumpulan node yang Anda buat di Langkah 1: Membuat cluster. Jika Anda menggunakan pemilih node yang berbeda atau tidak menggunakannya, ubah atau hapus nodeSelector.
   • STATIC_IP adalah alamat IP untuk load balancer Anda. Jika Anda belum mengaturnya, hapus properti loadBalancerIP, tetapi pertahankan type dan ports.
6. Ikuti petunjuk untuk mempersiapkan penginstalan ASM:
   1. Anthos prasyarat.
   2. Izin yang diperlukan untuk instal Anthos Service Mesh.
   3. Rencanakan penginstalan.
7. Instal asmcli dan alat apa pun yang diperlukan seperti git, kubectl, dan jq, dengan mengikuti petunjuk dalam Menginstal alat yang diperlukan.
8. Lanjutkan langkah untuk Berikan izin admin cluster Anda dan berhenti. Jangan menjalankan "Validasi project dan cluster" langkah waktu ini.
9. Instal ASM dengan fitur opsional. Tentukan gateway masuk lama dengan --option legacy-default-ingressgateway. misalnya:

   ./asmcli install \
     --verbose \
     --project_id $PROJECT_ID \
     --cluster_name $CLUSTER_NAME \
     --cluster_location $CLUSTER_LOCATION \
     --output_dir dir_path \
     --custom_overlay overlay.yaml \
     --enable_all \
     --option legacy-default-ingressgateway

   • dir_path adalah direktori output tempat Anda ingin menyiapkan asmcli instalasi ASM Anda, termasuk semua subdirektori.
   • overlay.yaml adalah file overlay yang Anda buat di langkah sebelumnya.

   Gunakan setelan ini saat mengikuti petunjuk di Instal dengan fitur opsional.

Pemecahan masalah

Jika Anda mengalami error pada merujuk ke gcloud container hub memberships register, Anda mungkin telah melampaui jumlah maksimum cluster yang terdaftar dengan GKE Hub. Contoh:

asmcli_1.12: [WARNING]:  Command 'run_command gcloud
container hub memberships register my-hybrid-example
...' failed.

Coba langkah-langkah berikut untuk memperbaiki error ini, lalu jalankan asmcli install lagi:

1. Buat daftar keanggotaan GKE Hub untuk project Anda:

   gcloud container hub memberships list --project=$PROJECT_ID

2. Hapus keanggotaan GKE Hub:

   gcloud container hub memberships delete "membership" --project=$PROJECT_ID

Untuk mengetahui informasi selengkapnya tentang batas GKE Hub, lihat Kuota dan batas.

Platform Kubernetes lainnya