Compare os produtos da Apigee

Neste tópico, comparamos a Apigee X e a Apigee híbrida com a Apigee Edge para nuvem pública e privada. Para detalhes sobre a Apigee Edge para nuvem pública e nuvem privada, consulte a documentação da Apigee Edge.

A tabela a seguir lista os produtos de gerenciamento de API da Apigee comparados neste tópico:

Produto Onde está hospedado Gerenciado por
Apigee Edge para nuvem pública Nuvem da Apigee Apigee
Apigee Edge para nuvem privada O data center particular do cliente. Cliente
Apigee X Google Cloud Apigee
Apigee híbrida O Google Cloud e o data center particular do cliente A Apigee administra o plano de gerenciamento e o cliente gerencia o plano de ambiente de execução.

Apigee híbrida x Apigee Edge para nuvem privada

A tabela a seguir compara a Apigee híbrida e a Apigee Edge para nuvem privada:

Serviço Produto ou área de recurso da Apigee
Apigee híbrida Apigee Edge para nuvem privada
Análise Um pod de coleta de dados no plano do ambiente de execução usa fluentd e UDCA (Agente universal de coleta de dados, na sigla em inglês) para reunir análise e alimentar os dados para a UAP (plataforma de análise unificada) no plano de gerenciamento. Servidores Qpid e Postgres
Gateway de proxy de API O Processador de mensagens (MP, na sigla em inglês) processa as solicitações recebidas. Os MPs são implementados como um ou mais apps em contêiner no plano do ambiente de execução. processador de mensagens
Persistência O Cassandra fornece persistência para os recursos KMS, KVM, cota e cache. Nó ou anel do Cassandra
Implantação O Synchronizer garante que as configurações de proxy de API, as informações de ambiente e outros dados sejam atualizados entre o plano de gerenciamento e o de tempo de execução. ZooKeeper
Interface do usuário administrativa A IU da Apigee é um app em contêiner hospedado no plano de gerenciamento. A IU da Apigee Edge está hospedada no servidor de gerenciamento
Balanceamento de carga Um controlador de entrada Istio envia solicitações ao app em contêiner Router/Message Processor (RMP) no plano de ambiente de execução. Router
APIs As APIs da Apigee X são acessadas por meio do servidor de gerenciamento e do MART. O MART interage com o repositório de dados local do Cassandra e atua como provedor de API para que as APIs da Apigee X acessem e gerenciem entidades de dados de ambiente de execução. Servidor de gerenciamento
Métricas Gerenciado por um único servidor Prometheus por cluster para todos os serviços. Cada componentes configuradoscom JMX

Comparação do recurso

As seções a seguir comparam os recursos da nuvem pública/privada da Apigee Edge com disponibilidade de recursos na Apigee X e na Apigee híbrida.

Resumo das diferenças nos recursos atuais

Na tabela a seguir, descrevemos as diferenças no nível de recurso entre a Apigee X (e a Apigee híbrida) e a Apigee Edge para plataformas de nuvem pública e privada.

Recurso da Apigee Edge Suporte na Apigee X e na Apigee híbrida
Revisões de proxy de API

Imutável quando implantado

Adaptador da Apigee para Istio Obsoleto: recomendamos que você use o adaptador da Apigee para Envoy.
Deployments
  • Implantações assíncronas
  • A recuperação do status de implantação é baseada na última vez em que o plano de ambiente de execução "fez check-in" com o plano de gerenciamento.
Ambientes
  • Compatibilidade para grupos de ambiente
  • Autoatendimento nas IUs e APIs da Apigee
  • Mais flexibilidade na exibição de topologia
  • Um pod de MP pode exibir apenas um ambiente

Para mais informações, consulte Sobre ambientes e grupos de ambiente.

Extensões Incompatível
Keystores/Truststores
  • Northbound gerenciado como secrets do Kubernetes
KVMs
  • É possível criar KVMs criptografadas com escopo de ambiente na IU da Apigee. As KVMs são sempre criptografadas. Não é possível adicionar, atualizar ou visualizar entradas KVM na IU.
  • Use o atributo private. com todas as variáveis ao acessar uma KVM com o comando GET para ocultar as informações da KVM em uma sessão de depuração (Trace). Se o atributo private. não for usado, a KVM ainda será criptografada. No entanto, as informações da KVM aparecerão descriptografadas na sessão de depuração (Trace) e nenhuma exceção será gerada.
  • Gerencie entradas da KVM usando a API keyvaluemaps.entries ou a política KeyValueMapOperations.
  • É possível usar conjuntos de propriedades para alguns dos casos de uso como KVMs. Consulte Como usar conjuntos de propriedades.
  • O elemento <MapName> permite que a política KeyValueMapOperations identifique qual KVM usar dinamicamente, no ambiente de execução.

