Update Before the HOL - Microservices architecture.md
August test/fix QC.
This commit is contained in:
Dawnmarie DesJardins
GitHub
Родитель
33d64d38c7
Коммит
dfb0863bb0
|
|
@ -21,22 +21,27 @@ The names of manufacturers, products, or URLs are provided for informational pur
|
|||
|
||||
© 2018 Microsoft Corporation. All rights reserved.
|
||||
|
||||
Microsoft and the trademarks listed at <https://www.microsoft.com/en-us/legal/intellectualproperty/Trademarks/Usage/General.aspx> are trademarks of the Microsoft group of companies. All other trademarks are property of their respective owners.
|
||||
|
||||
**Contents**
|
||||
|
||||
<!-- TOC -->
|
||||
|
||||
- [Requirements](#requirements)
|
||||
- [Before the hands-on lab](#before-the-hands-on-lab)
|
||||
- [Task 1: Provision Service Fabric Cluster](#task-1-provision-service-fabric-cluster)
|
||||
- [Task 2: Provision a lab virtual machine (VM)](#task-2-provision-a-lab-virtual-machine-vm)
|
||||
- [Task 3: Connect to your lab VM](#task-3-connect-to-your-lab-vm)
|
||||
- [Task 4: Install Chrome on LabVM](#task-4-install-chrome-on-labvm)
|
||||
- [Task 5: Install Service Fabric SDK for Visual Studio](#task-5-install-service-fabric-sdk-for-visual-studio)
|
||||
- [Task 6: Setup Service Fabric certificate](#task-6-setup-service-fabric-certificate)
|
||||
- [Task 7: Validate Service Fabric ports](#task-7-validate-service-fabric-ports)
|
||||
- [Microservices architecture before the hands-on lab setup guide](#microservices-architecture-before-the-hands-on-lab-setup-guide)
|
||||
- [Requirements](#requirements)
|
||||
- [Before the hands-on lab](#before-the-hands-on-lab)
|
||||
- [Task 1: Provision Service Fabric Cluster](#task-1-provision-service-fabric-cluster)
|
||||
- [Task 2: Provision a lab virtual machine (VM)](#task-2-provision-a-lab-virtual-machine-vm)
|
||||
- [Task 3: Connect to your lab VM](#task-3-connect-to-your-lab-vm)
|
||||
- [Task 4: Install Chrome on LabVM](#task-4-install-chrome-on-labvm)
|
||||
- [Task 5: Install Service Fabric SDK for Visual Studio](#task-5-install-service-fabric-sdk-for-visual-studio)
|
||||
- [Task 6: Setup Service Fabric certificate](#task-6-setup-service-fabric-certificate)
|
||||
- [Task 7: Validate Service Fabric ports](#task-7-validate-service-fabric-ports)
|
||||
|
||||
<!-- /TOC -->
|
||||
|
||||
# Microservices architecture before the hands-on lab setup guide
|
||||
|
||||
## Requirements
|
||||
|
||||
1. Microsoft Azure subscription must be pay-as-you-go or MSDN
|
||||
|
|
@ -61,7 +66,7 @@ Duration: 45 minutes
|
|||
|
||||
Synopsis: In this exercise, you will set up your environment for use in the rest of the hands-on lab. You should follow all the steps provided in the Before the hands-on lab section to prepare your environment before attending the hands-on lab.
|
||||
|
||||
IMPORTANT: Most Azure resources require unique names. Throughout these steps, you will see the word "SUFFIX" as part of resource names. You should replace this with your Microsoft alias, initials, or other value to ensure the resource is uniquely named.
|
||||
>**IMPORTANT**: Most Azure resources require unique names. Throughout these steps, you will see the word "SUFFIX" as part of resource names. You should replace this with your Microsoft alias, initials, or other value to ensure the resource is uniquely named.
|
||||
|
||||
### Task 1: Provision Service Fabric Cluster
|
||||
|
||||
|
|
@ -71,61 +76,61 @@ In this task, you will provision the Service Fabric Cluster in Azure.
|
|||
|
||||
|
||||
|
||||
2. On the Service Fabric Cluster blade, select Create
|
||||
2. On the Service Fabric Cluster blade, select Create.
|
||||
|
||||
3. On the Basics blade of the Create Service Fabric cluster screen, enter the following:
|
||||
|
||||
- Cluster name: Enter contosoeventssf-SUFFIX, replacing SUFFIX with your alias, initials, or another value to make the name unique (indicated by a green check in the text box).
|
||||
|
||||
- Operating system: Set to WindowsServer 2016-Datacenter
|
||||
- Operating system: Set to WindowsServer 2016-Datacenter.
|
||||
|
||||
- User name: Enter holuser
|
||||
- User name: Enter holuser.
|
||||
|
||||
- Password: Enter Password.1!!
|
||||
|
||||
- Subscription: Select the subscription you are using for this lab
|
||||
- Subscription: Select the subscription you are using for this lab.
|
||||
|
||||
- Resource Group: Select Create new, and enter hands-on-labs for the resource group name. You can add -SUFFIX, if needed to make resource group name unique. This is the resource group you will use for all resources you create for this hands-on lab.
|
||||
|
||||
- Location: Select the region to use
|
||||
- Location: Select the region to use.
|
||||
|
||||
- Select OK
|
||||
- Select OK.
|
||||
|
||||
|
||||
|
||||
4. On the Cluster configuration blade, set the following:
|
||||
|
||||
- Node type count: Select 1
|
||||
- Node type count: Select 1.
|
||||
|
||||
- Node type 1 (Primary): Select to configure required settings. On the Node type configuration blade enter:
|
||||
|
||||
- Node type name: Enter Web
|
||||
- Node type name: Enter Web.
|
||||
|
||||
- Durability tier: Leave Bronze selected
|
||||
- Durability tier: Leave Bronze selected.
|
||||
|
||||
- Virtual machine size: Select a VM size of D1\_V2 Standard and select Select on the Choose a size blade
|
||||
- Virtual machine size: Select a VM size of D1\_V2 Standard and select Select on the Choose a size blade.
|
||||
|
||||
|
||||
|
||||
- Single node cluster: Leave unchecked
|
||||
- Single node cluster: Leave unchecked.
|
||||
|
||||
- Initial VM scale set capacity: Leave set to 5
|
||||
- Initial VM scale set capacity: Leave set to 5.
|
||||
|
||||
- Custom endpoints: Enter 8082. This will allow the Web API to be accessible through the cluster.
|
||||
|
||||
- Enable reverse proxy: Leave unchecked
|
||||
- Enable reverse proxy: Leave unchecked.
|
||||
|
||||
- Configure advanced settings: Leave unchecked
|
||||
- Configure advanced settings: Leave unchecked.
|
||||
|
||||
- Select OK on the Node type configuration blade
|
||||
- Select OK on the Node type configuration blade.
|
||||
|
||||
- Select OK on the Cluster configuration blade
|
||||
- Select OK on the Cluster configuration blade.
|
||||
|
||||
|
||||
|
||||
5. On the Security blade, you can provide security settings for your cluster. This configuration is completed up front, cannot be changed later. Set the following:
|
||||
|
||||
- Configuration Type: Leave "Basic" selected
|
||||
- Configuration Type: Leave "Basic" selected.
|
||||
|
||||
- Key vault: Select to configure required settings. On the Key vault configuration blade select "Create a new vault".
|
||||
|
||||
|
|
@ -135,7 +140,7 @@ In this task, you will provision the Service Fabric Cluster in Azure.
|
|||
|
||||
- Resource Group: hands-on-lab2-SUFFIX
|
||||
|
||||
- Location: Use the same location as the first resource group you created
|
||||
- Location: Use the same location as the first resource group you created.
|
||||
|
||||
|
||||
|
||||
|
|
@ -143,11 +148,11 @@ In this task, you will provision the Service Fabric Cluster in Azure.
|
|||
|
||||
- When the key vault deployment completes you will return to the Security configuration blade. You will see a warning that the key vault is not enabled for deployment. Follow these steps to resolve the warning:
|
||||
|
||||
- Choose "Edit access policies for hands-on-lab-SUFFIX"
|
||||
- Choose "Edit access policies for hands-on-lab-SUFFIX".
|
||||
|
||||
- In the Access policies configuration blade, choose the link "Click to show advanced access policies"
|
||||
- In the Access policies configuration blade, choose the link "Click to show advanced access policies".
|
||||
|
||||
- Check the "Enable access to Azure Virtual Machines for deployment" checkbox
|
||||
- Check the "Enable access to Azure Virtual Machines for deployment" checkbox.
|
||||
|
||||
- Choose "Save". When the key vault update completes, close the Access policies blade.
|
||||
|
||||
|
|
@ -155,45 +160,45 @@ In this task, you will provision the Service Fabric Cluster in Azure.
|
|||
|
||||
- Enter "hands-on-lab-SUFFIX" as the certificate name. Then choose OK on the Security configuration blade.
|
||||
|
||||
6. On the Summary blade, review the summary, and select Create to begin provisioning the new cluster
|
||||
6. On the Summary blade, review the summary, and select Create to begin provisioning the new cluster.
|
||||
|
||||
|
||||
|
||||
7. It can take up to 30 minutes or more to provision your Service Fabric Cluster. You can move on to the next task while you wait.
|
||||
|
||||
**Note**: If you experience errors related to lack of available cores, you may have to delete some other compute resources, or request additional cores to be added to your subscription, and then try this again.
|
||||
>**Note**: If you experience errors related to lack of available cores, you may have to delete some other compute resources, or request additional cores to be added to your subscription, and then try this again.
|
||||
|
||||
### Task 2: Provision a lab virtual machine (VM)
|
||||
|
||||
In this task, you will provision a virtual machine (VM) in Azure. The VM image used will have Visual Studio Community 2017 installed.
|
||||
|
||||
1. Launch a web browser and navigate to the [Azure portal](https://portal.azure.com/)
|
||||
1. Launch a web browser and navigate to the [Azure portal](https://portal.azure.com/).
|
||||
|
||||
2. Select +Create a Resource, then type "Visual Studio" into the search bar. Select Visual Studio Community 2017 (latest release) on Windows Server 2016 (x64) from the results.
|
||||
|
||||
|
||||
|
||||
3. On the blade that comes up, ensure the deployment model is set to Resource Manager and select Create
|
||||
3. On the blade that comes up, ensure the deployment model is set to Resource Manager and select Create.
|
||||
|
||||
|
||||
|
||||
4. Set the following configuration on the Basics tab
|
||||
4. Set the following configuration on the Basics tab:
|
||||
|
||||
- Name: Enter LabVM
|
||||
- Name: Enter LabVM.
|
||||
|
||||
- VM disk type: Leave Premium SSD selected
|
||||
- VM disk type: Leave Premium SSD selected.
|
||||
|
||||
- User name: Enter holuser
|
||||
- User name: Enter holuser.
|
||||
|
||||
- Password: Enter Password.1!!
|
||||
|
||||
- Subscription: Select the subscription you are using for this lab
|
||||
- Subscription: Select the subscription you are using for this lab.
|
||||
|
||||
- Resource group: Select Use existing, and select the hands-on-labs resource group created previously
|
||||
- Resource group: Select Use existing, and select the hands-on-labs resource group created previously.
|
||||
|
||||
- Location: Select the region you are using for resources in this lab
|
||||
- Location: Select the region you are using for resources in this lab.
|
||||
|
||||
- Select OK to move to the next step
|
||||
- Select OK to move to the next step.
|
||||
|
||||
|
||||
|
||||
|
|
@ -201,41 +206,41 @@ In this task, you will provision a virtual machine (VM) in Azure. The VM image u
|
|||
|
||||
|
||||
|
||||
6. Select Select to move on to the Settings blade
|
||||
6. Select Select to move on to the Settings blade.
|
||||
|
||||
7. On the Settings blade, choose RDP (3389) from the Select public inbound ports dropdown
|
||||
7. On the Settings blade, choose RDP (3389) from the Select public inbound ports dropdown .
|
||||
|
||||
8. Accept all the remaining default values on the Settings blade and select OK
|
||||
8. Accept all the remaining default values on the Settings blade and select OK.
|
||||
|
||||
|
||||
|
||||
9. Select Create on the Create blade to provision the virtual machine
|
||||
9. Select Create on the Create blade to provision the virtual machine.
|
||||
|
||||
|
||||
|
||||
10. It may take 10+ minutes for the virtual machine to complete provisioning
|
||||
10. It may take 10+ minutes for the virtual machine to complete provisioning.
|
||||
|
||||
### Task 3: Connect to your lab VM
|
||||
|
||||
In this step, you will open an RDP connection to your Lab VM and disable Internet Explorer Enhanced Security Configuration.
|
||||
|
||||
1. Connect to the Lab VM (If you are already connected to your Lab VM, skip to Step 9)
|
||||
1. Connect to the Lab VM (If you are already connected to your Lab VM, skip to Step 9).
|
||||
|
||||
2. From the side menu in the Azure portal, select Resource groups, then enter your resource group name into the filter box, and select it from the list
|
||||
2. From the side menu in the Azure portal, select Resource groups, then enter your resource group name into the filter box, and select it from the list.
|
||||
|
||||
|
||||
|
||||
3. Next, select your lab virtual machine, LabVM, from the list
|
||||
3. Next, select your lab virtual machine, LabVM, from the list.
|
||||
|
||||
|
||||
|
||||
4. On your Lab VM blade, select Connect from the top menu
|
||||
4. On your Lab VM blade, select Connect from the top menu.
|
||||
|
||||
|
||||
|
||||
5. Download and open the RDP file
|
||||
5. Download and open the RDP file.
|
||||
|
||||
6. Select Connect on the Remote Desktop Connection dialog
|
||||
6. Select Connect on the Remote Desktop Connection dialog.
|
||||
|
||||
|
||||
|
||||
|
|
@ -247,7 +252,7 @@ In this step, you will open an RDP connection to your Lab VM and disable Interne
|
|||
|
||||
|
||||
|
||||
8. Select Yes to connect, if prompted that the identity of the remote computer cannot be verified
|
||||
8. Select Yes to connect, if prompted that the identity of the remote computer cannot be verified.
|
||||
|
||||
|
||||
|
||||
|
|
@ -255,33 +260,33 @@ In this step, you will open an RDP connection to your Lab VM and disable Interne
|
|||
|
||||
|
||||
|
||||
10. Select Local Server, then select On (might also display Off) next to IE Enhanced Security Configuration
|
||||
10. Select Local Server, then select On (might also display Off) next to IE Enhanced Security Configuration.
|
||||
|
||||
|
||||
|
||||
11. In the Internet Explorer Enhanced Security Configuration dialog, select Off under Administrators and under Users, then select OK
|
||||
11. In the Internet Explorer Enhanced Security Configuration dialog, select Off under Administrators and under Users, then select OK.
|
||||
|
||||
|
||||
|
||||
12. Close the Server Manager
|
||||
12. Close the Server Manager.
|
||||
|
||||
### Task 4: Install Chrome on LabVM
|
||||
|
||||
In this task, you will install the Google Chrome browser on your Lab VM.
|
||||
|
||||
1. On your Lab VM, open a web browser, and navigate to <https://www.google.com/chrome/browser/desktop/index.html>, and select Download Chrome
|
||||
1. On your Lab VM, open a web browser, and navigate to <https://www.google.com/chrome/browser/desktop/index.html>, and select Download Chrome.
|
||||
|
||||
|
||||
|
||||
2. Select Accept and Install on the terms of service screen
|
||||
2. Select Accept and Install on the terms of service screen.
|
||||
|
||||
|
||||
|
||||
3. Select Run on the Application Run -- Security Warning dialog
|
||||
3. Select Run on the Application Run -- Security Warning dialog.
|
||||
|
||||
|
||||
|
||||
4. Select Run again, on the Open File -- Security Warning dialog
|
||||
4. Select Run again, on the Open File -- Security Warning dialog.
|
||||
|
||||
|
||||
|
||||
|
|
@ -293,25 +298,25 @@ In this task, you will install the latest Service Fabric SDK for Visual Studio 2
|
|||
|
||||
1. On your Lab VM, open a browser, and navigate to <https://docs.microsoft.com/azure/service-fabric/service-fabric-get-started>
|
||||
|
||||
2. Scroll down on the page to the Install the SDK and tools section and select Install the Microsoft Azure Service Fabric SDK under the To use Visual Studio 2017 heading
|
||||
2. Scroll down on the page to the Install the SDK and tools section and select Install the Microsoft Azure Service Fabric SDK under the To use Visual Studio 2017 heading.
|
||||
|
||||
|
||||
|
||||
3. Run the downloaded executable and select Install in the Web Platform Installer screen
|
||||
3. Run the downloaded executable and select Install in the Web Platform Installer screen.
|
||||
|
||||
|
||||
|
||||
4. On the Prerequisites screen, select I Accept
|
||||
4. On the Prerequisites screen, select I Accept.
|
||||
|
||||
|
||||
|
||||
5. Select Finish when the install completes
|
||||
5. Select Finish when the install completes.
|
||||
|
||||
|
||||
|
||||
6. Select Exit on the Web Platform installer to close it
|
||||
6. Select Exit on the Web Platform installer to close it.
|
||||
|
||||
7. Restart the VM to complete the installation and start the local Service Fabric cluster service
|
||||
7. Restart the VM to complete the installation and start the local Service Fabric cluster service.
|
||||
|
||||
### Task 6: Setup Service Fabric certificate
|
||||
|
||||
|
|
@ -319,71 +324,71 @@ When you create a new Service Fabric Cluster using the portal, a secure cluster
|
|||
|
||||
In this task, you will download the required certificate and install it on your Lab VM.
|
||||
|
||||
1. In the Azure portal, navigate to the Resource Group you created previously and where you created the Key vault that supports the cluster
|
||||
1. In the Azure portal, navigate to the Resource Group you created previously and where you created the Key vault that supports the cluster.
|
||||
|
||||
2. Select the key vault from the list of resources in the resource group
|
||||
2. Select the key vault from the list of resources in the resource group.
|
||||
|
||||
|
||||
|
||||
3. Under the Settings category in the menu, select Certificates and then select the existing certificate
|
||||
3. Under the Settings category in the menu, select Certificates and then select the existing certificate.
|
||||
|
||||
|
||||
|
||||
4. Select the Current Version of the existing certificate
|
||||
4. Select the Current Version of the existing certificate.
|
||||
|
||||
|
||||
|
||||
5. In the certificate information blade, select Download in PFX/PEM format and save the certificate
|
||||
5. In the certificate information blade, select Download in PFX/PEM format and save the certificate.
|
||||
|
||||
|
||||
|
||||
6. Copy the downloaded certificate into the Lab VM
|
||||
6. Copy the downloaded certificate into the Lab VM.
|
||||
|
||||
7. On the Lab VM, double-click the copied certificate to initiate it's installation. Select Local Machine as the Store Location and select Next.
|
||||
|
||||
|
||||
|
||||
8. Select Next
|
||||
8. Select Next.
|
||||
|
||||
|
||||
|
||||
9. Select Next
|
||||
9. Select Next.
|
||||
|
||||
|
||||
|
||||
10. Select Next
|
||||
10. Select Next.
|
||||
|
||||
|
||||
|
||||
11. Select Finish
|
||||
11. Select Finish.
|
||||
|
||||
|
||||
|
||||
12. When the import finishes successfully, select OK
|
||||
12. When the import finishes successfully, select OK.
|
||||
|
||||
|
||||
|
||||
13. On the Lab VM, double-click the copied certificate once again to initiate it's installation. Select Current User as the Store Location and select Next
|
||||
13. On the Lab VM, double-click the copied certificate once again to initiate it's installation. Select Current User as the Store Location and select Next.
|
||||
|
||||
|
||||
|
||||
14. Select Next
|
||||
14. Select Next.
|
||||
|
||||
|
||||
|
||||
15. Select Next
|
||||
15. Select Next.
|
||||
|
||||
|
||||
|
||||
16. Select Next
|
||||
16. Select Next.
|
||||
|
||||
|
||||
|
||||
17. Select Finish
|
||||
17. Select Finish.
|
||||
|
||||
|
||||
|
||||
18. When the import finishes successfully, select OK
|
||||
18. When the import finishes successfully, select OK.
|
||||
|
||||
|
||||
|
||||
|
|
@ -395,11 +400,11 @@ In this task, you will validate that the ports are open and if not, fix the issu
|
|||
|
||||
1. In the Azure portal, navigate to the Resource Group you created previously, and where you created the cluster. If your Service Fabric cluster is still deploying, do not proceed to the next step until the deployment is completed.
|
||||
|
||||
2. Select the load balancer from the list of resources in the resource group
|
||||
2. Select the load balancer from the list of resources in the resource group.
|
||||
|
||||
|
||||
|
||||
3. Under the Settings category in the menu, select Health probes
|
||||
3. Under the Settings category in the menu, select Health probes.
|
||||
|
||||
|
||||
|
||||
|
|
@ -407,23 +412,23 @@ In this task, you will validate that the ports are open and if not, fix the issu
|
|||
|
||||
|
||||
|
||||
5. Select +Add on the Health probes blade
|
||||
5. Select +Add on the Health probes blade.
|
||||
|
||||
|
||||
|
||||
6. On the Add health probe blade, enter the following:
|
||||
|
||||
- Name: Enter WebApiPortProbe
|
||||
- Name: Enter WebApiPortProbe.
|
||||
|
||||
- Protocol: Select TCP
|
||||
- Protocol: Select TCP.
|
||||
|
||||
- Port: Enter 8082
|
||||
- Port: Enter 8082.
|
||||
|
||||
- Interval: Leave the default value
|
||||
- Interval: Leave the default value.
|
||||
|
||||
- Unhealthy threshold: Leave the default value
|
||||
- Unhealthy threshold: Leave the default value.
|
||||
|
||||
- Select OK to create the probe
|
||||
- Select OK to create the probe.
|
||||
|
||||
|
||||
|
||||
|
|
@ -431,7 +436,7 @@ In this task, you will validate that the ports are open and if not, fix the issu
|
|||
|
||||
|
||||
|
||||
8. Select +Add on the Load balancing rules blade
|
||||
8. Select +Add on the Load balancing rules blade.
|
||||
|
||||
|
||||
|
||||
|
|
@ -439,22 +444,24 @@ In this task, you will validate that the ports are open and if not, fix the issu
|
|||
|
||||
- Name: Enter LBWebApiPortRule
|
||||
|
||||
- IP Version: Leave IPv4 selected
|
||||
- IP Version: Leave IPv4 selected.
|
||||
|
||||
- Frontend IP address: Leave the default value selected
|
||||
- Frontend IP address: Leave the default value selected.
|
||||
|
||||
- Protocol: Leave as TCP
|
||||
- Protocol: Leave as TCP.
|
||||
|
||||
- Port: Set to 8082
|
||||
- Port: Set to 8082.
|
||||
|
||||
- Backend port: Set to 8082
|
||||
- Backend port: Set to 8082.
|
||||
|
||||
- Backend pool: Leave the default value selected
|
||||
- Backend pool: Leave the default value selected.
|
||||
|
||||
- Health probe: Select the WebApiPortProbe you created previously
|
||||
- Health probe: Select the WebApiPortProbe you created previously.
|
||||
|
||||
- Leave the default values for the remaining fields, and Select OK
|
||||
- Leave the default values for the remaining fields, and Select OK.
|
||||
|
||||
|
||||
|
||||
10. If you get an error notification such as "Failure to create probe", ignore this, but just go check that the probe indeed exists. It should. You now have a cluster ready to deploy to and expose 8082 as the Web API endpoint / port.
|
||||
|
||||
You should follow all steps provided *before* performing the Hands-on lab.
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче