El instalador de Apigee hybrid usa valores predeterminados para muchos ajustes. Sin embargo, hay algunos ajustes que no tienen valores predeterminados. Debe proporcionar valores para estos ajustes, tal como se explica a continuación.
Asegúrate de que estás en el directorio hybrid-base-directory/hybrid-files.
Copia el archivo overrides-small.yaml del directorio $APIGEECTL_HOME/examples en el directorio overrides:
Este archivo de ejemplo proporciona una configuración básica para una instalación de tiempo de ejecución híbrida con un tamaño reducido, una configuración adecuada para tu primera instalación.
cd en el directorio overrides:
cd overrides
Abre overrides.yaml y añade los valores de propiedad obligatorios, que se muestran a continuación. A continuación, se ofrece una descripción detallada de cada propiedad:
Sintaxis
El archivo overrides.yaml tiene la siguiente estructura y sintaxis.
Los valores de red, bold italics son
valores de propiedad que debe proporcionar:
(Obligatorio) En la guía de inicio rápido, usa el carácter comodín "*".
Solo se recomienda usar *
para una instalación de prueba cuando se utilicen credenciales TLS autofirmadas.
Más adelante, cuando desarrolles configuraciones híbridas de Apigee más complejas, como la creación de varios entornos, tendrás que usar un nombre de dominio cualificado para este valor.
test-cert-name test-key-name
Introduce el nombre de los archivos de clave y certificado TLS autofirmados que has generado anteriormente en el paso
Crear credenciales TLS para la pasarela de tiempo de ejecución. Estos archivos deben estar en el directorio base_directory/hybrid-files/certs. Por ejemplo:
Nombre de DNS cualificado del endpoint del servidor MART. Este nombre debe coincidir con el nombre común (CN) usado en el certificado TLS autorizado necesario para esta configuración. Por ejemplo:
mart.mydomain.com
mart-service-account-name
El nombre del archivo de clave de cuenta de servicio de mart que has generado con la herramienta create-service-account.
mart-cert-name mart-key-name
Introduce el nombre de los archivos de clave y certificado TLS autorizados que has generado anteriormente en el paso Crear credenciales TLS para la pasarela MART.
Estos archivos deben estar en el directorio base_directory/hybrid-files/certs. Por ejemplo:
El archivo de configuración indica a Kubernetes cómo desplegar los componentes híbridos en un clúster. A continuación, aplicarás esta configuración a tu clúster.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-11 (UTC)."],[[["\u003cp\u003eThis documentation version 1.1 is end of life, and users should upgrade to a newer version, as detailed in the "Supported versions" section.\u003c/p\u003e\n"],["\u003cp\u003eThe Apigee hybrid installer requires users to provide values for certain settings, which are configured in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eoverrides.yaml\u003c/code\u003e file, which is copied from \u003ccode\u003eoverrides-small.yaml\u003c/code\u003e, needs to be modified with property values including \u003ccode\u003egcpProjectID\u003c/code\u003e, \u003ccode\u003ek8sClusterName\u003c/code\u003e, \u003ccode\u003eorg\u003c/code\u003e, and environment details.\u003c/p\u003e\n"],["\u003cp\u003eLogging must be disabled in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file by setting \u003ccode\u003elogger:enabled:false\u003c/code\u003e since logging is already provided by default within the Google Kubernetes Engine (GKE).\u003c/p\u003e\n"],["\u003cp\u003eThe configuration will utilize various service accounts, TLS credentials, and aliases, all of which must be properly referenced within the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file, with their paths being properly stated.\u003c/p\u003e\n"]]],[],null,["# Step 3: Configure the GKE 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.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.yaml` and add the required property values, shown below. A detailed description of each property is also provided below: **NOTE:** Be sure to disable logging in the overrides file by setting `logger:enabled:false`. Logging is provided by default as part of GKE. \n\n ### Syntax\n\n The `overrides.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: 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: false\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: false\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) [2](/apigee/docs/hybrid/v1.1/install-download-install) [3](/apigee/docs/hybrid/v1.1/install-copy-overrides) [(NEXT) Step 4: Install hybrid runtime](/apigee/docs/hybrid/v1.1/install-apply-hybrid)\n\n\u003cbr /\u003e"]]
