Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 6: Konfigurasi runtime hybrid

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.

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

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.

Terdapat perbedaan antara berbagai platform untuk region project Google Cloud dan Region cluster Kubernetes. Pilih platform tempat Anda menginstal Apigee Hybrid.

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

k8sCluster:
  name: cluster-name
  region: analytics-region # Must be 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 # set to "false" for GKE.
  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:
                     #   false for GKE installations.
                     #   true for GKE On-prem GKE on AWS, Anthos on bare metal,
                     #            AKS, EKS, and OpenShift 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 # set to "false" for GKE.
  serviceAccountPath: ./service-accounts/logger-service-account-name.json

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`	Di GKE, Anda harus menetapkan nilai ini ke region yang sama dengan tempat cluster dijalankan. Di semua platform lain, pilih region analisis yang paling dekat dengan cluster Anda yang memiliki Analytics support (lihat tabel dalam Bagian 1, Langkah 4: Membuat organisasi. Ini adalah nilai yang Anda tetapkan ke variabel lingkungan `ANALYTICS_REGION` sebelumnya.
`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. Catatan: Anda dapat membuat beberapa organisasi di cluster yang sama, tetapi `instanceId` harus sama untuk semua organisasi dalam cluster Kubernetes yang sama. Sebagai penginstalan multi-region, tiap region memerlukan clusternya sendiri (cluster individual tidak mencakup region). Anda dapat membuat beberapa organisasi di cluster yang sama, tetapi `instanceId` harus sama untuk semua organisasi dalam cluster kubernetes yang sama.
`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 Anda ingin menempatkan instance cluster di beberapa Anda harus berhati-hati dalam menentukan lingkungan dan {i>host<i} virtual Anda. Jika memiliki satu atau beberapa lingkungan yang disertakan ke grup lingkungan, Anda harus menyertakan konfigurasi grup lingkungan yang sama dalam file penggantian setiap instance cluster.
`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 `apigee-synchronizer` yang Anda buat dengan alat `create-service-account` di Penyiapan runtime hybrid - Langkah 6: Buat akun layanan dan kredensial. Anda dapat melihat daftar layanan file akun di direktori `service-accounts/` Anda. Contoh: ls ../service-accounts/
`udca-service-account-name`	Nama file kunci akun layanan `apigee-udca` yang Anda buat dengan alat `create-service-account`.
`mart-service-account-name`	Nama file kunci akun layanan `apigee-mart` yang Anda buat dengan alat `create-service-account`. Catatan: `mart` dan `connectAgent` menggunakan akun layanan `apigee-mart`.
`metrics-service-account-name`	Nama file kunci akun layanan `apigee-metrics` yang Anda buat dengan alat `create-service-account`.
`watcher-service-account-name`	Nama file kunci akun layanan `apigee-watcher` yang Anda buat dengan alat `create-service-account`.
`logger-service-account-name`	Nama file kunci akun layanan `apigee-logger` yang Anda buat dengan alat `create-service-account`.

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 5 6 (BERIKUTNYA) Langkah 7: Instal runtime hybrid