Referência da propriedade de configuração

Version 1.14 (coming soon)

Versões com suporte:

• v1.13 (mais recente)                        
• v1.12                         
• v1.11
• Lista de versões com suporte

Versões sem suporte:

• v1.10                                      
• v1.9
• v1.8                                         
• v1.7
• v1.6
• v1.5
• v1.4
• v1.3
• v1.2
• v1.1

Nesta seção, estão listadas todas as propriedades de configuração que podem ser usadas para personalizar o plano do ambiente de execução da implantação do híbrido da Apigee.

Observação: para instruções sobre como adicionar anotações personalizadas, que são mapas de chave-valor usados para anexar metadados a pods do Kubernetes híbridos da Apigee, consulte Anotações personalizadas.

Sobre as propriedades de configuração

É possível modificar muitas propriedades de configuração, se necessário, adicionando-as a HYBRID_ROOT_DIR/overrides.yaml.

Dica: a Apigee fornece um pequeno conjunto de configurações de amostra que você pode usar para mais orientações. Consulte Exemplo de arquivo de modificações.

Por exemplo, para alterar os números mínimo e máximo da réplica para o serviço MART, adicione esta estrofe para overrides.yaml:

mart:
    replicaCountMin: 3
    replicaCountMax: 6

Também é possível encontrar essas propriedades de configuração e as configurações padrão em HYBRID_ROOT_INSTALL/1.0.0/values.yaml

Para ver mais informações, consulte Manage runtime plane components.

Além disso, se você estiver configurando uma implantação fora do Google Cloud, consulte a Etapa 6: criar a substituição para informações sobre como definir essas propriedades.

Filtrar esta página

Para filtrar as propriedades exibidas nesta página, selecione Básico (propriedades mais comuns) ou Avançado (propriedades que raramente precisam de alterações):

Exibição  Todos Básico Avançado  propriedades de configuração nesta página.

Cuidado: não altere propriedades avançadas sem testá-las primeiro em ambientes inferiores e verificá-las no ambiente operacional específico.

Propriedades de nível superior

A tabela a seguir descreve as propriedades de nível superior no arquivo overrides.yaml. Estas são propriedades que não pertencem a outro objeto e se aplicam no nível da organização ou do ambiente:

