Glossário

Nesta seção, descrevemos termos comuns que você precisa conhecer ao usar a Apigee híbrida.

Termo Definição
imagem do app Consulte Imagem.
APIs Apigee Os endpoints que podem ser usados para configurar ambientes, organizações, proxies de API e outros serviços híbridos. Eles são acessados pelo MART.
app/aplicativo Um serviço híbrido que foi empacotado e implantado em um contêiner, pod, nó, cluster . Também conhecido como imagem de contêiner, microsserviço, serviço, aplicativo em contêiner ou imagem do docker (quando o Docker é o contêiner).
Cassandra

O repositório de dados do ambiente de execução do Edge que armazena configurações de aplicativos, contadores de cota distribuída, chaves de API e tokens OAuth para aplicativos em execução no gateway.

Esse é um StatefulSet que consome muitos recursos e precisa estar em um nó de trabalho separado do processador de mensagens.

Para saber mais, consulte Sobre o plano de ambiente de execução.

infraestrutura central de gerenciamento (ou "plano") Consulte plano de gerenciamento.
CNCF Cloud Native Computing Foundation. É possível executar o ambiente de execução híbrido em qualquer implementação oficial do CNCF no Kubernetes, exceto no OpenShift.
modelo de configuração Consulte modelo.
container

Normalmente, 1 contêiner para 1 aplicativo. não associados ao sistema operacional nem ao sistema de arquivos. Tem um sistema de arquivos próprio e não pode interagir com os processos de outros contêineres dentro de um pod. Docker ou rkt são exemplos de contêineres.

No entanto, o contêiner do processador de mensagens do ambiente de execução híbrido (mp) contém o roteador e o processador de mensagens.

imagem de contêiner [conteinerizada] Consulte imagem.
plano de controle Consulte plano de gerenciamento.
controlador Examina o sistema e atribui recursos novamente conforme necessário.

Há programador, implantação, replicação, endpoint, Kubelet e outros controladores.

Implantação Consulte app/aplicativo.
especificação de implantação O arquivo de configuração completo do plano de ambiente de execução. É a combinação de valores padrão do arquivo values.yaml e suas configurações personalizadas no arquivo overrides.yaml.
ambiente Oferece um contexto isolado ou "sandbox" para executar proxies da API. Em uma única organização, é possível ter vários ambientes, e cada ambiente tem um serviço de gateway de entrada do Istio mapeado para ele. Todo o tráfego de fora do cluster passa por esse endpoint de entrada protegido por TLS.
GCR Google Container Repository.
GKE Google Kubernetes Engine. Um ambiente pronto para produção gerenciado pelo Google para implantar aplicativos em contêineres no Kubernetes. Com o GKE, é possível começar a usar o Kubernetes em pouco tempo, eliminando por completo a necessidade de instalar, gerenciar e operar seus próprios clusters do Kubernetes.
imagem

Uma imagem pode se referir a dois estados diferentes de um aplicativo e suas dependências:

  • imagem de aplicativo é uma versão do código-fonte de um aplicativo, além das dependências dele. Por exemplo, é possível usar um repositório ou uma ferramenta de gerenciamento de código-fonte, como Git ou Perforce, para controlar a versão do app em um sistema de compilação que gerencie as dependências dele.

    Ao criar uma implantação, você referencia uma imagem de aplicativo:

    
    kubectl run kubernetes-bootcamp --image=app_image_location
  • imagem de contêiner: uma imagem de aplicativo mais um dockerfile, empacotado para implantação. Também conhecida como imagem de aplicativo em contêiner ou imagem do docker. Atualmente, a Apigee híbrida é compatível apenas com imagens de aplicativos em contêineres do docker.

    O processo de criação de uma imagem de contêiner é o seguinte:

    
    app image -> [package/build utility] -> container image

    Quando você cria uma implantação pela primeira vez, o comando kubectl run usa uma opção image. Essa opção especifica o local da imagem do aplicativo (antes de ser conteinerizado). No entanto, na maioria dos lugares, o termo "imagem" refere-se ao aplicativo em contêiner: o resultado do comando de execução/a saída de uma imagem do aplicativo que está sendo processada por um utilitário de empacotamento.

repositório de imagens Um grupo de imagens de contêiner compartilhadas.
controlador de entrada/entrada Um aplicativo em contêiner que encaminha o tráfego de fora do cluster para os serviços dentro do cluster.
KMS Serviço de gerenciamento de chaves Armazena, mantém e apresenta chaves e tokens OAuth para criptografar e descriptografar tráfego. O Edge KMS gerencia chaves para aplicativos, desenvolvedores e produtos de API.
KVM Mapa de chave-valor. Uma coleção personalizada de pares de strings de chave/valor criptografados ou não. Para saber mais, consulte Como trabalhar com mapas de valores-chave.
Máquina de administração do Kubernetes A máquina local usada para executar comandos no cluster do Kubernetes. Ela é normalmente uma máquina de área de trabalho com acesso às VMs do Kubernetes.
plano de gerenciamento Os serviços centrais hospedados pelo Google que se comunicam com o plano de ambiente de execução por meio de contas de serviço.
MART

A API para dados de ambiente de execução interage com o armazenamento de dados local do ambiente de execução (Cassandra). Ele funciona como o provedor de API para a API Apigee pública para acessar e gerenciar dados do ambiente de execução.

O MART é um aplicativo sem estado, assim como os Processadores de mensagens. É um aplicativo em contêiner Kubenetes.

Para saber mais, consulte Sobre o plano de ambiente de execução.

nó mestre Um termo do Kubernetes para um nó que inclua o apiserver, cloud-controller-manager (CCM), o programador e o kube-controller-manager.
processador de mensagens (MP, na sigla em inglês)

