Bem-vindo ao Apigee Edge para nuvem privada

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

O Edge para nuvem privada é uma instalação local do Apigee Edge em que você controla o ambiente de hardware e é responsável pela instalação, upgrade, manutenção e processos administrativos do produto.

O que há de novo

Consulte as notas da versão da Apigee.

Acessar a comunidade da Apigee

A Comunidade Apigee (em inglês) é um recurso gratuito onde você pode entrar em contato com a Apigee e outros clientes da Apigee com perguntas, dicas e outros problemas. Antes de postar na comunidade, primeiro pesquise as postagens existentes para ver se sua pergunta já foi respondida.

Visão geral da arquitetura

Antes de instalar o Apigee Edge para nuvem privada, é necessário conhecer a organização geral dos módulos e componentes de software do Edge.

O Apigee Edge para nuvem privada é composto pelos seguintes módulos:

  • Gateway do Apigee Edge (também conhecido como serviços de API)
  • Apigee Edge Analytics
  • Serviços de monetização do Apigee Edge (também conhecidos como monetização de serviços para desenvolvedores)

A imagem a seguir mostra como os diferentes módulos interagem na Apigee:

Os módulos de borda conectam diferentes serviços e equipes em uma organização. Por exemplo, o Edge Analytics conecta um usuário empresarial aos serviços de back-end e à equipe de API. A monetização do Edge conecta um desenvolvedor à equipe de API. O app é conectado pelo Edge Gateway e pelos serviços de app do Edge aos serviços de back-end e à equipe de API. Todos esses serviços e equipes estão de alguma forma
interconectados.

Para saber mais sobre como criar um portal para desenvolvedores, consulte Criar seu portal usando o Drupal 9.

Gateway do Apigee Edge

O Edge Gateway é o módulo principal do Apigee Edge e a principal ferramenta para gerenciar suas APIs. A interface da API Gateway oferece ferramentas para adicionar e configurar suas APIs, configurar pacotes de recursos e gerenciar desenvolvedores e apps. O gateway elimina muitas preocupações comuns de gerenciamento da API de back-end. Ao adicionar uma API, é possível aplicar políticas de segurança, limitação de taxa, mediação, armazenamento em cache e outros controles. Você também pode personalizar o comportamento da API aplicando scripts personalizados, fazendo chamadas para APIs de terceiros e assim por diante.

Componentes de software

O Edge Gateway é criado com os seguintes componentes principais:

  • Servidor de gerenciamento de borda
  • Apache ZooKeeper
  • Apache Cassandra
  • Roteador de borda
  • Processador de mensagens de borda
  • OpenLDAP
  • Interface do Edge (anteriormente conhecida como experiência do novo Edge) e interface clássica

O Edge Gateway foi projetado para que todos possam ser instalados em um único host ou distribuídos entre vários hosts.

Análise do Apigee Edge

O Edge Analytics tem análises de API eficientes para conferir tendências de uso de longo prazo. É possível segmentar seu público por desenvolvedores e apps principais, entender o uso por método de API para saber onde investir e criar relatórios personalizados com informações comerciais.

Conforme os dados passam pelo Apigee Edge, vários tipos padrão de informações são coletados, incluindo URL, IP, ID do usuário para informações de chamada de API, latência e dados de erro. É possível usar políticas para adicionar outras informações, como cabeçalhos, parâmetros de consulta e partes de uma solicitação ou resposta extraída de XML ou JSON.

Todos os dados são enviados para o Edge Analytics, onde são mantidos pelo servidor de análise em segundo plano. As ferramentas de agregação de dados podem ser usadas para compilar vários relatórios padrão ou personalizados.

Componentes de software

O Edge Analytics inclui:

  • Qpid, que consiste no seguinte:
    • Sistema de mensagens Apache Qpid
    • Serviço do servidor Apigee Qpid: um serviço Java da Apigee usado para gerenciar o Apache Qpid.
  • Postgres, que consiste no seguinte:
    • Banco de dados PostgreSQL
    • Serviço do Apigee Postgres Server: um serviço Java do Apigee usado para gerenciar o banco de dados PostgreSQL.

Serviços de monetização do Apigee Edge

Os serviços de monetização do Edge são uma nova extensão poderosa do Apigee Edge para nuvem privada. Como provedor de API, você precisa de uma maneira flexível e fácil de usar para gerar receita com suas APIs para que possa gerar receita pelo uso delas. Os serviços de monetização resolvem esses requisitos. Com os Serviços de monetização, é possível criar vários planos de tarifas para cobrar os desenvolvedores pelo uso das suas APIs em pacotes. A solução oferece um alto nível de flexibilidade: é possível criar planos pré-pagos, pós-pagos, de taxa fixa, de preço variável, freemium, adaptados a desenvolvedores específicos, que abrangem grupos de desenvolvedores e muito mais.

