Langkah 4: Konfigurasikan cluster pengguna

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/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 penginstalan hybrid Apigee Anda yang unik. File penggantian di langkah ini menyediakan konfigurasi dasar untuk penginstalan runtime hybrid jejak kecil, yang cocok untuk penginstalan pertama Anda.

Di overrides.yaml, tambahkan nilai properti yang diperlukan, yang ditunjukkan di bawah. Deskripsi mendetail setiap properti juga disediakan di bawah:

Sintaksis

Pastikan file overrides.yaml memiliki struktur dan sintaksis berikut. Nilai di red, bold italics adalah nilai properti yang harus Anda berikan. Hal tersebut dijelaskan dalam tabel di bawah ini.


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: false #Set this to `true` for GKE-On-prem installations.

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 yang ditambahkan:

gcp:
  region: us-central1
  projectID: hybrid-example

k8sCluster:
  name: apigee-hybrid
  region: us-central1

org: hybrid-example

instanceID: "my_hybrid_example"

cassandra:
  hostNetwork: false #Set this to `true` for GKE-On Prem installations.

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 {i>file<i}.

Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan dalam file penggantian. 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 datanya ke region ini.
`gcp-project-id`	Mengidentifikasi project Google Cloud tempat `apigee-logger` dan `apigee-metrics` mengirim data. 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 Apigee Hybrid Anda. Ini adalah nilai yang ditetapkan ke variabel lingkungan `ORG_NAME`.
`unique-instance-identifier`	String unik untuk mengidentifikasi instance ini. Sandi dapat berupa kombinasi huruf dan angka dengan panjang maksimal 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`. Catatan: Jika ingin menempatkan instance cluster di beberapa region, Anda harus berhati-hati dalam menentukan lingkungan dan host virtual. Jika memiliki satu atau beberapa lingkungan yang terpasang pada grup lingkungan, Anda harus menyertakan konfigurasi grup lingkungan yang sama tersebut di setiap file penggantian instance cluster.
`cert-name` `key-name`	Masukkan nama kunci TLS dan file sertifikat yang ditandatangani sendiri yang Anda buat sebelumnya di 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 dalam Penyiapan project dan organisasi - Langkah 6: Membuat 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 peran Agen Apigee Connect yang ditetapkan padanya) yang 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 ke cluster. Selanjutnya, Anda akan menerapkan konfigurasi ini ke cluster Anda.

Langkah berikutnya

1 2 3 4 (BERIKUTNYA) Langkah 5: Instal runtime hybrid