Anterior

Siguientes

Ejercicio: Configuración de una API de prueba

Completado

Con Azure Logic Apps, puede crear conectores personalizados para llamar a API web. Para esta tarea, las API deben estar publicadas y hay que implementar una definición de OpenAPI.

En este escenario, la empresa quiere crear un flujo de trabajo de Azure Logic Apps que pueda acceder a Print Framer API. La API está hospedada en Azure como una API REST.

En esta unidad, implementaremos nuestra API de prueba en el espacio aislado de Azure activado para este módulo.

Hospedaje de una API de prueba en el espacio aislado de Azure

Para ahorrar tiempo, primero se ejecutará un script para hospedar la API de prueba en Azure. Este script lleva a cabo los pasos siguientes:

• Crea un plan de Azure App Service en el nivel Gratis.
• Creación de una API web en Azure App Service y configuración para la implementación en Git desde un repositorio local
• Establece las credenciales de implementación de nivel de cuenta para la aplicación.
• Configura Git localmente.
• Implementa la API web en nuestra instancia de App Service.

1. En Cloud Shell, ejecute el comando git clone siguiente para clonar el repositorio que contiene el script de origen y la configuración de la aplicación desde GitHub:

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

   El comando clona el repositorio en el almacenamiento local del espacio aislado.

2. Vaya a la carpeta del repositorio localmente. Para ello, ejecute el comando cd siguiente:

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

   Si enumera el contenido de la carpeta ms-learn-print-framer-api con el comando ls, verá que contiene un archivo denominado setup-exercise.sh y una carpeta llamada PrintFramerAPI.

   Como sugiere su nombre, setup-exercise.sh es el script que ejecutaremos para crear el entorno de laboratorio. PrintFramerAPI contiene la aplicación que se quiere implementar en Azure como una aplicación web con una API pública.

   El espacio aislado gratuito permite crear recursos en un subconjunto de las regiones globales de Azure. Seleccione una región de la lista siguiente al crear los recursos:

   • Oeste de EE. UU. 2
   • Centro-sur de EE. UU.
   • Centro de EE. UU.
   • Este de EE. UU.
   • Oeste de Europa

   • Sudeste de Asia
   • Japón Oriental
   • Sur de Brasil
   • Sudeste de Australia
   • Centro de la India

3. Antes de ejecutar el script, debe agregar un parámetro de ubicación al comando az appservice plan create en el script de configuración. Ejecute el siguiente comando para abrir el archivo setup-exercise.sh en el editor de Cloud Shell.

   . code setup-exercise.sh
   

4. Agregue un parámetro location al comando az appservice plan create. Seleccione una ubicación en la lista de regiones de espacio aislado anterior. Por ejemplo:

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

5. Presione Ctrl + S para guardar los cambios y, a continuación, presione Ctrl + Q para salir del editor.

6. En Cloud Shell, ejecute el comando siguiente para ejecutar el script de configuración:

   bash setup-exercise.sh
   

   El script tarda unos minutos en ejecutarse. Cuando finalice el script, aparecerán dos direcciones URL para usar y probar la implementación de la aplicación. Observe que durante la implementación, todas las dependencias necesarias para que la aplicación se ejecute se instalan automáticamente en la instancia remota de App Service en este momento.

7. Para probar que la aplicación se ha implementado correctamente, copie el valor de Dirección URL de ejemplo de la salida de Cloud Shell y péguelo en su explorador favorito.

   El explorador muestra el valor 20.0, que es el valor en dólares que la API ha calculado para un marco con unas dimensiones de 6 × 7 pulgadas. Puede probar otros valores si reemplaza 6 y 7 en la dirección URL.

8. Recuerde esta dirección URL, que usará en el ejercicio siguiente.

9. Para ver el aspecto de la API, navegue desde el explorador a la dirección URL que se muestra en Cloud Shell en la salida con la dirección URL de Swagger. La URL debe ser similar a https://PrintFramerAPIabcde.azurewebsites.net/swagger. En el explorador se muestra la interfaz de usuario de Swagger para la aplicación, como se ilustra en la captura de pantalla siguiente.

   

10. En el explorador, desde la interfaz de usuario de Swagger seleccione Obtener y después Probarlo.

11. Escriba un alto y ancho y, después, seleccione Ejecutar. Examine la respuesta.

12. En la barra de direcciones del explorador, reemplace /swagger/index.html por /swagger/v1/swagger.json.

    En el explorador se mostrará la definición de OpenAPI para la API.

13. Guarde el contenido JSON de OpenAPI en un archivo local para usarlo en el ejercicio siguiente.

En el ejercicio siguiente se creará un conector personalizado con esta definición JSON de OpenAPI de la API. Después, se mostrará cómo usar ese conector en un flujo de trabajo de Azure Logic Apps. Recuerde mantener el archivo JSON de OpenAPI que ha creado y la URL de la aplicación.

Continuar