Além disso, os Serviços de monetização incluem recursos de faturamento e relatórios. Por exemplo, como provedor de API, você pode receber relatórios resumidos ou detalhados sobre o tráfego dos pacotes de API para os quais os desenvolvedores compraram um plano de taxas. Você também pode fazer ajustes nesses registros, se necessário. Você também pode criar documentos de faturamento (que incluem impostos aplicáveis) para o uso dos pacotes de API e publicá-los para os desenvolvedores.

Você também pode definir limites para ajudar a controlar e monitorar o desempenho dos pacotes de API e reagir de acordo com isso. Além disso, é possível configurar notificações automáticas quando esses limites forem alcançados ou se aproximarem.

Recursos dos serviços de monetização

Os principais recursos dos serviços de monetização do Edge incluem:

  • A integração total com a plataforma de API significa interação em tempo real
  • Suporte a todos os modelos de negócios prontos para uso, desde planos simples com base em taxas até os planos de cobrança/compartilhamento de receita mais complexos (fáceis de criar e modificar)
  • Avalie as transações com base no volume ou nos atributos personalizados. A transação pode ser composta por APIs do Gateway e outros sistemas (externos ao Apigee Edge)
  • Ferramentas automatizadas, como limites e notificações, para monitorar o desempenho e gerenciar o processo
  • Fluxo de trabalho integrado de desenvolvedor/parceiro e controles para gerenciar a compra pelo faturamento/pagamento
  • Totalmente autoatendimento para usuários empresariais e desenvolvedores/parceiros, sem necessidade de intervenção técnica onerosa
  • Integração com qualquer sistema de back-end de vendas, contabilidade e ERP

As camadas de uma instalação de borda, com a IU de gerenciamento e o portal do desenvolvedor atuando como a
camada de interface e todos os outros componentes do Edge fornecendo serviços.

Componentes de software

Os Serviços de monetização do Edge são criados com base nos seguintes componentes principais:

  • Servidor de gerenciamento de borda
  • Processador de mensagens de borda

Para mais informações sobre como começar a usar os Serviços de monetização com a interface Edge, consulte Começar a usar a monetização.

Implantação local

Uma instalação local do Apigee Edge para nuvem privada (gateway e Analytics) oferece a infraestrutura necessária para executar o tráfego de API em nome dos clientes do cliente local.

Os vídeos a seguir apresentam os modelos de implantação do Apigee Edge para nuvem privada:

S26E01: Introdução ao modelo de implantação

S26E04: Arquitetura de implantação

Os componentes fornecidos pela instalação local do Edge Gateway incluem, entre outros:

  • Um roteador processa todo o tráfego de API recebido de um balanceador de carga, determina a organização e os ambientes do proxy de API que processa a solicitação, equilibra as solicitações entre os processadores de mensagens disponíveis e, em seguida, as envia. O roteador encerra a solicitação HTTP, processa o tráfego TLS/SSL e usa o nome do host virtual, a porta e o URI para direcionar as solicitações ao processador de mensagens apropriado.
  • Um processador de mensagens processa solicitações de API. O processador de mensagens avalia uma solicitação recebida, executa todas 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 Apache Cassandra é o repositório de dados do ambiente de execução que armazena configurações de aplicativos, contadores de cota distribuídos, chaves de API e tokens OAuth para aplicativos em execução no gateway.
  • O Apache ZooKeeper contém dados de configuração sobre o local e a configuração dos vários componentes da Apigee e notifica os diferentes servidores sobre mudanças de configuração.
  • OpenLDAP (LDAP) para gerenciar usuários e papéis do sistema e da organização.
  • Um servidor de gerenciamento para manter essas peças juntas. O servidor de gerenciamento é o endpoint das solicitações da API Edge Management. Ele também interage com a interface do Edge.
  • Uma interface fornece ferramentas baseadas em navegador que permitem realizar a maioria das tarefas necessárias para criar, configurar e gerenciar proxies de API, produtos de API, apps e usuários.

Os componentes fornecidos pela instalação local do Edge Analytics incluem:

  • Um Qpid Server gerencia o sistema de filas para dados de análise.
  • Um Postgres Server gerencia o banco de dados de análise do PostgreSQL.

O diagrama a seguir ilustra como os componentes do Apigee Edge interagem:

O elemento
central na interação do componente do Edge é o servidor de gerenciamento, que está vinculado à maioria dos outros
componentes. Alguns componentes, como o roteador e o processador de mensagens, interagem diretamente entre si
e com o servidor de gerenciamento. Componentes como Qpid e Postgres
têm componentes de dados secundários que não estão conectados diretamente ao servidor de gerenciamento.