03 -setup-resources-and-environment.md

In this lab, you will create and configure fabric resource cluster, API management resource and bot channel registration resource.

Exercise 1: Create a Resource Group

1. Sign in to the Azure portal.

2. To see all the resource groups in your subscription, select Resource groups

   

3. To create an empty resource group, select Add.

   

4. Provide Resource Group Name as "OneBankRG", Resource Group Location as "West US" and Click Create.

   

Exercise 2: Create a new Azure API Management service instance

1. In the Azure portal, select Create a resource > Enterprise Integration > API management.

2. In the API Management service window, enter settings. Choose ** Create.

   

3. Once the API Management is deployed, Copy the Developer Portal URL (to be used in Bot channel registration)

   

Exercise 3: Deploy Service Fabric Cluster

1. Click Create a resource to add a new resource template.

   

2. Search for the Service Fabric Cluster template in the Marketplace under Everything.

   

3. Select Service Fabric Cluster from the list.

   

4. Navigate to the Service Fabric Cluster blade, click Create,

5. The Create Service Fabric cluster blade has the following four steps:

Task I: Basics - In the Basics blade, you need to provide the basic details for your cluster.

• Enter the name of your cluster as "onebank-fabric-cluster"
• Enter a user name and password for Remote Desktop for the VMs.
• Make sure to select the Subscription that you want your cluster to be deployed to, especially if you have multiple subscriptions.
• Select the Resource Group created in first step.
• Select the region in which you want to create the cluster as "West US 2"

Task II: Cluster configuration

• Choose a name for your node type as "Node 0"
• The minimum size of VMs for the primary node type is driven by the durability tier you choose for the cluster. The default for the durability tier is bronze.
• Select the VM size as "Standards_D1_v2"
• Choose the number of VMs for the node type as 1
• Select Three node clusters
• Configure custom endpoints with 80,8770

Task III: Security

• Select Basic in Security Configuration settings. To make setting up a secure test cluster easy for you, we have provided the Basic option. Click on Key Vault for configuring required settings. Click on Create a new vault

• Create a key Vault with given values and Click on Create

• Now that the certificate is added to your key vault, you may see the following screen prompting you to edit the access policies for your Key vault. click on the Edit access policies for. button.

• Click on the advanced access policies and enable access to the Virtual Machines for deployment. It is recommended that you enable the template deployment as well. Once you have made your selections, do not forget to click the Save button and close out of the Access policies pane.

• You are now ready to proceed to the rest of the create cluster process.

Task III: Summary

• Now you are ready to deploy the cluster. Before you do that, download the certificate, look inside the large blue informational box for the link. Make sure to keep the cert in a safe place. you need it to connect to your cluster. Since the certificate you downloaded does not have a password, it is advised that you add one.
• To complete the cluster creation, click Create. You can optionally download the template.

6. You can see the creation progress in the notifications.

   

7. Install the downloaded certificate from previous step.

8. Select Current User and Click Next

   

9. Click Next. Leave Password Blank. Select Next

   

10. Click on Next and Finish the Installation.

Exercise 4: Configure Azure API Management service

Task I: Create and publish a product

a. Click on Products in the menu on the left to display the Products page.

b. Click + Product.

c. When you add a product, supply the following information:

• Display name
• Name
• Description
• State as Published
• Requires subscription - Uncheck Require subscription checkbox
• Click Create to create the new product.

Task II: Add APIs to a product

a. Select APIs from under API MANAGEMENT.

b. Select Blank API from the list.

c. Enter settings for the API.

• Display name
• Web Service URL – Fabric cluster end point. Update the port as 8770 and suffix with /api
• URL suffix as api
• Products – Select the Product created form previous step

d. Select Create.

Task III: Add the operation

a. Select the API you created in the previous step.

b. Click + Add Operation.

c. In the URL, select POST and enter "/messages" in the resource.

d. Enter "Post /messages" for Display name.

e. Select Save

Exercise 5: Create a Bot Channels Registration

1. Click the New button found on the upper left-hand corner of the Azure portal, then select AI + Cognitive Services > Bot Channels Registration.

2. A new blade will open with information about the Bot Channels Registration. Click the Create button to start the creation process.

3. In the Bot Service blade, provide the requested information about your bot as specified in the table below the image.

   

4. Click Create to create the service and register your bot's messaging end point.

5. Bot Channels Registration - bot service does not have an app service associated with it. Because of that, this bot service only has a MicrosoftAppID. You need to generate the password manually and save it yourself.

• From the Settings blade, click Manage. This is the link appearing by the Microsoft App ID. This link will open a window where you can generate a new password.

• Click Generate New Password. This will generate a new password for your bot. Copy this password and save it to a file. This is the only time you will see this password. If you do not have the full password saved, you will need to repeat the process to create a new password should you need it later.

• Click on Save at the end of the page. Close the page. In portal, Click on Save in Settings blade.

Cleaning Up

In this lab, you will remove the resource group containing your Service Fabric resources and Bot Channel resources.

Removing Lab Assets

In many Azure scenarios, your entire application solution is grouped into an Azure resource group. You will use the Cloud Shell tool in the Azure Portal to list all of your resource groups and then delete the resource group you used for these labs.

Open Cloud Shell

1. At the top of the portal, click the Cloud Shell icon to open a new shell instance.

   If this is your first time using the cloud shell, you may need to configure the default Storage account and SMB file share.

Use Azure CLI to Delete Resource Group

1. 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

2. Type in the following command and press Enter to delete the ONEBANKRG Resource Group:

   az group delete --name ONEBANKRG --no-wait --yes

3. Close the Cloud Shell prompt at the bottom of the portal.

4. Close your browser application.