Referência da propriedade de configuração

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

Propriedades de nível superior

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

Propriedade Descrição
contractProvider Versão: 1.0.0

Valor padrão: https://apigee.googleapis.com

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

gcpProjectID Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

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

gcpRegion Versão: 1.0.0

Valor padrão: us-central1

Obrigatório

A região ou zona mais próxima do GCP do cluster do Kubernetes. Funciona com gcpProjectID e k8sClusterName para identificar o projeto e determinar onde apigee-logger e apigee-metrics enviam os dados.

imagePullSecrets.name Versão: 1.0.0

Valor padrão: nenhum

Nome do secret do Kubernetes configurado como tipo de registro do docker; usado para extrair imagens do repo privado.

k8sClusterName

Tipo:

Versão: 1.0.0

Valor padrão: nenhum

Nome do cluster do Kubernetes (K8S) em que seu projeto híbrido está sendo executado. Funciona com gcpProjectID e gcpRegion para identificar o projeto e determinar para onde apigee-logger e apigee-metrics enviam os dados dele.

namespace Versão: 1.0.0

Valor padrão: apigee

O namespace do cluster do Kubernetes em que os componentes da Apigee serão instalados.

org Obrigatório

Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

A organização com recurso híbrido que foi provisionada para você pela Apigee durante a instalação híbrida. Uma organização é o contêiner de nível superior no Apigee. Ela contém todos os proxies de API e recursos relacionados. Se o valor estiver vazio, será necessário atualizá-lo para limpar o nome da organização depois de criá-lo.

revision Versão: 1.0.0

Valor padrão: 1.0.0

O híbrido da Apigee oferece suporte a atualizações graduais do Kubernetes, o que permite atualizações de implantação com tempo de inatividade zero por meio da atualização incremental de instâncias de pod com novas instâncias.

Ao atualizar determinadas modificações do YAML que resultam na alteração subjacente do PodTemplateSpec do Kubernetes, a propriedade de modificação revision também precisa ser alterada no override.yaml do cliente. Isso é necessário para que o controlador subjacente ApigeeDeployment (AD) do Kubernetes faça uma atualização gradual e segura da versão anterior para a nova versão. É possível usar qualquer valor de texto. Por exemplo: "blue", "a", "1.0.0".

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

As alterações nas propriedades dos objetos a seguir exigem uma atualização de revision:

Para mais informações, consulte Atualizações graduais.

validateServiceAccounts Versão: 1.0.0

Valor padrão: verdadeiro

Permite a validação rigorosa das permissões da conta de serviço. Isso usa o método "testIamPermissions" da API Cloud Resource Manager para verificar se a conta de serviço fornecida tem as permissões necessárias. No caso de contas de serviço de uma organização da Apigee, a verificação do ID do projeto é aquela mapeada para a organização. Para Metrics e Logger, o projeto verificado é baseado na configuração gcp.ID "gcpProjectID".

Consulte também gcpProjectID

adah

O Apigee Deployment Admissionhook (ADAH) é responsável por validar a configuração que o usuário fornece para o apigee-deployment-controller. Ele é executado em um cluster do Kubernetes e é responsável por validar as solicitações de criação/atualização/exclusão de entrada do controlador de implantação da Apigee. Consulte também:

A tabela a seguir descreve as propriedades do objeto adah do controlador de implantação da Apigee:

Propriedade Descrição
adah.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

adah.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O local da imagem do Docker desse serviço.

adah.image.url Versão: 1.0.0

Valor padrão: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-admissionhook/master/admissionhook"

O local da imagem do Docker desse serviço.

adc

O controlador de implantação da Apigee (ADC, na sigla em inglês) é um processo que gerencia a implantação da Apigee em clusters do Kubernetes. Ele é um controlador personalizado do Kubernetes que cria e atualiza recursos específicos do Kubernetes e do Istio necessários para implantar e manter o ApigeeDeployment (AD).

Veja também adah (Apigee Deployment Admissionhook)

A tabela a seguir descreve as propriedades do objeto adc do apigee-deployment-controller:

Propriedade Descrição
adc.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

adc.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O local da imagem do Docker desse serviço.

adc.image.url Versão: 1.0.0

Valor padrão: "us.gcr.io/google.com/edge-ci/release/eda/apigee-deployment-controller/master/controller"

O local da imagem do Docker desse serviço.

adc.resources.limits.cpu Versão: 1.0.0

Valor padrão: 250m

O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.

adc.resources.limits.memory Versão: 1.0.0

Valor padrão: 256Mi

O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.

adc.resources.requests.cpu Versão: 1.0.0

Valor padrão: 250m

A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

adc.resources.requests.memory Versão: 1.0.0

Valor padrão: 256Mi

A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

authz

A tabela a seguir descreve as propriedades do objeto authz:

Propriedade Descrição
authz.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

authz.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O rótulo da versão da imagem do Docker desse serviço.

authz.image.url Versão: 1.0.0

Valor padrão: "us.gcr.io/google.com/edge-ci/integration/featureplatform/apigee-authn-authz/master"

O local da imagem do Docker desse serviço.

authz.livenessProbe.failureThreshold Versão: 1.0.0

Valor padrão: 2

O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

authz.livenessProbe.initialDelaySeconds Versão: 1.0.0

Valor padrão: 0

O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

authz.livenessProbe.periodSeconds Versão: 1.0.0

