Langkah 3: Instal ASM

Saat ini Anda sedang melihat versi 1.4 dokumentasi hybrid Apigee. This version is end of life. You should upgrade to a newer version. Untuk informasi lebih lanjut, lihat Versi yang didukung.

Version 1.4 (unsupported)

Versi yang didukung:

• v1.12 (terbaru)                        
• v1.11                         
• v1.10                                        
• Daftar versi yang didukung

Versi yang tidak didukung:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Instal ASM

Apigee Hybrid menggunakan distribusi Istio yang disediakan dengan Anthos Service Mesh (ASM). Ikuti langkah-langkah berikut untuk menginstal ASM di cluster Anda.

Versi ASM yang didukung

• Untuk instalasi hibrida baru versi 1.4.4, instal ASM versi 1.7.x.
• Untuk upgrade dari versi hybrid sebelumnya, instal ASM versi 1.6.x.

Melakukan langkah penyiapan dan konfigurasi ASM

Untuk menyelesaikan penginstalan ASM, Anda harus terlebih dahulu mengikuti langkah-langkah penyiapan dan konfigurasi khusus ASM dalam dokumentasi ASM. Kemudian, Anda harus kembali ke sini untuk menyelesaikan konfigurasi khusus hybrid sebelum menerapkan konfigurasi ke cluster.

Petunjuk untuk menginstal dan mengonfigurasi ASM berbeda-beda bergantung pada platform Anda. Pilih langkah-langkah platform Anda di bawah ini.

Konfigurasi berikut mengasumsikan bahwa klien akan mengaktifkan SNI secara default. Jika tidak, lihat petunjuk untuk Mengaktifkan klien non-SNI dan HTTP.

GKE

1. Ikuti langkah-langkah penyiapan dan konfigurasi ASM:
   Penting: Saat mengikuti dokumentasi ASM, jangan instal atau terapkan file konfigurasi YAML istio-operator.yaml jika diperintahkan untuk melakukannya. Pada saat itu, kami mengharuskan Anda untuk kembali ke halaman ini untuk mengedit file dengan konfigurasi khusus hybrid lebih lanjut sebelum menginstal/menerapkan konfigurasi.
   • Jika ini adalah penginstalan baru Apigee Hybrid, instal ASM versi 1.7.x. Buka: New installation.
   • Jika Anda melakukan upgrade dari hybrid versi sebelumnya, gunakan ASM 1.6.x. Buka: Pengantar penginstalan dan migrasi.

2. Setelah Anda menyelesaikan langkah-langkah penyiapan dan konfigurasi ASM, lanjutkan ke bagian berikutnya untuk menyelesaikan langkah-langkah konfigurasi hybrid dan penginstalan ASM.

Melakukan konfigurasi hybrid akhir dan menginstal ASM

Terakhir, tambahkan konfigurasi khusus hybrid ke file istio-operator.yaml dan instal ASM.

1. Pastikan Anda berada di direktori utama penginstalan ASM. Misalnya: 1.7.3-asm.6.
2. Buka file istio-operator.yaml di editor.
   • Di ASM 1.7.x: ./asm/istio/istio-operator.yaml
   • Di ASM 1.6.x: ./asm/cluster/istio-operator.yaml
3. Tambahkan (atau perbarui) stanza spec:components di file istio-operator.yaml di bawah bagian meshConfig: dan tepat di atas values:, dengan reserved_static_ip adalah alamat IP yang dapat digunakan oleh gateway masuk runtime Anda. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, untuk Mulai Cepat ini, Anda dapat mengecualikan properti LoadBalancerIP.

   Teks untuk disalin

     components:
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: static_ip # If you do not have a reserved static IP, leave this out.
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
   

   Contoh yang menampilkan penempatan

   Jeda baris disisipkan agar mudah dibaca

   apiVersion: install.istio.io/v1alpha1
   kind: IstioOperator
   metadata:
     clusterName: "hybrid-example/us-central1/example-cluster" # {"$ref":"#/definitions/io.k8s.cli.substitutions.cluster-name"}
   spec:
     profile: asm
     hub: gcr.io/gke-release/asm # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.hub"}
     tag: 1.5.7-asm.0 # {"$ref":"#/definitions/io.k8s.cli.setters.anthos.servicemesh.tag"}
     meshConfig:
       defaultConfig:
         proxyMetadata:
           GCP_METADATA: "hybrid-example|123456789123|example-cluster|us-central1" #
             {"$ref":"#/definitions/io.k8s.cli.substitutions.gke-metadata"}
   
     components:
       pilot:
         k8s:
           hpaSpec:
             maxReplicas: 2
       ingressGateways:
       - name: istio-ingressgateway
         enabled: true
         k8s:
           service:
             type: LoadBalancer
             loadBalancerIP: 123.234.56.78
             ports:
             - name: status-port
               port: 15021 # for ASM 1.7.x and above, else 15020
               targetPort: 15021 # for ASM 1.7.x and above, else 15020
             - name: http2
               port: 80
               targetPort: 8080
             - name: https
               port: 443
               targetPort: 8443
           hpaSpec:
             maxReplicas: 2
     values:
       .
       .
       .
   

4. Kembali sekarang ke dokumentasi ASM yang Anda gunakan sebelumnya, dan selesaikan penginstalan ASM (instal atau terapkan file istio-operator.yaml ke cluster). Jika Anda menggunakan ASM 1.6 dan diberi pilihan, pilih mTLS PERMISSIF.
   Catatan: Jika Anda menggunakan ASM 1.6, sebaiknya gunakan perintah asmctl validate untuk memvalidasi konfigurasi dan kondisi komponen yang diinstal. Perintah ini dijelaskan di bagian dokumentasi ASM tentang memvalidasi penginstalan. Perintah ini hanya valid jika Anda menggunakan ASM 1.6.

GKE on-prem

Menyiapkan dan mendownload ASM

Gunakan dokumentasi ASM untuk menyiapkan lingkungan Anda dan mendownload ASM.

1. Baca langkah-langkah berikut dengan cermat sebelum memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
2. Buka Menginstal Anthos Service Mesh secara lokal dan lakukan semua langkah ASM hingga dan termasuk Membuat namespace istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
   Penting: Setelah menyelesaikan langkah-langkah di bagian Membuat namespace istio-system, berhenti dan lanjutkan dengan langkah-langkah yang tercantum di bagian berikutnya. Sebaiknya Anda menunggu untuk menerapkan file manifes hingga petunjuk di bawah ini.

Menerapkan manifes

Setelah mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:

1. Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh: 1.7.3-asm.6.
2. Jalankan perintah berikut, dengan your_static_ip adalah alamat IP statis yang dapat digunakan oleh komponen ingress istio. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, biarkan baris --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen bidang kontrol guna memvalidasi penginstalan Anda.

Menyesuaikan penginstalan ASM

Penginstalan ASM yang baru saja Anda lakukan adalah penginstalan minimal, yang cukup untuk menguji dan menggunakan Apigee Hybrid untuk kasus penggunaan dasar. Untuk mengetahui informasi tentang penanganan kasus penggunaan lanjutan lainnya, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, baca bagian Mengaktifkan fitur opsional.

Ringkasan

Sekarang Anda telah menginstal cert-manager dan ASM, dan siap menginstal alat command line Apigee Hybrid di komputer lokal Anda.

AKS

Menyiapkan dan mendownload ASM

Gunakan dokumentasi ASM untuk menyiapkan lingkungan Anda dan mendownload ASM.

1. Baca langkah-langkah berikut dengan cermat sebelum memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
2. Buka Menginstal Anthos Service Mesh pada cluster yang terpasang dan lakukan semua langkah ASM hingga dan termasuk Membuat namespace istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
   Penting: Setelah menyelesaikan langkah-langkah di bagian Membuat namespace istio-system, berhenti dan lanjutkan dengan langkah-langkah yang tercantum di bagian berikutnya. Sebaiknya Anda menunggu untuk menerapkan file manifes hingga petunjuk di bawah ini.

Menerapkan manifes

Setelah mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:

1. Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh: 1.7.3-asm.6.
2. Jalankan perintah berikut, dengan your_static_ip adalah alamat IP statis yang dapat digunakan oleh komponen ingress istio. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, biarkan baris --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen bidang kontrol guna memvalidasi penginstalan Anda.

