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. Exemplo:
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:
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-clitar -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:
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:
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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-07 UTC."],[[["\u003cp\u003eThis guide provides instructions for downloading and installing the Apigee Adapter for Envoy, applicable to both Apigee and Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eYou will need to download and install two applications: the Apigee Remote Service CLI and the Apigee Remote Service for Envoy, into a designated base directory.\u003c/p\u003e\n"],["\u003cp\u003eAfter downloading, you will extract the contents of each application into separate directories within the base directory and set environment variables for easy access.\u003c/p\u003e\n"],["\u003cp\u003eThe next steps involve setting up and using the Apigee Adapter for Envoy to proxy API calls using Apigee API management, with examples provided for both native Envoy setups and Apigee hybrid deployments within Kubernetes.\u003c/p\u003e\n"]]],[],null,["# Getting started\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\n\nThis topic explains how to download and install Apigee Adapter for Envoy.\n\nOverview\n--------\n\n\nIn the following steps, you will download and set up two applications on your system:\nthe **Apigee Remote Service CLI** and the\n**Apigee Remote Service for Envoy**.\n\nDownload and install\n--------------------\n\n1. Create a base directory on your system in which to install the Remote Service CLI and the Remote Service. For example: \n\n mkdir ~/envoy-adapter\n cd ~/envoy-adapter\n export ENVOY_HOME=$PWD\n\n2. For the remaining steps, be sure you are in the `$ENVOY_HOME` directory: \n\n ```\n cd $ENVOY_HOME\n ```\n3. Download the [latest release](https://github.com/apigee/apigee-remote-service-cli/releases) of the **Apigee Remote Service CLI** into `$ENVOY_HOME`. Be sure to grab the correct package for your operating system.\n4. Download the [latest release](https://github.com/apigee/apigee-remote-service-envoy/releases) of the **Apigee Remote Service for Envoy** into `$ENVOY_HOME`.\n5. Create directories to hold the extracted package contents inside `$ENVOY_HOME`: \n\n mkdir apigee-remote-service-cli\n mkdir apigee-remote-service-envoy\n\n6. Extract the tar file contents into the new directories: \n\n tar -xf apigee-remote-service-cli_\u003cvar translate=\"no\"\u003eversion_platform\u003c/var\u003e.tar.gz -C apigee-remote-service-cli\n tar -xf apigee-remote-service-envoy_\u003cvar translate=\"no\"\u003eversion_platform\u003c/var\u003e.tar.gz -C apigee-remote-service-envoy\n\n7. Delete the tar files.\n8. When you complete these steps, `$ENVOY_HOME` contains two directories: \n\n ```\n ls -1 .\n apigee-remote-service-cli\n apigee-remote-service-envoy\n ```\n9. Create the following environment variables for the `apigee-remote-service-cli` and `apigee-remote-service-envoy` directories. You will use these environment variables throughout the documentation: \n\n export CLI_HOME=$PWD/apigee-remote-service-cli\n export REMOTE_SERVICE_HOME=$PWD/apigee-remote-service-envoy\n\nNext steps\n----------\n\n\nYou are now ready to set up and use the\nApigee Adapter for Envoy to proxy API calls with Apigee API management. The following examples\nshows you how to use the adapter with Apigee and Apigee hybrid:"]]