Valor padrão: 5

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

authz.livenessProbe.timeoutSeconds Versão: 1.0.0

Valor padrão: 1

O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

authz.readinessProbe.failureThreshold Versão: Beta2

Valor padrão: 2

O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

authz.readinessProbe.initialDelaySeconds Versão: 1.0.0

Valor padrão: 0

O número de segundos após o início de um contêiner antes de uma sondagem de preparo.

authz.readinessProbe.periodSeconds Versão: 1.0.0

Valor padrão: 5

Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

authz.readinessProbe.successThreshold Versão: 1.0.0

Valor padrão: 1

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

authz.readinessProbe.timeoutSeconds Versão: 1.0.0

Valor padrão: 1

O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

authz.resources.requests.cpu Versão: 1.0.0

Valor padrão: 50m

A ativação de recursos de CPU a serem alocados para solicitações de autenticação.

authz.resources.requests.memory Versão: 1.0.0

Valor padrão: 128Mi

A montagem de recursos de memória para alocar para solicitações de autenticação.

authz.serviceAccountPath Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

busyBoxInit

A tabela a seguir descreve as propriedades do objeto busyBoxInit:

Propriedade Descrição
busyBoxInit.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

busyBoxInit.image.tag Versão: 1.0.0

Valor padrão: "1.0.0"

O rótulo da versão da imagem do Docker desse serviço.

busyBoxInit.image.url Versão: 1.0.0

Valor padrão: "busybox"

O local da imagem do Docker desse serviço.

cassandra

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

Para saber mais informações, consulte Configurar o Cassandra.

A tabela a seguir descreve as propriedades do objeto cassandra:

Propriedade Descrição
cassandra.auth.admin.password Versão: 1.0.0

Valor padrão: "iloveapis123"

Obrigatório

Senha para o administrador do Cassandra. O usuário administrador é usado para qualquer atividade administrativa realizada no cluster do Cassandra.

cassandra.auth.ddl.password Versão: 1.0.0

Valor padrão: "iloveapis123"

Obrigatório

Senha para o usuário da linguagem de definição de dados (DDL, na sigla em inglês) do Cassandra. Usado por MART para qualquer tarefa de definição de dados, como criação, atualização e exclusão de keyspace.

cassandra.auth.default.password Versão: 1.0.0

Valor padrão: "iloveapis123"

Obrigatório

A senha do usuário padrão do Cassandra criada quando o Authentication está ativado. Essa senha precisa ser redefinida ao configurar a autenticação do Cassandra. Consulte Como configurar o TLS para o Cassandra.

cassandra.auth.dml.password Versão: 1.0.0

Valor padrão: "iloveapis123"

Obrigatório

Senha para o usuário da linguagem de manipulação de dados (DML, na sigla em inglês) do Cassandra. O usuário DML é usado pela comunicação do cliente para ler e gravar dados no Cassandra.

cassandra.auth.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

cassandra.auth.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O rótulo da versão da imagem do Docker desse serviço.

cassandra.auth.image.url Versão: 1.0.0

Valor padrão: "google/apigee-cassandra-client"

O local da imagem do Docker desse serviço.

cassandra.backup.cloudProvider Versão: 1.0.0

Valor padrão: "GCP"

Obrigatório se o backup estiver ativado.

Provedor de nuvem para armazenamento de backup.

cassandra.backup.dbStorageBucket Versão: 1.0.0

Valor padrão: nenhum

Obrigatório se o backup estiver ativado.

Bucket de armazenamento do Cloud para os dados de backup.

cassandra.backup.enabled Versão: 1.0.0

Valor padrão: false

O backup de dados não está ativado por padrão. Para ativar, defina como true.

Consulte Backup e recuperação do Cassandra.

cassandra.backup.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

cassandra.backup.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O rótulo da versão da imagem do Docker desse serviço.

cassandra.backup.image.url Versão: 1.0.0

Valor padrão: "google/apigee-cassandra-backup-utility"

O local da imagem do Docker desse serviço.

cassandra.backup.schedule Versão: 1.0.0

Valor padrão: "0 2 * * *"

A programação do job do chron.

Consulte Backup e recuperação do Cassandra.

cassandra.backup.serviceAccountPath Versão: 1.0.0

Valor padrão: nenhum

Obrigatório se o backup estiver ativado.

Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

cassandra.clusterName Versão: 1.0.0

Valor padrão: "apigeecluster"

Especifica o nome do cluster do Cassandra.

cassandra.datacenter Versão: 1.0.0

Valor padrão: "dc-1"

Especifica o data center do nó do Cassandra.

cassandra.dnsPolicy Versão: 1.1.1

Valor padrão: ClusterFirstWithHostNet

Quando cassandra.hostNetwork está definido como true, isso determina qual política de DNS o Cassandra usa. Para implantações baseadas em Anthos, ele precisa ser definido como ClusterFirstWithHostNet.

cassandra.externalSeedHost Versão: 1.0.0

Valor padrão: nenhum

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

cassandra.heapNewSize Versão: 1.0.0

Valor padrão: 100M

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

cassandra.hostNetwork Versão: 1.1.1

Valor padrão: true

Defina como verdadeiro para implantações baseadas no Anthos.

cassandra.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

cassandra.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O rótulo da versão da imagem do Docker desse serviço.

cassandra.image.url Versão: 1.0.0

Valor padrão: "google/apigee-cassandra"