Para mais informações sobre como criar KVMs na IU, consulte Como usar mapas de chave-valor. Consulte também Como acessar dados de configuração para informações sobre como escolher o mecanismo de persistência de dados correto.

Microgateway Não compatível
Monetização Consulte Comparação da monetização entre a Apigee X e a Apigee Edge
Node.js
  • Os proxies da API Node.js não são compatíveis.
  • A Apigee recomenda que você hospede aplicativos Node.js como contêineres separados no Kubernetes (mesmo cluster ou diferente)
Destinos hospedados

Incompatível.

OAuth A nova política RevokeOAuthv2 revoga por ID de usuário final, pelo ID do app ou ambos. Essa política substitui a API Apigee Edge para revogar os tokens do OAuth2.
Armazenamento de especificações da OpenAPI Incompatível
Políticas
  • Novas políticas:
    • Política AssertCondition: avalia uma instrução condicional do ambiente de execução nos fluxos de solicitação ou resposta.
    • Política CORS: permite que chamadas XMLHttpRequest (XHR) JavaScript executadas em uma página da Web interajam com recursos de domínios não originais.
    • Política DataCapture: substitui a política StatisticsCollector.
    • Política ExternalCallout: envia solicitações gRPC ao servidor gRPC para implementar um comportamento personalizado que não é compatível com as políticas da Apigee.
    • Política GraphQL: analisa payloads do GraphQL em variáveis de fluxo de mensagens, verifica as solicitações do GraphQL em um esquema ou ambos.
    • Política PublishMessages: publica informações do fluxo do proxy de API em um tópico do Google Cloud Pub/Sub.
    • Política RevokeOAuthv2: revoga por ID do usuário, ID do app ou ambos
    • Política TraceCapture: adiciona outras variáveis aos dados de trace do ambiente de execução da Apigee.
  • Política incompatível:
    • Política StatisticsCollector (substituída pela nova política DataCapture)
  • Políticas alteradas:
Recursos Não é possível usar recursos no nível da organização
Papéis e permissões
  • Gerenciado por meio do serviço de IAM do Console do Google Cloud
  • Algumas funções prontas para uso estão disponíveis
  • É possível criar papéis personalizados que podem incluir outras permissões do Google Cloud

Para mais informações, consulte Usuários e papéis.

Apigee Sense Não compatível
Serviços de SOAP no assistente de criação de proxy Incompatível. Consulte o wsdl2apigee, um projeto de código aberto que fornece utilitários SOAP para uso com a Apigee.
Sessões de rastreamento/depuração Veja Diferenças com o Trace.
Hosts virtuais

Para a Apigee híbrida:

  • A entrada é implementada com o Anthos Service Mesh.
  • As chaves e os certificados são implantados diretamente no Kubernetes.

Para a Apigee X:

  • Não é gerenciado na Apigee por ela
  • Cada instância expõe um endpoint HTTPS por meio de um certificado autoassinado. Para fazer o download da CA do certificado, consulte a organização.
  • O gateway do Istio (Envoy) é usado onde certificados e chaves são implantados

Para ambos:

  • Não é gerenciado na Apigee por ela

Diferenças com o Trace

A tabela a seguir compara as diferenças na maneira como o Trace opera na Apigee X e na Apigee híbrida em comparação à Apigee Edge Cloud:

Recurso Apigee Edge Cloud Apigee X e Apigee híbrida
Momento oportuno Em tempo real, síncrona Pequeno atraso, assíncrona
Nome/ID da sessão Aceita o nome da sessão do usuário Não aceita o nome da sessão do usuário.
Filtros Compatibilidade básica com filtros, como filtragem de parâmetros de consulta e cabeçalho Suporte para lógica de filtragem complexa, incluindo operações lógicas "E" e "OU". Acesso a qualquer variável de fluxo mencionada na referência de variáveis de fluxo. A sintaxe é a mesma usada com condicionais, como mostrado na referência de condições.
Tempo limite da sessão

Define a duração da sessão de depuração e por quanto tempo os dados são retidos.

O valor padrão é de 20 minutos quando iniciado por chamadas de API e 10 minutos quando iniciado na IU.

Define somente a duração da sessão de depuração. O ponto de partida é quando o processador de mensagens recebe a solicitação para ser executada no modo de depuração.

O valor padrão será 5 minutos se a sessão tiver sido iniciada com a API e 10 minutos se tiver sido iniciada na IU.

Os dados são mantidos por 24 horas até que sejam excluídos automaticamente pela Apigee híbrida.

Validade da sessão

