Module 10: Integrating SaaS Services Available on the Azure Platform

Lab Answer Key: Deploying Service Instances as Components of Overall Azure Solutions

Before we start

Ensure that you are logged in to your Windows 10 Virtual Machine using the following credentials:
- Username: Admin
- Password: Pa55w.rd
Observe the Taskbar located at the bottom of your Windows 10 desktop. The Taskbar contains the icons for the common applications we will use in the labs:
- Microsoft Edge
- File Explorer
- Visual Studio Code
- Microsoft Azure Storage Explorer
- Bash on Ubuntu on Windows
- Windows PowerShell
- Microsoft Word 2016
Note: You can also find shortcuts to these applications on the Desktop and in the Start Menu.

Exercise 1: Deploy Function App and Cognitive Service using ARM Template

Task 1: Open the Azure Portal

On the Taskbar, click the Microsoft Edge icon.
In the open browser window, navigate to the Azure Portal (https://portal.azure.com).
Enter the email address of your Microsoft account.
Click the Next button.
Enter the password for your Microsoft account.
Click the Sign in button.

Task 2: Deploy Cognitive Service using ARM

On the left side of the portal, click the Create a resource link.
At the top of the New blade, locate the Search the Marketplace field.
Enter the text Template Deployment into the search field and press Enter.
In the Everything search results blade, select the Template deployment result.
In the Template deployment blade, click the Create button.
In the Custom deployment blade, click the Build your own template in the editor link.
In the Edit template blade, locate the text editor and delete the existing template content.

Copy and paste the following ARM template into the template editor:

{
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "variables": {
        "serviceName": "[concat('cgnt', uniqueString(resourceGroup().id))]"
    },
    "resources": [
        {
            "apiVersion": "2017-04-18",
            "type": "Microsoft.CognitiveServices/accounts",
            "name": "[variables('serviceName')]",
            "kind": "TextAnalytics",
            "location": "[resourceGroup().location]",
            "sku": {
                "name": "S1"
            },
            "properties": {}
        }
    ],
    "outputs": {
        "cognitiveEndpointUrl": {
            "type": "string",
            "value": "[reference(variables('serviceName')).endpoint]"
        },
        "cognitiveEndpointKey": {
            "type": "string",
            "value": "[listKeys(variables('serviceName'), '2017-04-18').key1]"
        }
    }
}

Click the Save button to persist the template.
Back in the Custom deployment blade, perform the following actions:

a. Leave the Subscription field set to its default value.

a. In the Resource group section, select the Create new option.

a. In the Resource group section, enter the value MOD10COGS into the empty field.

a. In the Location field, select the East US location.

a. In the Terms and Conditions section, select the I agree to the terms and conditions stated above checkbox.

a. Click the Purchase button.
Wait for the deployment of the DSC configuration to complete before moving on with this lab.
On the left side of the portal, click the Resource groups link.
In the Resource groups blade, select the MOD10COGS resouce group. On the Overview tab, locate the Deployments header at the top of the blade and click the hyperlink immediately below the header that indicates the number of successful deployments.
In the Deployments blade, click the name of the most recent deployment.
In the Microsoft.Template Deployment blade, record the output values CognitiveEndpointURL and CognitiveEndpointKey. These values will be used later in the lab.

Task 3: Deploy Function App and Code

On the left side of the portal, click the Create a resource link.
At the top of the New blade, locate the Search the Marketplace field.
Enter the text Function into the search field and press Enter.
In the Everything search results blade, select the Function App result.
In the Function App blade, click the Create button.
In the next Function App blade, perform the following actions:

a. In the App name field, enter a globally unique name.

a. Leave the Subscription field set to its default value.

a. In the Resource group section, select the Use existing option.

a. In the Resource group section, locate the dropdown list and select the MOD10COGS option.

a. In the OS section, select the Windows option.

a. In the Hosting Plan list, select the Consumption Plan option.

a. In the Location field, select the East US location.

a. In the Storage section, select the Create new option.

a. In the Storage section, enter a globally unique name.

a. In the Application Insights section, select the Off option.

a. Click the Create button.
Wait for the creation task to complete before moving on with this lab.
On the left side of the portal, click the Resource groups link.
In the Resource groups blade, locate and select the MOD10COGS Resource Group link.
In the MOD10COGS blade, select the Function App you most recently created.
In the Function Apps blade, click the Platform features tab at the top of the blade.
In the Platform features tab, click the Application Settings link in the General Settings section.
In the Application settings tab, scroll down and locate the Application Settings section. Click the Add new setting link. Perform the following actions:

a. In the Enter a name field, enter the value EndpointUrl.

a. In the Enter a value field, enter the value you previously recorded for the CognitiveEndpointURL.
Back in the Application Settings section, click the Add new setting link. Perform the following actions:

a. In the Enter a name field, enter the value EndpointKey.

a. In the Enter a value field, enter the value you previously recorded for the CognitiveEndpointKey.
Click the Save button at the top of the Application settings tab.
Back in the Function Apps blade, click the Platform features tab at the top of the blade.
In the Platform features tab, click the Deployment options link in the Code Deployment section.
In the Deployments blade that appears, click the Setup button at the top of the blade.
In the Deployment option blade that appears, click the Choose Source section.
In the Choose source blade that appears, click the External Repository link.
In the Deployment option blade that appears, perform the following actions:

a. In the Repository URL field, enter the value https://github.com/azure-labs/cognitive-services-function.

a. In the Branch field, enter the value master.

a. In the Repository Type section, select the Git option.

a. Click the OK button.
Wait for the first deployment to complete.

Note: You will know the first deployment has completed when you see a successful deployment operation listed on the Deployments tab. This tab updates automatically.

Task 4: Test Function App

Back in the Function Apps blade, click the Functions link on the left side of the blade to expand the list of functions.

Note: You may need to click the Functions link twice to refresh the list of functions.
Select the DetermineLanguage function from the list of functions.
In the run.csx pane that opens, click the Test link on the right side of the pane.
In the Test popup, perform the following actions:

a. In the Request body field, enter the following value:
```
{
    "text": "I stuffed a shirt or two into my old carpet-bag, tucked it under my arm, and started for Cape Horn and the Pacific."
}
```
a. Click the Run button.

a. Observe the output in the Output section. The output should correctly identify the language as en (English).

Review: In this exercise, you create a Function App that is uses an Azure Cognitive Services account.

Exercise 2: Create a Logic App using a Function App

Task 1: Create Logic App

On the left side of the portal, click the Create a resource link.
At the top of the New blade, locate the Search the Marketplace field.
Enter the text Logic into the search field and press Enter.
In the Everything search results blade, select the Logic App result.
In the Logic App blade, click the Create button.
In the Create logic App blade, perform the following actions:

a. In the Name field, enter the value CognitiveWorkflow.

a. Leave the Subscription field set to its default value.

a. In the Resource group section, select the Use existing option.

a. In the Resource group section, locate the dropdown list and select the MOD10COGS option.

a. In the Location field, select the East US location.

a. In the Log Analytics section, select the Off option.

a. Click the Create button.
Wait for the creation task to complete before moving on with this lab.

Task 2: Build Logic App Steps

On the left side of the portal, click the Resource groups link.
In the Resource groups blade, locate and select the MOD10COGS Resource Group link.
In the MOD10COGS blade, select the CognitiveWorkflow Logic App you most recently created.
In the Logic App blade, you will see the default Logic Apps Designer screen. Scroll down and click the Blank Logic App option in the Templates section.
In the Logic Apps Designer pane, click the Code view button at the top of the pane.

In the code view, view the blank Logic App JSON template:

{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {},
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {},
        "triggers": {}
    }
}

Replace the entire JSON template definition with a new template that adds a simple HTTP trigger:

{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {},
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {},
        "triggers": {
            "manual": {
                "inputs": {
                    "method": "POST",
                    "schema": {
                        "properties": {
                            "text": {
                                "type": "string"
                            }
                        },
                        "type": "object"
                    }
                },
                "kind": "Http",
                "type": "Request"
            }
        }
    }
}

Click the Designer button at the top of the pane.

Note: At this point, you should see a single step in the designer. This is the "trigger" step that begins a workflow.
Click the + New Step button in the designer. Click the Add an action button to open the dialog for creating an action.
In the Choose an action dialog that displays, perform the following actions:

a. Enter the value Azure Functions into the search field.

a. In the search results, select the Action named Azure Functions - Choose an Azure function.

a. In the next set of search results, select the named Azure Function instance you created earlier in this lab.

a. In the final set of search results, select the DetermineLanguage function that will be used for the action.
In the DetermineLanguage step that is created, perform the following actions:

a. Click the Show advanced options link to display all options.

a. In the Request Body field, enter the value @triggerBody().

a. In the Method list, select the POST option.
Click the + New Step button in the designer. Click the Add an action button to open the dialog for creating an action.
In the Choose an action dialog that displays, perform the following actions:

a. Enter the value Azure Functions into the search field.

a. In the search results, select the Action named Azure Functions - Choose an Azure function.

a. In the next set of search results, select the named Azure Function instance you created earlier in this lab.

a. In the final set of search results, select the DetermineKeyPhrases function that will be used for the action.
In the DetermineKeyPhrases step that is created, perform the following actions:

a. Click the Show advanced options link to display all options.

