Langkah 4: Konfigurasikan cluster pengguna

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.

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

  3. 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: 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 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 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