Período em que a solicitação de criação da sessão é válida. Se a sessão de depuração não for iniciada dentro desse tempo, os sincronizadores poderão ignorar a solicitação de criação da sessão. Certifique-se de manter os relógios dos sincronizadores sincronizados, conforme descrito em Pré-requisitos.
Contagem de solicitações de trace Máximo de 20 por processador de mensagens O padrão é 10 por processador de mensagens, e o máximo é 15.
API Apigee Edge Cloud Apigee X
A Apigee X expõe a API Debug Session e a API Debug Session Data, mas não é compatível com os seguintes elementos nas APIs da Apigee X:
Interromper sessão de depuração

Excluir transações específicas

Recursos do Apigee Edge sem suporte no Apigee X

O Google não planeja oferecer suporte aos seguintes recursos:

  • APIs para pesquisar ou revogar tokens de acesso OAuth (porque os tokens são criptografados com hash)
  • Desenvolvimento do portal do desenvolvedor usando o Drupal 7
  • OAuth v1 ou política do OAuth OAuthv1.0a
  • Trireme (EOL em 10/10/2019)

Comparação de APIs

Em geral, a maioria das APIs do Apigee Edge tem equivalentes. Nesta seção, apresentamos o seguinte:

Resumo das mudanças usando a API

Veja a seguir as alterações de comportamento em todas as APIs da Apigee X em comparação com as APIs da Apigee Edge.

Comportamento APIs da Apigee X APIs Apigee Edge
Domínio de base apigee.googleapis.com api.enterprise.apigee.com
Tipos de mídia application/json application/json
application/xml
Autenticação OAuth2 OAuth2, SAML, Basic
Carimbos de data/hora em chaves Formato String

{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Formato int64

{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
Estrutura do parâmetro de consulta expand=false

{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}

[
  "helloworld",
  "weather"
]
Parâmetros de consulta prefixados por sublinhado Não compatível (optimal=true) Compatível (_optimal=true)
Propriedades em payloads:
  • created_by
  • modified_by
  • self
Não compatível Suporte
Valores padrão em payloads Não incluído Incluso
Estrutura de tratamento de erros

{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}

{
  "code": "...",
  "message": "..",
  "contexts": []
}
Resposta de exclusão de cache Retorna: 204 No Content Retorna: 200 OK e detalhes do cache
Operações da API de cache List e delete apenas. O cache L1 de curta duração é criado automaticamente quando você implanta um proxy de API. Para mais informações, consulte Caches internos. Opções List, create, get, update, delete, clear all, and clear.

Diferenças entre a Apigee as APIs de métricas da Apigee

O Resumo das alterações usando a API lista as diferenças gerais entre a API Apigee e Apigee Edge. A tabela a seguir lista as diferenças específicas das APIs de métricas:

Recurso APIs da Apigee X APIs Apigee Edge
Endpoint da API apigee.googleapis.com api.enterprise.apigee.com
E-mails de análise diários Nenhuma API compatível
API Async Query List A propriedade userId foi omitida da resposta. Consulte Método: organizations.environments.queries.list. Veja uma lista de consultas de análise assíncronas
APIs de relatórios personalizados As propriedades createdBy e lastModifiedBy foram removidas da resposta. Consulte a API Reports. API Reports

APIs Apigee Edge incompatíveis

A tabela a seguir lista as APIs da Apigee Edge não compatíveis (que não têm API Apigee X equivalentes).

Categoria da API APIs Apigee Edge incompatíveis
Monitoramento de APIs Nenhuma API compatível
Proxies de API
  • Forçar a implantação do proxy de API
  • Acessar dependências npm
  • Gerenciar módulos npm
Auditorias Use a API Stackdriver Logging.
Registros em cache Nenhuma API compatível
Empresas Nenhuma API compatível
Apps da empresa Nenhuma API compatível
Família de apps da empresa Nenhuma API compatível
Chaves de apps da empresa Nenhuma API compatível
Sessões de depuração
  • Não é possível interromper sessões de trace
  • Não é possível excluir transações individuais

Para mais informações, consulte Diferenças com o Trace.

App do desenvolvedor Acessar contagem de recursos da API
Família de apps do desenvolvedor Nenhuma API compatível
Extensões Nenhuma API compatível
Armazenamento de chaves: truststore Testar um keystore ou truststore
LDAP Nenhuma API compatível
Monetização Nenhuma API compatível
OAuth V2 Nenhuma API compatível
Políticas Nenhuma API compatível
Arquivos de recurso
  • Escopo da revisão do proxy de API
  • Escopo da organização
Apigee Sense Nenhuma API compatível
Usuários e funções do usuário Use as APIs relacionadas ao Google Identity and Access Management (IAM), conforme descrito em Como gerenciar usuários, papéis e permissões usando APIs.
Hosts virtuais Nenhuma API compatível