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.
Pastikan Anda berada di direktori hybrid-base-directory/hybrid-files.
Salin file overrides-small.yaml dari direktori $APIGEECTL_HOME/examples ke
direktori overrides Anda:
File contoh ini memberikan konfigurasi dasar untuk penginstalan runtime hibrida dengan footprint
kecil, konfigurasi yang cocok untuk penginstalan pertama Anda.
cd ke dalam direktori overrides:
cd overrides
Buka overrides-aks.yaml dan tambahkan nilai properti yang diperlukan, yang ditampilkan di bawah. Deskripsi
mendetail tentang setiap properti juga diberikan di bawah ini:
Sintaks
File overrides-aks.yaml memiliki struktur dan sintaksis berikut.
Nilai dalam red, bold italics adalah
nilai properti yang harus Anda berikan:
(Wajib) Untuk memulai cepat, gunakan karakter pengganti "*".
Penggunaan *
hanya direkomendasikan untuk penginstalan uji coba saat menggunakan kredensial TLS yang ditandatangani sendiri.
Kemudian, saat mengembangkan konfigurasi hibrida Apigee yang lebih kompleks, seperti membuat beberapa lingkungan, Anda harus menggunakan nama domain yang memenuhi syarat untuk nilai ini.
test-cert-name test-key-name
Masukkan nama file kunci dan sertifikat TLS yang ditandatangani sendiri yang Anda buat sebelumnya di langkah
Membuat kredensial TLS untuk gateway runtime. File ini harus berada di
direktori base_directory/hybrid-files/certs. Contoh:
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 marketplace yang Anda buat dengan
alat create-service-account.
mart-cert-name mart-key-name
Masukkan nama file kunci dan sertifikat TLS resmi yang Anda buat sebelumnya di langkah
Membuat kredensial TLS untuk gateway MART.
File ini harus berada di
direktori base_directory/hybrid-files/certs. Contoh:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-03 UTC."],[[["\u003cp\u003eThis documentation version is end-of-life, and users should upgrade to a newer version for continued support.\u003c/p\u003e\n"],["\u003cp\u003eThe Apigee hybrid installer uses default settings, but you must provide values for specific, non-default settings in the \u003ccode\u003eoverrides-aks.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eYou need to copy the \u003ccode\u003eoverrides-small.yaml\u003c/code\u003e file to create \u003ccode\u003eoverrides-aks.yaml\u003c/code\u003e, which will contain the required property values for a basic configuration.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eoverrides-aks.yaml\u003c/code\u003e file requires specific property values, including GCP project ID, Kubernetes cluster name, organization name, and service account paths, to configure the hybrid environment.\u003c/p\u003e\n"],["\u003cp\u003eEnabling logging in the \u003ccode\u003eoverrides-aks.yaml\u003c/code\u003e file is mandatory by setting \u003ccode\u003elogger:enabled:true\u003c/code\u003e, and you should reference the provided table for detailed property descriptions.\u003c/p\u003e\n"]]],[],null,["# Step 3: Configure the AKS cluster\n\n| You are currently viewing version 1.1 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nSpecify configuration overrides\n-------------------------------\n\n\nThe Apigee hybrid installer uses defaults for many settings; however, there are a few settings\nthat do not have defaults. You must provide values for these settings, as explained next.\n\n1. Be sure you are in the \u003cvar translate=\"no\"\u003ehybrid-base-directory\u003c/var\u003e`/hybrid-files` directory.\n2. Copy the `overrides-small.yaml` file from the `$APIGEECTL_HOME``/examples` directory to your `overrides` directory: \n\n cp $APIGEECTL_HOME/examples/overrides-small.yaml ./overrides/overrides-aks.yaml\n\n\n This example file provides a basic configuration for a small-footprint hybrid\n runtime installation, a configuration that is suitable for a your first installation.\n3. `cd` into the `overrides` directory: \n\n```\ncd overrides\n```\n 4. Open `overrides-aks.yaml` and add the required property values, shown below. A detailed description of each property is also provided below: **NOTE:** You must explicitly enable logging by setting `logger:enabled:true` in the overrides file. \n\n ### Syntax\n\n The `overrides-aks.yaml` file has the following structure and syntax.\n Values in \u003cvar translate=\"no\"\u003ered, bold italics\u003c/var\u003e are\n property values that you must provide: \n\n ```actionscript-3\n gcpProjectID: project-id\n k8sClusterName: aks-cluster-name\n org: org-name\n\n envs:\n - name: environment-name # The same name of the env you created in the UI\n hostAlias: test-host-alias\n sslCertPath: ./certs/test-cert-name.pem\n sslKeyPath: ./certs/test-key-name.key\n serviceAccountPaths:\n synchronizer: ./service-accounts/synchronizer-service-account-name.json\n udca: ./service-accounts/udca-service-account-name.json\n\n mart:\n hostAlias: mart-host-alias\n serviceAccountPath: ./service-accounts/mart-service-account-name.json\n sslCertPath: ./certs/mart-cert-name.pem\n sslKeyPath: ./certs/mart-key-name.key\n\n metrics:\n serviceAccountPath: ./service-accounts/metrics-service-account-name.json\n\n logger:\n enabled: true\n ```\n\n ### Example\n\n The following example shows a completed overrides file with example property values\n added: \n\n ```actionscript-3\n gcpProjectID: hybrid-project\n k8sClusterName: apigee-hybrid\n org: hybrid-org\n\n envs:\n - name: test\n hostAlias: \"*\"\n sslCertPath: ./certs/keystore.pem\n sslKeyPath: ./certs/keystore.key\n serviceAccountPaths:\n synchronizer: ./service-accounts/hybrid-project-apigee-synchronizer.json\n udca: ./service-accounts/hybrid-project-apigee-udca.json\n\n mart:\n hostAlias: \"mart.apigee-hybrid-docs.net\"\n serviceAccountPath: ./service-accounts/hybrid-project-apigee-mart.json\n sslCertPath: ./certs/fullchain.pem\n sslKeyPath: ./certs/privkey.key\n\n metrics:\n serviceAccountPath: ./service-accounts/hybrid-project-apigee-metrics.json\n\n logger:\n enabled: true\n ```\n5. When your finished, save the file.\n\n\nThe following table describes each of the property values that you must provide in the\noverrides file.\n\nSummary\n-------\n\n\nThe configuration file tells Kubernetes how to deploy the hybrid components to\na cluster. Next, you will apply this configuration to your cluster.\n[1](/apigee/docs/hybrid/v1.1/install-create-cluster-aks) [2](/apigee/docs/hybrid/v1.1/install-download-install-aks) [3](/apigee/docs/hybrid/v1.1/install-copy-overrides-aks) [(NEXT) Step 4: Install hybrid runtime](/apigee/docs/hybrid/v1.1/install-apply-hybrid-aks)\n\n\u003cbr /\u003e"]]
