Langkah 3: Konfigurasikan cluster AKS

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.

  1. Pastikan Anda berada di direktori hybrid-base-directory/hybrid-files.
  2. Salin file overrides-small.yaml dari direktori $APIGEECTL_HOME/examples ke direktori overrides Anda:
    cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides-aks.yaml

    File contoh ini menyediakan konfigurasi dasar untuk penginstalan runtime hybrid jejak kecil, konfigurasi yang cocok untuk penginstalan pertama Anda.

  3. cd ke direktori overrides:
  4. cd overrides
  5. Buka overrides-aks.yaml dan tambahkan nilai properti yang diperlukan, yang ditunjukkan di bawah. Deskripsi mendetail setiap properti juga disediakan di bawah:

    Sintaksis

    File overrides-aks.yaml memiliki struktur dan sintaksis berikut. Nilai di red, bold italics adalah nilai properti yang harus Anda berikan:

    gcpProjectID: project-id
    k8sClusterName: aks-cluster-name
    org: org-name
    
    envs:
      - name: environment-name  # The same name of the env you created in the UI
        hostAlias: test-host-alias
        sslCertPath: ./certs/test-cert-name.pem
        sslKeyPath: ./certs/test-key-name.key
        serviceAccountPaths:
          synchronizer: ./service-accounts/synchronizer-service-account-name.json
          udca: ./service-accounts/udca-service-account-name.json
    
    mart:
      hostAlias: mart-host-alias
      serviceAccountPath: ./service-accounts/mart-service-account-name.json
      sslCertPath: ./certs/mart-cert-name.pem
      sslKeyPath: ./certs/mart-key-name.key
    
    metrics:
      serviceAccountPath: ./service-accounts/metrics-service-account-name.json
    
    logger:
      enabled: true

    Contoh

    Contoh berikut menunjukkan file penggantian yang telah selesai dengan contoh nilai properti yang ditambahkan:

    gcpProjectID: hybrid-project
    k8sClusterName: apigee-hybrid
    org: hybrid-org
    
    envs:
      - name: test
        hostAlias: "*"
        sslCertPath: ./certs/keystore.pem
        sslKeyPath: ./certs/keystore.key
        serviceAccountPaths:
          synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json
          udca: ./service-accounts/hybrid-project-apigee-udca.json
    
    mart:
      hostAlias: "mart.apigee-hybrid-docs.net"
      serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json
      sslCertPath: ./certs/fullchain.pem
      sslKeyPath: ./certs/privkey.key
    
    metrics:
          serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json
    
    logger:
      enabled: true
  6. Jika sudah selesai, simpan file.

Tabel berikut menjelaskan setiap nilai properti yang harus Anda berikan dalam file penggantian.

Variabel Deskripsi
project-id Project ID GCP Anda.
aks-cluster-name Nama cluster AKS Kubernetes Anda.
org-name Nama organisasi Apigee Hybrid Anda.
environment-name Gunakan nama yang sama dengan yang Anda gunakan saat membuat lingkungan di UI, seperti yang dijelaskan di Langkah 5: Tambahkan lingkungan baru di UI hybrid.
test-host-alias

(Wajib) Untuk panduan memulai, gunakan karakter pengganti "*".

Penggunaan * hanya direkomendasikan untuk penginstalan uji coba saat menggunakan kredensial TLS yang ditandatangani sendiri. Kemudian, saat Anda mengembangkan konfigurasi hybrid Apigee yang lebih kompleks, misalnya membuat beberapa lingkungan, Anda harus menggunakan nama domain yang memenuhi syarat untuk nilai ini.

test-cert-name
test-key-name
Masukkan nama file sertifikat dan kunci TLS yang ditandatangani sendiri yang Anda buat sebelumnya pada langkah Membuat kredensial TLS untuk gateway runtime. File ini harus berada di direktori base_directory/hybrid-files/certs. Contoh:

sslCertPath: ./certs/keystore.pem
sslKeyPath: ./certs/keystore.key
synchronizer-service-account-name Nama file kunci akun layanan sinkronisasi yang Anda buat dengan alat create-service-account. Contoh:

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:

udca: ./service-accounts/hybrid-project-apigee-udca.json
mart-host-alias Nama DNS yang memenuhi syarat untuk endpoint server MART. Nama ini harus cocok dengan nama umum (CN) yang digunakan dalam sertifikat TLS resmi yang diperlukan untuk konfigurasi ini. Misalnya, mart.mydomain.com
mart-service-account-name Nama file kunci akun layanan mart yang Anda buat dengan alat create-service-account.
mart-cert-name
mart-key-name
Masukkan nama file sertifikat dan kunci TLS yang diotorisasi yang Anda buat sebelumnya pada langkah Membuat kredensial TLS untuk gateway MART. File ini harus berada di direktori base_directory/hybrid-files/certs. Contoh:

sslCertPath: ./certs/fullchain.pem
sslKeyPath: ./certs/privkey.key
metrics-service-account-name Nama file kunci akun layanan metrik yang Anda buat dengan alat create-service-account. Contoh:

serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.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 (BERIKUTNYA) Langkah 4: Menginstal runtime hybrid