Propriedade	Tipo	Descrição
axHashSalt	Avançado	Introduzida na versão: 1.3.0 Valor padrão: o nome da sua organização Opcional O nome de um secret do Kubernetes que contém um sal usado ao calcular hashes para ofuscar os dados do usuário antes de enviá-los às análises da Apigee. Se você não especificar um valor de sal, iloveapis123 será usado por padrão. Crie o secret com o valor de sal como entrada. É possível usar o mesmo sal em vários clusters para garantir resultados de hash consistentes entre eles. A Apigee usa SHA512 a fim de gerar hash do valor original antes de enviar dados do plano do ambiente de execução para o plano de controle. Consulte: Ofuscar dados do usuário para análise.
contractProvider	Avançado	Introduzida na versão: 1.0.0 Valor padrão: https://apigee.googleapis.com Define o caminho da API para todas as APIs na instalação. Obrigatório se a instalação híbrida estiver usando Residência de dados no seguinte formato: contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com Em que CONTROL_PLANE_LOCATION é o local onde os dados do plano de controle, como pacotes de proxy, são armazenados. Para uma lista, consulte Regiões disponíveis do plano de controle da API Apigee. Por exemplo: contractProvider: https://us-apigee.googleapis.com
gcpProjectID	Avançado	Deprecated: Para a v1.2.0 ou posterior, use gcp.projectID. Introduzida na versão: 1.0.0 Valor padrão: nenhum Obrigatório ID do seu projeto do Google Cloud. Funciona com k8sClusterName (obsoleto) e gcpRegion (obsoleto) para identificar o projeto e determinar para onde apigee-logger e apigee-metrics enviam dados.
gcpRegion	Avançado	Deprecated: Para a v1.2.0 ou posterior, use gcp.region. Introduzida na versão: 1.0.0 Valor padrão: us-central1 Obrigatório A região ou zona mais próxima do Google Cloud do cluster do Kubernetes. Funciona com gcpProjectID (obsoleto) e k8sClusterName (obsoleto) para identificar o projeto e determinar para onde os apigee-logger e apigee-metrics enviam dados.
hub	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum O URL de um repositório de contêineres de imagens particulares usado para extrair imagens de todos os componentes da Apigee de um repositório particular. hub fornece um caminho padrão para todos os componentes da Apigee híbrida. Se você estiver usando um repositório particular, use hub para definir o URL do repositório para todos os componentes, em vez de usar a propriedade image.url individual para cada componente. Configure URLs individuais somente se você estiver usando um repositório separado para um componente específico. O caminho da imagem para cada componente será o valor de hub mais o nome da imagem e a tag do componente. Por exemplo, se o valor de hub for private-docker-host.example.com, os componentes individuais vão resolver automaticamente o caminho da imagem: hub: private-docker-host.example.com como: ## an example of internal component vs 3rd party containers: - name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.14.0 imagePullPolicy: IfNotPresent containers: - name: apigee-ingressgateway image: private-docker-host.example.com/apigee-asm-ingress:1.18.7-asm.4-distroless imagePullPolicy: IfNotPresent Os outros componentes vão seguir um padrão semelhante. Use apigee-pull-push --list para ver o URL do repositório atual para todos os componentes. Usar um repositório de imagens particular com a Apigee híbrida. É possível substituir o URL da imagem por componentes individualmente com as seguintes propriedades: ao.image.url apigeeIngressGateway.image.url cassandra.image.url cassandra.auth.image.url cassandra.backup.image.url cassandra.restore.image.url connectAgent.image.url ingressGateways[].image.url istiod.image.url kubeRBACProxy.image.url logger.image.url mart.image.url metrics.adapter.image.url metrics.prometheus.image.url metrics.sdSidecar.image.url mintTaskScheduler.image.url redis.image.url redis.envoy.image.url runtime.image.url synchronizer.image.url udca.image.url udca.fluentd.image.url watcher.image.url
imagePullSecrets.name	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Nome do secret do Kubernetes configurado como tipo de registro do Docker; usado para extrair imagens de um repositório privado.
instanceID	Básico	Introduzida na versão: 1.3.0 Valor padrão: Nenhum Obrigatório Um identificador exclusivo da instalação. Uma string exclusiva para identificar a instância. Pode ser qualquer combinação de letras e números, com até 63 caracteres. É possível criar várias organizações no mesmo cluster, mas o instanceID precisa ser o mesmo para todas as organizações que estiverem no mesmo cluster do Kubernetes. No caso de instalações multirregionais, cada região requer o próprio cluster. Os clusters individuais não abrangem regiões.
k8sClusterName	Avançado	Deprecated: Para v1.2.0 e posterior, use k8sCluster.name e k8sCluster.region. Introduzida na versão: 1.0.0 Valor padrão: Nenhum Nome do cluster do Kubernetes (K8S) em que seu projeto híbrido está sendo executado. Funciona com gcpProjectID (obsoleto) e gcpRegion (obsoleto) para identificar o projeto e determinar para onde apigee-logger e apigee-metrics enviam dados.
kmsEncryptionKey	Avançado	Introduzida na versão: 1.0.0 Valor padrão: defaults.org.kmsEncryptionKey Opcional. Use apenas um valor de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret. Caminho do sistema de arquivos local para a chave de criptografia dos dados do Apigee KMS.
kmsEncryptionPath	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kmsEncryptionKey, kmsEncryptionKey ou kmsEncryptionKey. O caminho para um arquivo que contém uma chave de criptografia codificada em base64. Consulte Criptografia de dados.
kmsEncryptionSecret.key	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret. A chave de uma chave secreta do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
kmsEncryptionSecret.name	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret. O nome de um secret do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
kvmEncryptionKey	Avançado	Introduzida na versão: 1.0.0 Valor padrão: defaults.org.kmsEncryptionKey Opcional. Use apenas um valor de kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret. Caminho do sistema de arquivos local para a chave de criptografia dos dados do Apigee KMS.
kvmEncryptionPath	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kvmEncryptionKey, kvmEncryptionKey ou kvmEncryptionKey. O caminho para um arquivo que contém uma chave de criptografia codificada em base64. Consulte Criptografia de dados.
kvmEncryptionSecret.key	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret. A chave de uma chave secreta do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
kvmEncryptionSecret.name	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Opcional. Use apenas um valor de kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret. O nome de um secret do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
multiOrgCluster	Avançado	Introduzida na versão: 1.10.0 Valor padrão: false Para clusters de várias organizações, essa propriedade permite que as métricas da organização sejam exportadas para o projeto listado na propriedade gcp.projectID. Aplique essa configuração ao arquivo de substituição para cada organização em um cluster de várias organizações. Para mais informações, consulte Como adicionar várias organizações híbridas a um cluster.
namespace	Básico	Introduzida na versão: 1.0.0 Valor padrão: apigee O namespace do cluster do Kubernetes em que os componentes da Apigee serão instalados.
org	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório A organização com recurso híbrido que foi provisionada para você pela Apigee durante a instalação híbrida. Uma organização é o contêiner de nível superior no Apigee. Ela contém todos os proxies de API e recursos relacionados. Se o valor estiver vazio, será necessário atualizá-lo para limpar o nome da organização depois de criá-lo.
orgScopedUDCA	Avançado	Introduzida na versão: 1.8.0 Valor padrão: true Ativa o serviço Universal Data Collection Agent (UDCA) no nível da organização, que extrai dados de análise, monetização e depuração (trace) e o envia para a plataforma unificada do Analytics (UAP, na sigla em inglês) que reside no plano de controle. O UDCA com escopo da organização usa uma única conta de serviço do Google para todos os ambientes da Apigee. A conta de serviço precisa ter o papel de agente de análise da Apigee (roles/apigee.analyticsAgent). Especifique o caminho para o arquivo de chave da conta de serviço com a propriedade udca.serviceAccountPath ou forneça a chave em um secret do Kubernetes com a propriedade udca.serviceAccountRef no arquivo de configuração overrides.yaml. Se você preferir usar um agente UDCA separado para cada ambiente, defina orgScopedUDCA: false e defina os valores de envs[].serviceAccountPaths.udca e envs[].serviceAccountSecretRefs.udca. Confira também: udca.
revision	Avançado	Introduzida na versão: 1.0.0 Valor padrão: "1140" (sua versão da Apigee híbrida sem pontos. Por exemplo, para a versão 1.12.0, o valor padrão é "1120". O híbrido da Apigee oferece suporte a atualizações graduais do Kubernetes, o que permite atualizações de implantação com tempo de inatividade zero por meio da atualização incremental de instâncias de pod com novas instâncias. Ao atualizar determinadas modificações de YAML que resultam em alteração PodTemplateSpec do Kubernetes, a propriedade de modificação revision também precisa ser alterada no override.yaml do cliente. Isso é necessário para que o controlador subjacente ApigeeDeployment (AD) do Kubernetes faça uma atualização gradual e segura da versão anterior para a nova versão. É possível usar qualquer valor de texto em minúsculas, por exemplo: blue, a, 1.0.0 Observação: revision pode aceitar somente caracteres alfa minúsculos, números e pontuação. Quando a propriedade revision for alterada e aplicada, ocorrerá uma atualização contínua para todos os componentes As alterações nas propriedades dos objetos a seguir exigem uma atualização de revision: nodeSelector envs imagePullSecrets gcpProjectID k8sClusterName contractProvider org Para mais informações, consulte Atualizações graduais.
serviceAccountSecretProviderClass	Avançado	Introduzida na versão: 1.12.0 Valor padrão: Nenhum O nome da classe do provedor de secrets específica da organização (SecretProviderClass) usada para armazenar as chaves de contas de serviço no Vault. Consulte Como armazenar chaves de conta de serviço no Hashicorp Vault.
validateOrg	Avançado	Introduzida na versão: 1.8.0 Valor padrão: true Permite a validação restrita da vinculação entre a organização da Apigee e os projetos do Google Cloud e verifica a existência de grupos de ambientes. Consulte também org
validateServiceAccounts	Avançado	Introduzida na versão: 1.0.0 Valor padrão: true Permite a validação rigorosa das permissões da conta de serviço. Isso usa o método da API Cloud Resource Manager testIamPermissions para verificar se a conta de serviço fornecida tem as permissões necessárias. No caso de contas de serviço de uma organização da Apigee, a verificação do ID do projeto é aquela mapeada para a organização. Para Métricas e Logger, o projeto verificado é baseado na configuração gcpProjectID overrides.yaml. Consulte também gcpProjectID

ao

Os operadores da Apigee (AO, na sigla em inglês) criam e atualizam recursos de baixo nível do Kubernetes e do Istio necessários para implantar e manter um componente. Por exemplo, o controlador executa o lançamento dos processadores de mensagens.

Observação: na versão 1.2.0, os operadores de Apigee substituem o Apigee Deployment Admissionhook (ADAH) e o Apigee Deployment Controller (ADC).

A tabela a seguir descreve as propriedades do objeto ao apigee-operators:

Propriedade	Tipo	Descrição
ao.args.disableIstioConfigInAPIServer	Avançado	Introduzida na versão: 1.8.0 Valor padrão: true Impede que a Apigee forneça configuração ao Cloud Service Mesh instalado pelo cliente. Defina como true para instalações híbridas usando o gateway de entrada da Apigee. Defina como false para instalações híbridas que usam o Cloud Service Mesh (versões híbridas 1.8 e anteriores da Apigee).
ao.args.disableManagedClusterRoles	Avançado	Introduzida na versão: 1.10.0 Valor padrão: true Quando true (padrão), a Apigee híbrida não gerencia o Kubernetes ClusterRole e ClursterRoleBinding diretamente. Se você tiver um processo que exija o gerenciamento desses recursos, ele precisará ser executado por um usuário com as permissões corretas.
ao.image.pullPolicy	Avançado	Introduzida na versão: 1.2.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
ao.image.tag	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
ao.image.url	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
ao.resources.limits.cpu	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 250m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
ao.resources.limits.memory	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 256Mi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
ao.resources.requests.cpu	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 250m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
ao.resources.requests.memory	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 256Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
ao.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
ao.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
ao.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
ao.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
ao.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

apigeeIngressGateway

Configura o gateway de entrada da Apigee para a Apigee híbrida. Use as propriedades apigeeIngressGateway para aplicar a configuração comum a todas as instâncias do gateway de entrada da Apigee.

Consulte ingressGateways para configurar instâncias individuais de maneira exclusiva.

Aplique alterações às propriedades apigeeIngressGateway com o gráfico apigee-org.

A tabela a seguir descreve as propriedades do objeto apigeeIngressGateway:

Propriedade	Tipo	Descrição
apigeeIngressGateway.image.pullPolicy	Avançado	Introduzido na versão: 1.11.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
apigeeIngressGateway.image.tag	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 1.18.7-asm.4-distroless O rótulo da versão da imagem do Docker desse serviço.
apigeeIngressGateway.image.url	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
apigeeIngressGateway.nodeSelector.key	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Obrigatório Chave do identificador do seletor de nós usada para visar nós dedicados do Kubernetes para serviços de gateway de entrada. Consulte Como configurar pools de nós dedicados.
apigeeIngressGateway.nodeSelector.value	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Valor opcional do rótulo do seletor de nós usado a fim de segmentar nós dedicados do Kubernetes para serviços de gateway de entrada e substituir as configurações nodeSelector.apigeeData. Consulte nodeSelector.
apigeeIngressGateway.replicaCountMax	Básico	Introduzido na versão: 1.11.0 Valor padrão: 4 O número máximo de pods que podem ser adicionados de forma automática ao gateway de entrada disponível para escalonamento automático.
apigeeIngressGateway.replicaCountMin	Básico	Introduzido na versão: 1.11.0 Valor padrão: 2 O número mínimo de pods para o gateway de entrada disponível para escalonamento automático.
apigeeIngressGateway.targetCPUUtilizationPercentage	Avançado	Introduzido na versão: 1.10.5, 1.11.2, 1.12.1 Valor padrão: 75 O limite de uso da CPU para escalonar o número de pods no ReplicaSet, como uma porcentagem do total de recursos de CPU disponíveis. Quando o uso da CPU ultrapassar esse valor, o híbrido aumentará gradualmente o número de pods no ReplicaSet, até apigeeIngressGateway.replicaCountMax. Para mais informações sobre escalonamento no Kubernetes, consulte Escalonamento automático horizontal de pods na documentação do Kubernetes.
apigeeIngressGateway.tolerations.effect	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
apigeeIngressGateway.tolerations.key	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
apigeeIngressGateway.tolerations.operator	Avançado	Introduzido na versão: 1.11.0 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
apigeeIngressGateway.tolerations.tolerationSeconds	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
apigeeIngressGateway.tolerations.value	Avançado	Introduzido na versão: 1.11.0 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

cassandra

Define o serviço híbrido que gerencia o repositório de dados de ambiente de execução. Esse repositório armazena configurações de aplicativos, contadores de cota distribuídos, chaves de API e tokens OAuth para aplicativos em execução no gateway.

Para mais informações, consulte a configuração StorageClass.

A tabela a seguir descreve as propriedades do objeto cassandra:

Propriedade	Tipo	Descrição
cassandra.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
cassandra.auth.admin.password	Básico	Introduzida na versão: 1.0.0 Valor padrão: iloveapis123 Obrigatório Senha para o administrador do Cassandra. O usuário administrador é usado para qualquer atividade administrativa realizada no cluster do Cassandra, como backup e restauração.
cassandra.auth.ddl.password	Básico	Introduzida na versão: 1.0.0 Valor padrão: iloveapis123 Obrigatório Senha para o usuário da linguagem de definição de dados (DDL, na sigla em inglês) do Cassandra. Usado por MART para qualquer tarefa de definição de dados, como criação, atualização e exclusão de keyspace.
cassandra.auth.default.password	Básico	Introduzida na versão: 1.0.0 Valor padrão: iloveapis123 Obrigatório A senha do usuário padrão do Cassandra criada quando o Authentication está ativado. Essa senha precisa ser redefinida ao configurar a autenticação do Cassandra. Consulte Como configurar o TLS para o Cassandra.
cassandra.auth.dml.password	Básico	Introduzida na versão: 1.0.0 Valor padrão: iloveapis123 Obrigatório Senha para o usuário da linguagem de manipulação de dados (DML, na sigla em inglês) do Cassandra. O usuário DML é usado pela comunicação do cliente para ler e gravar dados no Cassandra.
cassandra.auth.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
cassandra.auth.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
cassandra.auth.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
cassandra.auth.jmx.password	Básico	Introduzida na versão: 1.4.0 Valor padrão: iloveapis123 Obrigatório Senha do usuário das operações do Cassandra JMX. Usado para autenticar e se comunicar com a interface do Cassandra JMX.
cassandra.auth.jmx.username	Básico	Introduzida na versão: 1.4.0 Valor padrão: jmxuser Obrigatório Senha do usuário das operações do Cassandra JMX. Usado para autenticar e se comunicar com a interface do Cassandra JMX.
cassandra.auth.jolokia.password	Básico	Introduzida na versão: 1.4.0 Valor padrão: iloveapis123 Obrigatório Senha do usuário das operações do Cassandra Jolokia JMX. Usado para autenticar e se comunicar com a API Cassandra JMX.
cassandra.auth.jolokia.username	Básico	Introduzida na versão: 1.4.0 Valor padrão: apigee Obrigatório Senha do usuário das operações do Cassandra Jolokia JMX. Usado para autenticar e se comunicar com a API Cassandra JMX.
cassandra.auth.secret	Básico	Introduzida na versão: 1.3.3 Valor padrão: Nenhum O nome do arquivo armazenado em um secret do Kubernetes que contém os usuários e as senhas do Cassandra. É possível criar a chave secreta usando as seguintes instruções: Criar a chave secreta. Consulte também: Como armazenar dados em um secret do Kubernetes Secrets na documentação do Kubernetes Como criar um secret usando a kubectl na documentação do Kubernetes
cassandra.auth.secretProviderClass	Avançado	Introduzida na versão: 1.10.3 Valor padrão: Nenhum A política de armazenamento de secrets do Cassandra. Quando definida, ela precisa corresponder ao SecretProviderClass que faz referência ao provedor de secrets externos, como o Hashicorp Vault. Quando não definida, a Apigee híbrida usa os nomes de usuário e as senhas armazenados no seguinte: cassandra.auth.admin.password cassandra.auth.ddl.password cassandra.auth.default.password cassandra.auth.dml.password cassandra.auth.jmx.password cassandra.auth.jmx.username cassandra.auth.jolokia.password cassandra.auth.jolokia.username ou o secret do Kubernetes armazenado em: cassandra.auth.secret Consulte Como armazenar secrets do Cassandra no Hashicorp Vault para as instruções de criação da política.
cassandra.backup.cloudProvider	Avançado	Introduzida na versão: 1.0.0 Valor padrão: GCP O nome de um provedor de backup. Valores aceitos: GCP, HYBRID e CSI. Definir o valor de como: GCP para armazenar arquivos de backup no Google Cloud Storage. HYBRID para armazenar arquivos de backup em um servidor SSH remoto. CSI (recomendado) para usar os snapshots de volume da CSI do Kubernetes para backup. Para informações sobre backup e restauração de CSI para plataformas de nuvem, como Google Cloud, AWS e Azure, consulte Backup e restauração de CSI.
cassandra.backup.dbStorageBucket	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como GCP. O nome de um bucket do Google Cloud Storage que será usado para armazenar os arquivos de backup. Consulte Como criar buckets. caso precise criar um. Observação: a partir da versão híbrida 1.13, o nome do bucket não precisa ser com o prefixo gs://. A compatibilidade com esse prefixo foi descontinuada e será removida em versões futuras.
cassandra.backup.enabled	Avançado	Introduzida na versão: 1.0.0 Valor padrão: false O backup de dados não está ativado por padrão. Para ativar, defina como true. Consulte Backup e recuperação do Cassandra.
cassandra.backup.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
cassandra.backup.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
cassandra.backup.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
cassandra.backup.keyfile	Avançado	Introduzida na versão: 1.3.0 Valor padrão: Nenhum Obrigatório se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como HYBRID. O caminho no sistema de arquivos local para o arquivo de chave privada SSH.
cassandra.backup.schedule	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 2 * * * O agendamento do cron job de backup. Consulte Backup e recuperação do Cassandra.
cassandra.backup.server	Avançado	Introduzida na versão: 1.3.0 Valor padrão: Nenhum Obrigatório se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como HYBRID. O endereço IP do servidor de backup SSH remoto.
cassandra.backup.serviceAccountPath	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Caminho para um arquivo de chave conta de serviço do Google que tenha o papel de Administrador de objetos do Storage (roles/storage.objectAdmin). Essa conta de serviço do Google será usada para fazer upload de arquivos de backup para um cassandra.backup.dbStorageBucket especificado. Se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como GCP, será necessário um dos itens a seguir para garantir que a Apigee híbrida possa acessar o bucket do Google Cloud Storage para fazer upload de arquivos de backup: cassandra.backup.serviceAccountPath especificado. cassandra.backup.serviceAccountRef especificado. Identidade da carga de trabalho para a Apigee híbrida no GKE configurada. Federação de identidade da carga de trabalho configurada para a Apigee híbrida no AKS ou EKS.
cassandra.backup.serviceAccountRef	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O nome de um secret do Kubernetes que armazena o conteúdo de um arquivo de chave de uma conta de serviço do Google com o papel de Administrador de objetos do Storage (roles/storage.objectAdmin). Esta conta de serviço do Google será usada para fazer upload de arquivos de backup para um cassandra.backup.dbStorageBucket Se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como GCP, será necessário um dos itens a seguir para garantir que a Apigee híbrida possa acessar o bucket do Google Cloud Storage para fazer upload de arquivos de backup: cassandra.backup.serviceAccountPath especificado. cassandra.backup.serviceAccountRef especificado. Identidade da carga de trabalho para a Apigee híbrida no GKE configurada. Federação de identidade da carga de trabalho configurada para a Apigee híbrida no AKS ou EKS.
cassandra.backup.storageDirectory	Avançado	Introduzida na versão: 1.3.0 Valor padrão: Nenhum Obrigatório se o backup estiver ativado e cassandra.backup.cloudProvider estiver definido como HYBRID. Pode ser um caminho absoluto ou relativo ao diretório inicial do usuário apigee. O nome do diretório de backup no servidor SSH de backup.
cassandra.clusterName	Básico	Introduzida na versão: 1.0.0 Valor padrão: apigeecluster Especifica o nome do cluster do Cassandra. Observação: para instalações multirregionais, o valor de clusterName precisa corresponder a todas as regiões.
cassandra.datacenter	Básico	Introduzida na versão: 1.0.0 Valor padrão: dc-1 Especifica o data center do nó do Cassandra.
cassandra.dnsPolicy	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum Observação: essa propriedade não é mais compatível com o Apigee híbrido v1.3. Quando você define hostNetwork como verdadeiro, a política de DNS é definida como ClusterFirstWithHostNet para você.
cassandra.externalSeedHost	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Nome do host ou IP de um nó do cluster do Cassandra. Se não for definido, o serviço local do Kubernetes será usado.
cassandra.heapNewSize	Básico	Introduzida na versão: 1.0.0 Valor padrão: 100M A quantidade de memória do sistema JVM alocada para objetos mais recentes, em megabytes.
cassandra.hostNetwork	Básico	Introduzida na versão: 1.1.1 Valor padrão: false Ativa o recurso hostNetwork do Kubernetes. A Apigee usa esse recurso em instalações multirregionais para se comunicar entre pods se o namespace de rede do pod não tiver conectividade entre clusters (os clusters estão sendo executados no "modo de rede de ilha"), que é o caso padrão em instalações que não são do GKE, incluindo o Google Distributed Cloud na VMware ou em bare metal, o GKE na AWS, o AKS, o EKS e o OpenShift. Defina cassandra.hostNetwork como false para instalações de região única e multirregionais com conectividade entre pods em clusters diferentes, como instalações do GKE. Defina cassandra.hostNetwork como true para instalações multirregionais sem comunicação entre pods em clusters diferentes, como Google Distributed Cloud no VMware ou bare metal, GKE em instalações da AWS, AKS, EKS e OpenShift. Consulte Implantação multirregional: pré-requisitos. Quando true, a política de DNS é definida automaticamente como ClusterFirstWithHostNet.
cassandra.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
cassandra.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
cassandra.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
cassandra.maxHeapSize	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 512M O limite máximo da memória do sistema JVM disponível para as operações do Cassandra em megabytes.
cassandra.multiRegionSeedHost	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Endereço IP de um cluster do Cassandra usado para expandir o cluster atual para uma nova região. Consulte Configurar o host de sugestão multirregional.
cassandra.nodeSelector.key	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços de dados do cassandra. Consulte Como configurar pools de nós dedicados.
cassandra.nodeSelector.value	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Valor do rótulo do seletor de nós opcional usado para segmentar nós dedicados do Kubernetes para serviços de dados cassandra e substituir as configurações de nodeSelector.apigeeData. Consulte nodeSelector.
cassandra.port	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 9042 Número da porta usado para se conectar ao Cassandra.
cassandra.rack	Básico	Introduzida na versão: 1.0.0 Valor padrão: ra-1 Especifica o rack do nó do Cassandra.
cassandra.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
cassandra.readinessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 O número de segundos após o início de um contêiner antes de uma sondagem de preparo.
cassandra.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 10 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
cassandra.readinessProbe.successThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de preparo seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
cassandra.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
cassandra.replicaCount	Básico	Introduzida na versão: 1.0.0 Valor padrão: 1 O Cassandra é um banco de dados replicado. Essa propriedade especifica o número de nós do Cassandra empregado como um StatefulSet. Observação: o valor padrão de 1 só é aceitável para instalações de demonstração ou de teste. Para instalações de produção, o valor de replicaCount precisa ser um múltiplo de 3. Para determinar o valor replicaCount desejado, considere o seguinte: Estime as demandas de tráfego dos proxies. Carregue o teste e faça previsões razoáveis de uso da CPU. É possível especificar valores replicaCount diferentes em regiões diferentes. Você pode expandir o replicaCount no futuro no arquivo de modificações.
cassandra.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
cassandra.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1Gi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
cassandra.restore.cloudProvider	Avançado	Introduzida na versão: 1.0.0 Valor padrão: GCP O nome de um provedor de restauração. Valores aceitos: GCP, HYBRID e CSI. Definir o valor de como: GCP para restaurar dados de um backup armazenado no Google Cloud Storage. HYBRID para restaurar dados de um backup armazenado em um servidor SSH remoto. CSI (recomendado) para utilizar snapshots de volume da CSI do Kubernetes para restauração. Para informações sobre backup e restauração de CSI para plataformas de nuvem, como Google Cloud, AWS e Azure, consulte Backup e restauração de CSI.
cassandra.restore.dbStorageBucket	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório se a restauração estiver ativada e o cassandra.restore.cloudProvider estiver definido como GCP. O nome de um bucket do Google Cloud Storage que armazena arquivos de backup para serem usados na restauração de dados. Observação: a partir da versão híbrida 1.13, o nome do bucket não precisa ser com o prefixo gs://. A compatibilidade com esse prefixo foi descontinuada e será removida em versões futuras.
cassandra.restore.enabled	Avançado	Introduzida na versão: 1.0.0 Valor padrão: false A restauração de dados não está ativada por padrão. Para ativar, defina como true. Consulte Backup e recuperação do Cassandra.
cassandra.restore.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
cassandra.restore.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
cassandra.restore.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
cassandra.restore.serviceAccountPath	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Caminho para um arquivo de chave da conta de serviço do Google que tenha o papel de Administrador de objetos do Storage (roles/storage.objectAdmin). Essa conta de serviço do Google será usada para fazer o download de arquivos de backup de um cassandra.restore.dbStorageBucket especificado. Se a restauração estiver ativada e cassandra.restore.cloudProvider estiver definido como GCP, uma das opções a seguir é necessária para garantir que a Apigee híbrida possa acessar o bucket do Google Cloud Storage para fazer o download dos arquivos de backup para restauração: cassandra.restore.serviceAccountPath especificado. cassandra.restore.serviceAccountRef especificado. Identidade da carga de trabalho para a Apigee híbrida no GKE configurada. Federação de identidade da carga de trabalho configurada para a Apigee híbrida no AKS ou EKS.
cassandra.restore.serviceAccountRef	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O nome de um secret do Kubernetes que armazena o conteúdo de um arquivo de chave de uma conta de serviço do Google com o papel de Administrador de objetos do Storage (roles/storage.objectAdmin). Essa conta de serviço do Google será usada para fazer o download de arquivos de backup de um cassandra.restore.dbStorageBucket especificado. Se a restauração estiver ativada e cassandra.restore.cloudProvider estiver definido como GCP, uma das opções a seguir é necessária para garantir que a Apigee híbrida possa acessar o bucket do Google Cloud Storage para fazer o download dos arquivos de backup para restauração: cassandra.restore.serviceAccountPath especificado. cassandra.restore.serviceAccountRef especificado. Identidade da carga de trabalho para a Apigee híbrida no GKE configurada. Federação de identidade da carga de trabalho configurada para a Apigee híbrida no AKS ou EKS.
cassandra.restore.snapshotTimestamp	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório se a restauração estiver ativada. Carimbo de data/hora do backup que precisa ser restaurado.
cassandra.sslCertPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O caminho no seu sistema para um arquivo de certificado TLS. Observação: para cada ambiente configurado, o Nome comum (CN, na sigla em inglês) no certificado precisa corresponder ao domínio na propriedade hostAliases[]. Por exemplo, se o CN for *.example.com, hostAliases[] poderá ser foo.example.com ou bar.example.com.
cassandra.sslKeyPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O caminho no seu sistema para o arquivo de chave privada TLS.
cassandra.sslRootCAPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum A cadeia de certificados para a CA raiz (autoridade do certificado).
cassandra.storage.capacity	Básico	Introduzida na versão: 1.0.0 Valor padrão: 10Gi Obrigatório se storage.storageclass for especificado Especifica o tamanho do disco necessário, em mebibytes (Mi) ou gibibytes (Gi).
cassandra.storage.storageclass	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Especifica a classe de armazenamento local que está sendo usada.
cassandra.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 300 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
cassandra.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
cassandra.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
cassandra.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
cassandra.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
cassandra.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

certManager

A Apigee usa o cert-manager para a validação do certificado.

A tabela a seguir descreve as propriedades do objeto certManager:

Propriedade	Tipo	Descrição
certManager.namespace	Avançado	Introduzida na versão: 1.9.0 Valor padrão: cert-manager O namespace do cert-manager. Consulte Como executar o cert-manager em um namespace personalizado.

connectAgent

O Apigee Connect permite que o plano de gerenciamento híbrido da Apigee se conecte com segurança ao serviço MART no plano do ambiente de execução sem exigir que você exponha o endpoint MART na Internet.

A tabela a seguir descreve as propriedades do objeto connectAgent:

Propriedade	Tipo	Descrição
connectAgent.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
connectAgent.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) que o connectAgent vai associar à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Observação: o connectAgent usa a conta de serviço apigee-mart. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
connectAgent.logLevel	Avançado	Introduzida na versão: 1.2.0 Valor padrão: INFO O nível de geração de relatórios de registro. Possíveis valores: INFO: mensagens informativas além de alertas, erros e mensagens fatais. Mais útil para depuração. WARNING: avisos não fatais, além de mensagens fatais e de erro. ERROR: erros internos e erros que não são retornados ao usuário, além de mensagens fatais. FATAL: eventos e erros irrecuperáveis que causam falha na Apigee.
connectAgent.image.pullPolicy	Avançado	Introduzida na versão: 1.2.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
connectAgent.image.tag	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
connectAgent.image.url	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
connectAgent.replicaCountMax	Básico	Introduzida na versão: 1.2.0 Valor padrão: 5 Número máximo de réplicas disponíveis para escalonamento automático.
connectAgent.replicaCountMin	Básico	Introduzida na versão: 1.2.0 Valor padrão: 1 Número mínimo de réplicas disponíveis para escalonamento automático. Em produção, é recomendável aumentar replicaCountMin para 1, a fim de ter um número maior de conexões com o plano de controle para garantir a confiabilidade e a escalabilidade.
connectAgent.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 512m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
connectAgent.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 512Mi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
connectAgent.resources.requests.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 100m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
connectAgent.resources.requests.memory	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 30Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
connectAgent.server	Avançado	Introduzida na versão: 1.2.0 Valor padrão: apigeeconnect.googleapis.com:443 O local do servidor e da porta deste serviço.
connectAgent.serviceAccountPath	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google referente à conta de serviço apigee-mart. Na maioria das instalações, o valor de connectAgent.serviceAccountPath precisa corresponder ao valor de mart.serviceAccountPath.
connectAgent.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Na maioria das instalações, o valor de connectAgent.serviceAccountRef precisa corresponder ao valor de mart.serviceAccountRef.
connectAgent.targetCPUUtilizationPercentage	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 75 Meta de uso da CPU para o agente de conexão da Apigee no pod O valor desse campo permite que a Apigee se conecte ao escalonamento automático quando a utilização da CPU atingir esse valor, até replicaCountMax.
connectAgent.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.2.0 Valor padrão: 600 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
connectAgent.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
connectAgent.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
connectAgent.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
connectAgent.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
connectAgent.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

