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.

You're viewing Apigee Edge documentation.
Go to the Apigee X documentation. info

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.