El instalador híbrido de Apigee usa los valores predeterminados para muchos parámetros de configuración. Sin embargo, hay algunos parámetros de configuración que no tienen valores predeterminados. Debes proporcionar valores para estos parámetros de configuración, 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 a tu directorio overrides:
Este archivo de ejemplo proporciona una configuración básica para una instalación de entorno de ejecución híbrido de huella pequeña, una configuración adecuada para tu primera instalación.
cd en el directorio overrides:
cd overrides
Abre overrides.yaml y agrega los valores de propiedad necesarios que se muestran a continuación. También se proporciona una descripción detallada de cada propiedad a continuación:
Sintaxis
El archivo overrides.yaml tiene la siguiente estructura y sintaxis.
Los valores en red, bold italics son los valores de propiedad que debes proporcionar:
(Obligatorio) Para la guía de inicio rápido, usa el carácter comodín “*”.
El uso de * solo se recomienda para una instalación de prueba cuando se usan credenciales TLS autofirmadas.
Más adelante, a medida que desarrolles configuraciones más complejas de Apigee Hybrid, como la creación de varios entornos, deberás usar un nombre de dominio calificado para este valor.
Un nombre de DNS calificado para el extremo del servidor de MART. Este nombre debe coincidir con el nombre común (CN) que se usa en el certificado TLS autorizado que se requiere para esta configuración. Por ejemplo, mart.mydomain.com
mart-service-account-name
El nombre del archivo de claves de la cuenta de servicio de mart que generaste con la herramienta create-service-account.
mart-cert-name mart-key-name
Ingresa el nombre de los archivos de certificados y de la clave de TLS autorizados que generaste en el paso Crea credenciales TLS para la puerta de enlace MART.
Estos archivos deben estar ubicados en el directorio base_directory/hybrid-files/certs. Por ejemplo:
El archivo de configuración le indica a Kubernetes cómo implementar los componentes híbridos en un clúster. A continuación, aplicarás esta configuración a tu clúster.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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"]]
