Menginstal ASM
Hybrid Apigee 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 penginstalan versi hybrid 1.4.4 baru, instal ASM versi 1.7.x.
- Untuk upgrade dari versi hybrid sebelumnya, instal ASM versi 1.6.x.
Lakukan langkah-langkah penyiapan dan konfigurasi ASM
Untuk menyelesaikan penginstalan ASM, Anda harus mengikuti langkah-langkah penyiapan dan konfigurasi khusus ASM terlebih dahulu 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 untuk platform Anda di bawah.
GKE
- Ikuti langkah-langkah penyiapan dan konfigurasi ASM:
- Jika ini adalah penginstalan Apigee hybrid baru, instal versi ASM 1.7.x. Buka: Penginstalan baru.
- Jika Anda melakukan upgrade dari versi hybrid sebelumnya, gunakan ASM 1.6.x. Buka: Pengantar penginstalan dan migrasi.
Setelah Anda menyelesaikan langkah-langkah penyiapan dan konfigurasi ASM, buka bagian berikutnya untuk menyelesaikan langkah-langkah konfigurasi hybrid dan penginstalan ASM.
Lakukan konfigurasi hybrid akhir dan instal ASM
Terakhir, tambahkan konfigurasi khusus hybrid ke file istio-operator.yaml dan
instal ASM.
-
Pastikan Anda berada di direktori root penginstalan ASM. Misalnya:
1.7.3-asm.6. - Buka file
istio-operator.yamldi editor.- Di ASM 1.7.x:
./asm/istio/istio-operator.yaml - Di ASM 1.6.x:
./asm/cluster/istio-operator.yaml
- Di ASM 1.7.x:
- Tambahkan (atau perbarui) stanza
spec:componentsdi fileistio-operator.yamldi bawah bagianmeshConfig:dan tepat di atasvalues:, dengan reserved_static_ip adalah alamat IP yang dapat digunakan gateway ingress runtime Anda. Jika Anda tidak memiliki alamat IP statis yang dicadangkan, untuk Panduan Singkat ini, Anda dapat menghilangkan propertiLoadBalancerIP.Teks yang akan 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: 8443Contoh 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: . . .
- Sekarang kembali ke dokumentasi ASM yang Anda gunakan sebelumnya, lalu selesaikan penginstalan ASM
(instal atau terapkan file
istio-operator.yamlke cluster). Jika Anda menggunakan ASM 1.6 dan diberi pilihan, pilih PERMISSIVE mTLS.
GKE on-prem
Menyiapkan dan mendownload ASM
Gunakan dokumentasi ASM untuk menyiapkan lingkungan dan mendownload ASM.
- Baca langkah-langkah berikut dengan cermat sebelum Anda memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
- Buka Menginstal
Anthos Service Mesh di lokal dan lakukan semua langkah ASM hingga dan termasuk
Buat
namespace
istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
Terapkan manifes
Setelah Anda mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:
- Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh:
1.7.3-asm.6. - 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, hapus baris
--set values.gateways.istio-ingressgateway.loadBalancerIP:./bin/istioctl install --set profile=asm-multicloud \ --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
- Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen control plane 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 cara menangani kasus penggunaan yang lebih canggih, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, lihat Mengaktifkan fitur opsional.
Ringkasan
Anda kini telah menginstal cert-manager dan ASM, dan Anda siap menginstal alat command line hybrid Apigee di komputer lokal Anda.
AKS
Menyiapkan dan mendownload ASM
Gunakan dokumentasi ASM untuk menyiapkan lingkungan dan mendownload ASM.
- Baca langkah-langkah berikut dengan cermat sebelum Anda memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
- Buka Menginstal
Anthos Service Mesh di cluster terlampir dan lakukan semua langkah ASM hingga dan termasuk
Buat
namespace
istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
Terapkan manifes
Setelah Anda mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:
- Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh:
1.7.3-asm.6. - 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, hapus baris
--set values.gateways.istio-ingressgateway.loadBalancerIP:./bin/istioctl install --set profile=asm-multicloud \ --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
- Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen control plane 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 cara menangani kasus penggunaan yang lebih canggih, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, lihat Mengaktifkan fitur opsional.
Ringkasan
Anda kini telah menginstal cert-manager dan ASM, dan Anda siap menginstal alat command line hybrid Apigee di komputer lokal Anda.
GKE di AWS
Menyiapkan dan mendownload ASM
Gunakan dokumentasi ASM untuk menyiapkan lingkungan dan mendownload ASM.
- Baca langkah-langkah berikut dengan cermat sebelum Anda memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
- Buka Menginstal Anthos Service Mesh di GKE di AWS dan lakukan semua langkah ASM hingga dan termasuk Mendownload file penginstalan, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
Terapkan manifes
Setelah Anda mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:
- Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh:
1.7.3-asm.6. - 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, hapus baris
--set values.gateways.istio-ingressgateway.loadBalancerIP:./bin/istioctl install --set profile=asm-multicloud \ --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
- Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen control plane 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 cara menangani kasus penggunaan yang lebih canggih, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, lihat Mengaktifkan fitur opsional.
Ringkasan
Anda kini telah menginstal cert-manager dan ASM, dan Anda siap menginstal alat command line hybrid Apigee di komputer lokal Anda.
EKS
Menyiapkan dan mendownload ASM
Gunakan dokumentasi ASM untuk menyiapkan lingkungan dan mendownload ASM.
- Baca langkah-langkah berikut dengan cermat sebelum Anda memulai. Kami akan meminta Anda untuk melakukan beberapa langkah yang tercantum dalam dokumentasi ASM, lalu kembali ke sini untuk menyelesaikan penginstalan.
- Buka Menginstal
Anthos Service Mesh di cluster terlampir dan lakukan semua langkah ASM hingga dan termasuk
Membuat
namespace
istio-system, lalu hentikan dan buka bagian berikutnya Terapkan manifes di bawah.
Terapkan manifes
Setelah Anda mendownload dan mengekstrak file penginstalan ASM, lanjutkan dengan langkah-langkah berikut:
- Pastikan Anda berada di direktori Istio yang telah didownload dan diekstrak. Contoh:
1.7.3-asm.6. - 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, hapus baris
--set values.gateways.istio-ingressgateway.loadBalancerIP:./bin/istioctl install --set profile=asm-multicloud \ --set values.gateways.istio-ingressgateway.loadBalancerIP=your_static_IP
- Terakhir, kembali ke dokumentasi ASM untuk Memeriksa komponen control plane 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 cara menangani kasus penggunaan yang lebih canggih, seperti menambahkan, menghapus, atau mengubah nomor port load balancer, lihat Mengaktifkan fitur opsional.
Ringkasan
Anda kini telah menginstal cert-manager dan ASM, dan Anda siap menginstal alat command line hybrid Apigee di komputer lokal Anda.
Ringkasan
Anda kini telah menginstal cert-manager dan ASM, dan Anda siap menginstal alat command line hybrid Apigee di komputer lokal Anda.
1 2 3 (NEXT) Langkah 4: Instal apigeectl 5 6 7