Referência da propriedade de configuração

Esta secção apresenta todas as propriedades de configuração que pode usar para personalizar o plano de tempo de execução da sua implementação híbrida do Apigee.

Propriedades de nível superior

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

Propriedade Descrição
axHashSalt

Introduzido na versão: 1.3.0

Valor predefinido: o nome da sua organização

Opcional

O nome de um segredo do Kubernetes que contém um valor de salt de hash usado para encriptar dados do utilizador ocultados enviados para o Apigee Analytics. Se não especificar um valor de salt, é usado o nome da sua organização por predefinição. Crie o segredo com o valor de salt como entrada. Pode usar o mesmo valor aleatório em vários clusters para garantir resultados de hash consistentes entre os clusters.

contractProvider Introduzido na versão: 1.0.0

Valor predefinido: https://apigee.googleapis.com

Define o caminho da API para todas as APIs na sua instalação.

gcpProjectID Deprecated: Para a versão 1.2.0 e posteriores, use gcp.projectID.

Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

ID do seu projeto do Google Cloud. Funciona com o k8sClusterName (descontinuado) e o gcpRegion (descontinuado) para identificar o projeto e determinar onde o apigee-logger e o apigee-metrics enviam os respetivos dados.

gcpRegion Deprecated: Para a versão 1.2.0 e posteriores, use gcp.region.

Introduzido na versão: 1.0.0

Valor predefinido: us-central1

Obrigatório

A região ou a zona do Google Cloud mais próxima do seu cluster do Kubernetes. Funciona com o gcpProjectID (descontinuado) e o k8sClusterName (descontinuado) para identificar o projeto e determinar onde o apigee-logger e o apigee-metrics enviam os respetivos dados.

imagePullSecrets.name Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Nome do segredo do Kubernetes configurado como tipo docker-registry; usado para extrair imagens do repositório privado.

instanceID Introduzido na versão: 1.3.0

Valor predefinido: nenhum

Obrigatório

Um identificador exclusivo desta instalação.

Uma string exclusiva para identificar esta instância. Pode ser qualquer combinação de letras e números com um máximo de 63 carateres.

k8sClusterName Deprecated: Para a versão 1.2.0 e posteriores, use k8sCluster.name e k8sCluster.region.

Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Nome do procluster do Kubernetes (K8S) onde o seu projeto híbrido está a ser executado. Funciona com o gcpProjectID (descontinuado) e o gcpRegion (descontinuado) para identificar o projeto e determinar onde o apigee-logger e o apigee-metrics enviam os respetivos dados.

kmsEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: defaults.org.kmsEncryptionKey

Opcional. Use apenas um de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret.

Caminho do sistema de ficheiros local para a chave de encriptação dos dados do KMS do Apigee.

kmsEncryptionPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret.

O caminho para um ficheiro que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

kmsEncryptionSecret.key Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret.

A chave de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

kmsEncryptionSecret.name Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um de kmsEncryptionKey, kmsEncryptionPath ou kmsEncryptionSecret.

O nome de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

kvmEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: defaults.org.kmsEncryptionKey

Opcional. Use apenas um dos seguintes elementos: kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret.

Caminho do sistema de ficheiros local para a chave de encriptação dos dados da KVM do Apigee.

kvmEncryptionPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um dos seguintes elementos: kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret.

O caminho para um ficheiro que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

kvmEncryptionSecret.key Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um dos seguintes elementos: kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret.

A chave de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

kvmEncryptionSecret.name Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Opcional. Use apenas um dos seguintes elementos: kvmEncryptionKey, kvmEncryptionPath ou kvmEncryptionSecret.

O nome de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

namespace Introduzido na versão: 1.0.0

Valor predefinido: apigee

O espaço de nomes do cluster do Kubernetes onde os componentes do Apigee vão ser instalados.

org

Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

A organização com capacidade híbrida que foi aprovisionada para si pelo Apigee durante a instalação híbrida. Uma organização é o contentor de nível superior no Apigee. Contém todos os seus proxies de API e recursos relacionados. Se o valor estiver vazio, tem de o atualizar com o nome da sua organização assim que o criar.

orgScopedUDCA Introduzido na versão: 1.8.0

Valor predefinido: true

Ativa o serviço do agente de recolha de dados universal (UDCA) ao nível da organização, que extrai dados de estatísticas, rentabilização e depuração (rastreio) e envia-os para a plataforma de estatísticas unificada (UAP), que reside no plano de controlo.

Se preferir usar um agente UDCA separado para cada ambiente, defina orgScopedUDCA: false e defina os valores para envs[].serviceAccountPaths.udca e envs[].serviceAccountSecretRefs.udca.

Veja também: udca.

revision Introduzido na versão: 1.0.0

Valor predefinido: v120

O Apigee hybrid suporta atualizações contínuas do Kubernetes, que permitem que as atualizações de implementação ocorram sem tempo de inatividade, atualizando incrementalmente as instâncias de pods com novas.

Quando atualiza determinadas substituições de YAML que resultam numa alteração subjacente do Kubernetes, a propriedade de substituição revision também tem de ser alterada no override.yaml do cliente.PodTemplateSpec Isto é necessário para que o controlador ApigeeDeployment (AD) subjacente do Kubernetes faça uma atualização progressiva segura da versão anterior para a nova versão. Pode usar qualquer valor de texto em letras minúsculas, por exemplo: blue, a, 1.0.0

Quando a propriedade revision é alterada e aplicada, ocorre uma atualização contínua para todos os componentes

As alterações às propriedades dos seguintes objetos requerem uma atualização de revision:

Para mais informações, consulte o artigo Atualizações contínuas.

validateOrg Introduzido na versão: 1.8.0

Valor predefinido: true

Ativa a validação rigorosa da associação entre a organização do Apigee e o projeto da GCP, e verifica a existência de grupos de ambientes.

Veja também org

validateServiceAccounts Introduzido na versão: 1.0.0

Valor predefinido: true

Ativa a validação rigorosa das autorizações da conta de serviço. Isto usa o método da API Cloud Resource Manager testIamPermissions para verificar se a conta de serviço fornecida tem as autorizações necessárias. No caso de contas de serviço para uma organização da Apigee, a verificação do ID do projeto é a mapeada para a organização. Para as métricas e o registador, o projeto verificado baseia-se na configuração de gcpProjectID overrides.yaml.

Veja também gcpProjectID

ao

Os operadores da Apigee (AO) criam e atualizam recursos de Kubernetes e Istio de baixo nível necessários para implementar e manter um componente. Por exemplo, o controlador executa a libertação dos processadores de mensagens.

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

Propriedade Descrição
ao.args.disableIstioConfigInAPIServer Introduzido na versão: 1.8.0

Valor predefinido: false

Impede que o Apigee forneça configuração ao ASM instalado pelo cliente.

  • Definido como true para instalações híbridas que usam o gateway de entrada do Apigee.
  • Definido como false para instalações híbridas que usam o Anthos Service Mesh.
ao.image.pullPolicy Introduzido na versão: 1.2.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

ao.image.tag Introduzido na versão: 1.2.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

ao.image.url Introduzido na versão: 1.2.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-operators

A localização da imagem do Docker para este serviço.

ao.installer.pullPolicy Introduzido na versão: 1.3.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

ao.installer.tag Introduzido na versão: 1.3.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

ao.installer.url Introduzido na versão: 1.3.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-installer

A localização da imagem do Docker para este serviço.

ao.resources.limits.cpu Introduzido na versão: 1.2.0

Valor predefinido: 250m

O limite da CPU para o recurso num contentor do Kubernetes, em milicores.

ao.resources.limits.memory Introduzido na versão: 1.2.0

Valor predefinido: 256Mi

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

ao.resources.requests.cpu Introduzido na versão: 1.2.0

Valor predefinido: 250m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

ao.resources.requests.memory Introduzido na versão: 1.2.0

Valor predefinido: 256Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

cassandra

Define o serviço híbrido que gere o repositório de dados de tempo de execução. Este repositório armazena configurações de aplicações, contadores de quotas distribuídos, chaves de API e tokens OAuth para aplicações em execução no gateway.

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

A tabela seguinte descreve as propriedades do objeto cassandra:

Propriedade Descrição
cassandra.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

cassandra.auth.admin.password Introduzido na versão: 1.0.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do administrador do Cassandra. O utilizador administrador é usado para quaisquer atividades administrativas realizadas no cluster do Cassandra.

cassandra.auth.ddl.password Introduzido na versão: 1.0.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do utilizador da linguagem de definição de dados (LDD) do Cassandra. Usado pelo MART para qualquer uma das tarefas de definição de dados, como a criação, a atualização e a eliminação do espaço de chaves.

cassandra.auth.default.password Introduzido na versão: 1.0.0

Valor predefinido: iloveapis123

Obrigatório

A palavra-passe do utilizador predefinido do Cassandra criado quando a autenticação está ativada. Esta palavra-passe tem de ser reposta quando configurar a autenticação do Cassandra. Consulte o artigo Configurar o TLS para o Cassandra.

cassandra.auth.dml.password Introduzido na versão: 1.0.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do utilizador da linguagem de manipulação de dados (DML) do Cassandra. O utilizador de DML é usado pela comunicação do cliente para ler e escrever dados no Cassandra.

cassandra.auth.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

cassandra.auth.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

cassandra.auth.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client

A localização da imagem do Docker para este serviço.

cassandra.auth.jmx.password Introduzido na versão: 1.4.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do utilizador de operações JMX do Cassandra. Usado para autenticar e comunicar com a interface JMX do Cassandra.

cassandra.auth.jmx.username Introduzido na versão: 1.4.0

Valor predefinido: jmxuser

Obrigatório

Nome de utilizador do utilizador de operações JMX do Cassandra. Usado para autenticar e comunicar com a interface JMX do Cassandra.

cassandra.auth.jolokia.password Introduzido na versão: 1.4.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do utilizador de operações JMX do Cassandra Jolokia. Usado para autenticar e comunicar com a API JMX do Cassandra.

cassandra.auth.jolokia.username Introduzido na versão: 1.4.0

Valor predefinido: apigee

Obrigatório

Nome de utilizador do utilizador de operações JMX do Cassandra Jolokia. Usado para autenticar e comunicar com a API JMX do Cassandra.

cassandra.auth.secret Introduzido na versão: 1.3.3

Valor predefinido: nenhum

O nome do ficheiro armazenado num segredo do Kubernetes que contém os utilizadores e as palavras-passe do Cassandra. Pode criar o segredo seguindo as instruções: Crie o segredo.

Veja também:

cassandra.backup.cloudProvider Introduzido na versão: 1.0.0

Valor predefinido: GCP

Obrigatório se a cópia de segurança estiver ativada.

Fornecedor de nuvem para armazenamento de cópias de segurança.

Pode definir o valor como GCP ou HYBRID. Defina o valor como GCP se quiser armazenar a cópia de segurança no Google Cloud Storage e HYBRID se quiser armazenar a cópia de segurança num servidor remoto.

cassandra.backup.dbStorageBucket Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório se a cópia de segurança estiver ativada.

Contentor do Cloud Storage para os dados da cópia de segurança.

cassandra.backup.enabled Introduzido na versão: 1.0.0

Valor predefinido: false

A cópia de segurança de dados não está ativada por predefinição. Para ativar, defina como true.

Consulte o artigo Cópia de segurança e recuperação do Cassandra.

cassandra.backup.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

cassandra.backup.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

cassandra.backup.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

A localização da imagem do Docker para este serviço.

cassandra.backup.schedule Introduzido na versão: 1.0.0

Valor predefinido: 0 2 * * *

A programação da tarefa cronológica.

Consulte o artigo Cópia de segurança e recuperação do Cassandra.

cassandra.backup.serviceAccountPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessária uma das colunas backup.serviceAccountPath ou backup.serviceAccountRef se a cópia de segurança estiver ativada.

Caminho para o ficheiro de chave da conta de serviço Google com a função Administrador de objetos de armazenamento.

cassandra.backup.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessária uma das colunas backup.serviceAccountPath ou backup.serviceAccountRef se a cópia de segurança estiver ativada.

cassandra.clusterName Introduzido na versão: 1.0.0

Valor predefinido: apigeecluster

Especifica o nome do cluster do Cassandra.

cassandra.datacenter Introduzido na versão: 1.0.0

Valor predefinido: dc-1

Especifica o centro de dados do nó do Cassandra.

cassandra.dnsPolicy Introduzido na versão: 1.1.1

Valor predefinido: nenhum

Quando define hostNetwork como verdadeiro, a política de DNS é definida como ClusterFirstWithHostNet.

cassandra.externalSeedHost Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Nome do anfitrião ou IP de um nó do cluster do Cassandra. Se não for definido, é usado o serviço local do Kubernetes.

cassandra.heapNewSize Introduzido na versão: 1.0.0

Valor predefinido: 100M

A quantidade de memória do sistema JVM alocada a objetos mais recentes, em megabytes.

cassandra.hostNetwork Introduzido na versão: 1.1.1

Valor predefinido: false

Ativa a funcionalidade do Kubernetes hostNetwork. O Apigee usa esta funcionalidade em instalações multirregionais para comunicar entre pods se o espaço de nomes da rede de pods não tiver conetividade entre clusters (os clusters estão a ser executados no "modo de rede isolada"), que é o caso predefinido em instalações não pertencentes ao GKE, incluindo GKE On-Prem, GKE on AWS, Anthos on bare metal, AKS, EKS e OpenShift.

Defina cassandra.hostNetwork como false para instalações de região única e instalações de várias regiões com conetividade entre pods em diferentes clusters, por exemplo, instalações do GKE.

Defina cassandra.hostNetwork como true para instalações em várias regiões sem comunicação entre pods em diferentes clusters, por exemplo, GKE On-Prem, GKE on AWS, Anthos on bare metal, AKS, EKS e instalações do OpenShift. Consulte o artigo Implementação em várias regiões: pré-requisitos.

Quando true, a política de DNS é automaticamente definida como ClusterFirstWithHostNet.

cassandra.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

cassandra.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

cassandra.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra

A localização da imagem do Docker para este serviço.

cassandra.maxHeapSize Introduzido na versão: 1.0.0

Valor predefinido: 512M

O limite superior da memória do sistema JVM disponível para operações do Cassandra, em megabytes.

cassandra.multiRegionSeedHost Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Endereço IP de um cluster do Cassandra existente usado para expandir o cluster existente para uma nova região. Consulte o artigo Configure o host inicial multirregional.

cassandra.nodeSelector.key Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Chave da etiqueta do seletor de nós usada para segmentar nós do Kubernetes dedicados para cassandra serviços de dados.

Consulte o artigo Configurar node pools dedicados.

cassandra.nodeSelector.value Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Valor da etiqueta do seletor de nós opcional usado para segmentar nós Kubernetes dedicados para cassandra serviços de dados e substituir as definições de nodeSelector.apigeeData.

Consulte nodeSelector.

cassandra.port Introduzido na versão: 1.0.0

Valor predefinido: 9042

Número da porta usado para estabelecer ligação ao Cassandra.

cassandra.rack Introduzido na versão: 1.0.0

Valor predefinido: ra-1

Especifica o rack do nó do Cassandra.

cassandra.readinessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes vai verificar se as sondas de prontidão falharam antes de marcar o pod como não pronto. O valor mínimo é 1.

cassandra.readinessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 0

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de prontidão.

cassandra.readinessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 10

Determina a frequência com que é realizada uma sondagem de prontidão, em segundos. O valor mínimo é 1.

cassandra.readinessProbe.successThreshold Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de êxitos consecutivos necessários para que uma sondagem de prontidão seja considerada bem-sucedida após uma falha. O valor mínimo é 1.

cassandra.readinessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

cassandra.replicaCount Introduzido na versão: 1.0.0

Valor predefinido: 1

O Cassandra é uma base de dados replicada. Esta propriedade especifica o número de nós do Cassandra usados como um StatefulSet.

cassandra.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

cassandra.resources.requests.memory Introduzido na versão: 1.0.0

Valor predefinido: 1Gi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

cassandra.restore.cloudProvider Introduzido na versão: 1.0.0

Valor predefinido: GCP

Obrigatório se a opção de restauro estiver ativada.

Fornecedor de nuvem para armazenamento de cópias de segurança.

cassandra.restore.dbStorageBucket Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório se a opção de restauro estiver ativada.

Contentor do Cloud Storage para os dados de cópia de segurança a restaurar.

cassandra.restore.enabled Introduzido na versão: 1.0.0

Valor predefinido: false

cassandra.restore.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

cassandra.restore.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

cassandra.restore.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

A localização da imagem do Docker para este serviço.

cassandra.restore.serviceAccountPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessária uma coluna restore.serviceAccountPath ou restore.serviceAccountRef se o restauro estiver ativado.

Caminho para o ficheiro de chave da conta de serviço Google com a função Administrador de objetos de armazenamento.

cassandra.restore.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessária uma coluna restore.serviceAccountPath ou restore.serviceAccountRef se o restauro estiver ativado.

cassandra.restore.snapshotTimestamp Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório se a opção de restauro estiver ativada.

Data/hora da cópia de segurança que deve ser restaurada.

cassandra.restore.user Introduzido na versão: 1.0.0

Valor predefinido: conta de administrador

Nome de utilizador do Cassandra usado para o restauro da cópia de segurança do esquema. Se não for especificado, é usado o utilizador administrador.

cassandra.sslCertPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

O caminho no seu sistema para um ficheiro de certificado TLS.

cassandra.sslKeyPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

O caminho no seu sistema para o ficheiro de chave privada TLS.

cassandra.sslRootCAPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

A cadeia de certificados para a CA de raiz (autoridade de certificação).

cassandra.storage.capacity Introduzido na versão: 1.0.0

Valor predefinido: 50Gi

Obrigatório se storage.storageclass for especificado

Especifica o tamanho do disco necessário, em mebibytes.

cassandra.storage.storageclass Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Especifica a classe de armazenamento no local que está a ser usada.

cassandra.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 300

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

connectAgent

O Apigee Connect permite que o plano de gestão híbrido do Apigee se ligue de forma segura ao serviço MART no plano de tempo de execução sem que tenha de expor o ponto final do MART na Internet.

Consulte Apigee Connect.

A tabela seguinte descreve as propriedades do objeto connectAgent:

Propriedade Descrição
connectAgent.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

connectAgent.server Introduzido na versão: 1.2.0

Valor predefinido: apigeeconnect.googleapis.com:443

A localização do servidor e a porta para este serviço.

connectAgent.logLevel Introduzido na versão: 1.2.0

Valor predefinido: INFO

O nível de relatórios de registos. Os valores podem ser:

  • INFO: mensagens informativas, além de mensagens de aviso, erro e fatal. Mais útil para a depuração.
  • WARNING: avisos não críticos, além de mensagens de erro e críticas.
  • ERROR: erros internos e erros que não são devolvidos ao utilizador, além de mensagens fatais.
  • FATAL: erros e eventos irrecuperáveis que fazem com que o Apigee Connect falhe.
connectAgent.image.pullPolicy Introduzido na versão: 1.2.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

connectAgent.image.tag Introduzido na versão: 1.2.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

connectAgent.image.url Introduzido na versão: 1.2.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-connect-agent

A localização da imagem do Docker para este serviço. Verifique o ficheiro values.yaml para o URL específico.

connectAgent.replicaCountMax Introduzido na versão: 1.2.0

Valor predefinido: 5

Número máximo de réplicas disponíveis para o escalamento automático.

connectAgent.replicaCountMin Introduzido na versão: 1.2.0

Valor predefinido: 1

Número mínimo de réplicas disponíveis para o ajuste de escala automático.

Na produção, recomendamos que aumente o valor de replicaCountMin para 3, para ter um maior número de ligações ao plano de controlo para fiabilidade e escalabilidade.

connectAgent.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 100m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

connectAgent.resources.requests.memory Introduzido na versão: 1.0.0

Valor predefinido: 30Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

connectAgent.targetCPUUtilizationPercentage Introduzido na versão: 1.2.0

Valor predefinido: 75

Utilização da CPU alvo para o agente do Apigee Connect no pod. O valor deste campo permite o dimensionamento automático do Apigee Connect quando a utilização da CPU atinge este valor, até replicaCountMax.

connectAgent.terminationGracePeriodSeconds Introduzido na versão: 1.2.0

Valor predefinido: 600

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

defaults

As chaves de encriptação predefinidas para a instalação do Apigee Hybrid.

A tabela seguinte descreve as propriedades do objeto defaults:

Propriedade Descrição
defaults.org.kmsEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: aWxvdmVhcGlzMTIzNDU2Nw==

Chave de encriptação predefinida para a organização no KMS.

defaults.org.kvmEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: aWxvdmVhcGlzMTIzNDU2Nw==

Chave de encriptação predefinida para a organização no KVM.

defaults.env.kmsEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: aWxvdmVhcGlzMTIzNDU2Nw==

Chave de encriptação predefinida para o ambiente (env) no KMS.

defaults.env.kvmEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: aWxvdmVhcGlzMTIzNDU2Nw==

Chave de encriptação predefinida para o ambiente (env) no KVM.

defaults.env.cacheEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: aWxvdmVhcGlzMTIzNDU2Nw==

Chave de encriptação da cache predefinida para o ambiente (env).

diagnostic

As definições da ferramenta de recolha de diagnósticos.

Consulte o artigo Usar o coletor de diagnósticos

A tabela seguinte descreve as propriedades do objeto diagnostic:

Propriedade Descrição
diagnostic.bucket Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

O nome do contentor do Google Cloud Storage onde os seus dados de diagnóstico vão ser depositados.

Consulte o artigo Criar contentores de armazenamento.

diagnostic.container Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

Isto especifica o tipo de cápsula a partir do qual está a captar dados. Os valores podem ser um dos seguintes:

  • "apigee-cassandra" capta dados sobre a base de dados Cassandra. Os pods istio-cassandra são executados no espaço de nomes apigee.
  • "apigee-mart-server" capta dados sobre o MART. Os pods apigee-mart-server são executados no espaço de nomes apigee.
  • "apigee-runtime" captura dados sobre o processador de mensagens. Os pods apigee-runtime são executados no espaço de nomes apigee.
  • "apigee-synchronizer" capta dados sobre o sincronizador. Os pods apigee-synchronizer são executados no espaço de nomes apigee.
  • O "apigee-udca" capta dados sobre a UDCA. Os pods apigee-udca são executados no espaço de nomes apigee.
  • "apigee-watcher" capta dados sobre o Watcher. Os pods apigee-watcher são executados no espaço de nomes apigee.
  • "istio-proxy" capta dados sobre o gateway de entrada do Istio. Os pods istio-proxy são executados no espaço de nomes istio-system.
diagnostic.loggingDetails.logDuration Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório se a operação de recolha de diagnósticos for "LOGGING" (definida com operation: "LOGGING")

A duração em milissegundos dos dados de registo recolhidos. Um valor típico é 30000.

Consulte diagnostic.operation

diagnostic.loggingDetails.loggerNames[] Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório se a operação de recolha de diagnósticos for "LOGGING" (definida com operation: "LOGGING")

Especifica por nome os registadores a partir dos quais recolher dados. Para a versão híbrida 1.6.0 do Apigee, o único valor suportado é ALL, o que significa todos os registadores. Por exemplo:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório se a operação de recolha de diagnósticos for "LOGGING" (definida com operation: "LOGGING")

Especifica o nível de detalhe dos dados de registo a recolher. No Apigee hybrid 1.6, apenas FINE é suportado.

diagnostic.namespace Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

O espaço de nomes do Kubernetes no qual residem os pods sobre os quais está a recolher dados. O espaço de nomes tem de ser o correto para o contentor que especificar 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 Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

Especifica se devem ser recolhidas todas as estatísticas ou apenas os registos.

Os valores são:

diagnostic.podNames[] Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

Os nomes dos pods do Kubernetes para os quais está a recolher 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 Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Obrigatório

O caminho para um ficheiro de chave da conta de serviço (.json) para a conta de serviço com a função de administrador do armazenamento (roles/storage.admin). Na maioria das instalações híbridas do Apigee, esta é a conta de serviço apigee-cassandra.

Consulte o artigo Acerca das contas de serviço.

diagnostic.tcpDumpDetails.maxMsgs Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Uma das seguintes opções é obrigatória se estiver a usar diagnostic.tcpDumpDetails: diagnostic.tcpDumpDetails.maxMsgs ou diagnostic.tcpDumpDetails.timeoutInSeconds

Define o número máximo de mensagens tcpDump a recolher. A Apigee recomenda um valor máximo não superior a 1000.

diagnostic.tcpDumpDetails.timeoutInSeconds Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Uma das seguintes opções é obrigatória se estiver a usar diagnostic.tcpDumpDetails: diagnostic.tcpDumpDetails.maxMsgs ou diagnostic.tcpDumpDetails.timeoutInSeconds

Define o tempo em segundos a aguardar que tcpDump devolva mensagens.

diagnostic.threadDumpDetails.delayInSeconds Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Ambos os campos diagnostic.threadDumpDetails.delayInSeconds e diagnostic.threadDumpDetails.iterations são obrigatórios se estiver a usar o diagnostic.threadDumpDetails.

O atraso em segundos entre a recolha de cada despejo de threads.

diagnostic.threadDumpDetails.iterations Introduzido na versão: 1.6.0

Valor predefinido: nenhum

Ambos os campos diagnostic.threadDumpDetails.delayInSeconds e diagnostic.threadDumpDetails.iterations são obrigatórios se estiver a usar o diagnostic.threadDumpDetails.

O número de iterações de despejo de threads jstack a recolher.

envs

Define uma matriz de ambientes para os quais pode implementar os seus proxies de API. Cada ambiente oferece um contexto isolado ou uma sandbox para executar proxies de API.

A sua organização com a funcionalidade híbrida ativada tem de ter, pelo menos, um ambiente.

Para mais informações, consulte o artigo Acerca dos ambientes.

A tabela seguinte descreve as propriedades do objeto envs:

Propriedade Descrição
envs[].cacheEncryptionKey Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: cacheEncryptionKey, cacheEncryptionPath ou cacheEncryptionSecret.

Uma chave de encriptação codificada em Base64. Consulte a secção Encriptação de dados.

envs[].cacheEncryptionPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: cacheEncryptionKey, cacheEncryptionPath ou cacheEncryptionSecret.

O caminho para um ficheiro que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

envs[].cacheEncryptionSecret.key Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: cacheEncryptionKey, cacheEncryptionPath ou cacheEncryptionSecret.

A chave de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

envs[].cacheEncryptionSecret.name Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: cacheEncryptionKey, cacheEncryptionPath ou cacheEncryptionSecret.

O nome de um segredo do Kubernetes que contém uma chave de encriptação codificada em base64. Consulte a secção Encriptação de dados.

envs[].hostAliases[] Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Deprecated: a partir da versão híbrida 1.4, o plano de tempo de execução recebe estas informações do plano de gestão. Consulte o artigo Acerca dos ambientes e dos grupos de ambientes.

envs[].httpProxy.host Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Especifica o nome do anfitrião ou o endereço IP onde o proxy HTTP está em execução.

Listar httpProxy propriedades pela ordem scheme, host, port. Por exemplo:

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

Consulte também: Configure o encaminhamento de proxy para proxies de API.

envs[].httpProxy.port Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Especifica a porta na qual o proxy HTTP está em execução. Se esta propriedade for omitida, por predefinição, usa a porta 80 para HTTP e a porta 443 para HTTPS.

envs[].httpProxy.scheme Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Especifica o tipo de proxy HTTP como HTTP ou HTTPS. Por predefinição, usa "HTTP".

envs[].httpProxy.username Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Se o proxy HTTP exigir autenticação básica, use esta propriedade para fornecer um nome de utilizador.