defaults

As chaves de criptografia padrão para a instalação híbrida da Apigee.

Observação: você precisa atualizá-los para sua instalação.

A tabela a seguir descreve as propriedades do objeto defaults:

Propriedade	Tipo	Descrição
defaults.org.kmsEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: aWxvdmVhcGlzMTIzNDU2Nw== Chave de criptografia padrão para a organização no KMS.
defaults.org.kvmEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: aWxvdmVhcGlzMTIzNDU2Nw== Chave de criptografia padrão para a organização no KVM.
defaults.env.kmsEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: aWxvdmVhcGlzMTIzNDU2Nw== Chave de criptografia padrão para o ambiente (ambiente) no KMS.
defaults.env.kvmEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: aWxvdmVhcGlzMTIzNDU2Nw== Chave de criptografia padrão para o ambiente (env) em KVM.
defaults.env.cacheEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: aWxvdmVhcGlzMTIzNDU2Nw== Chave de criptografia de cache padrão para o ambiente (env).

diagnostic

As configurações da ferramenta Coletor de diagnósticos.

Consulte Como usar o coletor de diagnósticos

A tabela a seguir descreve as propriedades do objeto diagnostic:

Propriedade	Tipo	Descrição
diagnostic.bucket	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório O nome do bucket de armazenamento do Google Cloud em que os dados de diagnóstico serão depositados. Consulte Como criar buckets de armazenamento.
diagnostic.container	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório Isso especifica de qual tipo de pod você está capturando dados. Os valores podem ser um dos seguintes: "apigee-cassandra" captura dados sobre o banco de dados do Cassandra. Os pods istio-cassandra são executados no namespace da Apigee. "apigee-mart-server" captura dados sobre MART. Os pods apigee-mart-server são executados no namespace da Apigee. O "apigee-runtime" captura dados sobre o processador de mensagens. Os pods do apigee-runtime são executados no namespace do Apigee. "apigee-synchronizer" captura dados sobre o sincronizador. Os pods do sincronizador da Apigee são executados no namespace da Apigee. "apigee-udca" captura dados sobre UDCA. Os pods apigee-udca são executados no namespace da apigee. O "apigee-watcher" captura dados sobre o Watcher. Os pods apigee-watcher são executados no namespace da Apigee. "istio-proxy" captura dados sobre o gateway de entrada do Istio. Os pods do istio-proxy são executados no namespace do sistema istio.
diagnostic.loggingDetails.logDuration	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório se a operação de coleta de diagnóstico for "LOGGING" (definida com operation: "LOGGING") A duração em milissegundos dos dados de registro coletados. Um valor típico é 30000. Consulte diagnostic.operation
diagnostic.loggingDetails.loggerNames[]	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório se a operação de coleta de diagnóstico for "LOGGING" (definida com operation: "LOGGING") Especifica por nome os registradores que coletarão dados. Para a Apigee híbrida versão 1.6.0, o único valor compatível é ALL, o que significa todos os registradores. Por exemplo: diagnostic: loggingDetails: loggerNames: - ALL
diagnostic.loggingDetails.logLevel	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório se a operação de coleta de diagnóstico for "LOGGING" (definida com operation: "LOGGING") Especifica a granularidade dos dados de geração de registros a serem coletados. No Apigee híbrido 1.6, somente FINE é compatível.
diagnostic.namespace	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório O namespace do Kubernetes em que os pods de que você está coletando dados residem. O namespace precisa ser o correto para o contêiner que você especifica com diagnostic.container: apigee para apigee-runtime apigee-synchronizer apigee-udca apigee-watcher apigee-cassandra apigee-mart-server istio-system para istio-proxy
diagnostic.operation	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório Especifica se é necessário coletar todas as estatísticas ou apenas registros. Os valores são: "ALL" "LOGGING" Se você definir diagnostic.operation como "LOGGING", as seguintes propriedades serão obrigatórias: diagnostic.loggingDetails.logDuration diagnostic.loggingDetails.loggerNames diagnostic.loggingDetails.logLevel
diagnostic.podNames[]	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório Os nomes dos pods do Kubernetes de que você está coletando dados. Por exemplo: diagnostic: podNames: - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2
diagnostic.serviceAccountPath	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum Obrigatório O caminho para um arquivo de chave da conta de serviço (.json) para a conta de serviço com o papel Administrador de armazenamento (roles/storage.admin). Na maioria das instalações híbridas da Apigee, esta é a conta de serviço apigee-cassandra. Consulte Sobre contas de serviço.
diagnostic.tcpDumpDetails.maxMsgs	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum É obrigatório incluir diagnostic.tcpDumpDetails.maxMsgs ou diagnostic.tcpDumpDetails.timeoutInSeconds se você estiver usando diagnostic.tcpDumpDetails. Define o número máximo de mensagens tcpDump a serem coletadas. A Apigee recomenda um valor máximo de até 1000.
diagnostic.tcpDumpDetails.timeoutInSeconds	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum É obrigatório incluir diagnostic.tcpDumpDetails.maxMsgs ou diagnostic.tcpDumpDetails.timeoutInSeconds se você estiver usando diagnostic.tcpDumpDetails. Define o tempo de espera em segundos para que tcpDump retorne mensagens.
diagnostic.threadDumpDetails.delayInSeconds	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum É obrigatório usar diagnostic.threadDumpDetails.delayInSeconds e diagnostic.threadDumpDetails.iterations se você estiver usando diagnostic.threadDumpDetails. O atraso em segundos entre a coleta de cada despejo de linhas de execução.
diagnostic.threadDumpDetails.iterations	Básico	Introduzida na versão: 1.6.0 Valor padrão: Nenhum É obrigatório usar diagnostic.threadDumpDetails.delayInSeconds e diagnostic.threadDumpDetails.iterations se você estiver usando diagnostic.threadDumpDetails. O número de iterações de despejo de linhas de execução do jstack a serem coletadas.

