Visão geral do Edge para nuvem privada

Edge para nuvem privada v. 4.17.09

Novidades

Consulte 4.17.09 - Notas de lançamento do Edge para nuvem privada.

Acesse a comunidade Apigee

A Comunidade Apigee é um recurso sem custo financeiro em que é possível entrar em contato com a Apigee, bem como outros clientes da Apigee, com dúvidas, dicas e outros problemas. Antes de postar na comunidade, pesquise primeiro 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, você precisa conhecer a organização geral dos módulos e componentes de software do Edge.

O Apigee Edge para nuvem privada consiste nos seguintes módulos:

  • Gateway da Apigee Edge (também conhecido como serviços de API)
  • Análises da Apigee Edge
  • BaaS da API Apigee
  • Canal para desenvolvedores do Apigee Edge
  • Serviços de monetização do Apigee Edge (também conhecido como monetização de serviços para desenvolvedores)

Observação: o canal de desenvolvedor do Apigee Edge não está disponível para instalação pelo Edge para instalador de nuvem privada. O canal do desenvolvedor está disponível para instalação no local por meio de um script separado. Se você quiser instalar o Canal de desenvolvedor, entre em contato com o suporte da Apigee.

Gateway da Apigee Edge

O gateway de borda é o módulo principal do Apigee Edge e é a principal ferramenta para gerenciar suas APIs. A interface do gateway oferece ferramentas para adicionar e configurar APIs, definir pacotes de recursos e gerenciar desenvolvedores e apps. O gateway descarrega muitas preocupações de gerenciamento comuns da sua 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. Também é possível personalizar o comportamento da API aplicando scripts personalizados, fazendo chamadas para APIs de terceiros e assim por diante.

Componentes de software

O gateway de borda é criado com base nos seguintes componentes principais:

  • Servidor de gerenciamento de borda
  • Apache ZooKeeper
  • Apache Cassandra
  • Roteador de borda
  • Processador de mensagens do Edge
  • OpenLDAP
  • interface do Edge

O gateway de borda foi projetado para que todos sejam instalados em um único host ou distribuídos entre vários hosts.

Análises da Apigee Edge

O Edge Analytics tem uma análise de API avançada para identificar tendências de uso de longo prazo. É possível segmentar o público-alvo pelos principais desenvolvedores e apps, saber mais sobre o uso por método da API para saber onde investir e criar relatórios personalizados com informações comerciais.

À medida que 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 ao 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 integrados ou personalizados.

Componentes de software

O Edge Analytics abrange o seguinte:

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

BaaS da API Apigee

A API BaaS é um back-end como serviço (BaaS) completo para potencializar os apps da Web e para dispositivos móveis que você instala como um complemento ao Edge. A API BaaS oferece aos desenvolvedores de apps acesso a um armazenamento de dados flexível e aos principais recursos de diferenciação, como gráficos sociais, geolocalização, gerenciamento de usuários, notificações push, monitoramento de desempenho e muito mais. A API BaaS disponibiliza esses recursos com SDKs para iOS, Android, JavaScript e outros. Isso permite que os desenvolvedores de apps se concentrem em criar recursos avançados e experiência do usuário que realmente diferenciam um app cliente, em vez de gastar muito tempo implementando os principais serviços de back-end e a infraestrutura.

Recursos da API BaaS

O site de documentação da Apigee tem muitas informações sobre os recursos da API BaaS. Consulte http://apigee.com/docs/app-services/content/app-services-features.

O diagrama a seguir ilustra como os componentes da API BaaS interagem.

Componentes de software

O BaaS da API é criado a partir dos seguintes componentes principais:

  • Pilha BaaS da API: implantada no servidor da Web do Tomcat
  • Portal da API BaaS: interface implantada no servidor da Web Nginx
  • ElasticSearch: mecanismo de pesquisa de texto completo distribuído. O ElasticSearch pode ser instalado no mesmo nó da pilha BaaS da API ou no próprio nó.

É possível escalonar a capacidade da API REST da API BaaS horizontalmente adicionando servidores Tomcat e usando um balanceador de carga para encaminhar solicitações da Web para todos os servidores ativos.

Para saber como começar a usar a API BaaS, consulte http://apigee.com/docs/content/build-apps-home (em inglês).

Canal para desenvolvedores do Apigee Edge

