Menentukan penggantian konfigurasi
Penginstal hybrid Apigee menggunakan default untuk banyak setelan; namun, ada beberapa setelan yang tidak memiliki default. Anda harus memberikan nilai untuk setelan ini, seperti yang akan dijelaskan selanjutnya.
- Pastikan Anda berada di direktori
hybrid-base-directory/hybrid-files
. - Salin file
overrides-small.yaml
dari direktori
ke direktori$APIGEECTL_HOME
/examplesoverrides
Anda:cp
$APIGEECTL_HOME
/examples/overrides-small.yaml ./overrides/overrides-aks.yamlFile contoh ini menyediakan konfigurasi dasar untuk penginstalan runtime hybrid jejak kecil, konfigurasi yang cocok untuk penginstalan pertama Anda.
cd
ke direktorioverrides
:- Buka
overrides-aks.yaml
dan tambahkan nilai properti yang diperlukan, yang ditunjukkan di bawah. Deskripsi mendetail setiap properti juga disediakan di bawah:Sintaksis
File
overrides-aks.yaml
memiliki struktur dan sintaksis berikut. Nilai di red, bold italics adalah nilai properti yang harus Anda berikan:gcpProjectID: project-id k8sClusterName: aks-cluster-name org: org-name envs: - name: environment-name # The same name of the env you created in the UI hostAlias: test-host-alias sslCertPath: ./certs/test-cert-name.pem sslKeyPath: ./certs/test-key-name.key serviceAccountPaths: synchronizer: ./service-accounts/synchronizer-service-account-name.json udca: ./service-accounts/udca-service-account-name.json mart: hostAlias: mart-host-alias serviceAccountPath: ./service-accounts/mart-service-account-name.json sslCertPath: ./certs/mart-cert-name.pem sslKeyPath: ./certs/mart-key-name.key metrics: serviceAccountPath: ./service-accounts/metrics-service-account-name.json logger: enabled: true
Contoh
Contoh berikut menunjukkan file penggantian yang telah selesai dengan contoh nilai properti yang ditambahkan:
gcpProjectID: hybrid-project k8sClusterName: apigee-hybrid org: hybrid-org envs: - name: test hostAlias: "*" sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key serviceAccountPaths: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json udca: ./service-accounts/hybrid-project-apigee-udca.json mart: hostAlias: "mart.apigee-hybrid-docs.net" serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json logger: enabled: true
- Jika sudah selesai, simpan file.
cd overrides
Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan dalam file penggantian.
Variabel | Deskripsi |
---|---|
project-id | Project ID GCP Anda. |
aks-cluster-name | Nama cluster AKS Kubernetes Anda. |
org-name | Nama organisasi Apigee Hybrid Anda. |
environment-name | Gunakan nama yang sama dengan yang Anda gunakan saat membuat lingkungan di UI, seperti yang dijelaskan di Langkah 5: Tambahkan lingkungan baru di UI hybrid. |
test-host-alias | (Wajib) Untuk panduan memulai, gunakan karakter pengganti " Penggunaan |
test-cert-name test-key-name |
Masukkan nama file sertifikat dan kunci TLS yang ditandatangani sendiri yang Anda buat sebelumnya pada langkah
Membuat kredensial TLS untuk gateway runtime. File ini harus berada di
direktori base_directory/hybrid-files/certs . Contoh:
sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key |
synchronizer-service-account-name | Nama file kunci akun layanan sinkronisasi yang Anda buat dengan alat create-service-account . Contoh:
synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json |
udca-service-account-name | Nama file kunci akun layanan udca yang Anda buat dengan alat create-service-account . Contoh:
udca: ./service-accounts/hybrid-project-apigee-udca.json |
mart-host-alias | Nama DNS yang memenuhi syarat untuk endpoint server MART. Nama ini harus cocok
dengan nama umum (CN) yang digunakan dalam sertifikat TLS resmi yang diperlukan untuk
konfigurasi ini. Misalnya,
mart.mydomain.com
|
mart-service-account-name | Nama file kunci akun layanan mart yang Anda buat dengan
alat create-service-account . |
mart-cert-name mart-key-name |
Masukkan nama file sertifikat dan kunci TLS yang diotorisasi yang Anda buat sebelumnya pada langkah Membuat kredensial TLS untuk gateway MART.
File ini harus berada di
direktori base_directory/hybrid-files/certs . Contoh:
sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.key |
metrics-service-account-name | Nama file kunci akun layanan metrik yang Anda buat dengan alat create-service-account . Contoh:
serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json |
Ringkasan
File konfigurasi memberi tahu Kubernetes cara men-deploy komponen hybrid ke cluster. Selanjutnya, Anda akan menerapkan konfigurasi ini ke cluster Anda.
Langkah berikutnya
1 2 3 (BERIKUTNYA) Langkah 4: Menginstal runtime hybrid