envs

Define uma matriz de ambientes em que é possível implantar os proxies de API. Cada ambiente fornece um contexto isolado ou sandbox para executar proxies de API.

Sua organização com recurso híbrido precisa ter pelo menos um ambiente.

Para mais informações, consulte Sobre ambientes.

A tabela a seguir descreve as propriedades do objeto envs:

Propriedade	Tipo	Descrição
envs[].cacheEncryptionKey	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum cacheEncryptionKeyÉ necessário incluir um destes campos: cacheEncryptionPath ou cacheEncryptionSecret. Uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
envs[].cacheEncryptionPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum cacheEncryptionKeyÉ necessário incluir um destes campos: cacheEncryptionPath ou cacheEncryptionSecret. O caminho para um arquivo que contém uma chave de criptografia codificada em base64. Consulte Criptografia de dados.
envs[].cacheEncryptionSecret.key	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum cacheEncryptionKeyÉ necessário incluir um destes campos: cacheEncryptionPath ou cacheEncryptionSecret. A chave de uma chave secreta do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
envs[].cacheEncryptionSecret.name	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: cacheEncryptionKey, cacheEncryptionPath ou cacheEncryptionSecret. O nome de um secret do Kubernetes contendo uma chave de criptografia codificada em Base64. Consulte Criptografia de dados.
envs[].components.runtime.replicaCountMax	Básico	Introduzida na versão: 1.9.3 Valor padrão: 4 Número máximo de réplicas para escalonamento automático. Substitui runtime.replicaCountMax, se especificado.
envs[].components.runtime.replicaCountMin	Básico	Introduzida na versão: 1.9.3 Valor padrão: 1 Número mínimo de réplicas para escalonamento automático. Substitui runtime.replicaCountMin, se especificado.
envs[].components.synchronizer.replicaCountMax	Básico	Introduzida na versão: 1.9.3 Valor padrão: 4 Número máximo de réplicas para escalonamento automático. Substitui synchronizer.replicaCountMax, se especificado.
envs[].components.synchronizer.replicaCountMin	Básico	Introduzida na versão: 1.9.3 Valor padrão: 1 Número mínimo de réplicas para escalonamento automático. Substitui synchronizer.replicaCountMin, se especificado.
envs[].components.udca.replicaCountMax	Básico	Introduzida na versão: 1.9.3 Valor padrão: 4 Número máximo de réplicas para escalonamento automático. Substitui udca.replicaCountMax, se especificado.
envs[].components.udca.replicaCountMin	Básico	Introduzida na versão: 1.9.3 Valor padrão: 1 Número mínimo de réplicas para escalonamento automático. Substitui udca.replicaCountMin, se especificado.
envs.gsa.runtime	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google relativa ao ambiente de execução a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
envs.gsa.synchronizer	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google relativa ao sincronizador a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
envs.gsa.udca	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google relativa ao udca com escopo do ambiente a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
envs[].hostAliases[]	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Deprecated: a partir da versão híbrida 1.4, o plano do ambiente de execução recebe essas informações do plano de gerenciamento. Consulte Sobre ambientes e grupos de ambiente.
envs[].httpProxy.host	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Especifica o nome de host ou o endereço IP em que o proxy HTTP está em execução. Liste as propriedades httpProxy na ordem scheme, host, port. Por exemplo: envs: - name: test httpProxy: scheme: HTTP host: 10.12.0.47 port: 3128 ... Confira também: Configurar proxy para proxies de API.
envs[].httpProxy.port	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Especifica a porta na qual o proxy HTTP está em execução. Se esta propriedade for omitida, por padrão, ela usará a porta 80 para HTTP e a porta 443 para HTTPS.
envs[].httpProxy.scheme	Básico	Introduzida na versão: 1.2.0 Valor padrão: HTTPS Especifica o tipo do proxy HTTP como HTTP ou HTTPS. Por padrão, ele usa HTTPS.
envs[].httpProxy.username	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Se o proxy HTTP exigir autenticação básica, use essa propriedade para fornecer um nome de usuário.
envs[].httpProxy.password	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Se o proxy HTTP exigir autenticação básica, use essa propriedade para fornecer uma senha.
envs[].name	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Nome do ambiente da Apigee a ser sincronizado.
envs[].pollInterval	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Intervalo usado para pesquisar alterações de organização e sincronização de ambiente, em segundos.
envs[].port	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Número da porta TCP para o tráfego HTTPS.
envs[].serviceAccountPaths.runtime	Básico	Introduzida na versão: 1.4.0 Valor padrão: Nenhum Caminho para arquivar no sistema local em uma chave da conta de serviço do Google com o papel Agente do Cloud Trace, geralmente na conta de serviço apigee-runtime. Consulte Sobre contas de serviço para conferir os nomes padrão das contas de serviço e os papéis atribuídos.
envs[].serviceAccountPaths.synchronizer	Básico	Introduzida na versão: 1.0 Valor padrão: Nenhum Caminho para arquivar no sistema local em uma chave da conta de serviço do Google com o papel Apigee Synchronizer Manager.
envs[].serviceAccountPaths.udca	Básico	Introduzida na versão: 1.0 Valor padrão: Nenhum Caminho para arquivar no sistema local em uma chave da conta de serviço do Google com o papel Agente do Apigee Analytics. Defina essa propriedade somente se orgScopedUDCA estiver definido como false.
envs[].serviceAccountSecretProviderClass	Avançado	Introduzida na versão: 1.12.0 Valor padrão: Nenhum O nome da classe do provedor de secrets específica do ambiente (SecretProviderClass) usada para armazenar as chaves de contas de serviço no Vault. Consulte Como armazenar chaves de conta de serviço no Hashicorp Vault.
envs[].serviceAccountSecretRefs.runtime	Básico	Introduzida na versão: 1.4.0 Valor padrão: Nenhum O nome de um secret do Kubernetes. Crie o secret usando uma chave de conta de serviço do Google com o papel Agente do Cloud Trace como entrada.
envs[].serviceAccountSecretRefs.synchronizer	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O nome de um secret do Kubernetes. Crie o secret usando uma chave de conta de serviço do Google com o papel Apigee Synchronizer Manager como entrada.
envs[].serviceAccountSecretRefs.udca	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O nome de um secret do Kubernetes. Crie o secret usando uma chave de conta de serviço do Google com o papel de agente do Apigee Analytics como entrada. Defina essa propriedade somente se orgScopedUDCA estiver definido como false.
envs[].sslCertPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O caminho no seu sistema para um arquivo de certificado TLS. Observação: para cada ambiente configurado, o Nome comum (CN, na sigla em inglês) no certificado precisa corresponder ao domínio na propriedade hostAliases[]. Por exemplo, se o CN for *.example.com, hostAliases[] poderá ser foo.example.com ou bar.example.com.
envs[].sslKeyPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O caminho no seu sistema para o arquivo de chave privada TLS.
envs[].sslSecret	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O nome de um arquivo armazenado em um secret do Kubernetes que contém o certificado TLS e a chave privada. Você precisa criar o secret usando o certificado TLS e os dados da chave como entrada. Consulte também: Como armazenar dados em um secret do Kubernetes Secrets na documentação do Kubernetes Como criar um secret usando a kubectl na documentação do Kubernetes

gcp

Identifica o ID do projeto do Google Cloud e a região para onde o apigee-logger e o apigee-metrics enviam dados.

A tabela a seguir descreve as propriedades do objeto gcp:

Propriedade	Tipo	Descrição
gcp.federatedWorkloadIdentity.audience	Básico	Introduzida na versão: 1.12.0 Valor padrão: Nenhum O público-alvo permitido do provedor de identidade da carga de trabalho em plataformas que não são do GKE. Consulte Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
gcp.federatedWorkloadIdentity.credentialSourceFile	Básico	Introduzida na versão: 1.12.0 Valor padrão: Nenhum O nome de arquivo e o caminho até o arquivo de origem da credencial usado pela federação de identidade da carga de trabalho para receber as credenciais das contas de serviço. Esse é o valor fornecido para credential-source-file ao configurar a federação de identidade da carga de trabalho com o comando create-cred-config. Consulte Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
gcp.federatedWorkloadIdentity.enabled	Básico	Introduzida na versão: 1.12.0 Valor padrão: false Ativa a federação de identidade da carga de trabalho em plataformas que não são do GKE. Não pode ser definido como true quando gcp.workloadIdentity.enabled está definido como true no mesmo cluster. Consulte Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
gcp.federatedWorkloadIdentity.tokenExpiration	Básico	Introduzida na versão: 1.12.0 Valor padrão: 3600 A vida útil do token em segundos. Consulte Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
gcp.projectID	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Obrigatório Identifica o projeto do Google Cloud em que apigee-logger e apigee-metrics enviam dados.
gcp.projectIDRuntime	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Identifica o projeto de cluster do ambiente de execução do Kubernetes. A propriedade projectIDRuntime é opcional. Se não for usado, presumimos que o valor projectID é usado para o projeto do GCP da organização da Apigee e o projeto do cluster de K8S do ambiente de execução.
gcp.region	Básico	Introduzida na versão: 1.2.0 Valor padrão: us-central1 Obrigatório Identifica a região do Google Cloud em que apigee-logger e apigee-metrics enviam os dados.
gcp.workloadIdentity.enabled	Básico	Introduzida na versão: 1.10.0 Valor padrão:false Somente Helm: ativa o uso da Identidade da carga de trabalho no GKE. A Identidade da carga de trabalho permite que as cargas de trabalho nos clusters do GKE representem contas de serviço do Identity and Access Management (IAM) para acessar serviços do Google Cloud. Não pode ser definido como true quando gcp.federatedWorkloadIdentity.enabled está definido como true no mesmo cluster. Quando enabled for false, o padrão, a Apigee usará as contas de serviço do IAM para cada componente híbrido da Apigee. Consulte Sobre contas de serviço. Quando workloadIdentityEnabled é true, a Apigee usa as contas de serviço do Kubernetes e as mapeia para as contas de serviço do IAM apropriadas com relação a cada componente. Especifique as contas de serviço do IAM a serem mapeadas para as contas de serviço do Kubernetes com o seguinte: gcp.workloadIdentity.gsa connectAgent.gsa envs.gsa.runtime envs.gsa.synchronizer envs.gsa.udca logger.gsa mart.gsa metrics.gsa udca.gsa watcher.gsa
gcp.workloadIdentity.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) para todos os componentes a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho em clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. gcp.workloadIdentity.gsa se aplica a todos os componentes híbridos. Se você especificar um valor para gcp.workloadIdentity.gsa, não precisará fornecer uma GSA com relação aos componentes híbridos individuais. Se você fornecer uma GSA para um componente individual, a GSA desse componente substituirá gcp.workloadIdentity.gsa somente para ele. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Confira Enabling Workload Identity on GKE.
gcp.workloadIdentityEnabled	Básico	Introduzida na versão: 1.4.0 Valor padrão:false Somente apigeectl: ativa o uso da Identidade da carga de trabalho. A Identidade da carga de trabalho permite que as cargas de trabalho nos clusters do GKE representem contas de serviço do Identity and Access Management (IAM) para acessar serviços do Google Cloud. Quando workloadIdentityEnabled for false, o padrão, a Apigee usará as contas de serviço do IAM para cada componente híbrido da Apigee. Consulte Sobre contas de serviço. Quando workloadIdentityEnabled é true, a Apigee usa contas de serviço do Kubernetes em vez de contas de serviço do IAM e ignora as seguintes propriedades de configuração: validateServiceAccounts cassandra.backup.serviceAccountPath cassandra.backup.serviceAccountRef cassandra.restore.serviceAccountPath cassandra.restore.serviceAccountRef envs[].serviceAccountPaths.* logger.serviceAccountPath logger.serviceAccountRef mart.serviceAccountPath mart.serviceAccountRef metrics.serviceAccountPath metrics.serviceAccountRef synchronizer.serviceAccountPath synchronizer.serviceAccountRef udca.serviceAccountPath udca.serviceAccountRef watcher.serviceAccountPath watcher.serviceAccountRef

httpProxy

httpProxy fornece parâmetros de configuração para um servidor proxy HTTP. Quando configurada em overrides.yaml, toda a comunicação pela Internet para os componentes Apigee Connect, Logger, MART, Metrics, Synchronizer e UDCA passa pelo servidor proxy.

Observação: também é possível configurar o encaminhamento de proxy HTTP no escopo do ambiente para proxies da API. Consulte Configurar o encaminhamento de proxy para proxies de API.

Consulte também: connectAgent, logger, mart, metrics, synchronizer e udca.

A tabela a seguir descreve as propriedades do objeto httpProxy:

Propriedade	Tipo	Descrição
httpProxy.host	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum O nome do host do proxy HTTP.
httpProxy.port	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum A porta do proxy HTTP.
httpProxy.scheme	Básico	Introduzida na versão: 1.1.1 Valor padrão: HTTPS O esquema usado pelo proxy. Os valores podem ser HTTP ou HTTPS. Os valores precisam estar em maiúsculas.
httpProxy.username	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum Se o proxy HTTP exigir autenticação básica, use essa propriedade para fornecer um nome de usuário.
httpProxy.password	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum Se o proxy HTTP exigir autenticação básica, use essa propriedade para fornecer uma senha.

ingressGateways

Configura cada instância individual do gateway de entrada da Apigee. Use essas propriedades para gerenciar instâncias individuais separadamente por ingressGateways[].name.

Consulte apigeeIngressGateway para aplicar uma configuração comum a todas as instâncias do gateway de entrada da Apigee.'

Aplique alterações às propriedades ingressGateways com o gráfico apigee-org.

A tabela a seguir descreve as propriedades do objeto ingressGateways:

Propriedade	Tipo	Descrição
ingressGateways[].name	Básico	Introduzida na versão: 1.8.0 Valor padrão: Nenhum Obrigatório O nome do gateway de entrada. Outros serviços usarão esse nome para endereçar o tráfego ao gateway. O nome precisa cumprir os seguintes requisitos: máximo de 17 caracteres; conter apenas caracteres alfanuméricos minúsculos, "-" ou "." começar com um caractere alfanumérico; terminar com um caractere alfanumérico. Para mais informações, consulte Nomes de subdomínios de DNS na documentação do Kubernetes.
ingressGateways[].resources.limits.cpu	Avançado	Introduzida na versão: 1.8.0 Valor padrão: 2000m O limite de CPU para o recurso, em milicores.
ingressGateways[].resources.limits.memory	Avançado	Introduzida na versão: 1.8.0 Valor padrão: 1Gi O limite de memória do recurso, em mebibytes.
ingressGateways[].resources.requests.cpu	Avançado	Introduzida na versão: 1.8.0 Valor padrão: 300m A CPU necessária para a operação normal do recurso, em milicores.
ingressGateways[].resources.requests.memory	Avançado	Introduzida na versão: 1.8.0 Valor padrão: 128Mi A memória necessária para a operação normal do recurso, em mebibytes.
ingressGateways[].replicaCountMax	Básico	Introduzida na versão: 1.8.0 Valor padrão: 10 O número máximo de pods que podem ser adicionados de forma automática ao gateway de entrada disponível para escalonamento automático.
ingressGateways[].replicaCountMin	Básico	Introduzida na versão: 1.8.0 Valor padrão: 2 O número mínimo de pods para o gateway de entrada disponível para escalonamento automático.
ingressGateways[].svcAnnotations	Básico	Introduzida na versão: 1.8.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar o gateway de entrada em plataformas compatíveis com anotações. Por exemplo: ingressGateways: svcAnnotations: networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP	Básico	Introduzida na versão: 1.8.0 Valor padrão: Nenhum Nas plataformas compatíveis com a especificação do endereço IP do balanceador de carga, o balanceador de carga será criado com esse endereço IP. Nas plataformas que não permitem especificar o endereço de IP do balanceador de carga, essa propriedade é ignorada.
ingressGateways[].svcType	Básico	Introduzida na versão: 1.8.1 Valor padrão: LoadBalancer Usado para alterar o tipo de serviço k8s padrão para a implantação de entrada. Defina o valor como ClusterIP se quiser desativar a criação do balanceador de carga padrão. Valores possíveis: ClusterIP LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage	Avançado	Introduzido na versão: 1.10.5, 1.11.2, 1.12.1 Valor padrão: 75 O limite de uso da CPU para escalonar o número de pods no ReplicaSet, como uma porcentagem do total de recursos de CPU disponíveis. Quando o uso da CPU ultrapassar esse valor, o híbrido aumentará gradualmente o número de pods no ReplicaSet, até ingressGateways[].replicaCountMax. Para mais informações sobre escalonamento no Kubernetes, consulte Escalonamento automático horizontal de pods na documentação do Kubernetes.
ingressGateways[].tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
ingressGateways[].tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
ingressGateways[].tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
ingressGateways[].tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
ingressGateways[].tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

istiod

Configura a entrada da Apigee.

A tabela a seguir descreve as propriedades do objeto istiod:

Propriedade	Tipo	Descrição
istiod.accessLogFile	Avançado	Introduzida na versão: 1.8.0 Valor padrão: /dev/stdout O endereço do arquivo do registro de acesso de entrada, por exemplo, /dev/stdout. Deixar esse valor indefinido desativa a geração de registros de acesso.
istiod.accessLogFormat	Avançado	Introduzida na versão: 1.8.0 O formato do registro de acesso de entrada. Deixar esse valor indefinido resulta no uso do formato de registro de acesso padrão do proxy. Formato de registro de acesso padrão: '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}' Consulte a seguir uma cópia do formato de registro de acesso padrão com quebras de linha adicionadas para facilitar a leitura. '{"start_time":"%START_TIME%", "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%", "user_agent":"%REQ(USER-AGENT)%", "host":"%REQ(:AUTHORITY)%", "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%", "request_time":"%DURATION%", "status":"%RESPONSE_CODE%", "status_details":"%RESPONSE_CODE_DETAILS%", "bytes_received":"%BYTES_RECEIVED%", "bytes_sent":"%BYTES_SENT%", "upstream_address":"%UPSTREAM_HOST%", "upstream_response_flags":"%RESPONSE_FLAGS%", "upstream_response_time":"%RESPONSE_DURATION%", "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%", "upstream_cluster":"%UPSTREAM_CLUSTER%", "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%", "request_method":"%REQ(:METHOD)%", "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%", "request_protocol":"%PROTOCOL%", "tls_protocol":"%DOWNSTREAM_TLS_VERSION%", "request_id":"%REQ(X-REQUEST-ID)%", "sni_host":"%REQUESTED_SERVER_NAME%", "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
istiod.forwardClientCertDetails	Avançado	Introduzida na versão: 1.9.2 Valor padrão: SANITIZE_SET Determina como o proxy Envoy (para o gateway de entrada da Apigee) manipula o cabeçalho HTTP x-forwarded-client-cert (XFCC). Os valores possíveis são: SANITIZE_SET (padrão) Quando a conexão do cliente for mTLS, redefina o cabeçalho XFCC com as informações do certificado do cliente e envie-o para o próximo salto. FORWARD_ONLY Quando a conexão do cliente for mTLS (TLS mútuo), encaminhe o cabeçalho XFCC apenas na solicitação. APPEND_FORWARD Quando a conexão do cliente for mTLS, anexe as informações do certificado do cliente ao cabeçalho XFCC da solicitação e encaminhe-a. SANITIZE Não encaminhe o cabeçalho XFCC. ALWAYS_FORWARD_ONLY Sempre encaminhe o cabeçalho XFCC na solicitação, independentemente de a conexão do cliente ser mTLS. Para mais informações sobre esses valores, consulte a documentação do Envoy sobre Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails. Se você alterar essa configuração depois de instalar o Hybrid, aplique-o com apigeectl init e reinicie os pods de gateway de entrada da Apigee.
istiod.healthCheckUserAgents	Avançado	Introduzida na versão: 1.12.0 Valores padrão: - "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)" - "Edge Health Probe" Permite que balanceadores de carga que não são do Google Cloud verifiquem os endpoints de verificação de integridade do gateway de entrada (/healthz/ingress e /healthz) substituindo a lista de permissões de user-agent padrão no modo híbrido. Observação: o uso dessa propriedade de configuração só é compatível com instalações híbridas que usam gráficos do Helm. Não é compatível com apigeectl. Para substituir os user agents padrão especificados, use a seguinte sintaxe, inserindo os user agents personalizados: istiod: healthCheckUserAgents: - "CUSTOM_USER_AGENT_1" - "CUSTOM_USER_AGENT_2" Para remover a exigência de user agent, use o seguinte: istiod: healthCheckUserAgents: [] Observação: os pods precisam ser reiniciados para que isso entre em vigor. Use kubectl rollout restart deployment -n apigee apigee-ingressgateway-manager para reiniciar os pods e kubectl rollout status deployment -n apigee apigee-ingressgateway-manager para verificar o status do lançamento.
istiod.image.pullPolicy	Avançado	Introduzida na versão: 1.8.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
istiod.image.tag	Avançado	Introduzida na versão: 1.8.0 Valor padrão: 1.18.7-asm.4-distroless O rótulo da versão da imagem do Docker desse serviço.
istiod.image.url	Avançado	Introduzida na versão: 1.8.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
istiod.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
istiod.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
istiod.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
istiod.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
istiod.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

k8sCluster

Identifica o cluster do Kubernetes em que o ambiente de execução híbrido está instalado.

A tabela a seguir descreve as propriedades do objeto k8sCluster:

Propriedade	Tipo	Descrição
k8sCluster.name	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O nome do cluster do Kubernetes em que o ambiente de execução híbrido está instalado.
k8sCluster.region	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Identifica a região do Google Cloud em que seu cluster do Kubernetes foi criado.

kubeRBACProxy

Identifica onde a Apigee deve procurar controles de acesso baseados em papéis do Kubernetes.

A tabela a seguir descreve as propriedades do objeto kubeRBACProxy:

Propriedade	Tipo	Descrição
kubeRBACProxy.image.pullPolicy	Avançado	Introduzida na versão: 1.2.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
kubeRBACProxy.image.tag	Avançado	Introduzida na versão: 1.2.0 Valor padrão: v0.14.2 O rótulo da versão da imagem do Docker desse serviço.
kubeRBACProxy.image.url	Avançado	Introduzida na versão: 1.2.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
kubeRBACProxy.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 500m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
kubeRBACProxy.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 128Mi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
kubeRBACProxy.resources.requests.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 5m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
kubeRBACProxy.resources.requests.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 64Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

logger

Define o serviço que gerencia registros operacionais. Todos os serviços do híbrido da Apigee que são executados no cluster do Kubernetes geram essas informações.

Para mais informações, consulte Visão geral do Logging.

A tabela a seguir descreve as propriedades do objeto logger:

Propriedade	Tipo	Descrição
logger.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
logger.bufferChunkSize	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 256k O tamanho inicial do buffer para ler arquivos de registro.
logger.bufferMaxSize	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 104857600 O limite do tamanho do buffer por arquivo monitorado. Os arquivos que excedem esse limite são removidos da lista de arquivos monitorados.
logger.bufferMemoryLimit	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 150 MB O limite de memória que o logger pode consumir. Se o alcance for atingido, o registrador fará uma pausa momentânea na leitura de mais dados até que os dados existentes sejam transferidos para a memória.
logger.enabled	Básico	Introduzida na versão: 1.0.0 Valor padrão: false Ativa ou desativa a geração de registros no cluster. Para não GKE definido como true, para GKE no Google Cloud ou Google Distributed Cloud definido como false.
logger.envVars	Básico	Introduzida na versão: 1.8.5 Valor padrão: Nenhum Permite incluir a variável de ambiente NO_PROXY do Fluent Bit, que especifica URLs para os quais o tráfego não é roteado por meio do proxy HTTP. A variável NO_PROXY precisa ser definida como uma string separada por vírgulas de nomes de host, no formato: logger: ... envVars: NO_PROXY: '<comma-separated-values>' por exemplo: envVars: NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com' Use envVars: NO_PROXY opcionalmente quando o proxy de encaminhamento de HTTP estiver ativado. Consulte NO_PROXY na documentação do Fluent Bit.
logger.flushInterval	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 1 O intervalo a aguardar antes de invocar a próxima limpeza de buffer, em segundos.
logger.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) apigee-logger a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
logger.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
logger.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.9.9 O rótulo da versão da imagem do Docker desse serviço.
logger.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
logger.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 3 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
logger.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
logger.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 60 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
logger.livenessProbe.successThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de atividade seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
logger.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
logger.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: apigee.com/apigee-logger-enabled Obrigatório Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução logger. Consulte Como configurar pools de nós dedicados.
logger.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: true Obrigatório Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução logger. Consulte Como configurar pools de nós dedicados.
logger.resources.limits.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 200m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
logger.resources.limits.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 500Mi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
logger.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 100m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
logger.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 250Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
logger.serviceAccountPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google com o papel de gravador de registros.
logger.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef.
logger.storageMaxChunks	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 128 O número máximo de blocos que podem estar ativos na memória. Os blocos que excederem o limite serão salvos no sistema de arquivos.
logger.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 30 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
logger.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
logger.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
logger.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
logger.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
logger.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

mart

Define o serviço MART (API Management para dados do ambiente de execução, na sigla em inglês), que age como um provedor de API para APIs públicas da Apigee, para que você possa acessar e gerenciar entidades de dados de ambiente de execução, como KMS (Chaves de API e tokens OAuth), KVM, cota e produtos de API.

A tabela a seguir descreve as propriedades do objeto mart:

Propriedade	Tipo	Descrição
mart.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
mart.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) apigee-mart a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
mart.hostAlias	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O alias de host que aponta para o objeto MART. É possível definir essa propriedade como * ou um nome de domínio totalmente qualificado.
mart.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
mart.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
mart.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
mart.initCheckCF.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 10m A quantidade de CPU alocada para a verificação de inicialização do processo do Cloud Foundry.
mart.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 12 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
mart.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 15 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
mart.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
mart.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
mart.metricsURL	Básico	Introduzida na versão: 1.0.0 Valor padrão: /v1/server/metrics
mart.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Chave de rótulo do seletor de nó opcional para segmentar nós do Kubernetes para serviços do ambiente de execução mart. Se você não especificar uma chave para mart.nodeselector, o ambiente de execução usará o nó especificado no objeto nodeSelector. Consulte Como configurar pools de nós dedicados.
mart.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Valor do rótulo do seletor de nós opcional para segmentação de nós do Kubernetes para mart serviços do ambiente de execução. Consulte também o objeto nodeSelector. Consulte Como configurar pools de nós dedicados.
mart.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
mart.readinessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 15 O número de segundos após o início de um contêiner antes de uma sondagem de preparo.
mart.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
mart.readinessProbe.successThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de preparo seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
mart.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
mart.replicaCountMax	Básico	Introduzida na versão: 1.0.0 Valor padrão: 5 Número máximo de réplicas disponíveis para escalonamento automático.
mart.replicaCountMin	Básico	Introduzida na versão: 1.0.0 Valor padrão: 1 Número mínimo de réplicas disponíveis para escalonamento automático.
mart.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 2000m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
mart.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 5Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
mart.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
mart.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 512Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
mart.serviceAccountPath	Básico	Introduzida na versão: 1.1.1 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google sem papel.
mart.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef.
mart.sslCertPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. Caminho do sistema de arquivos local para carregar e codificar o certificado SSL como um Secret.
mart.sslKeyPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. Caminho do sistema de arquivos local para carregar e codificar a chave SSL para um secret.
mart.sslSecret	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O nome de um arquivo armazenado em um secret do Kubernetes que contém o certificado TLS e a chave privada. Você precisa criar o secret usando o certificado TLS e os dados da chave como entrada. Consulte também: Como armazenar dados em um secret do Kubernetes Secrets na documentação do Kubernetes Como criar um secret usando a kubectl na documentação do Kubernetes
mart.targetCPUUtilizationPercentage	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 75 Meta de uso da CPU para o processo MART no pod. O valor desse campo permite que o MART seja escalonado automaticamente quando a utilização da CPU atingir esse valor, até replicaCountMax.
mart.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 30 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
mart.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
mart.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
mart.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
mart.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
mart.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

metrics

Define o serviço que coleta métricas de operações. Use os dados das métricas para monitorar a integridade dos serviços híbridos, configurar alertas e assim por diante.

Para mais informações, consulte Visão geral da coleta de métricas.

A tabela a seguir descreve as propriedades do objeto metrics:

Propriedade	Tipo	Descrição
metrics.adapter.image.pullPolicy	Avançado	Introduzida na versão: 1.8.1 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
metrics.adapter.image.tag	Avançado	Introduzida na versão: 1.8.1 Valor padrão: v0.11.0 O rótulo da versão da imagem do Docker desse serviço.
metrics.adapter.image.url	Avançado	Introduzida na versão: 1.8.1 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
metrics.aggregator.resources.requests.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m A CPU necessária para a operação normal do agregador em um contêiner do Kubernetes, em millicores.
metrics.aggregator.resources.requests.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 512Mi A memória necessária para a operação normal do agregador em um contêiner do Kubernetes, em mebibytes.
metrics.aggregator.resources.limits.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m O limite de CPU do recurso de agregador em um contêiner do Kubernetes, em millicores.
metrics.aggregator.resources.limits.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 3Gi O limite de memória do recurso de agregador em um contêiner do Kubernetes, em gibibytes.
metrics.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
metrics.app.resources.requests.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m A CPU necessária para a operação normal do app em um contêiner do Kubernetes, em millicores.
metrics.app.resources.requests.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 512Mi A memória necessária para a operação normal do app em um contêiner do Kubernetes, em mebibytes.
metrics.app.resources.limits.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m O limite de CPU do recurso do aap em um contêiner do Kubernetes, em millicores.
metrics.app.resources.limits.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 1Gi O limite de memória para o recurso do app em um contêiner do Kubernetes, em gibibytes.
metrics.appStackdriverExporter.resources.requests.cpu	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 128m A CPU necessária para a operação normal do stackdriverExporter em um contêiner do Kubernetes, em millicores.
metrics.appStackdriverExporter.resources.requests.memory	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 512Mi A memória necessária para a operação normal do stackdriverExporter em um contêiner do Kubernetes, em mebibytes.
metrics.appStackdriverExporter.resources.limits.cpu	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 500m O limite de CPU do recurso stackdriverExporter em um contêiner do Kubernetes, em millicores.
metrics.appStackdriverExporter.resources.limits.memory	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 1Gi O limite de memória para o recurso stackdriverExporter em um contêiner do Kubernetes, em gibibytes.
metrics.collector.envVars	Básico	Introduzida na versão: 1.13 Valor padrão: Nenhum Permite transmitir e substituir variáveis de ambiente no OpenTelemetry. Por exemplo, é possível definir HTTP_PROXY, HTTPS_PROXY ou NO_PROXY para receber as solicitações passam pelo servidor proxy. A variável HTTP_PROXY pode ser definida como uma string que contém o nome do host no formato: metrics: ... EnvVars: HTTP_PROXY: '<host-name>' por exemplo: EnvVars: HTTP_PROXY: 'http://1.1.1.1:80' A variável HTTPS_PROXY pode ser definida como uma string que contém o nome do host no formato: metrics: ... EnvVars: HTTPS_PROXY: '<host-name>' por exemplo: EnvVars: HTTPS_PROXY: 'https://1.1.1.1:80' A variável NO_PROXY precisa ser definida como uma string separada por vírgulas de nomes de host, no formato: metrics: ... envVars: NO_PROXY: '<comma-separated-values>' por exemplo: envVars: NO_PROXY: 'https://1.1.1.1:80, https://1.1.1.1:81' Use envVars: HTTP_PROXY, envVars: HTTPS_PROXY ou envVars: NO_PROXY opcionalmente quando o proxy de encaminhamento de HTTP estiver ativado. Consulte Compatibilidade com proxy na documentação do OpenTelemetry.
metrics.collector.imagePullPolicy	Avançado	Introduzida na versão: 1.12.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, acesse Usar um repositório de imagens particular com a Apigee híbrida .
metrics.collector.image.tag	Básico	Introduzida na versão: 1.12.0 Valor padrão: v0.93.0 O rótulo da versão da imagem do Docker desse serviço.
metrics.collector.image.url	Básico	Introduzida na versão: 1.12.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
metrics.collector.resources.requests.cpu	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 500m A CPU necessária para a operação normal do app em um contêiner do Kubernetes, em millicores.
metrics.collector.resources.requests.memory	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 512Mi A memória necessária para a operação normal do app em um contêiner do Kubernetes, em mebibytes.
metrics.collector.resources.limits.cpu	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 500m O limite de CPU do recurso do aap em um contêiner do Kubernetes, em millicores.
metrics.collector.resources.limits.memory	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 1Gi O limite de memória para o recurso do app em um contêiner do Kubernetes, em gibibytes.
metrics.collector.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 5 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
metrics.collector.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 30 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
metrics.collector.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 10 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
metrics.collector.livenessProbe.successThreshold	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de atividade seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
metrics.collector.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 5 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
metrics.collector.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 3 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
metrics.collector.readinessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 30 O número de segundos após o início de um contêiner antes de uma sondagem de preparo.
metrics.collector.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 10 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
metrics.collector.readinessProbe.successThreshold	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de preparo seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
metrics.collector.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.12.0 Valor padrão: 5 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
metrics.disablePrometheusPipeline	Básico	Introduzida na versão: 1.12.0 Valor padrão: true As métricas dos recursos monitorados ProxyV2 e TargetV2 não são emitidas quando definidas como true. Em vez disso, use métricas para os recursos monitorados Proxy e Target.
metrics.enabled	Básico	Introduzida na versão: 1.0.0 Valor padrão: true Ativa as métricas da Apigee. Defina como true para ativar métricas. Defina como false para desativar métricas.
metrics.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) apigee-metrics a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
metrics.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução metrics. Consulte Como configurar pools de nós dedicados.
metrics.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução metrics. Consulte Como configurar pools de nós dedicados.
metrics.prometheus.containerPort	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 9090 A porta para se conectar ao serviço de métricas do Prometheus.
metrics.prometheus.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
metrics.prometheus.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: v2.45.0 O rótulo da versão da imagem do Docker desse serviço.
metrics.prometheus.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
metrics.prometheus.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 6 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
metrics.prometheus.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
metrics.prometheus.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 3 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
metrics.prometheus.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 120 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
metrics.prometheus.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
metrics.prometheus.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 3 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
metrics.prometheus.sslCertPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Caminho para o certificado SSL para o processo de coleta de métricas do Prometheus. O Prometheus é uma ferramenta que a Apigee pode usar para coletar e processar métricas. Veja estes tópicos: metrics Para informações contextuais, o site do Prometheus
metrics.prometheus.sslKeyPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Caminho para a chave SSL do processo de coleta de métricas do Prometheus. O Prometheus é uma ferramenta que a Apigee pode usar para coletar e processar métricas. Veja estes tópicos: metrics Para informações contextuais, o site do Prometheus
metrics.proxy.resources.requests.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m A CPU necessária para a operação normal do proxy em um contêiner do Kubernetes, em millicores.
metrics.proxy.resources.requests.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 512Mi A memória necessária para a operação normal do proxy em um contêiner do Kubernetes, em mebibytes.
metrics.proxy.resources.limits.cpu	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 500m O limite de CPU do recurso de proxy em um contêiner do Kubernetes, em millicores.
metrics.proxy.resources.limits.memory	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 1Gi O limite de memória do recurso de proxy em um contêiner Kubernetes em gibibytes.
metrics.proxyStackdriverExporter.resources.requests.cpu	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 128m A CPU necessária para a operação normal do stackdriverExporter em um contêiner do Kubernetes, em millicores.
metrics.proxyStackdriverExporter.resources.requests.memory	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 512Mi A memória necessária para a operação normal do stackdriverExporter em um contêiner do Kubernetes, em mebibytes.
metrics.proxyStackdriverExporter.resources.limits.cpu	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 500m O limite de CPU do recurso stackdriverExporter em um contêiner do Kubernetes, em millicores.
metrics.proxyStackdriverExporter.resources.limits.memory	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 1Gi O limite de memória para o recurso stackdriverExporter em um contêiner do Kubernetes, em gibibytes.
metrics.proxyURL	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum URL do proxy secundário do processo de métricas no cluster do Kubernetes.
metrics.sdSidecar.containerPort	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 9091 A porta para se conectar ao serviço de métricas do Cloud Monitoring.
metrics.sdSidecar.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o Kubelet extrai a imagem do Docker desse serviço. Os valores possíveis incluem: IfNotPresent: não extrair uma nova imagem se ela já existir Always: sempre extrair a política, mesmo que ela já exista Para mais informações, consulte Como atualizar imagens.
metrics.sdSidecar.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: v0.9.0 O rótulo da versão da imagem do Docker desse serviço.
metrics.sdSidecar.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
metrics.serviceAccountPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google com o papel de gravador de métricas do Monitoring.
metrics.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef.
metrics.stackdriverExporter.resources.requests.cpu	Avançado	Introduzida na versão: 1.4.0 Deprecated: a partir da versão híbrida 1.8, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Veja estes tópicos: metrics.appStackdriverExporter.resources.requests.cpu metrics.proxyStackdriverExporter.resources.requests.cpu
metrics.stackdriverExporter.resources.requests.memory	Avançado	Introduzida na versão: 1.4.0 Deprecated: a partir da versão híbrida 1.8, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Veja estes tópicos: metrics.appStackdriverExporter.resources.requests.memory metrics.proxyStackdriverExporter.resources.requests.memory
metrics.stackdriverExporter.resources.limits.cpu	Avançado	Introduzida na versão: 1.4.0 Deprecated: a partir da versão híbrida 1.8, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Veja estes tópicos: metrics.appStackdriverExporter.resources.thresholdscpu metrics.proxyStackdriverExporter.resources.thresholdscpu
metrics.stackdriverExporter.resources.limits.memory	Avançado	Introduzida na versão: 1.4.0 Deprecated: a partir da versão híbrida 1.8, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Veja estes tópicos: metrics.appStackdriverExporter.resources.limites.memory metrics.proxyStackdriverExporter.resources.thresholds.memory
metrics.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 300 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
metrics.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
metrics.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
metrics.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
metrics.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
metrics.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

mintTaskScheduler

mintTaskScheduler é o cron job para programar tarefas de monetização, como cálculo de taxa recorrente periodicamente.

A tabela a seguir descreve as propriedades do objeto mintTaskScheduler:

Propriedade	Tipo	Descrição
mintTaskScheduler.image.pullPolicy	Avançado	Introduzida na versão: 1.7.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
mintTaskScheduler.image.tag	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
mintTaskScheduler.image.url	Avançado	Introduzida na versão: 1.7.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
mintTaskScheduler.resources.limits.cpu	Avançado	Introduzido na versão: 1.1.0 Valor padrão: 2000m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
mintTaskScheduler.resources.limits.memory	Avançado	Introduzido na versão: 1.1.0 Valor padrão: 4Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
mintTaskScheduler.resources.requests.cpu	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
mintTaskScheduler.resources.requests.memory	Avançado	Introduzida na versão: 1.7.0 Valor padrão: 512Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
mintTaskScheduler.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
mintTaskScheduler.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
mintTaskScheduler.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
mintTaskScheduler.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
mintTaskScheduler.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

newDataPipeline

newDataPipeline determina se o híbrido da Apigee usa o novo pipeline de dados para que os componentes do ambiente de execução gravem dados diretamente no plano de controle. Essa propriedade é necessária para organizações híbridas com residência de dados ativada na versão 1.13.1 ou mais recente. Não tente usar o novo recurso de pipeline de dados com organizações que não têm a residência de dados ativada. Somente novas organizações criadas na versão híbrida v1.13.1 conseguem usar esse novo recurso. Consulte Como usar a residência de dados com a Apigee híbrida.