envs[].httpProxy.password Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Se o proxy HTTP exigir autenticação básica, use esta propriedade para fornecer uma palavra-passe.

envs[].name Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Nome do ambiente Apigee a sincronizar.

envs[].pollInterval Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Intervalo usado para sondar alterações de sincronização da organização e do ambiente, em segundos.

envs[].port Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Número da porta TCP para tráfego HTTPS.

envs[].serviceAccountPaths.runtime Introduzido na versão: 1.4.0

Valor predefinido: nenhum

Caminho para o ficheiro no sistema local para uma chave da conta de serviço Google com a função Agente do Cloud Trace, normalmente a conta de serviço apigee-runtime. Consulte o artigo Acerca das contas de serviço para ver os nomes predefinidos das contas de serviço e as respetivas funções atribuídas.

envs[].serviceAccountPaths.synchronizer Introduzido na versão: 1.0

Valor predefinido: nenhum

Caminho para o ficheiro no sistema local para uma chave de conta de serviço Google com a função de gestor do sincronizador do Apigee.

envs[].serviceAccountPaths.udca Introduzido na versão: 1.0

Valor predefinido: nenhum

Caminho para o ficheiro no sistema local para uma chave da conta de serviço Google com a função Agente analítico do Apigee.

Defina esta propriedade apenas se orgScopedUDCA estiver definido como false.

envs[].serviceAccountSecretRefs.runtime Introduzido na versão: 1.4.0

Valor predefinido: nenhum

O nome de um segredo do Kubernetes. Tem de criar o segredo através de uma chave da conta de serviço Google com a função Agente do Cloud Trace como entrada.

envs[].serviceAccountSecretRefs.synchronizer Introduzido na versão: 1.2.0

Valor predefinido: nenhum

O nome de um segredo do Kubernetes. Tem de criar o segredo com uma chave da conta de serviço Google com a função Apigee Synchronizer Manager como entrada.

envs[].serviceAccountSecretRefs.udca Introduzido na versão: 1.2.0

Valor predefinido: nenhum

O nome de um segredo do Kubernetes. Tem de criar o segredo através de uma chave da conta de serviço Google com a função Agente analítico do Apigee como entrada.

Defina esta propriedade apenas se orgScopedUDCA estiver definido como false.

envs[].sslCertPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O caminho no seu sistema para um ficheiro de certificado TLS.

envs[].sslKeyPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O caminho no seu sistema para o ficheiro de chave privada TLS.

envs[].sslSecret Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O nome de um ficheiro armazenado num segredo do Kubernetes que contém o certificado TLS e a chave privada. Tem de criar o segredo com os dados da chave e do certificado TLS como entrada.

Veja também:

gcp

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

A tabela seguinte descreve as propriedades do objeto gcp:

Propriedade Descrição
gcp.region Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Obrigatório

Identifica a região do Google Cloud onde o apigee-logger e o apigee-metrics enviam os respetivos dados.

gcp.projectID Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Obrigatório

Identifica o projeto do Google Cloud onde apigee-logger e apigee-metrics enviam os respetivos dados.

gcp.projectIDRuntime Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Identifica o projeto do cluster Kubernetes de tempo de execução.

A propriedade projectIDRuntime é opcional. Se não for usado, pressupõe-se que o valor projectID é usado para o projeto do Google Cloud da organização do Apigee e para o projeto do cluster K8S de tempo de execução.

gcp.workloadIdentityEnabled Introduzido na versão: 1.4.0

Valor predefinido:false

Permite a utilização do Workload Identity. O Workload Identity permite que as cargas de trabalho nos seus clusters do GKE se façam passar por contas de serviço da gestão de identidade e de acesso (IAM) para aceder aos serviços do Google Cloud.

Quando workloadIdentityEnabled é false, a predefinição, o Apigee usa as contas de serviço da IAM para cada componente híbrido do Apigee. Consulte o artigo Acerca das contas de serviço.

Quando workloadIdentityEnabled é true, o 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:

httpProxy

O httpProxy fornece parâmetros de configuração para um servidor proxy de encaminhamento HTTP. Quando configurados em overrides.yaml, todas as comunicações com a Internet para os componentes MART, Synchronizer e UDCA passam pelo servidor proxy.

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

A tabela seguinte descreve as propriedades do objeto httpProxy:

Propriedade Descrição
httpProxy.host Introduzido na versão: 1.1.1

Valor predefinido: nenhum

O nome do anfitrião do proxy HTTP.

httpProxy.port Introduzido na versão: 1.1.1

Valor predefinido: nenhum

A porta do proxy HTTP.

httpProxy.scheme Introduzido na versão: 1.1.1

Valor predefinido: HTTPS

O esquema usado pelo proxy. Os valores podem ser HTTP ou HTTPS. Os valores têm de estar apenas em maiúsculas.

ingressGateways

Configura o gateway de entrada do Apigee para o Apigee Hybrid.

A tabela seguinte descreve as propriedades do objeto ingressGateways:

Propriedade Descrição
ingressGateways[].image.pullPolicy Introduzido na versão: 1.8.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

ingressGateways[].image.tag Introduzido na versão: 1.8.0

Valor predefinido: 1.11.2-asm.17

A etiqueta de versão da imagem de Docker deste serviço.

ingressGateways[].image.url Introduzido na versão: 1.8.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-asm-ingress

A localização da imagem do Docker para este serviço.

ingressGateways[].name Introduzido na versão: 1.8.0

Valor predefinido: nenhum

Obrigatório

O nome da gateway de entrada. Outros serviços vão usar este nome para encaminhar o tráfego para o gateway. O nome tem de cumprir os seguintes requisitos:

  • Ter um comprimento máximo de 17 carateres
  • Contêm apenas carateres alfanuméricos minúsculos, "-" ou "."
  • Começar com um caráter alfanumérico
  • Terminar com um caráter alfanumérico

Para mais informações, consulte a secção DNS Subdomain Names na documentação do Kubernetes.

ingressGateways[].resources.limits.cpu Introduzido na versão: 1.8.0

Valor predefinido: 2000m

O limite de CPU para o recurso, em milicores.

ingressGateways[].resources.limits.memory Introduzido na versão: 1.8.0

Valor predefinido: 1Gi

O limite de memória para o recurso, em mebibytes.

ingressGateways[].resources.requests.cpu Introduzido na versão: 1.8.0

Valor predefinido: 300m

A CPU necessária para o funcionamento normal do recurso, em milicores.

ingressGateways[].resources.requests.memory Introduzido na versão: 1.8.0

Valor predefinido: 128Mi

A memória necessária para o funcionamento normal do recurso, em mebibytes.

ingressGateways[].replicaCountMax Introduzido na versão: 1.8.0

Valor predefinido: 10

O número máximo de pods que o híbrido pode adicionar automaticamente para o gateway de entrada disponível para o dimensionamento automático.

ingressGateways[].replicaCountMin Introduzido na versão: 1.8.0

Valor predefinido: 2

O número mínimo de pods para o gateway de entrada disponível para o dimensionamento automático.

ingressGateways[].svcAnnotations Introduzido na versão: 1.8.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar o gateway de entrada em plataformas que suportam anotações. Por exemplo:

intressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP Introduzido na versão: 1.8.0

Valor predefinido: nenhum

Em plataformas que suportam a especificação do endereço IP do balanceador de carga, o balanceador de carga é criado com este endereço IP. Nas plataformas que não permitem especificar o endereço IP do balanceador de carga, esta propriedade é ignorada.

ingressGateways[].svcType Introduzido na versão: 1.8.1

Valor predefinido: LoadBalancer

Usado para alterar o tipo do serviço k8s predefinido para a implementação de entrada. Defina o valor como ClusterIP se quiser desativar a criação do balanceador de carga predefinido. Valores possíveis:

  • ClusterIP
  • LoadBalancer

istiod

Configura a entrada do Apigee.

A tabela seguinte descreve as propriedades do objeto istiod:

Propriedade Descrição
istiod.forwardClientCertDetails Avançada Introduzido na versão: 1.8.7

Valor predefinido: SANITIZE_SET

Determina como o proxy Envoy (para o gateway de entrada do Apigee) processa o cabeçalho HTTP x-forwarded-client-cert (XFCC).

Os valores possíveis são:

  • SANITIZE_SET Quando a ligação do cliente é mTLS, reponha o cabeçalho XFCC com as informações do certificado do cliente e envie-o para o próximo salto.
  • FORWARD_ONLY Quando a ligação do cliente é mTLS (TLS mútuo), encaminhe o cabeçalho XFCC apenas no pedido.
  • APPEND_FORWARD Quando a ligação do cliente é mTLS, anexe as informações do certificado do cliente ao cabeçalho XFCC do pedido e encaminhe-o.
  • SANITIZE (predefinição) Não encaminhar o cabeçalho XFCC.
  • ALWAYS_FORWARD_ONLY Encaminhe sempre o cabeçalho XFCC no pedido, independentemente de a ligação do cliente ser mTLS.

Para mais informações sobre estes valores, consulte a documentação do Envoy para Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

Se alterar esta definição após a instalação do Hybrid, aplique-a com apigeectl init e, em seguida, reinicie os pods do gateway de entrada do Apigee.

istiod.image.pullPolicy Introduzido na versão: 1.8.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

istiod.image.tag Introduzido na versão: 1.8.0

Valor predefinido: 1.12.9-asm.3

A etiqueta de versão da imagem de Docker deste serviço.