O local da imagem do Docker desse serviço.

cassandra.maxHeapSize Versão: 1.0.0

Valor padrão: 512M

O limite máximo da memória do sistema JVM disponível para as operações do Cassandra em megabytes.

cassandra.multiRegionSeedHost Versão: 1.0.0

Valor padrão: nenhum

Endereço IP de um cluster do Cassandra usado para expandir o cluster atual para uma nova região. Consulte Configurar o host de sugestão multirregional.

cassandra.nodeSelector.key Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

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

Consulte Adicionar seletores de nós.

cassandra.nodeSelector.value Versão: 1.0.0

Valor padrão: nenhum

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

Consulte nodeSelector.

cassandra.port Versão: 1.0.0

Valor padrão: 9042

Número da porta usado para se conectar ao cassandra.

cassandra.rack Versão: 1.0.0

Valor padrão: "ra-1"

Especifica o rack do nó do Cassandra.

cassandra.readinessProbe.failureThreshold Versão: 1.0.0

Valor padrão: 2

O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

cassandra.readinessProbe.initialDelaySeconds Versão: 1.0.0

Valor padrão: 0

O número de segundos após o início de um contêiner antes de uma sondagem de preparo.

cassandra.readinessProbe.periodSeconds Versão: 1.0.0

Valor padrão: 10

Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

cassandra.readinessProbe.successThreshold Versão: 1.0.0

Valor padrão: 1

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

cassandra.readinessProbe.timeoutSeconds Versão: 1.0.0

Valor padrão: 5

O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

cassandra.replicaCount Versão: 1.0.0

Valor padrão: 3

O Cassandra é um banco de dados replicado. É configurado para ter pelo menos três cópias dos dados em cada região ou data center. Essa propriedade especifica o número de nós do Cassandra empregado como um StatefulSet.

cassandra.resources.requests.cpu Versão: 1.0.0

Valor padrão: 500m

A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

cassandra.resources.requests.memory Versão: 1.0.0

Valor padrão: 1Gi

A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

cassandra.restore.cloudProvider Versão: 1.0.0

Valor padrão: "GCP"

Obrigatório se a restauração estiver ativada.

Provedor de nuvem para armazenamento de backup.

cassandra.restore.dbStorageBucket Versão: 1.0.0

Valor padrão: nenhum

Obrigatório se a restauração estiver ativada.

Bucket do Cloud Storage para os dados de backup a serem restaurados.

cassandra.restore.enabled Versão: 1.0.0

Valor padrão: false

cassandra.restore.image.pullPolicy Versão: 1.0.0

Valor padrão: IfNotPresent

Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

  • IfNotPresent: não extraia uma nova imagem se ela já existir.
  • Always: sempre extraia a imagem, independentemente de ela existir.

Para mais informações, consulte Como atualizar imagens.

cassandra.restore.image.tag Versão: 1.0.0

Valor padrão: 1.0.0

O rótulo da versão da imagem do Docker desse serviço.

cassandra.restore.image.url Versão: 1.0.0

Valor padrão: "google/apigee-cassandra-backup-utility"

O local da imagem do Docker desse serviço.

cassandra.restore.serviceAccountPath Versão: 1.0.0

Valor padrão: nenhum

Obrigatório se a restauração estiver ativada.

Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

cassandra.restore.snapshotTimestamp Versão: 1.0.0

Valor padrão: nenhum

Obrigatório se a restauração estiver ativada.

Carimbo de data/hora do backup que precisa ser restaurado.

cassandra.storage.capacity Versão: 1.0.0

Valor padrão: 50Gi

Obrigatório se storage.storageClass for especificado

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

cassandra.storage.storageClass Versão: 1.0.0

Valor padrão: nenhum

Especifica a classe de armazenamento local que está sendo usada.

cassandra.terminationGracePeriodSeconds Versão: 1.0.0

Valor padrão: 300

O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.

defaults

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

A tabela a seguir descreve as propriedades do objeto defaults:

Propriedade Descrição
defaults.org.kmsEncryptionKey Versão: 1.0.0

Valor padrão: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chave de criptografia padrão para a organização no KMS.

defaults.org.kvmEncryptionKey Versão: 1.0.0

Valor padrão: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chave de criptografia padrão para a organização no KVM.

defaults.env.kmsEncryptionKey Versão: 1.0.0

Valor padrão: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chave de criptografia padrão para o ambiente (ambiente) no KMS.

defaults.env.kvmEncryptionKey Versão: 1.0.0

Valor padrão: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chave de criptografia padrão para o ambiente (env) em KVM.

defaults.env.cacheEncryptionKey Versão: 1.0.0

Valor padrão: "aWxvdmVhcGlzMTIzNDU2Nw=="

Chave de criptografia de cache padrão para o ambiente (env).

envs

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

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

Use envs[] para configurar o roteamento de caminho base, que permite configurar e gerenciar como o híbrido da Apigee roteia as chamadas de proxy da API para o ambiente correto.

Veja mais informações em:

A tabela a seguir descreve as propriedades do objeto envs:

Propriedade Descrição
envs[].cacheEncryptionKey Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

Caminho do sistema de arquivos local para a chave de criptografia dos dados em cache da Apigee.

envs[].hostAlias Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

O nome DNS do seu servidor. Por exemplo, foo-test.mydomain.com Se não tiver um nome DNS, use um caractere curinga ('*'). Se você usar um caractere curinga, poderá usar o IP EXTERNAL do istio-ingressgateway, que pode ser conseguido chamando kubectl get services -n namespace depois de concluir a instalação.

