Como implantar proxies na linha de comando

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X. informações

Neste tópico, explicamos como implantar um proxy usando a linha de comando. O Apigee Edge oferece dois para implantação na linha de comando. A primeira é usar uma ferramenta de implantação do Apigee Edge em Python. A outra é configurar e executar um script de shell.

Use as técnicas de implantação de linha de comando ao trabalhar diretamente com a origem do proxy arquivos no seu sistema. Há vários motivos para você trabalhar off-line. Você pode querer usar um editor XML favorito ou pode estar desenvolvendo políticas que exigem codificação Java e está trabalhando principalmente em um IDE. As técnicas descritas nesta seção permitem que você faça upload e implantar os arquivos de origem no ambiente de serviços de API escolhido.

Se você estiver trabalhando principalmente na interface de gerenciamento, consulte Como implantar proxies na IU.

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Como executar a ferramenta de implantação do Apigee Edge Python

A ferramenta de implantação do Apigee Edge em Python funciona com a API de gerenciamento do Edge para importar e implantar a API proxies. A ferramenta está disponível como parte da distribuição de exemplos de plataforma de API no GitHub. Consulte Como usar proxies de API de amostra.

Use a ferramenta Python da Apigee Edge para importar (fazer upload) e implantar a API de forma simples de desenvolvimento de software.

A ferramenta de implantação precisa ser executada no diretório base na distribuição da plataforma de APIs Distribuição de amostras, em que o diretório base é o diretório pai de setup e diretório tools.

No comando a seguir, substitua o nome do proxy, o nome de usuário e a senha do Edge, organização e ambiente e o caminho para o diretório que contém o arquivo "Diretório apiproxy":

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Exemplo:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Esse comando compacta os arquivos, os envia para sua organização no Apigee Edge e os implanta para o ambiente especificado.

A ferramenta de implantação descobre automaticamente a revisão atual da API proxy, cancela a implantação da revisão existente e implanta uma revisão incrementada da API proxy.

Se tudo der certo, você verá a saída no formulário:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

Por padrão, a ferramenta faz upload do proxy de API para https://api.enterprise.apigee.com, que correspondem ao Edge na nuvem. Você também pode usar essa ferramenta para carregar o proxy de API em uma versão local do Edge especificando a sinalização -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

Neste exemplo, você especifica o endereço IP do Servidor de gerenciamento de borda. Se você criou um registro DNS para o servidor de gerenciamento, você pode especificar um URL no seguinte formato:

https://ms_URL:8080

A lista completa de sinalizações do comando é:

  • -n: o nome do proxy de API.
  • -u: o nome de usuário e a senha da sua conta em uma organização na Apigee Borda
  • -o: o nome da organização em que você tem uma conta.
  • -e: o ambiente em que o proxy de API será implantado. (test ou prod).
  • -d: o caminho para o diretório que contém os arquivos de proxy da API. Seu proxy de API precisam ser armazenados em um diretório chamado "apiproxy". Esse valor é o caminho que contém o diretório "apiproxy" e não para o caminho o "apiproxy" em si.
  • -p: o caminho do URI usado como uma correspondência de padrão para rotear a mensagem de entrada para essa API implantação de proxy. Na maioria dos casos, é possível definir esse valor como "/", a menos que você tenha requisitos de implantação e roteamento. O caminho principal usado para roteamento de proxy de API é definido em o arquivo de configuração ProxyEndpoint do proxy de API.
  • -h: o URL de borda. Por padrão, o URL é https://api.enterprise.apigee.com, que correspondem ao Edge na nuvem. Para uma implantação no local, use o URL do Edge. de gerenciamento de projetos e a porta 8080, como em: 
    https://ms_URL:8080

    Ou use o endereço IP do servidor de gerenciamento, como em https://192.168.11.111:8080.

Como configurar e executar um shell de implantação script

A abordagem mais fácil é executar o script de implantação fornecido com o proxy de API de amostra. O shell os scripts unem a ferramenta de implantação do Apigee Edge em Python.

No diretório /simplyProxy, execute:

$ sh deploy.sh

Você verá:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

Digite sua senha e pressione ENTER.

Você verá:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Se você vir o seguinte:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

isso significa que você precisa modificar o arquivo /setup/setenv.sh na e a distribuição de amostras da plataforma. Para instruções, consulte o README ou as APIs Apigee Edge.

Em caso de êxito, a ferramenta de implantação compacta os arquivos em importações /apiproxy, o pacote na sua organização no Apigee Edge e, em seguida, implanta o proxy de API no "test" de nuvem.

Seu proxy de API está pronto para ser invocado.