a. In the Request Body field, enter the value @body('DetermineLanguage').

a. In the Method list, select the POST option.
Click the + New Step button in the designer. Click the Add an action button to open the dialog for creating an action.
In the Choose an action dialog that displays, perform the following actions:

a. Enter the value Response into the search field.

a. In the search results, select the Action named Request - Response.
In the Response step that is created, perform the following actions:

a. In the Status Code field, enter the value 200.

a. In the Body field, enter the value @body('DetermineKeyPhrases').
At the top of the Logic Apps Designer blade, click the Save button to persist your workflow.
Scroll to the top of the Logic Apps Designer area and expand the When a HTTP request is received step.
Copy the value of the HTTP POST URL field. This URL will be used later in this lab.

Task 2: Validate Logic App using Python

At the top of the portal, click the Cloud Shell icon to open a new shell instance.
In the Cloud Shell command prompt at the bottom of the portal, type in the following command and press Enter to open the interactive python terminal:
```
python
```
Type in the following command and press Enter to import the requests library:
```
import requests
```
Type in the following command and press Enter to create a new variable for your Logic App's url replacing the placeholder with the value of your url recorded earlier in this lab:
```
url = "[Logic App POST Url]"
```
Make sure you replace the [Logic App POST Url] placeholder with the url for your Logic App instance. For example, if your url is https://prod-16.eastus.logic.azure.com:443/workflows/b3fa4688c0f64345a6bcd7ab60c9f917/triggers/manual/paths/invoke?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=UPzs4YPwh_E4nnuUgqeDOBISJmLNwBaXBvzz9WcH9sU, your command will look like this:
```
url = "https://prod-16.eastus.logic.azure.com:443/workflows/b3fa4688c0f64345a6bcd7ab60c9f917/triggers/manual/paths/invoke?api-version=2016-10-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=UPzs4YPwh_E4nnuUgqeDOBISJmLNwBaXBvzz9WcH9sU"
```

Type in the following command and press Enter to send a HTTP POST request to trigger your Logic App workflow:

response = requests.post(url, json={'text': 'Circumambulate the city of a dreamy Sabbath afternoon. Go from Corlears Hook to Coenties Slip, and from thence, by Whitehall, northward.'})

Type in the following command and press Enter to print out the results from the Logic App workflow:
```
print(response.status_code, response.reason, response.text)
```

Review: In this exercise, you created a Logic App that leveraged the Function Apps created earlier in this lab.

Exercise 3: Cleanup Subscription

Task 1: Open Cloud Shell

At the top of the portal, click the Cloud Shell icon to open a new shell instance.
In the Cloud Shell command prompt at the bottom of the portal, type in the following command and press Enter to list all resource groups in the subscription:
```
az group list
```

Task 2: Delete Resource Groups

Type in the following command and press Enter to delete the MOD10COGS Resource Group:
```
az group delete --name MOD10COGS --no-wait --yes
```
Close the Cloud Shell prompt at the bottom of the portal.

Task 3: Close Active Applications

Close the currently running Microsoft Edge application.

Review: In this exercise, you "cleaned up your subscription" by removing the Resource Groups used in this lab.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

20535A_LAB_AK_10.md

20535A_LAB_AK_10.md

Module 10: Integrating SaaS Services Available on the Azure Platform

Lab Answer Key: Deploying Service Instances as Components of Overall Azure Solutions

Before we start

Exercise 1: Deploy Function App and Cognitive Service using ARM Template

Task 1: Open the Azure Portal

Task 2: Deploy Cognitive Service using ARM

Task 3: Deploy Function App and Code

Task 4: Test Function App

Exercise 2: Create a Logic App using a Function App

Task 1: Create Logic App

Task 2: Build Logic App Steps

Task 2: Validate Logic App using Python

Exercise 3: Cleanup Subscription

Task 1: Open Cloud Shell

Task 2: Delete Resource Groups

Task 3: Close Active Applications

Files

20535A_LAB_AK_10.md

Latest commit

History

20535A_LAB_AK_10.md

File metadata and controls

Module 10: Integrating SaaS Services Available on the Azure Platform

Lab Answer Key: Deploying Service Instances as Components of Overall Azure Solutions

Before we start

Exercise 1: Deploy Function App and Cognitive Service using ARM Template

Task 1: Open the Azure Portal

Task 2: Deploy Cognitive Service using ARM

Task 3: Deploy Function App and Code

Task 4: Test Function App

Exercise 2: Create a Logic App using a Function App

Task 1: Create Logic App

Task 2: Build Logic App Steps

Task 2: Validate Logic App using Python

Exercise 3: Cleanup Subscription

Task 1: Open Cloud Shell

Task 2: Delete Resource Groups

Task 3: Close Active Applications