Se você tiver vários ambientes, precisará usar um nome de alias de host exclusivo para cada um deles. Por exemplo, foo-test.mydomain.com e foo-prod.mydomain.com.

envs[].kmsEncryptionKey Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

Caminho do sistema de arquivos local para a chave de criptografia dos dados do Apigee KMS.

envs[].name Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

Nome do ambiente da Apigee a ser sincronizado.

envs[].pollInterval Versão: 1.0.0

Valor padrão: nenhum

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

envs[].paths.uri.prefixes Versão: 1.0.0

Valor padrão: nenhum

Uma propriedade compatível com o roteamento de caminho base de prefixo. Informe esses caminhos como no padrão:

      org: hybrid
      envs:
      - name: test
        paths:
          uri:
            prefixes:
            - /foo
            - /bar
envs[].port Versão: 1.0.0

Valor padrão: nenhum

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

envs[].serviceAccountPaths.synchronizer Versão: GA

Valor padrão: nenhum

Caminho para arquivar no sistema local em uma chave da conta de serviço do Google com o papel Apigee Synchronizer Manager.

envs[].serviceAccountPaths.udca Versão: GA

Valor padrão: nenhum

Caminho para arquivar no sistema local em uma chave da conta de serviço do Google com o papel Agente do Apigee Analytics.

envs[].sslCertPath Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

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

envs[].sslKeyPath Versão: 1.0.0

Valor padrão: nenhum

Obrigatório

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

httpProxy

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

Consulte também: MART, Synchronizer e UDCA.

A tabela a seguir descreve as propriedades do objeto httpProxy:

Propriedade Descrição
httpProxy.host Versão: 1.1.1

Valor padrão: nenhum

O nome do host do proxy HTTP.

httpProxy.port Versão: 1.1.1

Valor padrão: nenhum

A porta do proxy HTTP.

httpProxy.scheme Versão: 1.1.1

Valor padrão: HTTPS

O esquema usado pelo proxy. Os valores podem ser HTTP ou HTTPS.

ingress

ingress é a instanciação do Gateway de entrada do Istio, o Recurso do Kubernetes Ingress é usado para especificar os serviços que precisam ser expostos fora do cluster. Ele define um aplicativo em contêiner que encaminha o tráfego de fora do plano de ambiente de execução para serviços dentro desse plano. A instalação da Apigee cria dois objetos Ingress do Istio para:

  1. Ambiente de execução
  2. MART

Consulte também:

A tabela a seguir descreve as propriedades do objeto ingress:

Propriedade Descrição
ingress.enableAccesslog Versão: 1.0.0

Valor padrão: false

Ative ou desative o registro de acesso do Ingress. Por padrão, ele fica desativado.

ingress.envoyHeaders.headers Versão: 1.0.0

Valor padrão: nenhum

Uma lista de cabeçalhos do Envoy.

ingress.envoyHeaders.preserved Versão: 1.0.0

Valor padrão: false

Determina se os cabeçalhos do Envoy serão preservados ou não. Por padrão, elas não são.

ingress.httpsRedirect Versão: 1.0.0

Valor padrão: true

Ative ou desative o redirecionamento HTTPS automático para todo o tráfego de entrada.

ingress.mart.loadBalancerIP Versão: 1.1.1

Valor padrão: 10.0.10.252

Endereço IP do balanceador de carga MART.

ingress.runtime.loadBalancerIP Versão: 1.1.1

Valor padrão: 10.0.10.251

Endereço IP do balanceador de carga para o objeto Apigee-runtime.

ingress.serviceType Versão: 1.0.0

Valor padrão: LoadBalancer

O tipo de serviço usado para rotear o tráfego externo para serviços internos.

Os valores possíveis incluem:

  • ClusterIP (incompatível)
  • LoadBalancer
  • NodePort

istio

A implementação do Istio do Google Cloud Platform (GCP) é uma malha de serviço que se vincula à sua instância atual da Apigee, ajudando na integração com a plataforma de registro, telemetria e sistema de políticas.

Consulte também: documentação do Istio do GCP e O que é o Istio.

A tabela a seguir descreve as propriedades do objeto istio:

Propriedade Descrição
istio.ingressgateway.replicaCountMax Versão: 1.0.0

Valor padrão: 5

Obrigatório

Número máximo de réplicas do gateway de entrada do Istio permitido.

Veja estes tópicos:

istio.ingressgateway.replicaCountMin Versão: 1.0.0

Valor padrão: 1

Obrigatório

O número mínimo de réplicas do gateway de entrada do Istio necessário.

Veja estes tópicos:

istio.ingressgateway.resources.requests.cpu Versão: 1.0.0

Valor padrão: 100 m

Obrigatório

Recursos de CPU alocados para o controlador de entrada, necessários para que o gateway funcione perfeitamente.

Veja estes tópicos:

istio.ingressgateway.resources.requests.memory Versão: 1.0.0

Valor padrão: 128Mi

