Como começar

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

Neste tópico, explicamos como fazer o download e instalar o adaptador da Apigee para Envoy.

Visão geral

Nas etapas a seguir, você fará o download e configurará dois aplicativos no seu sistema: a CLI do serviço remoto da Apigee e o serviço remoto da Apigee para Envoy.

Fazer o download e instalar

Crie um diretório base no seu sistema para instalar a CLI do serviço remoto e o serviço remoto. Por exemplo:
```
mkdir ~/envoy-adapter
cd ~/envoy-adapter
export ENVOY_HOME=$PWD
```
Para as etapas restantes, verifique se você está no diretório $ENVOY_HOME:
```
cd $ENVOY_HOME
```
Faça o download da versão mais recente da CLI do serviço remoto da Apigee para $ENVOY_HOME. Certifique-se de conseguir o pacote correto para seu sistema operacional.
Faça o download da versão mais recente do Apigee Remote Service para Envoy em $ENVOY_HOME.
Crie diretórios para armazenar o conteúdo do pacote extraído em $ENVOY_HOME:
```
mkdir apigee-remote-service-cli
mkdir apigee-remote-service-envoy
```

Extraia o conteúdo do arquivo tar nos novos diretórios:

tar -xf apigee-remote-service-cli_version_platform.tar.gz -C apigee-remote-service-cli
tar -xf apigee-remote-service-envoy_version_platform.tar.gz -C apigee-remote-service-envoy

Exclua os arquivos tar.
Quando você concluir essas etapas, o $ENVOY_HOME terá dois diretórios:
```
ls -1 .
  apigee-remote-service-cli
  apigee-remote-service-envoy
```
Crie as seguintes variáveis de ambiente para os diretórios apigee-remote-service-cli e apigee-remote-service-envoy. Você usará essas variáveis de ambiente em toda a documentação:
```
export CLI_HOME=$PWD/apigee-remote-service-cli
export REMOTE_SERVICE_HOME=$PWD/apigee-remote-service-envoy
```

A seguir

Agora você está pronto para configurar e usar o adaptador da Apigee para Envoy para fazer chamadas de API do proxy com o gerenciamento de APIs da Apigee. Nos exemplos a seguir, mostramos como usar o adaptador com a Apigee e a Apigee híbrida:

Exemplo	Descrição
Exemplo do Envoy nativo para Apigee e híbrida	Instale e execute o Envoy e o serviço remoto localmente, não dentro de um cluster do Kubernetes. É possível seguir o exemplo neste documento para as instalações da Apigee e da Apigee híbrida.
Exemplo híbrido da Apigee com Kubernetes	Implantar o serviço remoto em uma malha de serviço do Istio. O serviço remoto fornece os endpoints para os proxies sidecar do Istio instalados nos serviços de destino. Para este procedimento, é possível usar o adaptador da Apigee para Envoy com uma instalação da Apigee híbrida.