Menyesuaikan penginstalan ASM

Penginstalan ASM yang baru saja Anda lakukan adalah penginstalan minimal, yang cukup untuk menguji dan menggunakan Apigee Hybrid untuk kasus penggunaan dasar. Untuk mengetahui informasi tentang penanganan kasus penggunaan lanjutan lainnya, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, baca bagian Mengaktifkan fitur opsional.

Ringkasan

Sekarang Anda telah menginstal cert-manager dan ASM, dan siap menginstal alat command line Apigee Hybrid di komputer lokal Anda.

GKE on AWS

Menyiapkan dan mendownload ASM

Gunakan dokumentasi ASM untuk menyiapkan lingkungan Anda dan mendownload ASM.

1. Baca langkah-langkah berikut dengan cermat sebelum memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
2. Buka Menginstal Anthos Service Mesh di GKE pada AWS dan lakukan semua langkah ASM hingga dan termasuk Download file penginstalan, lalu berhenti dan buka bagian berikutnya Terapkan manifes di bawah.
   Penting: Setelah menyelesaikan langkah-langkah di bagian Mendownload file penginstalan, hentikan dan lanjutkan dengan langkah-langkah yang tercantum di bagian berikutnya. Sebaiknya Anda menunggu untuk menerapkan file manifes hingga petunjuk di bawah ini.

Menerapkan manifes

Setelah mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:

1. Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh: 1.7.3-asm.6.
2. Jalankan perintah berikut, dengan your_static_ip adalah alamat IP statis yang dapat digunakan oleh komponen ingress istio. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, biarkan baris --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen bidang kontrol guna memvalidasi penginstalan Anda.

Menyesuaikan penginstalan ASM

Penginstalan ASM yang baru saja Anda lakukan adalah penginstalan minimal, yang cukup untuk menguji dan menggunakan Apigee Hybrid untuk kasus penggunaan dasar. Untuk mengetahui informasi tentang penanganan kasus penggunaan lanjutan lainnya, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, baca bagian Mengaktifkan fitur opsional.

Ringkasan

Sekarang Anda telah menginstal cert-manager dan ASM, dan siap menginstal alat command line Apigee Hybrid di komputer lokal Anda.

EKS

Menyiapkan dan mendownload ASM

Gunakan dokumentasi ASM untuk menyiapkan lingkungan Anda dan mendownload ASM.

1. Baca langkah-langkah berikut dengan cermat sebelum memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
2. Buka Menginstal Anthos Service Mesh pada cluster yang terpasang dan lakukan semua langkah ASM hingga dan termasuk Membuat namespace istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
   Penting: Setelah menyelesaikan langkah-langkah di bagian Membuat namespace istio-system, berhenti dan lanjutkan dengan langkah-langkah yang tercantum di bagian berikutnya. Sebaiknya Anda menunggu untuk menerapkan file manifes hingga petunjuk di bawah ini.

Menerapkan manifes

Setelah mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:

1. Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh: 1.7.3-asm.6.
2. Jalankan perintah berikut, dengan your_static_ip adalah alamat IP statis yang dapat digunakan oleh komponen ingress istio. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, biarkan baris --set values.gateways.istio-ingressgateway.loadBalancerIP:

   ./bin/istioctl install --set profile=asm-multicloud \
    --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP

3. Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen bidang kontrol guna memvalidasi penginstalan Anda.

Menyesuaikan penginstalan ASM

Penginstalan ASM yang baru saja Anda lakukan adalah penginstalan minimal, yang cukup untuk menguji dan menggunakan Apigee Hybrid untuk kasus penggunaan dasar. Untuk mengetahui informasi tentang penanganan kasus penggunaan lanjutan lainnya, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, baca bagian Mengaktifkan fitur opsional.

Ringkasan

Sekarang Anda telah menginstal cert-manager dan ASM, dan siap menginstal alat command line Apigee Hybrid di komputer lokal Anda.

Ringkasan

Sekarang Anda telah menginstal cert-manager dan ASM, dan siap menginstal alat command line Apigee Hybrid di komputer lokal Anda.

1 2 3 (BERIKUTNYA) Langkah 4: Instal apigeectl 5