O canal de desenvolvedor do Edge é um portal de modelo para gerenciamento de conteúdo e comunidade. Ele é baseado no projeto de código aberto Drupal (http://www.drupal.org). A configuração padrão permite criar e gerenciar a documentação, fóruns e blogs da API. Um console de testes integrado permite testar APIs em tempo real a partir do portal.

Além do gerenciamento de conteúdo, o canal do desenvolvedor tem vários recursos de gerenciamento da comunidade, como registro manual/automático de usuários e moderação de comentários. O modelo de controle de acesso baseado em papéis (RBAC, na sigla em inglês) controla o acesso a recursos no Canal do desenvolvedor. Por exemplo, você pode ativar controles para permitir que o usuário registrado crie postagens no fórum, use consoles de teste e assim por diante.

O script de implantação do Apigee Edge para nuvem privada não inclui a implantação do canal do desenvolvedor. A implantação do canal do desenvolvedor no local é aceita pelo próprio script de instalação. Se você quiser instalar e configurar o Canal de desenvolvedor, entre em contato com o suporte da Apigee.

Serviços de monetização do Apigee Edge

Os serviços de monetização do Edge são uma nova extensão do Apigee Edge para nuvem privada. Como provedor de API, você precisa de uma maneira fácil e flexível de monetizar suas APIs para gerar receita com o uso delas. Os Serviços de Monetização atendem a esses requisitos. Com os serviços de monetização, é possível criar uma variedade de planos de tarifas que cobrem os desenvolvedores pelo uso das APIs agrupadas nos pacotes. A solução oferece uma ampla flexibilidade: é possível criar planos pré-pagos, pós-pagos, de taxa fixa, de taxa variável, planos “freemium”, planos personalizados para desenvolvedores específicos, planos que cubram grupos de desenvolvedores e muito mais.

Além disso, os Serviços de Monetização incluem instalações de geração de relatórios e faturamento. Por exemplo, como provedor de API, você pode receber relatórios resumidos ou detalhados sobre o tráfego dos pacotes de API em que os desenvolvedores compraram um plano de tarifas. Também é possível fazer ajustes nesses registros conforme necessário. E você pode criar documentos de faturamento (que incluem impostos aplicáveis) para o uso de seus pacotes de API e publicar esses documentos para os desenvolvedores.

Também é possível definir limites para ajudar a controlar e monitorar o desempenho dos seus pacotes de API e permitir que você reaja de maneira adequada, além de configurar notificações automáticas para quando esses limites forem se aproximarem ou forem alcançados.

Observação: o Apigee Edge (Gateway e Analytics) é um pré-requisito para usar os serviços de monetização.

Recursos dos serviços de monetização

Os principais recursos dos Serviços de monetização de borda incluem:

  • Totalmente integrado com a plataforma da 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 mais complexos de cobrança/participação na receita (fáceis de criar e modificar)
  • Classifique as transações por volume ou "atributos personalizados" em cada transação. A transação pode ser composta por APIs do Gateway PLUS outros sistemas (fora do Apigee Edge)
  • Ferramentas automatizadas, como limites e notificações para monitorar o desempenho e gerenciar o processo
  • Fluxo de trabalho e controles integrados de desenvolvedor/parceiro para gerenciar a compra por meio do faturamento/pagamento
  • Totalmente self-service para usuários comerciais e desenvolvedores/parceiros, sem necessidade de intervenção técnica dispendiosa
  • Integrado com qualquer sistema de ERP, contabilidade e vendas de back-end

Componentes de software

Os serviços de monetização de borda são criados com base nos seguintes componentes principais:

  • Servidor de gerenciamento de borda
  • Processador de mensagens do Edge

Para saber mais sobre como começar a usar os Serviços de Monetização usando a IU do Edge, consulte http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services (em inglês).

Implantação no local

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

Os componentes fornecidos pela instalação local do gateway de borda incluem, entre outros:

  • Um roteador processa todo o tráfego de API de entrada de um balanceador de carga, determina a organização e os ambientes para o proxy de API que processa a solicitação, equilibra as solicitações nos processadores de mensagens disponíveis e envia a solicitação. 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 forem recebidas, o processador de mensagens formata uma resposta e a retorna ao cliente.
  • O Apache Cassandra é o repositório de dados do ambiente de execução que armazena as configurações de aplicativos, os contadores de cotas distribuídas, as chaves de API e os tokens OAuth para aplicativos executados no gateway.
  • Um 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 as alterações na configuração.
  • Um OpenLDAP (LDAP) para gerenciar usuários e funções do sistema e da organização.
  • Um servidor de gerenciamento para reunir essas partes. O servidor de gerenciamento é o endpoint para as solicitações da API Edge Management. Ele também interage com a IU do Edge.
  • Uma UI 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 servidor Qpid gerencia o sistema de enfileiramento para dados de análise.
  • Um servidor Postgres gerencia o banco de dados de análise do PostgreSQL.

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