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 berikutnya.

  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 # 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 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: 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
    
    
  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 Apigee Hybrid 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