Recursos de memória alocados ao controlador de entrada, necessários para que o gateway funcione da maneira ideal.

  • objeto ingress
  • Gateways de entrada na documentação do Istio
  • Controladores de entrada na documentação do Kubernetes.
  • istio.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

    Chave de rótulo de seletor de nó opcional para segmentar nós do Kubernetes para serviços istio. Se você não especificar uma chave para o marm.nodeselector, os serviços istio usarão o nó especificado no objeto nodeSelector.

    istio.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Valor do rótulo do seletor de nós opcional para segmentar nós do Kubernetes para serviços istio. Consulte também o objeto nodeSelector.

    istio.pilot.replicaCountMax Versão: 1.0.0

    Valor padrão: 5

    Obrigatório

    O gerenciamento de tráfego principal pilot no cluster, comunicando-se com o proxy secundário envoy. replicaCountMax é o número máximo de réplicas piloto do Istio permitidas.

    Consulte Piloto: gerenciamento de tráfego principal na documentação do Istio.

    istio.pilot.replicaCountMin Versão: 1.0.0

    Valor padrão: 1

    Obrigatório

    O gerenciamento de tráfego principal pilot no cluster, comunicando-se com o proxy secundário envoy. replicaCountMax é o número máximo de réplicas do piloto do Istio necessárias.

    Consulte Piloto: gerenciamento de tráfego principal na documentação do Istio.

    istio.pilot.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 500m

    Obrigatório

    Recursos de CPU alocados ao processo do piloto, necessário para que o gateway funcione da maneira ideal.

    Veja estes tópicos:

    istio.pilot.resources.requests.memory Versão: 1.0.0

    Valor padrão: 2048Mi

    Recursos de memória alocados para o processo piloto, necessários para que o gateway funcione de maneira ideal.

    Veja estes tópicos:

    logger

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

    Veja mais informações em Logging.

    A tabela a seguir descreve as propriedades do objeto logger:

    Propriedade Descrição
    logger.enabled Versão: 1.0.0

    Valor padrão: true

    Ativa ou desativa a geração de registros no cluster. Para não GKE definido como true, para Anthos ou GKE definido como false.

    logger.fluentd.buffer_chunk_limit Versão: 1.0.0

    Valor padrão: 512k

    O tamanho máximo de um bloco de buffer permitido, em kilobytes. Os fragmentos que excederem o limite serão apagados para a fila de saída automaticamente.

    logger.fluentd.buffer_queue_limit Versão: 1.0.0

    Valor padrão: 6

    O tamanho máximo da fila de saída. O limite padrão é de 256 partes.

    logger.fluentd.flush_interval Versão: 1.0.0

    Valor padrão: 5s

    O intervalo a aguardar antes de invocar a próxima limpeza de buffer, em segundos.

    logger.fluentd.max_retry_wait Versão: 1.0.0

    Valor padrão: 30

    O intervalo máximo entre novas tentativas de gravação, em segundos.

    logger.fluentd.num_threads Versão: 1.0.0

    Valor padrão: 2

    O número de linhas de execução usadas para liberar o buffer. O padrão é 1.

    logger.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    logger.image.tag Versão: 1.0.0

    Valor padrão: "1.6.8"

    O rótulo da versão da imagem do Docker desse serviço.

    logger.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-stackdriver-logging-agent"

    O local da imagem do Docker desse serviço.

    logger.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 3

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    logger.livenessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 0

    O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

    logger.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 60

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

    logger.livenessProbe.successThreshold Versão: 1.0.0

    Valor padrão: 1

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

    logger.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    logger.nodeSelector.key Versão: 1.0.0

    Valor padrão: "apigee.com/apigee-logger-enabled"

    Obrigatório

    Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução logger.

    Consulte Adicionar seletores de nós.

    logger.nodeSelector.value Versão: 1.0.0

    Valor padrão: "true"

    Obrigatório

    Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução logger.

    Consulte Adicionar seletores de nós.

    logger.proxyURL Versão: 1.0.0

    Valor padrão: nenhum

    URL do servidor proxy do cliente.

    logger.resource.limits.memory Versão: 1.0.0

    Valor padrão: 500Mi

    O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.

    logger.resource.limits.cpu Versão: 1.0.0

    Valor padrão: 200m

    O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.

    logger.resource.requests.cpu Versão: 1.0.0

    Valor padrão: 100m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    logger.resource.requests.memory Versão: 1.0.0

    Valor padrão: 250Mi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

    logger.serviceAccountPath Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

    logger.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 30

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.

    mart

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

    A tabela a seguir descreve as propriedades do objeto mart:

    Propriedade Descrição
    mart.hostAlias Versão: 1.0.0

    Valor padrão: nenhum

    O alias de host que aponta para o objeto MART. É possível definir essa propriedade como * ou um nome de domínio totalmente qualificado.

    mart.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    mart.image.tag Versão: 1.0.0

    Valor padrão: 1.0.0

    O rótulo da versão da imagem do Docker desse serviço.

    mart.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-mart-server"

    O local da imagem do Docker desse serviço. Verifique o arquivo values.yaml para o URL específico. Você pode substituir isso.

    mart.initCheckCF.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 10m

    A quantidade de CPU alocada para a verificação de inicialização do processo do Cloud Foundry.

    mart.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 12

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    mart.livenessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 15

    O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

    mart.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

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

    mart.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    mart.metricsURL Versão: 1.0.0

    Valor padrão: "/v1/server/metrics"

    mart.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

    Chave de rótulo do seletor de nó opcional para segmentar nós do Kubernetes para serviços do ambiente de execução mart. Se você não especificar uma chave para mart.nodeselector, o ambiente de execução usará o nó especificado no objeto nodeSelector.

    Consulte Adicionar seletores de nós.

    mart.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Valor do rótulo do seletor de nós opcional para segmentação de nós do Kubernetes para mart serviços do ambiente de execução. Consulte também o objeto nodeSelector.

    Consulte Adicionar seletores de nós.

    mart.readinessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

    mart.readinessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 15

    O número de segundos após o início de um contêiner antes de uma sondagem de preparo.

    mart.readinessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

    Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

    mart.readinessProbe.successThreshold Versão: 1.0.0

    Valor padrão: 1

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

    mart.readinessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    mart.replicaCountMax Versão: 1.0.0

    Valor padrão: 5

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

    mart.replicaCountMin Versão: 1.0.0

    Valor padrão: 1

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

    mart.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 500m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    mart.resources.requests.memory Versão: 1.0.0

    Valor padrão: 512Mi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

    mart.serviceAccountPath Versão: 1.1.1

    Valor padrão: nenhum

    Obrigatório

    Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

    mart.sslCertPath Versão: 1.0.0

    Valor padrão: nenhum

    Caminho do sistema de arquivos local para carregar e codificar o certificado SSL como um Secret.

    mart.sslKeyPath Versão: 1.0.0

    Valor padrão: nenhum

    Caminho do sistema de arquivos local para carregar e codificar a chave SSL para um secret.

    mart.targetCPUUtilizationPercentage Versão: 1.0.0

    Valor padrão: 75

    Meta de uso da CPU para o processo MART no pod. O valor desse campo permite que o MART seja escalonado automaticamente quando a utilização da CPU atingir esse valor, até replicaCountMax.

    mart.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 30

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.

    metrics

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

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

    A tabela a seguir descreve as propriedades do objeto metrics:

    Propriedade Descrição
    metrics.enabled Versão: 1.0.0

    Valor padrão: false

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

    metrics.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução metrics.

    Consulte Adicionar seletores de nós.

    metrics.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução metrics.

    Consulte Adicionar seletores de nós.

    metrics.prometheus.args.storage_tsdb_retention Versão: 1.0.0

    Valor padrão: 48h

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

    metrics.prometheus.containerPort Versão: 1.0.0

    Valor padrão: 9090

    A porta para se conectar ao serviço de métricas do Prometheus.

    metrics.prometheus.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    metrics.prometheus.image.tag Versão: 1.0.0

    Valor padrão: "v2.9.2"

    O rótulo da versão da imagem do Docker desse serviço.

    metrics.prometheus.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-prom-prometheus"

    O local da imagem do Docker desse serviço.

    metrics.prometheus.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 6

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    metrics.prometheus.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

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

    metrics.prometheus.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 3

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    metrics.prometheus.readinessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 120

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

    metrics.prometheus.readinessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

    Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

    metrics.prometheus.readinessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 3

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    metrics.proxyURL Versão: 1.0.0

    Valor padrão: nenhum

    URL do proxy secundário do processo de métricas no cluster do Kubernetes.

    metrics.resources.limits.cpu Versão: 1.0.0

    Valor padrão: 250m

    O limite de CPU do recurso em um contêiner do Kubernetes, em milésimos.

    metrics.resources.limits.memory Versão: 1.0.0

    Valor padrão: 256Mi

    O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.

    metrics.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 250m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    metrics.resources.requests.memory Versão: 1.0.0

    Valor padrão: 256Mi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

    metrics.sdSidecar.containerPort Versão: 1.0.0

    Valor padrão: 9091

    A porta para se conectar ao serviço de métricas do Stackdriver.

    metrics.sdSidecar.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

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

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

      Para mais informações, consulte Como atualizar imagens.

    metrics.sdSidecar.image.tag Versão: 1.0.0

    Valor padrão: "release-0.4.0"

    O rótulo da versão da imagem do Docker desse serviço.

    metrics.sdSidecar.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-stackdriver-prometheus-sidecar"

    O local da imagem do Docker desse serviço.

    metrics.serviceAccountPath Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

    metrics.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 300

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os ganchos de parada serão executados, e qualquer processo em execução será encerrado sem problemas.

    nodeSelector

    O objeto nodeSelector define o nó da instância da Apigee. Nos bastidores, quando o apigeectl é executado, é necessário mapear a chave/valor do rótulo para apigeeRuntime e apigeeData para os componentes individuais do Istio e MART. É possível modificar isso para objetos individuais nas propriedades istio:nodeSelector e mart:nodeSelector.

    A tabela a seguir descreve as propriedades do objeto nodeSelector:

    Propriedade Descrição
    nodeSelector.apigeeData.key Versão: 1.0.0

    Valor padrão: "cloud.google.com/gke-nodepool"

    ApigeeData é o nó do banco de dados do Cassandra. Chave de rótulo do seletor de nós para segmentar nós do Kubernetes para trabalhar com dados de serviços da Apigee.

    Consulte Adicionar seletores de nós.

    nodeSelector.apigeeData.value Versão: 1.0.0

    Valor padrão: "apigee-data"

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

    Consulte Adicionar seletores de nós.

    nodeSelector.apigeeRuntime.key Versão: 1.0.0

    Valor padrão: "cloud.google.com/gke-nodepool"

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

    Consulte Adicionar seletores de nós.

    nodeSelector.apigeeRuntime.value Versão: 1.0.0

    Valor padrão: "apigee-runtime"

    apigee-runtime é o nó do ambiente de execução do projeto. Valor do rótulo do seletor de nós para segmentação de nós do Kubernetes para serviços do ambiente de execução da Apigee.

    Consulte Adicionar seletores de nós.

    nodeSelector.requiredForScheduling Versão: 1.0.0

    Valor padrão: falso

    O padrão da propriedade requiredForScheduling é falso. Se esse valor for modificado como verdadeiro, o Kubernetes não poderá encontrar nós com a chave/valor de rótulo configurada. Além disso, os pods subjacentes não serão programados nos nós de trabalho da VM.

    Para a produção, nodeSelector.requiredForScheduling precisa ser definido como verdadeiro.

    Consulte Adicionar seletores de nós.

    runtime

    A tabela a seguir descreve as propriedades do objeto runtime:

    Propriedade Descrição
    runtime.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    runtime.image.tag Versão: 1.0.0

    Valor padrão: 1.0.0

    O rótulo da versão da imagem do Docker desse serviço.

    runtime.image.url Versão: 1.0.0

    Valor padrão: URL para o recurso de imagem da instalação, como: "google/apigee-runtime"

    O local da imagem do Docker desse serviço.

    runtime.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    runtime.livenessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 60

    O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

    runtime.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

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

    runtime.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    runtime.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

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

    Consulte propriedade nodeSelector.

    runtime.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Valor do rótulo do seletor de nós para segmentar nós do Kubernetes para serviços runtime.

    Consulte Adicionar seletores de nós.

    runtime.readinessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

    runtime.readinessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 60

    O número de segundos após o início de um contêiner antes de uma sondagem de preparo.

    runtime.readinessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

    Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

    runtime.readinessProbe.successThreshold Versão: 1.0.0

    Valor padrão: 1

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

    runtime.readinessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    runtime.replicaCountMax Versão: 1.0.0

    Valor padrão: 4

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

    runtime.replicaCountMin Versão: 1.0.0

    Valor padrão: 1

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

    runtime.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 500m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    runtime.resources.requests.memory Versão: 1.0.0

    Valor padrão: 1Gi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

    runtime.service.type Versão: 1.0.0

    Valor padrão: ClusterIP

    O tipo de serviço. Você pode definir isso como um serviço diferente de ClusterIP. Por exemplo, LoadBalancer.

    runtime.targetCPUUtilizationPercentage Versão: 1.0.0

    Valor padrão: 75

    Meta de uso da CPU para o processo do ambiente de execução no pod. O valor desse campo permite que o ambiente de execução seja escalonado automaticamente quando a utilização da CPU atingir esse valor, até replicaCountMax.

    runtime.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 180

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os ganchos de parada serão executados, e qualquer processo em execução será encerrado sem problemas.

    synchronizer

    Garanta que os processadores de mensagens sejam atualizados com os pacotes de proxy de API implantados mais recentes. Para fazer isso, o Synchronizer pesquisa o plano de gerenciamento. Quando um novo contrato é detectado, o sincronizador o envia para o plano de ambiente de execução.

    Para mais informações, consulte Sincronizador.

    A tabela a seguir descreve as propriedades do objeto synchronizer:

    Propriedade Descrição
    synchronizer.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    synchronizer.image.tag Versão: 1.0.0

    Valor padrão: 1.0.0

    O rótulo da versão da imagem do Docker desse serviço.

    synchronizer.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-synchronizer"

    O local da imagem do Docker desse serviço.

    synchronizer.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    synchronizer.livenessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 0

    O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

    synchronizer.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

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

    synchronizer.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    synchronizer.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Chave de rótulo do seletor de nó opcional para segmentar nós do Kubernetes para serviços do ambiente de execução synchronizer.

    Consulte nodeSelector.

    synchronizer.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Valor do rótulo do seletor de nós opcional usado para segmentação de nós do Kubernetes para synchronizer serviços do ambiente de execução.

    Consulte nodeSelector.

    synchronizer.pollInterval Versão: 1.0.0

    Valor padrão: 60

    O tempo que o Synchronizer aguarda entre as operações de pesquisa. O Synchronizer pesquisa os serviços do plano de controle do Apigee para detectar e receber novos contratos de ambiente de execução.

    synchronizer.readinessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de preparo antes de marcar o pod como não pronto. O valor mínimo é 1.

    synchronizer.readinessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 0

    O número de segundos após o início de um contêiner antes de uma sondagem de preparo.

    synchronizer.readinessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

    Determina a frequência com uma sondagem de preparo será feita, em segundos. O valor mínimo é 1.

    synchronizer.readinessProbe.successThreshold Versão: 1.0.0

    Valor padrão: 1

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

    synchronizer.readinessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    synchronizer.replicaCount Versão: 1.0.0

    Valor padrão: 2

    Número de réplicas para escalonamento automático.

    synchronizer.resources.requests.cpu Versão: 1.0.0

    Valor padrão: 100m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    synchronizer.resources.requests.memory Versão: 1.0.0

    Valor padrão: 1Gi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em gigabytes.

    synchronizer.serviceAccountPath Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Caminho para o arquivo de chave da conta de serviço do Google com o papel "Administrador somente leitura da Apigee".

    synchronizer.targetCPUUtilizationPercentage Versão: 1.0.0

    Valor padrão: 75

    Meta de uso da CPU para o processo do Synchronizer no pod. O valor desse campo permite que o Synchronizer faça o escalonamento automático quando a utilização da CPU atingir esse valor, até replicaCountMax.

    synchronizer.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 30

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os hooks de prestop serão executados, e qualquer processo em execução será encerrado sem problemas.

    udca

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

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

    A tabela a seguir descreve as propriedades do objeto udca:

    Propriedade Descrição
    udca.fluentd.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    udca.fluentd.image.tag Versão: 1.0.0

    Valor padrão: 1.0.0

    O rótulo da versão da imagem do Docker desse serviço.

    udca.fluentd.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-stackdriver-logging-agent"

    O local da imagem do Docker desse serviço.

    udca.fluentd.resource.limits.memory Versão: 1.0.0

    Valor padrão: 500Mi

    O limite de memória do recurso em um contêiner do Kubernetes, em mebibytes.

    udca.fluentd.resource.requests.cpu Versão: 1.0.0

    Valor padrão: 500m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    udca.fluentd.resource.requests.memory Versão: 1.0.0

    Valor padrão: 250Mi

    A memória necessária para a operação normal do recurso em um contêiner do Kubernetes, em mebibytes.

    udca.image.pullPolicy Versão: 1.0.0

    Valor padrão: IfNotPresent

    Determina quando o kubelet extrai a imagem do Docker do pod. Os valores possíveis incluem:

    • IfNotPresent: não extraia uma nova imagem se ela já existir.
    • Always: sempre extraia a imagem, independentemente de ela existir.

    Para mais informações, consulte Como atualizar imagens.

    udca.image.tag Versão: 1.0.0

    Valor padrão: "1.0.0"

    O rótulo da versão da imagem do Docker desse serviço.

    udca.image.url Versão: 1.0.0

    Valor padrão: "google/apigee-udca"

    O local da imagem do Docker desse serviço.

    udca.jvmXms Versão: 1.0.0

    Valor padrão: 256m

    A quantidade de memória inicial do JVM do pod de coleta de dados.

    udca.jvmXmx Versão: 1.0.0

    Valor padrão: 256m

    A alocação máxima de memória para JVM do pod de coleta de dados.

    udca.livenessProbe.failureThreshold Versão: 1.0.0

    Valor padrão: 2

    O número de vezes que o Kubernetes verificará se houve falha nas sondagens de ativação antes de reiniciar o contêiner. O valor mínimo é 1.

    udca.livenessProbe.initialDelaySeconds Versão: 1.0.0

    Valor padrão: 0

    O número de segundos após o início de um contêiner antes que uma sondagem de ativação seja iniciada.

    udca.livenessProbe.periodSeconds Versão: 1.0.0

    Valor padrão: 5

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

    udca.livenessProbe.timeoutSeconds Versão: 1.0.0

    Valor padrão: 1

    O número de segundos após os quais uma sondagem de ativação expira. O valor mínimo é 1.

    udca.nodeSelector.key Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Chave de rótulo do seletor de nós usada para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução udca.

    Consulte Adicionar seletores de nós.

    udca.nodeSelector.value Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

    Valor do rótulo do seletor de nós usado para segmentar nós dedicados do Kubernetes para serviços do ambiente de execução udca.

    Consulte Adicionar seletores de nós.

    udca.pollingIntervalInSec Versão: 1.0.0

    Valor padrão: 1

    O tempo, em segundos, que a UDCA aguarda entre as operações de pesquisa. A UDCA pesquisa o diretório de dados no sistema de arquivos do pod de coleta de dados para detectar novos arquivos.

    prometheus.sslCertPath Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

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

    Veja estes tópicos:

    prometheus.sslKeyPath Versão: 1.0.0

    Valor padrão: nenhum

    Obrigatório

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

    Veja estes tópicos:

    udca.replicaCountMax Versão: 1.0.0

    Valor padrão: 4

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

    udca.replicaCountMin Versão: 1.0.0

    Valor padrão: 1

    O número mínimo de pods para implantação da UDCA. Como a UDCA é implementada como um ReplicaSet, os pods são réplicas.

    Se o uso da CPU ultrapassar udca.targetCPUUtilizationPercentage, o híbrido aumentará gradualmente o número de pods, até udca.replicaCountMax.

    udca.resource.requests.cpu Versão: 1.0.0

    Valor padrão: 250m

    A CPU necessária para a operação normal do recurso em um contêiner do Kubernetes, em milissegundos.

    udca.revision Versão: 1

    Valor padrão: "v1"

    Um valor estático preenchido em um rótulo para ativar implantações canário.

    udca.targetCPUUtilizationPercentage Versão: 1.0.0

    Valor padrão: 75

    O limite de uso da CPU para escalonar o número de pods no ReplicaSet, como uma porcentagem do total de recursos de CPU disponíveis. O híbrido usa a combinação combinada de todos os contêineres no pod de coleta de dados (fluentd e UDCA) para calcular a utilização atual.

    Quando o uso da CPU ultrapassar esse valor, o híbrido aumentará gradualmente o número de pods no ReplicaSet, até udca.replicaCountMax.

    udca.terminationGracePeriodSeconds Versão: 1.0.0

    Valor padrão: 600

    O tempo entre uma solicitação de exclusão de pod e quando o pod é eliminado, em segundos. Durante esse período, todos os ganchos de parada serão executados, e qualquer processo em execução será encerrado sem problemas.