istiod.image.url Introduzido na versão: 1.8.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-asm-istiod

A localização da imagem do Docker para este serviço.

k8sCluster

Identifica o cluster do Kubernetes onde o tempo de execução híbrido está instalado.

A tabela seguinte descreve as propriedades do objeto k8sCluster:

Propriedade Descrição
k8sCluster.name Introduzido na versão: 1.2.0

Valor predefinido: nenhum

O nome do cluster do Kubernetes onde o tempo de execução híbrido está instalado.

k8sCluster.region Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Identifica a região do Google Cloud na qual o cluster do Kubernetes foi criado.

kubeRBACProxy

Identifica onde o Apigee deve procurar controlos de acesso baseados em funções do Kubernetes.

A tabela seguinte descreve as propriedades do objeto kubeRBACProxy:

Propriedade Descrição
kubeRBACProxy.image.pullPolicy Introduzido na versão: 1.2.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

kubeRBACProxy.image.tag Introduzido na versão: 1.2.0

Valor predefinido: v0.11.0

A etiqueta de versão da imagem de Docker deste serviço.

kubeRBACProxy.image.url Introduzido na versão: 1.2.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy

A localização da imagem do Docker para este serviço.

Se não quiser usar o Google Docker Hub, transfira as imagens e use o endereço onde as suas imagens do Docker estão alojadas internamente.

logger

Define o serviço que gere os registos operacionais. Todos os serviços híbridos do Apigee que são executados no seu cluster do Kubernetes produzem estas informações.

Para mais informações, consulte o artigo Vista geral do registo.

A tabela seguinte descreve as propriedades do objeto logger:

Propriedade Descrição
logger.annotations Avançada Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

logger.enabled Básico Introduzido na versão: 1.0.0

Valor predefinido: false

Ativa ou desativa o registo no cluster. Para não GKE definido como true, para Anthos ou GKE definido como false.

logger.EnvVars Básico Introduzido na versão: 1.8.5

Valor predefinido: nenhum

Permite-lhe incluir a variável de ambiente NO_PROXY Fluent Bit, que especifica os URLs para os quais o tráfego não é encaminhado através do proxy HTTP. A variável NO_PROXY deve ser definida como uma string de nomes de anfitriões separados por vírgulas, 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 tiver o proxy de encaminhamento HTTP ativado.

Consulte NO_PROXY na documentação do Fluent Bit.

logger.fluentd.buffer_chunk_limit Avançada Introduzido na versão: 1.0.0

Valor predefinido: 512k

O tamanho máximo permitido de um fragmento de buffer, em kilobytes. Os fragmentos que excedam o limite são enviados automaticamente para a fila de saída.

logger.fluentd.buffer_queue_limit Avançada Introduzido na versão: 1.0.0

Valor predefinido: 6

O comprimento máximo da fila de saída. O limite predefinido é de 256 blocos.

logger.fluentd.flush_interval Avançada Introduzido na versão: 1.0.0

Valor predefinido: 5s

O intervalo de espera antes de invocar a descarga do buffer seguinte, em segundos.

logger.fluentd.max_retry_wait Avançada Introduzido na versão: 1.0.0

Valor predefinido: 30

O intervalo máximo entre novas tentativas de escrita, em segundos.

logger.fluentd.num_threads Avançada Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de threads usadas para esvaziar a memória intermédia. A predefinição é 1.

logger.image.pullPolicy Avançada Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

logger.image.tag Avançada Introduzido na versão: 1.0.0

Valor predefinido: 1.9.9

A etiqueta de versão da imagem de Docker deste serviço.

logger.image.url Avançada Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-fluent-bit

A localização da imagem do Docker para este serviço.

logger.livenessProbe.failureThreshold Avançada Introduzido na versão: 1.0.0

Valor predefinido: 3

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

logger.livenessProbe.initialDelaySeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 0

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de atividade.

logger.livenessProbe.periodSeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 60

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

logger.livenessProbe.successThreshold Avançada Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de êxitos 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çada Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

logger.nodeSelector.key Básico Introduzido na versão: 1.0.0

Valor predefinido: apigee.com/apigee-logger-enabled

Obrigatório

Chave da etiqueta do seletor de nós usada para segmentar nós Kubernetes dedicados para serviços de tempo de execução do logger.

Consulte o artigo Configurar node pools dedicados.

logger.nodeSelector.value Básico Introduzido na versão: 1.0.0

Valor predefinido: true

Obrigatório

Valor da etiqueta do seletor de nós usado para segmentar nós do Kubernetes dedicados para serviços de tempo de execução do logger.

Consulte o artigo Configurar node pools dedicados.

logger.proxyURL Básico Introduzido na versão: 1.0.0

Valor predefinido: nenhum

URL do servidor proxy do cliente.

logger.resources.limits.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 200m

O limite da CPU para o recurso num contentor do Kubernetes, em milicores.

logger.resources.limits.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500Mi

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

logger.resources.requests.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 100m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

logger.resources.requests.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 250Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

logger.serviceAccountPath Básico Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

Caminho para o ficheiro de chave da conta de serviço Google com a função Logs Writer.

logger.serviceAccountRef Básico Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

logger.terminationGracePeriodSeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 30

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

mart

Define o serviço MART (Management API for RunTime data), que funciona como um fornecedor de APIs para APIs Apigee públicas, para que possa aceder e gerir entidades de dados de tempo de execução, como KMS (chaves de API e tokens OAuth), KVM, quota e produtos de API.

A tabela seguinte descreve as propriedades do objeto mart:

Propriedade Descrição
mart.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

mart.hostAlias Introduzido na versão: 1.0.0

Valor predefinido: nenhum

O alias de anfitrião que aponta para o objeto MART. Pode definir esta propriedade como * ou um nome de domínio totalmente qualificado.

mart.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

mart.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

mart.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-mart-server

A localização da imagem do Docker para este serviço. Verifique o ficheiro values.yaml para o URL específico.Pode substituir esta opção.

mart.initCheckCF.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 10m

A quantidade de recursos da CPU atribuídos à verificação de inicialização do processo do Cloud Foundry.

mart.livenessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 12

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

mart.livenessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 15

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de atividade.

mart.livenessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

mart.livenessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

mart.metricsURL Introduzido na versão: 1.0.0

Valor predefinido: /v1/server/metrics

mart.nodeSelector.key Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Chave da etiqueta do seletor de nós opcional para segmentar nós do Kubernetes para mart serviços de tempo de execução. Se não especificar uma chave para mart.nodeselector, o seu tempo de execução usa o nó especificado no objeto nodeSelector.

Consulte o artigo Configurar node pools dedicados.

mart.nodeSelector.value Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Valor da etiqueta do seletor de nós opcional para segmentar nós do Kubernetes para mart serviços de tempo de execução. Consulte também o objeto nodeSelector.

Consulte o artigo Configurar node pools dedicados.

mart.readinessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes vai verificar se as sondas de prontidão falharam antes de marcar o pod como não pronto. O valor mínimo é 1.

mart.readinessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 15

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de prontidão.

mart.readinessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de prontidão, em segundos. O valor mínimo é 1.

mart.readinessProbe.successThreshold Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de êxitos consecutivos necessários para que uma sondagem de prontidão seja considerada bem-sucedida após uma falha. O valor mínimo é 1.

mart.readinessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

mart.replicaCountMax Introduzido na versão: 1.0.0

Valor predefinido: 5

Número máximo de réplicas disponíveis para o escalamento automático.

mart.replicaCountMin Introduzido na versão: 1.0.0

Valor predefinido: 1

Número mínimo de réplicas disponíveis para o ajuste de escala automático.

mart.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

mart.resources.requests.memory Introduzido na versão: 1.0.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

mart.serviceAccountPath Introduzido na versão: 1.1.1

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

Caminho para o ficheiro de chave da conta de serviço Google sem função.

mart.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

mart.sslCertPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

Caminho do sistema de ficheiros local para carregar e codificar o certificado SSL num segredo.

mart.sslKeyPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

Caminho do sistema de ficheiros local para carregar e encriptar a chave SSL num segredo.

mart.sslSecret Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O nome de um ficheiro armazenado num segredo do Kubernetes que contém o certificado TLS e a chave privada. Tem de criar o segredo com os dados da chave e do certificado TLS como entrada.

Veja também:

mart.targetCPUUtilizationPercentage Introduzido na versão: 1.0.0

Valor predefinido: 75

Utilização da CPU alvo para o processo MART no pod. O valor deste campo permite o dimensionamento automático do MART quando a utilização da CPU atinge este valor, até replicaCountMax.

mart.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 30

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

metrics

Define o serviço que recolhe métricas de operações. Pode usar os dados de métricas para monitorizar o estado dos serviços híbridos, configurar alertas, etc.

Para mais informações, consulte o artigo Vista geral da recolha de métricas.

A tabela seguinte descreve as propriedades do objeto metrics:

Propriedade Descrição
metrics.adapter.pullPolicy Introduzido na versão: 1.8.1

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

metrics.adapter.tag Introduzido na versão: 1.8.1

Valor predefinido: v0.9.1

A etiqueta de versão da imagem de Docker deste serviço.

metrics.adapter.url Introduzido na versão: 1.8.1

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-prometheus-adapter

A localização da imagem do Docker para este serviço.

metrics.aggregator.resources.requests.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do agregador num contentor do Kubernetes, em milicores.