A tabela a seguir descreve as propriedades do objeto newDataPipeline:

Propriedade	Tipo	Descrição
newDataPipeline.debugSession	Avançado	Introduzido na versão: 1.13.1 Valor padrão: false Determina se o novo pipeline de dados do Pub/Sub está ativado. Defina essa propriedade como true para usar o novo pipeline de dados (obrigatório para novas organizações híbridas v1.13.1 com residência de dados ativada). Defina como false para desativar o novo pipeline de dados. Consulte mais informações em Coleta de dados de análise e depuração com residência de dados.
newDataPipeline.analytics	Avançado	Introduzido na versão: 1.13.1 Valor padrão: false Determina se a análise usa o novo pipeline de dados do Pub/Sub. Defina como true para permitir que a análise use o novo pipeline de dados (obrigatório para novas organizações híbridas v1.13.1 com residência de dados ativada). Defina como false para forçar a análise a usar o pipeline de dados antigo. Consulte mais informações em Coleta de dados de análise e depuração com residência de dados.

nodeSelector

O objeto nodeSelector define o nó da instância da Apigee. Nos bastidores, a Apigee híbrida cuida de mapear a chave/valor do rótulo apigeeRuntime e apigeeData para os componentes individuais do Istio e do MART quando você instala ou faz upgrade do apigee-org e apigee-ingress-manager. É possível substituir isso por objetos individuais na propriedade mart:nodeSelector.

A tabela a seguir descreve as propriedades do objeto nodeSelector:

Propriedade	Tipo	Descrição
nodeSelector.apigeeData.key	Avançado	Introduzida na versão: 1.0.0 Valor padrão: cloud.google.com/gke-nodepool ApigeeData é o nó do banco de dados do Cassandra. Chave de rótulo do seletor de nós para segmentar nós do Kubernetes para trabalhar com dados de serviços da Apigee. Consulte Configurar pools de nós dedicados.
nodeSelector.apigeeData.value	Avançado	Introduzida na versão: 1.0.0 Valor padrão: apigee-data apigee-data é o nó do banco de dados do Cassandra. Valor do rótulo do seletor de nós para segmentar nós do Kubernetes para trabalhar com dados de serviços da Apigee. Consulte Configurar pools de nós dedicados.
nodeSelector.apigeeRuntime.key	Avançado	Introduzida na versão: 1.0.0 Valor padrão: cloud.google.com/gke-nodepool O ambiente de execução da Apigee é o nó do ambiente de execução do projeto. Chave de rótulo do seletor de nós para segmentar nós do Kubernetes para serviços do ambiente de execução da Apigee. Consulte Configurar pools de nós dedicados.
nodeSelector.apigeeRuntime.value	Avançado	Introduzida na versão: 1.0.0 Valor padrão: apigee-runtime apigee-runtime é o nó do ambiente de execução do projeto; Valor do rótulo do seletor de nós para segmentação de nós do Kubernetes para serviços do ambiente de execução da Apigee. Consulte Configurar pools de nós dedicados.
nodeSelector.requiredForScheduling	Avançado	Introduzida na versão: 1.0.0 Valor padrão: verdadeiro A propriedade requiredForScheduling assume como padrão true. Em caso de true, isso significa que, se o Kubernetes não conseguir encontrar nós com a chave/valor de rótulo configurados, os pods subjacentes não serão programados nos nós de trabalho da VM. Para a produção, nodeSelector.requiredForScheduling precisa ser definido como verdadeiro. Consulte Configurar pools de nós dedicados.

redis

A tabela a seguir descreve as propriedades do objeto redis:

Propriedade	Tipo	Descrição
redis.auth.password	Básico	Introduzida na versão: 1.6.0 Valor padrão: iloveapis123 Obrigatório Senha do administrador do Redis. O usuário administrador é usado para qualquer atividade administrativa realizada no cluster do Redis.
redis.auth.secret	Básico	Introduzida na versão: 1.9.1 Valor padrão: Nenhum O nome do arquivo armazenado em um secret do Kubernetes que contém a senha do administrador do Redis. O arquivo secret precisa conter a chave: data: redis.auth.password: encoded_value Consulte também: redis.auth.password Como armazenar dados em um secret do Kubernetes Secrets na documentação do Kubernetes Como criar um secret usando a kubectl na documentação do Kubernetes
redis.envoy.image.pullPolicy	Avançado	Introduzida na versão: 1.6.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
redis.envoy.image.tag	Avançado	Introduzida na versão: 1.6.0 Valor padrão: v1.27.0 O rótulo da versão da imagem do Docker desse serviço.
redis.envoy.image.url	Avançado	Introduzida na versão: 1.6.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
redis.image.pullPolicy	Avançado	Introduzida na versão: 1.6.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
redis.image.tag	Avançado	Introduzida na versão: 1.6.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
redis.image.url	Avançado	Introduzida na versão: 1.6.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
redis.replicaCount	Básico	Introduzida na versão: 1.6.0 Valor padrão: 2 O Redis é um armazenamento replicado. Essa propriedade especifica o número de nós do Redis empregado como um StatefulSet.
redis.resources.requests.cpu	Avançado	Introduzida na versão: 1.6.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos. A Apigee recomenda um valor de 500m a 1000m. Com 0,5 núcleo, um nó Redis geralmente consegue processar 10 mil QPS. Com 1,0 núcleos, ele normalmente processa 20 mil QPS. Recursos de solicitação de CPU acima de 1.000 m não são úteis na maioria dos casos.
redis.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
redis.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
redis.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
redis.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
redis.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

runtime

A tabela a seguir descreve as propriedades do objeto runtime:

Propriedade	Tipo	Descrição
runtime.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
runtime.envVars	Básico	Introduzido na versão:1.13.1 Valor padrão: Nenhum Permite fornecer variáveis de ambiente adicionais ao componente de execução em um par de chave-valor: runtime: envVars: KEY_1: VALUE_N ... ... KEY_N: VALUE_N por exemplo: runtime: envVars: RUNTIME_ENV_VAR1: "value of runtime env-var 1" RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
runtime.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
runtime.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
runtime.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
runtime.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 60 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
runtime.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
runtime.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
runtime.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Chave de rótulo do seletor de nós opcional para segmentar nós do Kubernetes para serviços runtime. Consulte propriedade nodeSelector.
runtime.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Valor do rótulo do seletor de nós para segmentar nós do Kubernetes para serviços runtime. Consulte Como configurar pools de nós dedicados.
runtime.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
runtime.readinessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 60 O número de segundos após o início de um contêiner antes de uma sondagem de preparo.
runtime.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
runtime.readinessProbe.successThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de preparo seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
runtime.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
runtime.replicaCountMax	Básico	Introduzida na versão: 1.0.0 Valor padrão: 4 Número máximo de réplicas disponíveis para escalonamento automático.
runtime.replicaCountMin	Básico	Introduzida na versão: 1.0.0 Valor padrão: 1 Número mínimo de réplicas disponíveis para escalonamento automático.
runtime.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 4000m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
runtime.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 6Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
runtime.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos. Observação: para garantir um escalonamento automático suave dos processadores de mensagens a fim de acomodar aumentos de tráfego, recomendamos não exceder dois núcleos (2000 millicores) se você decidir modificar o padrão. Os componentes do ambiente de execução do Apigee são limitados pela E/S, e a adição de mais capacidade de CPU nem sempre ajuda com o aumento do tráfego. Quando há solicitações de CPU altas, os processadores de mensagens podem não escalonar automaticamente, e as sondagens de ativação podem falhar com alto tráfego.
runtime.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 512Mi (confira a observação abaixo) A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes (Mi) ou Gibibytes (Gi). Observação: redefina o valor de runtime.resources.requests.memory para pelo menos 1Gi no seu overrides.yaml. O padrão de 512Mi é suficiente para operação inicial e configuração, mas precisa ser gerado para produção. Para alcançar o escalonamento automático suave dos processadores de mensagens a fim de acomodar aumentos de tráfego, recomendamos não exceder a 2,5Gi (2.560 Mi) se você decidir modificar o padrão.
runtime.service.type	Avançado	Introduzida na versão: 1.0.0 Valor padrão: ClusterIP O tipo de serviço. Você pode definir isso como um serviço diferente de ClusterIP. Por exemplo, LoadBalancer.
runtime.targetCPUUtilizationPercentage	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 75 Meta de uso da CPU para o processo do ambiente de execução no pod. O valor desse campo permite que o ambiente de execução seja escalonado automaticamente quando a utilização da CPU atingir esse valor, até replicaCountMax.
runtime.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 180 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
runtime.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
runtime.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
runtime.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
runtime.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
runtime.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

synchronizer

Garanta que os processadores de mensagens sejam mantidos atualizados com os pacotes de proxy de API implantados mais recentes. Para fazer isso, o Synchronizer pesquisa o plano de gerenciamento. Quando um novo contrato é detectado, o Synchronizer o envia para o plano de ambiente de execução. Por padrão, o Sync sincroniza dados de configuração do ambiente no Cassandra.

Para saber mais, consulte Configurar o sincronizador.

A tabela a seguir descreve as propriedades do objeto synchronizer:

Propriedade	Tipo	Descrição
synchronizer.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
synchronizer.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
synchronizer.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
synchronizer.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
synchronizer.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
synchronizer.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
synchronizer.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
synchronizer.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
synchronizer.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Chave de rótulo do seletor de nó opcional para segmentar nós do Kubernetes para serviços do ambiente de execução synchronizer. Consulte nodeSelector.
synchronizer.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Valor do rótulo do seletor de nós opcional usado para segmentação de nós do Kubernetes para synchronizer serviços do ambiente de execução. Consulte nodeSelector.
synchronizer.pollInterval	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 60 O tempo que o Synchronizer aguarda entre as operações de pesquisa. O Synchronizer pesquisa os serviços do plano de controle do Apigee para detectar e receber novos contratos de ambiente de execução.
synchronizer.readinessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.
synchronizer.readinessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 O número de segundos após o início de um contêiner antes de uma sondagem de preparo.
synchronizer.readinessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.
synchronizer.readinessProbe.successThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de sucessos consecutivos necessários para que uma sondagem de preparo seja considerada bem-sucedida após uma falha. O valor mínimo é 1.
synchronizer.readinessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
synchronizer.replicaCount	Básico	Introduzida na versão: 1.0.0 Deprecated: a partir da Apigee híbrida 1.2, gerencie a contagem de réplicas do sincronizador com: synchronizer.replicaCountMax e synchronizer.replicaCountMin
synchronizer.replicaCountMax	Básico	Introduzida na versão: 1.2.0 Valor padrão: 4 Número máximo de réplicas para escalonamento automático.
synchronizer.replicaCountMin	Básico	Introduzida na versão: 1.2.0 Valor padrão: 1 Número mínimo de réplicas para escalonamento automático.
synchronizer.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 2000m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
synchronizer.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 5Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
synchronizer.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 100m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
synchronizer.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1Gi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em gigabytes.
synchronizer.serviceAccountPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google com o papel Apigee Synchron Manager.
synchronizer.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef.
synchronizer.serviceAccountSecret	Básico	Introduzido na versão:1.1.0 Valor padrão: Nenhum O nome de um secret do Kubernetes. É necessário criar o secret usando uma chave de conta de serviço do Google com o papel Apigee Synchronizer Manager como entrada.
synchronizer.targetCPUUtilizationPercentage	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 75 Meta de uso da CPU para o processo do Synchronizer no pod. O valor desse campo permite que o Synchronizer faça o escalonamento automático quando a utilização da CPU atingir esse valor, até replicaCountMax.
synchronizer.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 30 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
synchronizer.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
synchronizer.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
synchronizer.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
synchronizer.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
synchronizer.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

udca

(Agente universal de coleta de dados) define o serviço que é executado no pod de coleta de dados no plano do ambiente de execução. Esse serviço extrai dados de status de análise e implantação e os envia para a plataforma de análise unificada (UAP, na sigla em inglês).

Para mais informações, consulte Coleta de dados de status de implantação e análise.

A tabela a seguir descreve as propriedades do objeto udca:

Propriedade	Tipo	Descrição
udca.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
udca.fluentd.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
udca.fluentd.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.9.12-2 O rótulo da versão da imagem do Docker desse serviço.
udca.fluentd.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent O local da imagem do Docker desse serviço.
udca.fluentd.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 1000m O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
udca.fluentd.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 500Mi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
udca.fluentd.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 500m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
udca.fluentd.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 250Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
udca.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) apigee-udca a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
udca.image.pullPolicy	Avançado	Introduzida na versão: 1.0.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
udca.image.tag	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
udca.image.url	Avançado	Introduzida na versão: 1.0.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
udca.jvmXms	Avançado	Introduzida na versão: 1.0.0 Deprecated: a partir da versão híbrida 1.8, udca.jvmXms não é mais usada.
udca.jvmXmx	Avançado	Introduzida na versão: 1.0.0 Deprecated: a partir da versão híbrida 1.8, udca.jvmXmx não é mais usada.
udca.livenessProbe.failureThreshold	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 2 O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.
udca.livenessProbe.initialDelaySeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 0 O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.
udca.livenessProbe.periodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 5 Determina a frequência com que uma sondagem de atividade será feita, em segundos. O valor mínimo é 1.
udca.livenessProbe.timeoutSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.
udca.nodeSelector.key	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução udca. Consulte Como configurar pools de nós dedicados.
udca.nodeSelector.value	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum Obrigatório Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução udca. Consulte Como configurar pools de nós dedicados.
udca.pollingIntervalInSec	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 1 O tempo, em segundos, que a UDCA aguarda entre as operações de pesquisa. A UDCA pesquisa o diretório de dados no sistema de arquivos do pod de coleta de dados para detectar novos arquivos.
udca.replicaCountMax	Básico	Introduzida na versão: 1.0.0 Valor padrão: 4 O número máximo de pods que o híbrido pode adicionar automaticamente para a implantação da UDCA. Como a UDCA é implementada como um ReplicaSet, os pods são réplicas. É recomendável definir udca.replicaCountMax como um número máximo de réplicas por ambiente vezes o número de ambientes na sua organização da Apigee. Por exemplo, se quiser no máximo quatro réplicas por ambiente e tiver três ambientes, defina udca.replicaCountMax: 12. Se você estiver usando UDCA com escopo no ambiente, defina udca.replicaCountMax como o número máximo de réplicas para um único ambiente. Consulte orgScopedUDCA.
udca.replicaCountMin	Básico	Introduzida na versão: 1.0.0 Valor padrão: 1 O número mínimo de pods para implantação da UDCA. Como a UDCA é implementada como um ReplicaSet, os pods são réplicas. Se o uso da CPU ultrapassar udca.targetCPUUtilizationPercentage, o híbrido aumentará gradualmente o número de pods, até udca.replicaCountMax.
udca.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 1000m O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
udca.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 2Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
udca.resources.requests.cpu	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 250m A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.
udca.resources.requests.memory	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 250Mi A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.
udca.revision	Avançado	Introduzida na versão: 1.0.0 Valor padrão: v1 Um valor estático preenchido em um rótulo para ativar implantações canário.
udca.serviceAccountPath	Básico	Introduzida na versão: 1.0.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef. Caminho para o arquivo de chave da conta de serviço do Google com o papel Agente do Apigee Analytics.
udca.serviceAccountRef	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário incluir um destes campos: serviceAccountPath ou serviceAccountRef.
udca.targetCPUUtilizationPercentage	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 75 O limite de uso da CPU para escalonar o número de pods no ReplicaSet, como uma porcentagem do total de recursos de CPU disponíveis. O híbrido usa a combinação combinada de todos os contêineres no pod de coleta de dados (fluentd e UDCA) para calcular a utilização atual. Quando o uso da CPU ultrapassar esse valor, o híbrido aumentará gradualmente o número de pods no ReplicaSet, até udca.replicaCountMax.
udca.terminationGracePeriodSeconds	Avançado	Introduzida na versão: 1.0.0 Valor padrão: 600 O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.
udca.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
udca.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
udca.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
udca.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
udca.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.

virtualhosts

A propriedade virtualhosts é uma propriedade de configuração obrigatória. Os hosts virtuais permitem que a Apigee híbrida processe solicitações de API para um grupo de ambiente especificado.

Para mais informações, consulte Configurar hosts virtuais.

A tabela a seguir descreve as propriedades do objeto virtualhosts:

Propriedade	Tipo	Descrição
virtualhosts[].additionalGateways	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Uma lista de gateways do Istio para rotear o tráfego.
virtualhosts[].cipherSuites[]	Avançado	Introduzida na versão: 1.9.2 Valor padrão: Nenhum Essa propriedade configura as criptografias TLS usadas no gateway de entrada. Confira abaixo uma lista das criptografias ativadas por padrão no formato OpenSSL. Veja mais informações sobre as criptografias compatíveis na documentação do Boring FIPS build of Envoy (em inglês). Um valor em branco é padronizado para os pacotes de criptografia compatíveis com o build Boring do FIPS do Envoy. Ativado por padrão para o TLS v.1.3. Não é possível modificar os pacotes de criptografia do TLS 1.3: TLS_AES_128_GCM_SHA256 TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 Ativado por padrão para o TLS v.1.2: ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-GCM-SHA384 Se você quiser ativar versões mais antigas do TLS na implantação do gateway de entrada da Apigee, use virtualhosts.minTLSProtocolVersion com a propriedade virtualhosts.cipherSuites. Por exemplo, para ativar a TLS v.1.1: virtualhosts: - name: ENV_GROUP_NAME minTLSProtocolVersion: "1.1" cipherSuites: - "ECDHE-ECDSA-AES128-GCM-SHA256" - "ECDHE-RSA-AES128-GCM-SHA256" - "ECDHE-ECDSA-AES256-GCM-SHA384" - "ECDHE-RSA-AES256-GCM-SHA384" - "ECDHE-ECDSA-CHACHA20-POLY1305" - "ECDHE-RSA-CHACHA20-POLY1305" - "ECDHE-ECDSA-AES128-SHA" - "ECDHE-RSA-AES128-SHA" - "ECDHE-ECDSA-AES256-SHA" - "ECDHE-RSA-AES256-SHA" ... Observação: essa propriedade substitui a lista de pacotes de criptografia com suporte do Envoy e não é adicionada ao final dela.
virtualhosts[].name	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum Obrigatório O nome do host virtual.
virtualhosts[].maxTLSProtocolVersion	Básico	Introduzida na versão: 1.3.0 Valor padrão: Nenhum A versão máxima do protocolo TLS que o Envoy pode selecionar. O Envoy usa automaticamente a versão ideal do protocolo TLS entre virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion. O valor precisa estar na forma de um número. Por exemplo: virtualhosts: - name: default maxTLSProtocolVersion: "1.3" Onde o número representa o número da versão TLS no formato #.#. No exemplo acima, "1.3" representa a versão TLS do Istio TLSV1_3. Consulte também ServerTLSSettings.TLSProtocol na documentação do Istio.
virtualhosts[].minTLSProtocolVersion	Básico	Introduzida na versão: 1.3.0 Valor padrão: Nenhum A versão mínima do protocolo TLS que o Envoy pode selecionar. O Envoy usa automaticamente a versão ideal do protocolo TLS entre virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion. O valor precisa estar na forma de um número. Por exemplo: virtualhosts: - name: default minTLSProtocolVersion: "1.2" Onde o número representa o número da versão TLS no formato #.#. No exemplo acima, 1.2 representa a versão TLS do Istio TLSV1_2. Consulte também ServerTLSSettings.TLSProtocol na documentação do Istio.
virtualhosts[].selector	Básico	Introduzida na versão: 1.2.0 Valor padrão: app: apigee-ingressgateway Obrigatório Um par de valor-chave seletora de valor-chave para apontar para diferentes seletores de entrada. apigee-ingressgateway: para instalações híbridas da Apigee usando o gateway de entrada da Apigee. istio-ingressgateway: para instalações híbridas da Apigee que usam o Cloud Service Mesh (versões híbridas 1.8 e anteriores da Apigee). Se nenhum rótulo do seletor for fornecido, a configuração será fornecida para o gateway de entrada da Apigee.
virtualhosts[].sslCertPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O caminho no seu sistema para um arquivo de certificado TLS. Observação: para cada ambiente configurado, o Nome comum (CN, na sigla em inglês) no certificado precisa corresponder ao domínio na propriedade hostAliases[]. Por exemplo, se o CN for *.example.com, hostAliases[] poderá ser foo.example.com ou bar.example.com.
virtualhosts[].sslKeyPath	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O caminho no seu sistema para o arquivo de chave privada TLS.
virtualhosts[].sslSecret	Básico	Introduzida na versão: 1.2.0 Valor padrão: Nenhum É necessário sslCertPath/sslKeyPath ou sslSecret. O nome de um arquivo armazenado em um secret do Kubernetes que contém o certificado TLS e a chave privada. Você precisa criar o secret usando o certificado TLS e os dados da chave como entrada. Consulte também: Como armazenar dados em um secret do Kubernetes Secrets na documentação do Kubernetes Como criar um secret usando a kubectl na documentação do Kubernetes

watcher

A propriedade watcher é uma propriedade de configuração obrigatória. O inspetor é um processo que monitora alterações de configuração e aciona o aplicativo no plano do ambiente de execução.

A tabela a seguir descreve as propriedades do objeto watcher:

Propriedade	Tipo	Descrição
watcher.annotations	Avançado	Introduzida na versão: 1.5.0 Valor padrão: Nenhum Mapa opcional de chave-valor usado para anotar pods. Para mais informações, consulte Anotações personalizadas.
watcher.args.enableIssueScanning	Avançado	Introduzida na versão: 1.10.0 Valor padrão: true Ativa ou desativa a exibição automática de problemas. Quando true, o inspetor verifica automaticamente o plano de controle e o estado do servidor da API Kubernetes para determinar se há algum problema de configuração. Defina como false para desativar a exibição automática de problemas. Para mais informações, consulte Solução de problemas automatizada.
watcher.args.enableLeaderElect	Avançado	Introduzido na versão:1.13.0 Valor padrão: true Quando true (padrão) watcher.args.enableLeaderElect seleciona um único pod de watcher para gerenciar e informar as informações de roteamento. Limitar isso a um único pod é necessário para evitar inatividades durante upgrades ou rollbacks. Durante esses eventos, várias versões do watcher podem ser executadas simultaneamente. Cada instância do Watcher pode ter uma lógica de criação de rota diferente, o que pode causar inatividade.watcher.replicaCountMax.
watcher.args.issueScanInterval	Avançado	Introduzida na versão: 1.10.0 Valor padrão: 60 O intervalo em segundos da frequência com que o inspetor analisa o plano do ambiente de execução para identificar problemas automatizados. Para mais informações, consulte Solução de problemas automatizada.
watcher.gsa	Avançado	Introduzida na versão: 1.10.0 Valor padrão: Nenhum Somente Helm: o endereço de e-mail da conta de serviço do IAM do Google (GSA) apigee-watcher a ser associada à conta de serviço correspondente do Kubernetes ao ativar a Identidade da carga de trabalho nos clusters do GKE usando gráficos do Helm. Faça essa configuração quando for preciso definir gcp.workloadIdentity.enabled como true. Os endereços de e-mail da GSA costumam ter o seguinte formato: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com Exemplo: [e-mail] Dica: para encontrar o endereço de e-mail das contas de serviço, use o seguinte comando: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Consulte Como ativar a Identidade da carga de trabalho no GKE ou Como ativar a federação de identidade da carga de trabalho no AKS e EKS.
watcher.image.pullPolicy	Avançado	Introduzida na versão: 1.4.0 Valor padrão: IfNotPresent Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem: IfNotPresent: não extraia uma nova imagem se ela já existir. Always: sempre extraia a imagem, independentemente de ela existir. Para mais informações, consulte Como atualizar imagens.
watcher.image.tag	Avançado	Introduzida na versão: 1.4.0 Valor padrão: 1.14.0 O rótulo da versão da imagem do Docker desse serviço.
watcher.image.url	Avançado	Introduzida na versão: 1.4.0 Valor padrão: Nenhum O local da imagem do Docker desse serviço. Use apigee-pull-push --list para conferir o URL do repositório atual desse componente. Dica: use hub para definir um URL de repositório particular para todos os componentes em vez de configurá-los individualmente.
watcher.replicaCountMax	Básico	Introduzida na versão: 1.3.0 Valor padrão: 1 O número máximo de réplicas do inspetor. Deve ser mantido em 1 para evitar conflitos. A Apigee híbrida usa um pod de watcher por instalação. A eleição de líder seleciona automaticamente um pod de watcher. As réplicas de pod do watcher serão forçadas para um estado instável. Consulte watcher.args.enableLeaderElect. Aviso:não exceda o valor de 1 para watcher.replicaCountMax.
watcher.replicaCountMin	Básico	Introduzida na versão: 1.3.0 Valor padrão: 1 O número mínimo de réplicas do inspetor.
watcher.resources.limits.cpu	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 1000m O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.
watcher.resources.limits.memory	Avançado	Introduzido na versão: 1.11.0 Valor padrão: 2Gi O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.
watcher.serviceAccountPath	Básico	Introduzida na versão: 1.3.0 Valor padrão: Nenhum Obrigatório. Caminho para o arquivo de chave da conta de serviço do Google com o papel de agente de ambiente de execução da Apigee.
watcher.serviceAccountRef	Avançado	Introduzida na versão: 1.3.0 Valor padrão: Nenhum É necessário escolher serviceAccountPath ou serviceAccountSecretRef.
watcher.tolerations.effect	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. effect especifica o efeito que a correspondência de uma tolerância com um taint terá. Os valores para effect podem ser: NoExecute NoSchedule PreferNoSchedule Consulte taints e tolerâncias: conceitos para mais detalhes.
watcher.tolerations.key	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Necessário para usar o recurso taints e tolerâncias do Kubernetes. key identifica os pods em que a tolerância pode ser aplicada. Consulte taints e tolerâncias: conceitos para mais detalhes.
watcher.tolerations.operator	Avançado	Introduzida na versão: 1.10.1 Valor padrão: "Equal" Necessário para usar o recurso taints e tolerâncias do Kubernetes. operator especifica a operação usada para acionar o effect. Os valores para operator podem ser: Equal corresponde ao valor definido em value. Exists ignora o valor definido em value. Consulte taints e tolerâncias: conceitos para mais detalhes.
watcher.tolerations.tolerationSeconds	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. tolerationSeconds define, em segundos, por quanto tempo um pod permanece vinculado a um nó com falha ou sem resposta. Consulte taints e tolerâncias: conceitos para mais detalhes.
watcher.tolerations.value	Avançado	Introduzida na versão: 1.10.1 Valor padrão: Nenhum Usado pelo recurso taints e tolerâncias do Kubernetes. value é o valor que aciona o effect quando operator está definido como Equal. Consulte taints e tolerâncias: conceitos para mais detalhes.