Exercício – Configurar uma API de teste

  • 10 minutos

Com os Aplicativos Lógicos do Azure, você pode criar conectores personalizados para chamar APIs Web. Para essa tarefa, essas APIs devem ser publicadas e devem implementar uma definição de OpenAPI.

Para esse cenário, sua empresa deseja criar um fluxo de trabalho do Azure Logic Apps que possa acessar a Print Framer API da empresa. A API é hospedada no Azure como uma API REST.

Nesta unidade, implantaremos nossa API de teste na área restrita do Azure ativada para este módulo.

Hospedar uma API de teste na área restrita do Azure

Para economizar tempo, comece executando um script para hospedar nossa API de teste no Azure. O script executa as seguintes etapas:

  • Crie um plano do Serviço de Aplicativo do Azure na camada gratuita.
  • Crie uma API Web no Serviço de Aplicativo do Azure e configure para a implantação do Git de um repositório local.
  • Defina as credenciais de implantação no nível da conta para nosso aplicativo.
  • Configure o Git localmente.
  • Implante nossa API Web em nossa instância do Serviço de Aplicativo.

  1. No Cloud Shell, em Configurações, selecione Ir para a versão Clássica. Em seguida, execute o seguinte git clone comando para clonar o repositório que tem o script de origem e configuração do aplicativo no GitHub:

    git clone https://github.com/MicrosoftDocs/mslearn-logic-apps-and-custom-connectors.git

    O comando clona o repositório para o armazenamento local no sandbox.

  2. Navegue localmente até a pasta de repositório executando o seguinte cd comando:

    cd mslearn-logic-apps-and-custom-connectors

    Se você listar o conteúdo na pasta ms-learn-print-framer-api usando o ls comando, verá que a pasta contém um arquivo chamado setup-exercise.sh e uma pasta chamada PrintFramerAPI.

    Como o nome sugere, setup-exercise.sh é o script que executaremos para criar nosso ambiente de laboratório. PrintFramerAPI contém o aplicativo que queremos implantar no Azure como um aplicativo Web com uma API pública.

    A área restrita gratuita permite criar recursos em um subconjunto das regiões globais do Azure. Selecione uma região na seguinte lista ao criar recursos:

    • Oeste dos EUA 2
    • Centro-Sul dos EUA
    • Centro dos EUA
    • Leste dos EUA
    • Europa Ocidental
    • Sudeste Asiático
    • Leste do Japão
    • Brasil Sul
    • Sudeste da Austrália
    • Índia Central

  3. Antes de executar o script, você deve adicionar um parâmetro de local ao az appservice plan create comando no script de instalação. Execute o comando a seguir para abrir o arquivo setup-exercise.sh no editor do Cloud Shell.

    . code setup-exercise.sh

  4. Adicione um location parâmetro ao az appservice plan create comando. Selecione um local da lista anterior de regiões de área restrita. Por exemplo:

    az appservice plan create --name $apiappname --resource-group $RESOURCE_GROUP --location eastus --sku FREE --verbose

  5. Pressione Ctrl + S para salvar suas alterações e pressione Ctrl + Q para sair do editor.

  6. No Cloud Shell, execute o seguinte comando para executar o script de instalação:

    bash setup-exercise.sh

    O script leva alguns minutos para ser executado. Quando o script for concluído, duas URLs serão exibidas para você usar e testar a implantação do aplicativo. Observe que, durante a implantação, todas as dependências necessárias para executar nosso aplicativo são instaladas automaticamente no Serviço de Aplicativo remoto neste momento.

  7. Para testar se nosso aplicativo foi implantado com êxito, copie o valor da URL de Exemplo na saída do Cloud Shell e cole-o no navegador favorito.

    O navegador mostra o valor 20.0, que é o valor em dólar que a API calculou para um quadro com as dimensões de 6 x 7 polegadas. Você pode tentar outros valores substituindo 6 e 7 na URL.

  8. Lembre-se dessa URL, que você usará no próximo exercício.

  9. Para ver a aparência da API, no navegador, navegue para a URL exibida na saída URL do Swagger mostrada no Cloud Shell. A URL deve ser semelhante a https://PrintFramerAPIabcde.azurewebsites.net/swagger. O navegador exibe a interface do usuário do Swagger para nosso aplicativo, conforme mostrado na captura de tela a seguir.

    A interface do usuário do Swagger.

  10. No navegador, na interface do usuário do Swagger, selecione Obter e, em seguida, selecione Experimentar.

  11. Insira uma altura e largura e selecione Executar. Examine a resposta.

  12. Na barra de endereços do navegador, substitua /swagger/index.html por /swagger/v1/swagger.json.

    O navegador exibe a definição de OpenAPI para a API.

  13. Salve o conteúdo JSON do OpenAPI em um arquivo local para que possamos usar esse conteúdo no próximo exercício.

No próximo exercício, criaremos um conector personalizado usando essa definição de JSON OpenAPI de nossa API. Em seguida, mostraremos como usar esse conector em um fluxo de trabalho dos Aplicativos Lógicos do Azure. Lembre-se de manter o arquivo JSON OpenAPI que você criou e a URL do aplicativo.