metrics.aggregator.resources.requests.memory Introduzido na versão: 1.4.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal do agregador num contentor do Kubernetes, em mebibytes.

metrics.aggregator.resources.limits.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

O limite da CPU para o recurso do agregador num contentor do Kubernetes, em milicores.

metrics.aggregator.resources.limits.memory Introduzido na versão: 1.4.0

Valor predefinido: 3Gi

O limite de memória para o recurso do agregador num contentor do Kubernetes, em gibibytes.

metrics.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

metrics.app.resources.requests.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal da app num contentor do Kubernetes, em milicores.

metrics.app.resources.requests.memory Introduzido na versão: 1.4.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal da app num contentor do Kubernetes, em mebibytes.

metrics.app.resources.limits.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

O limite da CPU para o recurso da app num contentor do Kubernetes, em milicores.

metrics.app.resources.limits.memory Introduzido na versão: 1.4.0

Valor predefinido: 1Gi

O limite de memória para o recurso da app num contentor Kubernetes, em gibibytes.

metrics.appStackdriverExporter.resources.requests.cpu Introduzido na versão: 1.7.0

Valor predefinido: 128m

A CPU necessária para o funcionamento normal do stackdriverExporter num contentor do Kubernetes, em milicores.

metrics.appStackdriverExporter.resources.requests.memory Introduzido na versão: 1.7.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal do stackdriverExporter num contentor do Kubernetes, em mebibytes.

metrics.appStackdriverExporter.resources.limits.cpu Introduzido na versão: 1.7.0

Valor predefinido: 500m

O limite da CPU para o recurso stackdriverExporter num contentor do Kubernetes, em millicores.

metrics.appStackdriverExporter.resources.limits.memory Introduzido na versão: 1.7.0

Valor predefinido: 1Gi

O limite de memória para o recurso stackdriverExporter num contentor Kubernetes, em gibibytes.

metrics.enabled Introduzido na versão: 1.0.0

Valor predefinido: true

Ativa as métricas do Apigee. Defina como true para ativar as métricas. Defina como false para desativar as métricas.

metrics.nodeSelector.key Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Chave da etiqueta do seletor de nós usada para segmentar nós Kubernetes dedicados para serviços de tempo de execução do metrics.

Consulte o artigo Configurar node pools dedicados.

metrics.nodeSelector.value Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Valor da etiqueta do seletor de nós usado para segmentar nós do Kubernetes dedicados para serviços de tempo de execução do metrics.

Consulte o artigo Configurar node pools dedicados.

metrics.prometheus.args.storage_tsdb_retention Introduzido na versão: 1.0.0

Valor predefinido: 48h

O tempo que o Prometheus aguarda antes de remover dados antigos do armazenamento local, em horas.

metrics.prometheus.containerPort Introduzido na versão: 1.0.0

Valor predefinido: 9090

A porta para estabelecer ligação ao serviço de métricas do Prometheus.

metrics.prometheus.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

metrics.prometheus.image.tag Introduzido na versão: 1.0.0

Valor predefinido: v2.9.2

A etiqueta de versão da imagem de Docker deste serviço.

metrics.prometheus.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-prom-prometheus

A localização da imagem do Docker para este serviço.

metrics.prometheus.livenessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 6

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

metrics.prometheus.livenessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

metrics.prometheus.livenessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 3

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

metrics.prometheus.readinessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 120

O número de vezes que o Kubernetes vai verificar se as sondas de prontidão falharam antes de marcar o pod como não pronto. O valor mínimo é 1.

metrics.prometheus.readinessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de prontidão, em segundos. O valor mínimo é 1.

metrics.prometheus.readinessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 3

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

metrics.prometheus.sslCertPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Caminho para o certificado SSL do processo de recolha de métricas do Prometheus. O Prometheus é uma ferramenta que o Apigee pode usar para recolher e processar métricas.

Consulte:

metrics.prometheus.sslKeyPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Caminho para a chave SSL do processo de recolha de métricas do Prometheus. O Prometheus é uma ferramenta que o Apigee pode usar para recolher e processar métricas.

Consulte:

metrics.proxy.resources.requests.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do proxy num contentor do Kubernetes, em milicores.

metrics.proxy.resources.requests.memory Introduzido na versão: 1.4.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal do proxy num contentor do Kubernetes, em mebibytes.

metrics.proxy.resources.limits.cpu Introduzido na versão: 1.4.0

Valor predefinido: 500m

O limite da CPU para o recurso de proxy num contentor do Kubernetes, em milicores.

metrics.proxy.resources.limits.memory Introduzido na versão: 1.4.0

Valor predefinido: 1Gi

O limite de memória para o recurso de proxy num contentor do Kubernetes, em gibibytes.

metrics.proxyStackdriverExporter.resources.requests.cpu Introduzido na versão: 1.7.0

Valor predefinido: 128m

A CPU necessária para o funcionamento normal do stackdriverExporter num contentor do Kubernetes, em milicores.

metrics.proxyStackdriverExporter.resources.requests.memory Introduzido na versão: 1.7.0

Valor predefinido: 512Mi

A memória necessária para o funcionamento normal do stackdriverExporter num contentor do Kubernetes, em mebibytes.

metrics.proxyStackdriverExporter.resources.limits.cpu Introduzido na versão: 1.7.0

Valor predefinido: 500m

O limite da CPU para o recurso stackdriverExporter num contentor do Kubernetes, em millicores.

metrics.proxyStackdriverExporter.resources.limits.memory Introduzido na versão: 1.7.0

Valor predefinido: 1Gi

O limite de memória para o recurso stackdriverExporter num contentor Kubernetes, em gibibytes.

metrics.proxyURL Introduzido na versão: 1.0.0

Valor predefinido: nenhum

URL do proxy sidecar do processo de métricas no cluster do Kubernetes.

metrics.sdSidecar.containerPort Introduzido na versão: 1.0.0

Valor predefinido: 9091

A porta para estabelecer ligação ao serviço de métricas do Cloud Monitoring.

metrics.sdSidecar.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: IfNotPresent

Determina quando o Kubelet extrai a imagem do Docker deste serviço. Os valores possíveis incluem:

  • IfNotPresent: não extrair uma nova imagem se já existir
  • Always: extraia sempre a política, mesmo que já exista

    Para mais informações, consulte o artigo Atualizar imagens.

metrics.sdSidecar.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 0.9.0

A etiqueta de versão da imagem de Docker deste serviço.

metrics.sdSidecar.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar

A localização da imagem do Docker para este serviço.

metrics.serviceAccountPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

Caminho para o ficheiro de chave da conta de serviço Google com a função Monitoring Metric Writer.

metrics.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

metrics.stackdriverExporter.resources.requests.cpu Introduzido na versão: 1.4.0

Deprecated: a partir da versão 1.8 híbrida, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Consulte:

metrics.stackdriverExporter.resources.requests.memory Introduzido na versão: 1.4.0

Deprecated: a partir da versão 1.8 híbrida, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Consulte:

metrics.stackdriverExporter.resources.limits.cpu Introduzido na versão: 1.4.0

Deprecated: a partir da versão 1.8 híbrida, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Consulte:

metrics.stackdriverExporter.resources.limits.memory Introduzido na versão: 1.4.0

Deprecated: a partir da versão 1.8 híbrida, metrics:stackdriverExporter foi substituído por metrics:appStackdriverExporter e metrics:proxyStackdriverExporter. Consulte:

metrics.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 300

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

mintTaskScheduler

mintTaskScheduler é o trabalho cron para agendar tarefas de rentabilização, como o cálculo de taxas recorrentes de forma periódica.

A tabela seguinte descreve as propriedades do objeto mintTaskScheduler:

Propriedade Descrição
mintTaskScheduler.image.pullPolicy Introduzido na versão: 1.7.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

mintTaskScheduler.image.tag Introduzido na versão: 1.7.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

mintTaskScheduler.image.url Introduzido na versão: 1.7.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler

A localização da imagem do Docker para este serviço.

nodeSelector

O objeto nodeSelector define o nó para a sua instância do Apigee. Nos bastidores, quando o apigeectl é executado, tem o cuidado de mapear a chave/valor da etiqueta para apigeeRuntime e apigeeData para os componentes individuais do Istio e MART. Pode substituir esta opção para objetos individuais na propriedade smart:nodeSelector.

A tabela seguinte descreve as propriedades do objeto nodeSelector:

Propriedade Descrição
nodeSelector.apigeeData.key Introduzido na versão: 1.0.0

Valor predefinido: cloud.google.com/gke-nodepool

ApigeeData é o nó da base de dados Cassandra. Chave da etiqueta do seletor de nós para segmentar nós do Kubernetes para trabalhar com dados dos serviços Apigee.

Consulte o artigo Configure node pools dedicados.

nodeSelector.apigeeData.value Introduzido na versão: 1.0.0

Valor predefinido: apigee-data

apigee-data é o nó da base de dados Cassandra. Valor da etiqueta do seletor de nós para segmentar nós do Kubernetes para trabalhar com dados dos serviços Apigee.

Consulte o artigo Configure node pools dedicados.

nodeSelector.apigeeRuntime.key Introduzido na versão: 1.0.0

Valor predefinido: cloud.google.com/gke-nodepool

O Apigee Runtime é o nó do ambiente de tempo de execução do projeto. Chave da etiqueta do seletor de nós para segmentar nós do Kubernetes para serviços de tempo de execução do Apigee.

