Langkah 4: Konfigurasi cluster

Menentukan penggantian konfigurasi

Penginstal Apigee hybrid menggunakan setelan default untuk banyak setelan; namun, ada beberapa setelan yang tidak memiliki setelan default. Anda harus memberikan nilai untuk setelan ini, seperti yang dijelaskan di bawah.

  1. Pastikan Anda berada di direktori hybrid-base-directory/hybrid-files/overrides/. 
    cd hybrid-base-directory/hybrid-files/overrides
  2. Buat file baru bernama overrides.yaml di editor teks favorit Anda. Misalnya: 
    vi overrides.yaml

    overrides.yaml menyediakan konfigurasi untuk penginstalan Apigee hybrid unik Anda. File penggantian pada langkah ini memberikan konfigurasi dasar untuk penginstalan runtime hybrid dengan footprint kecil, yang cocok untuk penginstalan pertama Anda.

  3. Di overrides.yaml, tambahkan nilai properti yang diperlukan, yang ditunjukkan di bawah. Deskripsi mendetail untuk setiap properti juga diberikan di bawah ini:

    Sintaks

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

    
gcp:
  region: analytics-region
  projectID: gcp-project-id

k8sCluster:
  name: cluster-name
  region: analytics-region

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
  4. Setelah selesai, simpan file.

Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan dalam file penggantian. Untuk mengetahui informasi selengkapnya, lihat Referensi properti konfigurasi.

Variabel Deskripsi
analytics-region Anda harus menetapkan nilai ini ke region yang sama dengan tempat cluster berjalan. Ini adalah nilai yang Anda tetapkan ke variabel lingkungan ANALYTICS_REGION sebelumnya selama pembuatan cluster apigee-logger dan apigee-metrics akan mengirimkan datanya ke region ini.
gcp-project-id Mengidentifikasi project Google Cloud tempat apigee-logger dan apigee-metrics mendorong datanya. 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 variabel lingkungan ORG_NAME.
unique-instance-identifier

String unik untuk mengidentifikasi instance ini. Nama ini dapat berupa kombinasi huruf dan angka dengan panjang maksimal 63 karakter.
environment-group-name Nama grup lingkungan tempat lingkungan Anda ditetapkan. Ini adalah grup yang Anda buat di Penyiapan project dan organisasi - Langkah 6: Membuat grup lingkungan. Ini adalah nilai yang ditetapkan ke variabel lingkungan ENV_GROUP.
cert-name
key-name		 Masukkan nama file kunci dan sertifikat TLS 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 di 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) 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 campuran ke cluster. Selanjutnya, Anda akan menerapkan konfigurasi ini ke cluster.

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