Menentukan penggantian konfigurasi
Penginstal hybrid Apigee menggunakan setelan default untuk banyak setelan; Namun, ada beberapa setelan yang tidak memiliki setelan default. Anda harus memberikan nilai untuk setelan ini, seperti yang akan dijelaskan selanjutnya.
- Pastikan Anda berada di direktori
hybrid-base-directory/hybrid-files/overrides/
.cd hybrid-base-directory/hybrid-files/overrides
- Buat file baru bernama
overrides.yaml
di editor teks favorit Anda. Sebagai contoh:vi overrides.yaml
overrides.yaml
menyediakan konfigurasi untuk hybrid Apigee yang unik penginstalan. File penggantian pada langkah ini memberikan konfigurasi dasar untuk jejak kecil instalasi {i>runtime <i}hibrida, yang cocok untuk instalasi pertama Anda. - Di
overrides.yaml
, tambahkan nilai properti yang diperlukan, seperti yang ditunjukkan di bawah. Model deskripsi setiap properti juga tercantum di bawah:Sintaks
Pastikan file
overrides.yaml
memiliki struktur dan sintaksis berikut. Nilai dalam red, bold italics adalah yang harus Anda berikan. Kebijakan tersebut dijelaskan dalam tabel di bawah.gcp: region: analytics-region # Choose the closest Google Cloud region to your cluster. projectID: gcp-project-id k8sCluster: name: cluster-name region: analytics-region # Choose the closest Google Cloud region to your cluster. org: org-name instanceID: "unique-instance-identifier" cassandra: hostNetwork: true #Set this to `false` for platforms other than GKE On-prem. virtualhosts: - name: environment-group-name sslCertPath: ./certs/cert-name.pem sslKeyPath: ./certs/key-name.key envs: - name: environment-name serviceAccountPaths: synchronizer: ./service-accounts/synchronizer-service-account-name.json udca: ./service-accounts/udca-service-account-name.json mart: serviceAccountPath: ./service-accounts/mart-service-account-name.json connectAgent: serviceAccountPath: ./service-accounts/mart-service-account-name.json # Same account used for mart and connectAgent metrics: serviceAccountPath: ./service-accounts/metrics-service-account-name.json watcher: serviceAccountPath: ./service-accounts/watcher-service-account-name.json logger: enabled: true serviceAccountPath: ./service-accounts/logger-service-account-name.json
Contoh
Contoh berikut menunjukkan file penggantian yang telah selesai dengan contoh nilai properti ditambahkan:
gcp: region: us-central1 projectID: hybrid-example k8sCluster: name: apigee-hybrid region: us-central1 org: hybrid-example instanceID: "my_hybrid_example" cassandra: hostNetwork: true #Set this to `false` for platforms other than GKE-On Prem. virtualhosts: - name: example-env-group sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key envs: - name: test serviceAccountPaths: synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json udca: ./service-accounts/hybrid-project-apigee-udca.json mart: serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json connectAgent: serviceAccountPath: ./service-accounts/example-hybrid-apigee-mart.json metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json logger: enabled: true serviceAccountPath: ./service-accounts/logger-service-account-name.json
- Setelah selesai, simpan file.
Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan di mengganti file. Untuk informasi selengkapnya, lihat Referensi properti konfigurasi.
Variabel | Deskripsi |
---|---|
analytics-region | Anda harus menetapkan nilai ini ke region yang sama dengan tempat cluster dijalankan.
Ini adalah nilai yang Anda tetapkan ke variabel lingkungan
ANALYTICS_REGION sebelumnya
selama pembuatan cluster
apigee-logger dan apigee-metrics mengirim
ke region ini. |
gcp-project-id | Mengidentifikasi project Google Cloud tempat apigee-logger dan apigee-metrics dikirim
data mereka. Ini adalah nilai yang ditetapkan ke variabel lingkungan PROJECT_ID . |
cluster-name | Nama cluster Kubernetes Anda. Ini adalah nilai yang ditetapkan ke variabel lingkungan
CLUSTER_NAME . |
org-name | ID organisasi hybrid Apigee Anda. Ini adalah nilai yang ditetapkan ke lingkungan
variabel ORG_NAME . |
unique-instance-identifier | String unik untuk mengidentifikasi instance ini. Bisa berupa kombinasi huruf dan angka hingga 63 karakter. |
environment-group-name | Nama grup lingkungan yang ditetapkan untuk lingkungan Anda. Ini adalah grup
yang Anda buat di Penyiapan project dan organisasi - Langkah 6: Buat grup lingkungan.
Ini adalah nilai yang ditetapkan ke variabel lingkungan ENV_GROUP .
|
cert-name key-name |
Masukkan nama file sertifikat dan kunci TLS yang ditandatangani sendiri yang Anda buat sebelumnya
Langkah 3: Instal apigeectl.
File ini harus berada di
direktori base_directory/hybrid-files/certs . Contoh:
sslCertPath: ./certs/keystore.pem sslKeyPath: ./certs/keystore.key |
environment-name | Gunakan nama yang sama dengan yang Anda gunakan saat membuat lingkungan di UI, seperti yang dijelaskan di Penyiapan project dan organisasi - Langkah 6: Buat grup lingkungan. |
synchronizer-service-account-name | Nama file kunci akun layanan synchronizer yang Anda buat dengan
Alat create-service-account . Contoh:
serviceAccountPath: 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:
serviceAccountPath: udca: ./service-accounts/hybrid-project-apigee-udca.json |
mart-service-account-name | Nama file JSON kunci akun layanan mart yang Anda buat dengan
Alat create-service-account . |
metrics-service-account-name | Nama file JSON akun layanan metrik yang Anda buat dengan
Alat create-service-account . Contoh:
metrics: serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json |
mart-service-account-name | Nama akun layanan mart (yang memiliki Apigee Connect
Agent (Agen) yang telah Anda buat di
Langkah 3: Instal apigeectl.
MART dan Agen Apigee Connect menggunakan akun layanan yang sama.
|
watcher-service-account-name | Nama file JSON akun layanan watcher yang Anda buat dengan
Alat create-service-account . Contoh:
watcher: serviceAccountPath: ./service-accounts/hybrid-project-apigee-watcher.json |
Ringkasan
File konfigurasi memberi tahu Kubernetes cara men-deploy komponen hybrid untuk cluster. Selanjutnya, Anda akan menerapkan konfigurasi ini ke cluster Anda.
1 2 3 4 (BERIKUTNYA) Langkah 5: Instal runtime hybrid