Consulte o artigo Configure node pools dedicados.

nodeSelector.apigeeRuntime.value Introduzido na versão: 1.0.0

Valor predefinido: apigee-runtime

apigee-runtime é o nó do ambiente de tempo de execução do projeto. Etiqueta do seletor de nós valor para segmentar nós do Kubernetes para serviços de tempo de execução do Apigee.

Consulte o artigo Configure node pools dedicados.

nodeSelector.requiredForScheduling Introduzido na versão: 1.0.0

Valor predefinido: false

A propriedade requiredForScheduling tem como predefinição false. Se este valor for substituído por true, significa que, se o Kubernetes não conseguir encontrar nós com a chave/valor da etiqueta que está configurada, os pods subjacentes não são agendados em nós de trabalho de VMs.

Para a produção, nodeSelector.requiredForScheduling deve ser definida como verdadeira.

Consulte o artigo Configure node pools dedicados.

redis

A tabela seguinte descreve as propriedades do objeto redis:

Propriedade Descrição
redis.auth.password Introduzido na versão: 1.6.0

Valor predefinido: iloveapis123

Obrigatório

Palavra-passe do administrador do Redis. O utilizador administrador é usado para quaisquer atividades administrativas realizadas no cluster Redis.

redis.envoy.pullPolicy Introduzido na versão: 1.6.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

redis.envoy.tag Introduzido na versão: 1.6.0

Valor predefinido: v1.22.2

A etiqueta de versão da imagem de Docker deste serviço.

redis.envoy.url Introduzido na versão: 1.6.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-envoy

A localização da imagem do Docker para este serviço.

redis.image.pullPolicy Introduzido na versão: 1.6.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

redis.image.tag Introduzido na versão: 1.6.0

Valor predefinido:

A etiqueta de versão da imagem de Docker deste serviço.

redis.image.url Introduzido na versão: 1.6.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-redis

A localização da imagem do Docker para este serviço.

redis.replicaCount Introduzido na versão: 1.6.0

Valor predefinido: 2

O Redis é um armazenamento replicado. Esta propriedade especifica o número de nós do Redis usados como um StatefulSet.

redis.resources.requests.cpu Introduzido na versão: 1.6.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

runtime

A tabela seguinte descreve as propriedades do objeto runtime:

Propriedade Descrição
runtime.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

runtime.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

runtime.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

runtime.image.url Introduzido na versão: 1.0.0

Valor predefinido: URL para o recurso de imagem da sua instalação, por exemplo: gcr.io/apigee-release/hybrid/apigee-runtime

A localização da imagem do Docker para este serviço.

runtime.livenessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

runtime.livenessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 60

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de atividade.

runtime.livenessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

runtime.livenessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

runtime.nodeSelector.key Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Chave da etiqueta do seletor de nós opcional para segmentar nós do Kubernetes para serviços runtime.

Consulte a propriedade nodeSelector.

runtime.nodeSelector.value Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Valor da etiqueta do seletor de nós para segmentar nós do Kubernetes para serviços runtime.

Consulte o artigo Configurar node pools dedicados.

runtime.readinessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes vai verificar se as sondas de prontidão falharam antes de marcar o pod como não pronto. O valor mínimo é 1.

runtime.readinessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 60

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de prontidão.

runtime.readinessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de prontidão, em segundos. O valor mínimo é 1.

runtime.readinessProbe.successThreshold Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de êxitos consecutivos necessários para que uma sondagem de prontidão seja considerada bem-sucedida após uma falha. O valor mínimo é 1.

runtime.readinessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

runtime.replicaCountMax Introduzido na versão: 1.0.0

Valor predefinido: 4

Número máximo de réplicas disponíveis para o escalamento automático.

runtime.replicaCountMin Introduzido na versão: 1.0.0

Valor predefinido: 1

Número mínimo de réplicas disponíveis para o ajuste de escala automático.

runtime.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

runtime.resources.requests.memory Introduzido na versão: 1.0.0

Valor predefinido: 512Mi (consulte a nota abaixo)

A memória necessária para o funcionamento normal do recurso num contentor Kubernetes, em mebibytes (Mi) ou gibibytes (Gi).

runtime.service.type Introduzido na versão: 1.0.0

Valor predefinido: ClusterIP

O tipo de serviço. Pode definir isto para um serviço diferente de ClusterIP; por exemplo, LoadBalancer.

runtime.targetCPUUtilizationPercentage Introduzido na versão: 1.0.0

Valor predefinido: 75

Utilização da CPU alvo para o processo de tempo de execução no pod. O valor deste campo permite que o tempo de execução seja dimensionado automaticamente quando a utilização da CPU atinge este valor, até replicaCountMax.

runtime.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 180

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

synchronizer

Garante que os processadores de mensagens são mantidos atualizados com os pacotes de proxy de API implementados mais recentes. Para tal, o sincronizador sonda o plano de gestão. Quando é detetado um novo contrato, o sincronizador envia-o para o plano de tempo de execução. Por predefinição, o sincronizador armazena os dados de configuração do ambiente no Cassandra.

Para mais informações, consulte o artigo Configure o sincronizador.

A tabela seguinte descreve as propriedades do objeto synchronizer:

Propriedade Descrição
synchronizer.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

synchronizer.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

synchronizer.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

synchronizer.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-synchronizer

A localização da imagem do Docker para este serviço.

synchronizer.livenessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

synchronizer.livenessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 0

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de atividade.

synchronizer.livenessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

synchronizer.livenessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

synchronizer.nodeSelector.key Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Chave da etiqueta do seletor de nós opcional para segmentar nós do Kubernetes para synchronizer serviços de tempo de execução.

Consulte nodeSelector.

synchronizer.nodeSelector.value Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Valor da etiqueta do seletor de nós opcional usado para segmentar nós do Kubernetes para synchronizer serviços de tempo de execução.

Consulte nodeSelector.

synchronizer.pollInterval Introduzido na versão: 1.0.0

Valor predefinido: 60

O período de tempo que o sincronizador aguarda entre as operações de sondagem. O sincronizador sonda os serviços do plano de controlo do Apigee para detetar e extrair novos contratos de tempo de execução.

synchronizer.readinessProbe.failureThreshold Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes vai verificar se as sondas de prontidão falharam antes de marcar o pod como não pronto. O valor mínimo é 1.

synchronizer.readinessProbe.initialDelaySeconds Introduzido na versão: 1.0.0

Valor predefinido: 0

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de prontidão.

synchronizer.readinessProbe.periodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de prontidão, em segundos. O valor mínimo é 1.

synchronizer.readinessProbe.successThreshold Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de êxitos consecutivos necessários para que uma sondagem de prontidão seja considerada bem-sucedida após uma falha. O valor mínimo é 1.

synchronizer.readinessProbe.timeoutSeconds Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

synchronizer.replicaCount Introduzido na versão: 1.0.0

Deprecated: a partir da versão híbrida 1.2, faça a gestão da quantidade de réplicas do sincronizador com: synchronizer.replicaCountMax e synchronizer.replicaCountMin

synchronizer.replicaCountMax Introduzido na versão: 1.2.0

Valor predefinido: 4

Número máximo de réplicas para o escalamento automático.

synchronizer.replicaCountMin Introduzido na versão: 1.2.0

Valor predefinido: 1

Número mínimo de réplicas para o ajuste de escala automático.

synchronizer.resources.requests.cpu Introduzido na versão: 1.0.0

Valor predefinido: 100m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

synchronizer.resources.requests.memory Introduzido na versão: 1.0.0

Valor predefinido: 1Gi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em gigabytes.

synchronizer.serviceAccountPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

Caminho para o ficheiro de chave da conta de serviço Google com a função Apigee Synchronizer Manager.

synchronizer.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

synchronizer.targetCPUUtilizationPercentage Introduzido na versão: 1.0.0

Valor predefinido: 75

Utilização da CPU alvo para o processo do sincronizador no pod. O valor deste campo permite que o sincronizador seja dimensionado automaticamente quando a utilização da CPU atinge este valor, até replicaCountMax.

synchronizer.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 30

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

udca

(Agente de recolha de dados universal) Define o serviço que é executado no pod de recolha de dados no plano de tempo de execução. Este serviço extrai dados de estatísticas e do estado de implementação e envia-os para a Plataforma de estatísticas unificada (UAP).

Para mais informações, consulte o artigo Recolha de dados do estado de implementação e do Analytics.

A tabela seguinte descreve as propriedades do objeto udca:

Propriedade Descrição
udca.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

udca.fluentd.image.pullPolicy Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

udca.fluentd.image.tag Introduzido na versão: 1.0.0

Valor predefinido: 1.8.9

A etiqueta de versão da imagem de Docker deste serviço.

udca.fluentd.image.url Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent

A localização da imagem do Docker para este serviço.

udca.fluentd.resources.limits.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500m

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

udca.fluentd.resources.limits.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500Mi

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

udca.fluentd.resources.requests.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

udca.fluentd.resources.requests.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 250Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

udca.image.pullPolicy Avançada Introduzido na versão: 1.0.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

udca.image.tag Avançada Introduzido na versão: 1.0.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

udca.image.url Avançada Introduzido na versão: 1.0.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-udca

A localização da imagem do Docker para este serviço.

udca.jvmXms Avançada Introduzido na versão: 1.0.0

Deprecated: a partir da versão 1.8 híbrida, udca.jvmXms já não é usado.

udca.jvmXmx Avançada Introduzido na versão: 1.0.0

