O instalador híbrido da Apigee usa padrões para muitas configurações. No entanto, existem algumas configurações
sem padrões. É preciso fornecer valores para essas configurações, conforme explicado a seguir.
Verifique se você está no diretório hybrid-base-directory/hybrid-files.
Copie o arquivo overrides-small.yaml do diretório $APIGEECTL_HOME/examples para
seu diretório overrides:
Este arquivo de exemplo fornece uma configuração básica para uma instalação do ambiente de execução híbrido de abrangência pequena,
uma configuração adequada à sua primeira instalação.
cd no diretório overrides:
cd overrides
Abra overrides.yaml e adicione os valores de propriedade obrigatórios, mostrados abaixo. Uma descrição
detalhada de cada propriedade também é fornecida abaixo:
Sintaxe
O arquivo overrides.yaml tem a seguinte estrutura e sintaxe.
Os valores em red, bold italics são
valores de propriedade que você precisa fornecer.
gcpProjectID:project-idk8sClusterName:cluster-nameorg:org-nameenvs:-name:environment-name# The same name of the env you created in the UIhostAlias:test-host-aliassslCertPath:./certs/test-cert-name.pemsslKeyPath:./certs/test-key-name.keyserviceAccountPaths:synchronizer:./service-accounts/synchronizer-service-account-name.jsonudca:./service-accounts/udca-service-account-name.jsoncassandra:hostNetwork:truednsPolicy:ClusterFirstWithHostNetingress:runtime:loadBalancerIP:virtual_IP_runtimemart:loadBalancerIP:virtual_IP_martmart:hostAlias:mart-host-aliasserviceAccountPath:./service-accounts/mart-service-account-name.jsonsslCertPath:./certs/mart-cert-name.pemsslKeyPath:./certs/mart-key-name.keymetrics:serviceAccountPath:./service-accounts/metrics-service-account-name.jsonlogger:enabled:false
Exemplo
No exemplo a seguir, mostramos um arquivo de modificações concluído com valores de propriedade de exemplo
adicionados:
(Obrigatório) No início rápido, use o caractere curinga "*".
O uso do *
é recomendado apenas para uma instalação de avaliação ao usar credenciais TLS autoassinados.
Depois, ao desenvolver configurações híbridas
mais complexas da Apigee, como a criação de vários ambientes, você
precisará usar um nome de domínio qualificado para esse valor.
test-cert-name test-key-name
Digite o nome da chave TLS assinada e os arquivos de certificado gerados anteriormente na etapa
Criar credenciais de TLS para o gateway de ambiente de execução. Esses arquivos precisam estar localizados
no diretório base_directory/hybrid-files/certs. Exemplo:
Para usar o balanceamento de carga integrado do GKE On-Prem, é necessário fornecer
IPs virtuais para LoadBalancers nos serviços de MART e ambiente de execução híbridos.
O GKE On-Prem configura automaticamente o IP virtual no balanceador
de carga F5 BIG-IP. Para mais informações, consulte
Como configurar
o balanceador de carga para GKE On-Prem.
mart-host-alias
Um nome DNS qualificado para o endpoint do servidor MART. Esse nome precisa corresponder
ao nome comum (CN, na sigla em inglês) usado no certificado TLS autorizado necessário para
essa configuração. Por exemplo,
mart.mydomain.com
mart-service-account-name
O nome do arquivo de chave da conta de serviço de Mart que você gerou com a
ferramenta create-service-account.
mart-cert-name mart-key-name
Digite o nome da chave TLS e dos arquivos de certificado autorizados que você gerou anteriormente na etapa
Criar credenciais TLS para o gateway do MART.
Esses arquivos precisam estar localizados
no diretório base_directory/hybrid-files/certs. Exemplo:
O arquivo de configuração informa ao Kubernetes como implantar os componentes híbridos em
um cluster. Em seguida, você aplicará essa configuração ao cluster.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eThis documentation version 1.1 is end-of-life, and users are advised to upgrade to a newer version for continued support.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eoverrides.yaml\u003c/code\u003e file is used to configure the Apigee hybrid installation, and it requires specific property values to be set.\u003c/p\u003e\n"],["\u003cp\u003eYou must copy the example configuration file \u003ccode\u003eoverrides-small.yaml\u003c/code\u003e to the overrides directory and modify it accordingly to reflect your specific project requirements.\u003c/p\u003e\n"],["\u003cp\u003eLogging should be disabled in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file by setting \u003ccode\u003elogger:enabled:false\u003c/code\u003e because logging is provided by default with GKE on-prem.\u003c/p\u003e\n"],["\u003cp\u003eSpecific values such as project ID, cluster name, organization name, and various service account paths and TLS credentials must be provided in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file.\u003c/p\u003e\n"]]],[],null,["# Step 3: Configure the GKE on-prem user 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 by setting `logger:enabled:false` in the overrides file. Logging is provided by default as part of GKE on-prem. \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 ```gdscript\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 cassandra:\n hostNetwork: true\n dnsPolicy: ClusterFirstWithHostNet\n\n ingress:\n runtime:\n loadBalancerIP: virtual_IP_runtime\n mart:\n loadBalancerIP: virtual_IP_mart\n\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 ```gdscript\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 cassandra:\n hostNetwork: true\n dnsPolicy: ClusterFirstWithHostNet\n\n ingress:\n runtime:\n loadBalancerIP: 21.0.124.13\n mart:\n loadBalancerIP: 21.0.124.14\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-anthos) [2](/apigee/docs/hybrid/v1.1/install-download-install-anthos) [3](/apigee/docs/hybrid/v1.1/install-copy-overrides-anthos) [(NEXT) Step 4: Install hybrid runtime](/apigee/docs/hybrid/v1.1/install-apply-hybrid-anthos)\n\n\u003cbr /\u003e"]]