Um processador de mensagens processa as solicitações de ambiente de execução da API do cliente e aplica as políticas de proxy. Também conhecido como gateway de API.

O processador de mensagens avalia uma solicitação recebida, executa as políticas da Apigee e chama os sistemas de back-end e outros sistemas para recuperar dados. Depois que essas respostas são recebidas, o processador de mensagens formata uma resposta e a retorna para o cliente.

O MP é uma implantação do Kubernetes. Ele é configurado para um único ambiente de Edge, apontando para um subdiretório com escopo dentro do sistema de arquivos compartilhado a que o Sincronizador fornece dados.

Um MP consome muitos recursos e precisa estar em um nó de trabalho separado do Cassandra.

Para saber mais, consulte Sobre o plano de ambiente de execução.

namespace Clusters virtuais usados para dividir recursos de cluster. Os namespaces são para clusters maiores com muitos usuários. Clusters menores com apenas dezenas de usuários não precisam de namespaces normalmente.
Uma máquina de trabalho que pode ser uma máquina virtual ou física, dependendo do cluster. O Kubernetes cria objetos de nó, mas não nós em si. Os nós são criados por provedores de nuvem externos, como o Google Compute Engine (GCE).
Kubernetes de código aberto A implementação de referência do Kubernetes. Consulte Kubernetes. O ambiente de execução híbrido da Apigee é executado em Kubernetes de código aberto e em versões de código aberto do Kubernetes que são compatíveis com CNCF.
organização Um contêiner para todas as entidades em uma conta da Apigee, incluindo proxies de API, produtos de API, pacotes de API, apps e desenvolvedores. Neste documento, o termo organização da Apigee ou a organização híbrida é usada internamente.

Para instalar e usar a opção híbrida, você precisa ter uma organização da Apigee vinculada a um projeto do Google Cloud. Isso é feito quando você cria a organização em um processo conhecido como provisionamento.

Uma organização da Apigee não é igual a uma organização do GCP. Se houver possibilidade de ambiguidade, o documento deverá especificar que a "organização" é uma organização da Apigee.

pod Um pod é o bloco básico do Kubernetes: a menor e mais simples unidade no modelo de objeto do Kubernetes que pode ser criada ou implantada. Um pod representa um processo em execução no cluster.
proxy Também proxy de API. Um proxy de API é uma camada de abstração que serve como "front" para APIs de serviço de back-end e fornece recursos de valor agregado, como segurança, limitação de taxa, cotas, análises e mais.
controlador de replicação Reprograma os pods e processa a autocorreção para pods.
recurso Também recurso da API Kubernetes. Objetos que você usa para gerenciar o cluster, bem como contêineres, aplicativos e outros recursos nele.

Os recursos da API incluem serviços que fornecem descoberta, balanceamento de carga, configuração e armazenamento. Um exemplo de recurso da API é um controlador de entrada.

plano de ambiente de execução

Os serviços Apigee híbrida gerenciados por você no seu próprio cluster do Kubernetes existem no plano de ambiente de execução. Esses serviços se comunicam por meio de contas de serviço com o plano de gerenciamento.

Inclui MART, Sincronizador, Processadores de mensagens e Cassandra.

Para saber mais, consulte Sobre o plano de ambiente de execução.

serviço

Um termo geral para os aplicativos em contêiner em execução no cluster do Kubernetes no plano de execução. Esses serviços incluem MART, Sincronizador, Processadores de mensagens e Cassandra.

Para saber mais, consulte Sobre o plano de ambiente de execução.

Snuffleupagus Um mamutes grandioso e que se move lentamente, popularizado por um programa de televisão infantil.
nó com estado Um nó de cluster que requer armazenamento permanente para manter o estado. Consulte Configurar pools de nós dedicados.
Nó sem estado Um nó de cluster que não requer armazenamento permanente. Consulte Configurar pools de nós dedicados.
Sincronizador

Um serviço de plano de ambiente de execução que pesquisa o plano de gerenciamento em busca da configuração de implantação e eventos para cada ambiente. Ele faz o download dos metadados necessários sobre os proxies implantados, os arquivos de configuração de proxy e muito mais para o ambiente de execução.

O Sincronizador armazena as informações em um sistema de arquivos compartilhado que é lido pelo Processador de mensagens. Ele será executado como um aplicativo DaemonSet. Ele não tem tráfego da API de ambiente de execução e pode sincronizar dados de vários ambientes a partir de um único processo/pod do Kubernetes.

Para saber mais, consulte Sobre o plano de ambiente de execução.

modelo

Um arquivo YAML que define um serviço. A maioria dos serviços híbridos tem o próprio modelo. Por exemplo, mp.yaml define o serviço de Processador de mensagens.

Durante a instalação, o comando apigeectl mescla os modelos em um único arquivo com as informações de configuração do cluster chamadas values.yaml. É possível substituir alguns valores no arquivo values.yaml usando o arquivo overrides.yaml (em inglês).

Os modelos de configuração híbrida estão localizados no diretório hybrid_install_dir/templates na máquina de administração do Kubernetes.

UDCA

Agente de coleta de dados universal. Um serviço em execução no pod de coleta de dados no plano de ambiente de execução que extrai dados de análises, rastreamento e status de implantação e os envia ao UAP.

Para saber mais, consulte Coleta de dados de rastreamento, análise e status de implantação.

UAP

Plataforma unificada de análise. Um serviço da Apigee no plano de gerenciamento que processa análises de entrada, rastreamento e dados de status de implantação e os disponibiliza pela IU híbrida da Apigee ou das APIs Apigee.

Para saber mais, consulte Coleta de dados de rastreamento, análise e status de implantação.

volume Armazenamento compartilhado que pode ser usado por todos os aplicativos em contêiner dentro de um pod.