Deprecated: a partir da versão 1.8 híbrida, udca.jvmXmx já não é usado.

udca.livenessProbe.failureThreshold Avançada Introduzido na versão: 1.0.0

Valor predefinido: 2

O número de vezes que o Kubernetes verifica se as sondas de atividade falharam antes de reiniciar o contentor. O valor mínimo é 1.

udca.livenessProbe.initialDelaySeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 0

O número de segundos após o início de um contentor antes de ser iniciada uma sondagem de atividade.

udca.livenessProbe.periodSeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 5

Determina a frequência com que é realizada uma sondagem de atividade, em segundos. O valor mínimo é 1.

udca.livenessProbe.timeoutSeconds Avançada Introduzido na versão: 1.0.0

Valor predefinido: 1

O número de segundos após o qual uma sondagem de atividade expira. O valor mínimo é 1.

udca.nodeSelector.key Básico Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Chave da etiqueta do seletor de nós usada para segmentar nós Kubernetes dedicados para serviços de tempo de execução do udca.

Consulte o artigo Configurar node pools dedicados.

udca.nodeSelector.value Básico Introduzido na versão: 1.0.0

Valor predefinido: nenhum

Obrigatório

Valor da etiqueta do seletor de nós usado para segmentar nós do Kubernetes dedicados para serviços de tempo de execução do udca.

Consulte o artigo Configurar node pools dedicados.

udca.pollingIntervalInSec Avançada Introduzido na versão: 1.0.0

Valor predefinido: 1

O período, em segundos, que o UDCA aguarda entre as operações de sondagem. A UDCA sonda o diretório de dados no sistema de ficheiros do pod de recolha de dados para detetar novos ficheiros a carregar.

udca.replicaCountMax Básico Introduzido na versão: 1.0.0

Valor predefinido: 4

O número máximo de pods que o híbrido pode adicionar automaticamente para a implementação da UDCA. Uma vez que a UDCA está implementada como um ReplicaSet, os pods são réplicas.

Recomendamos que defina udca.replicaCountMax para um número máximo de réplicas por ambiente multiplicado pelo número de ambientes na sua organização do Apigee. Por exemplo, se quiser permitir, no máximo, 4 réplicas por ambiente e tiver 3 ambientes, defina udca.replicaCountMax: 12.

udca.replicaCountMin Básico Introduzido na versão: 1.0.0

Valor predefinido: 1

O número mínimo de pods para a implementação da UDCA. Uma vez que o UDCA está implementado como um ReplicaSet, os pods são réplicas.

Se a utilização da CPU exceder udca.targetCPUUtilizationPercentage, o modo híbrido aumenta gradualmente o número de pods até udca.replicaCountMax.

udca.resources.limits.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500m

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

udca.resources.limits.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 500Mi

O limite de memória para o recurso num contentor do Kubernetes, em mebibytes.

udca.resources.requests.cpu Avançada Introduzido na versão: 1.0.0

Valor predefinido: 250m

A CPU necessária para o funcionamento normal do recurso num contentor do Kubernetes, em milicores.

udca.resources.requests.memory Avançada Introduzido na versão: 1.0.0

Valor predefinido: 250Mi

A memória necessária para o funcionamento normal do recurso num contentor do Kubernetes, em mebibytes.

udca.revision Introduzido na versão: 1.0.0

Valor predefinido: v1

Um valor estático preenchido numa etiqueta para permitir implementações canárias.

udca.serviceAccountPath Introduzido na versão: 1.0.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

Caminho para o ficheiro de chave da conta de serviço Google com a função Agente do Apigee Analytics.

udca.serviceAccountRef Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário um dos seguintes elementos: serviceAccountPath ou serviceAccountRef.

udca.targetCPUUtilizationPercentage Introduzido na versão: 1.0.0

Valor predefinido: 75

O limite de utilização da CPU para dimensionar o número de pods no ReplicaSet, como uma percentagem dos recursos de CPU disponíveis totais. O modo híbrido usa a utilização combinada de todos os contentores no pod de recolha de dados (fluentd e UDCA) para calcular a utilização atual.

Quando a utilização da CPU ultrapassa este valor, o modo híbrido aumenta gradualmente o número de pods no ReplicaSet até udca.replicaCountMax.

udca.terminationGracePeriodSeconds Introduzido na versão: 1.0.0

Valor predefinido: 600

O tempo entre um pedido de eliminação de agrupamento e quando o agrupamento é terminado, em segundos. Durante este período, todos os hooks de pré-paragem são executados e todos os processos em execução devem terminar normalmente.

virtualhosts

A propriedade virtualhosts é uma propriedade de configuração obrigatória. Os anfitriões virtuais permitem que o Apigee Hybrid processe pedidos de API para um grupo de ambientes especificado.

Para mais informações, consulte o artigo Configure anfitriões virtuais.

A tabela seguinte descreve as propriedades do objeto virtualhosts:

Propriedade Descrição
virtualhosts[].additionalGateways Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Uma lista de gateways do Istio para encaminhar o tráfego.

virtualhosts[].cipherSuites[] Avançada Introduzido na versão: 1.8.7

Valor predefinido: nenhum

A lista de cifras TLS. Pode encontrar a lista completa de cifras suportadas na documentação da compilação Boring FIPS do Envoy. Um valor em branco assume as predefinições dos conjuntos de cifras suportados pela compilação FIPS do Boring do Envoy.

Por exemplo, para suportar o 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"
  ...
      
virtualhosts[].name Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Obrigatório

O nome do anfitrião virtual.

virtualhosts[].hostAliases[] Introduzido na versão: 1.2.0

Valor predefinido: nenhum

Obrigatório

Deprecated: a partir da versão híbrida 1.4, o plano de tempo de execução recebe estas informações do plano de gestão. Consulte o artigo Acerca dos ambientes e dos grupos de ambientes.

virtualhosts[].maxTLSProtocolVersion Introduzido na versão: 1.3.0

Valor predefinido: nenhum

A versão máxima do protocolo TLS que o Envoy pode selecionar. O Envoy usa automaticamente a versão do protocolo TLS ideal entre virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

O valor tem de estar no formato 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 Introduzido na versão: 1.3.0

Valor predefinido: nenhum

A versão mínima do protocolo TLS que o Envoy pode selecionar. O Envoy usa automaticamente a versão do protocolo TLS ideal entre virtualhosts[].minTLSProtocolVersion e virtualhosts[].maxTLSProtocolVersion.

O valor tem de estar no formato 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 Introduzido na versão: 1.2.0

Valor predefinido: app: apigee-ingressgateway

Obrigatório

Um par de chave-valor do seletor para apontar para diferentes seletores de entrada.

  • apigee-ingressgateway: para instalações do Apigee Hybrid que usam o gateway de entrada do Apigee.
  • istio-ingressgateway: para instalações do Apigee Hybrid que usam o Anthos Service Mesh.

Se não for fornecida nenhuma etiqueta de seletor, a configuração é fornecida ao gateway de entrada do Apigee e ao Anthos Service Mesh instalado pelo cliente.

virtualhosts[].sslCertPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O caminho no seu sistema para um ficheiro de certificado TLS.

virtualhosts[].sslKeyPath Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O caminho no seu sistema para o ficheiro de chave privada TLS.

virtualhosts[].sslSecret Introduzido na versão: 1.2.0

Valor predefinido: nenhum

É necessário sslCertPath/sslKeyPath ou sslSecret.

O nome de um ficheiro armazenado num segredo do Kubernetes que contém o certificado TLS e a chave privada. Tem de criar o segredo com os dados da chave e do certificado TLS como entrada.

Veja também:

watcher

A propriedade watcher é uma propriedade de configuração obrigatória. O observador é um processo que monitoriza as alterações de configuração e aciona a respetiva aplicação para o plano de tempo de execução.

A tabela seguinte descreve as propriedades do objeto watcher:

Propriedade Descrição
watcher.annotations Introduzido na versão: 1.5.0

Valor predefinido: nenhum

Mapa de chave/valor opcional usado para anotar pods. Para mais informações, consulte o artigo Anotações personalizadas.

watcher.image.pullPolicy Introduzido na versão: 1.4.0

Valor predefinido: 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 já existir.
  • Always: extrai sempre a imagem, independentemente de já existir.

Para mais informações, consulte o artigo Atualizar imagens.

watcher.image.tag Introduzido na versão: 1.4.0

Valor predefinido: 1.8.8

A etiqueta de versão da imagem de Docker deste serviço.

watcher.image.url Introduzido na versão: 1.4.0

Valor predefinido: gcr.io/apigee-release/hybrid/apigee-watcher

A localização da imagem do Docker para este serviço.

watcher.replicaCountMax Introduzido na versão: 1.3.0

Valor predefinido: 1

O número máximo de réplicas de observação. Este valor deve ser mantido em 1 para evitar conflitos.

watcher.replicaCountMin Introduzido na versão: 1.3.0

Valor predefinido: 1

O número mínimo de réplicas de observadores.

watcher.serviceAccountPath Introduzido na versão: 1.3.0

Valor predefinido: nenhum

Obrigatório.

Caminho para o ficheiro de chave da conta de serviço Google com a função Agente do Apigee Runtime.

watcher.serviceAccountRef Introduzido na versão: 1.3.0

Valor predefinido: nenhum

É necessário um dos seguintes: serviceAccountPath ou serviceAccountRef.