Skip to content

Commit bc2ab1f

Browse files
Merge pull request #312570 from MicrosoftDocs/main
Auto Publish – main to live - 2026-03-04 06:00 UTC
2 parents 0e3a523 + 4c47856 commit bc2ab1f

26 files changed

Lines changed: 366 additions & 297 deletions

articles/dns/tutorial-alias-pip.md

Lines changed: 34 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: dns
55
author: asudbring
66
ms.service: azure-dns
77
ms.topic: tutorial
8-
ms.date: 11/30/2023
8+
ms.date: 03/03/2026
99
ms.author: allensu
1010
ms.custom: template-tutorial #Required; leave this attribute/value as-is.
1111
#Customer intent: As an experienced network administrator, I want to configure Azure an DNS alias record to refer to an Azure public IP address.
@@ -76,11 +76,11 @@ Create a virtual network and a subnet to place your web server in.
7676

7777
## Create a web server virtual machine
7878

79-
Create a Windows Server virtual machine and then install IIS web server on it.
79+
Create a Linux virtual machine and install NGINX web server on it.
8080

8181
### Create the virtual machine
8282

83-
Create a Windows Server 2019 virtual machine.
83+
Create an Ubuntu virtual machine.
8484

8585
1. In the Azure portal, enter *virtual machine* in the search box at the top of the portal, and then select **Virtual machines** from the search results.
8686
1. In **Virtual machines**, select **+ Create** and then select **Azure virtual machine**.
@@ -92,16 +92,17 @@ Create a Windows Server 2019 virtual machine.
9292
| Subscription | Select your Azure subscription. |
9393
| Resource Group | Select **PIPResourceGroup**. |
9494
| **Instance details** | |
95-
| Virtual machine name | Enter **Web-01**. |
95+
| Virtual machine name | Enter **web-01**. |
9696
| Region | Select **(US) East US**. |
9797
| Availability options | Select **No infrastructure redundancy required**. |
9898
| Security type | Select **Standard**. |
99-
| Image | Select **Windows Server 2019 Datacenter - Gen2**. |
99+
| Image | Select **Ubuntu Server 24.04 LTS - x64 Gen2**. |
100100
| Size | Select your VM size. |
101101
| **Administrator account** | |
102+
| Authentication type | Select **SSH public key**. |
102103
| Username | Enter a username. |
103-
| Password | Enter a password. |
104-
| Confirm password | Reenter the password. |
104+
| SSH public key source | Select **Generate new key pair**. |
105+
| Key pair name | Enter a name for the key pair. |
105106
| **Inbound port rules** | |
106107
| Public inbound ports | Select **None**. |
107108

@@ -118,35 +119,40 @@ Create a Windows Server 2019 virtual machine.
118119
| Public IP | Take the default Standard SKU public IP. |
119120
| NIC network security group | Select **Basic**. |
120121
| Public inbound ports | Select **Allow selected ports**. |
121-
| Select inbound ports | Select **HTTP (80)**, **HTTPS (443)** and **RDP (3389)**. |
122+
| Select inbound ports | Select **HTTP (80)** and **HTTPS (443)**. |
122123

123124
1. Select **Review + create**.
124125
1. Review the settings, and then select **Create**.
125126

126127
This deployment may take a few minutes to complete.
127128

128129
> [!NOTE]
129-
> **Web-01** virtual machine has an attached NIC with a Standard SKU dynamic public IP that changes every time the virtual machine is restarted.
130+
> The **web-01** virtual machine has an attached NIC with a Standard SKU dynamic public IP that changes every time the virtual machine is restarted.
130131
131-
### Install IIS web server
132+
> [!NOTE]
133+
> The network security group rules block inbound SSH access from the internet. To run commands on the virtual machine, use the **Run command** feature in the Azure portal or deploy Azure Bastion. For more information about Azure Bastion, see [Quickstart: Deploy Azure Bastion with default settings](../bastion/quickstart-host-portal.md).
134+
135+
### Install NGINX web server
136+
137+
Install NGINX web server on **web-01** using the **Run command** feature in the Azure portal.
138+
139+
1. In the search box at the top of the portal, enter *virtual machine*. Select **Virtual machines** in the search results.
140+
141+
1. Select the **web-01** virtual machine.
142+
143+
1. In the **Operations** section of the left menu, select **Run command**.
132144

133-
Install IIS web server on **Web-01**.
145+
1. Select **RunShellScript**.
134146

135-
1. In the **Overview** page of **Web-01**, select **Connect** and then **RDP**.
136-
1. In the **RDP** page, select **Download RDP File**.
137-
1. Open *Web-01.rdp*, and select **Connect**.
138-
1. Enter the username and password entered during virtual machine creation.
139-
1. On the **Server Manager** dashboard, select **Manage** then **Add Roles and Features**.
140-
1. Select **Server Roles** or select **Next** three times. On the **Server Roles** screen, select **Web Server (IIS)**.
141-
1. Select **Add Features**, and then select **Next**.
147+
1. In the **Run Command Script** pane, enter the following command:
142148

143-
:::image type="content" source="./media/tutorial-alias-pip/iis-web-server-installation.png" alt-text="Screenshot of Add Roles and Features Wizard in Windows Server 2019 showing how to install the I I S Web Server by adding Web Server role.":::
149+
```bash
150+
sudo apt-get update && sudo apt-get install -y nginx
151+
```
144152

145-
1. Select **Confirmation** or select **Next** three times, and then select **Install**. The installation process takes a few minutes to finish.
146-
1. After the installation finishes, select **Close**.
147-
1. Open a web browser. Browse to **localhost** to verify that the default IIS web page appears.
153+
1. Select **Run**.
148154

149-
:::image type="content" source="./media/tutorial-alias-pip/iis-web-server.png" alt-text="Screenshot of Internet Explorer showing the I I S Web Server default web page.":::
155+
1. Wait for the command to complete. The output displays the installation progress and finishes when NGINX is installed.
150156

151157
## Create an alias record
152158

@@ -157,18 +163,18 @@ Create an alias record that points to the public IP address.
157163
1. In the **Add record set**, enter *web01* in the **Name**.
158164
1. Select **A** for the **Type**.
159165
1. Select **Yes** for the **Alias record set**, and then select the **Azure Resource** for the **Alias type**.
160-
1. Select the **Web-01-ip** public IP address for the **Azure resource**.
166+
1. Select the **web-01-ip** public IP address for the **Azure resource**.
161167
1. Select **OK**.
162168

163-
:::image type="content" source="./media/tutorial-alias-pip/add-public-ip-alias-inline.png" alt-text="Screenshot of adding an alias record to refer to the Azure public IP of the I I S web server using the Add record set page." lightbox="./media/tutorial-alias-pip/add-public-ip-alias-expanded.png":::
169+
:::image type="content" source="./media/tutorial-alias-pip/add-public-ip-alias-inline.png" alt-text="Screenshot of adding an alias record to refer to the Azure public IP of the web server using the Add record set page." lightbox="./media/tutorial-alias-pip/add-public-ip-alias-expanded.png":::
164170

165171
## Test the alias record
166172

167173
1. In the Azure portal, enter *virtual machine* in the search box at the top of the portal, and then select **Virtual machines** from the search results.
168-
1. Select the **Web-01** virtual machine. Note the public IP address in the **Overview** page.
169-
1. From a web browser, browse to `web01.contoso.com`, which is the fully qualified domain name of the **Web-01** virtual machine. You now see the IIS default web page.
174+
1. Select the **web-01** virtual machine. Note the public IP address in the **Overview** page.
175+
1. From a web browser, browse to `web01.contoso.com`, which is the fully qualified domain name of the **web-01** virtual machine. You now see the NGINX default web page.
170176
1. Close the web browser.
171-
1. Stop the **Web-01** virtual machine, and then restart it.
177+
1. Stop the **web-01** virtual machine, and then restart it.
172178
1. After the virtual machine restarts, note the new public IP address for the virtual machine.
173179
1. From a web browser, browse again to `web01.contoso.com`.
174180

articles/dns/tutorial-alias-tm.md

Lines changed: 42 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: dns
66
author: asudbring
77
ms.service: azure-dns
88
ms.topic: tutorial
9-
ms.date: 09/19/2024
9+
ms.date: 03/03/2026
1010
ms.author: allensu
1111
ms.custom:
1212
- template-tutorial #Required; leave this attribute/value as-is.
@@ -90,11 +90,11 @@ Create a virtual network and a subnet to place your web servers in.
9090

9191
## Create web server virtual machines
9292

93-
Create two Windows Server virtual machines, and install IIS web server on them, and then add DNS labels to their public IPs.
93+
Create two Linux virtual machines, install NGINX web server on them, and then add DNS labels to their public IPs.
9494

9595
### Create the virtual machines
9696

97-
Create two Windows Server 2019 virtual machines.
97+
Create two Ubuntu virtual machines.
9898

9999
1. In the Azure portal, enter *virtual machine* in the search box at the top of the portal, and then select **Virtual machines** from the search results.
100100
2. In **Virtual machines**, select **+ Create** and then select **Azure virtual machine**.
@@ -106,16 +106,17 @@ Create two Windows Server 2019 virtual machines.
106106
| Subscription | Select your Azure subscription. |
107107
| Resource Group | Select **TMResourceGroup**. |
108108
| **Instance details** | |
109-
| Virtual machine name | Enter *Web-01*. |
109+
| Virtual machine name | Enter *web-01*. |
110110
| Region | Select **(US) East US**. |
111111
| Availability options | Select **No infrastructure redundancy required**. |
112112
| Security type | Select **Standard**. |
113-
| Image | Select **Windows Server 2019 Datacenter - Gen2**. |
113+
| Image | Select **Ubuntu Server 24.04 LTS - x64 Gen2**. |
114114
| Size | Select your VM size. |
115115
| **Administrator account** | |
116+
| Authentication type | Select **SSH public key**. |
116117
| Username | Enter a username. |
117-
| Password | Enter a password. |
118-
| Confirm password | Reenter the password. |
118+
| SSH public key source | Select **Generate new key pair**. |
119+
| Key pair name | Enter a name for the key pair. |
119120
| **Inbound port rules** | |
120121
| Public inbound ports | Select **None**. |
121122

@@ -128,57 +129,65 @@ Create two Windows Server 2019 virtual machines.
128129
| **Network interface** | |
129130
| Virtual network | Select **myTMVNet**. |
130131
| Subnet | Select **WebSubnet**. |
131-
| Public IP | Select **Create new**, and then enter *Web-01-ip* in **Name**. </br> Select **Basic** for the **SKU**, and **Static** for the **Assignment**. |
132+
| Public IP | Select **Create new**, and then enter *web-01-ip* in **Name**. Select **Standard** for the **SKU**. |
132133
| NIC network security group | Select **Basic**. |
133134
| Public inbound ports | Select **Allow selected ports**. |
134-
| Select inbound ports | Select **HTTP (80)**, **HTTPS (443)** and **RDP (3389)**. |
135+
| Select inbound ports | Select **HTTP (80)** and **HTTPS (443)**. |
135136

136137
6. Select **Review + create**.
137138
7. Review the settings, and then select **Create**.
138-
8. Repeat previous steps to create the second virtual machine. Enter *Web-02* in the **Virtual machine name** and *Web-02-ip* in the **Name** of **Public IP**. For the other settings, use the same information from the previous steps used with first virtual machine.
139+
8. Repeat previous steps to create the second virtual machine. Enter *web-02* in the **Virtual machine name** and *web-02-ip* in the **Name** of **Public IP**. For the other settings, use the same information from the previous steps used with first virtual machine.
139140

140141
Each virtual machine deployment may take a few minutes to complete.
141142

142-
### Install IIS web server
143+
> [!NOTE]
144+
> The network security group rules block inbound SSH access from the internet. To run commands on the virtual machines, use the **Run command** feature in the Azure portal or deploy Azure Bastion. For more information about Azure Bastion, see [Quickstart: Deploy Azure Bastion with default settings](../bastion/quickstart-host-portal.md).
145+
146+
### Install NGINX web server
147+
148+
Install NGINX on both **web-01** and **web-02** virtual machines using the **Run command** feature in the Azure portal.
149+
150+
1. In the search box at the top of the portal, enter *virtual machine*. Select **Virtual machines** in the search results.
151+
152+
1. Select the **web-01** virtual machine.
153+
154+
1. In the **Operations** section of the left menu, select **Run command**.
155+
156+
1. Select **RunShellScript**.
143157

144-
Install IIS on both **Web-01** and **Web-02** virtual machines.
158+
1. In the **Run Command Script** pane, enter the following command:
145159

146-
1. In the **Connect** page of **Web-01** virtual machine, select **RDP** and then **Download RDP File**.
147-
2. Open *Web-01.rdp* file, and select **Connect**.
148-
3. Enter the username and password entered during virtual machine creation.
149-
4. On the **Server Manager** dashboard, select **Manage** then **Add Roles and Features**.
150-
5. Select **Server Roles** or select **Next** three times. On the **Server Roles** screen, select **Web Server (IIS)**.
151-
6. Select **Add Features**, and then select **Next**.
160+
```bash
161+
sudo apt-get update && sudo apt-get install -y nginx && echo 'Hello World from web-01' | sudo tee /var/www/html/index.html
162+
```
152163

153-
:::image type="content" source="./media/tutorial-alias-tm/iis-web-server-installation.png" alt-text="Screenshot of Add Roles and Features Wizard in Windows Server 2019 showing how to install the I I S Web Server by adding the Web Server role.":::
164+
1. Select **Run**.
154165

155-
7. Select **Confirmation** or select **Next** three times, and then select **Install**. The installation process takes a few minutes to finish.
156-
8. After the installation finishes, select **Close**.
157-
9. Go to *C:\inetpub\wwwroot* and open *iisstart.htm* with Notepad or any editor of your choice to edit the default IIS web page.
158-
10. Replace all the text in the file with `Hello World from Web-01` and save the changes to *iisstart.htm*.
159-
11. Open a web browser. Browse to **localhost** to verify that the default IIS web page appears.
166+
1. Wait for the command to complete. The output displays the installation progress and finishes when NGINX is installed.
160167

161-
:::image type="content" source="./media/tutorial-alias-tm/iis-on-web-01-vm-in-web-browser.png" alt-text="Screenshot of Internet Explorer showing the I I S Web Server default page of first virtual machine.":::
168+
1. Repeat the previous steps for the **web-02** virtual machine. Use the following command instead:
162169

163-
12. Repeat previous steps to install IIS web server on **Web-02** virtual machine. Use `Hello World from Web-02` to replace all the text in *iisstart.htm*.
170+
```bash
171+
sudo apt-get update && sudo apt-get install -y nginx && echo 'Hello World from web-02' | sudo tee /var/www/html/index.html
172+
```
164173

165174
### Add a DNS label
166175

167176
Public IP addresses need DNS labels to work with Traffic Manager.
168177

169178
1. In the Azure portal, enter *TMResourceGroup* in the search box at the top of the portal, and then select **TMResourceGroup** from the search results.
170-
2. In the **TMResourceGroup** resource group, select the **Web-01-ip** public IP address.
179+
1. In the **TMResourceGroup** resource group, select the **web-01-ip** public IP address.
171180
3. Under **Settings**, select **Configuration**.
172181
4. Enter *web01pip* in the **DNS name label**.
173182
5. Select **Save**.
174183

175184
:::image type="content" source="./media/tutorial-alias-tm/ip-dns-name-label-inline.png" alt-text="Screenshot of the Configuration page of Azure Public IP Address showing D N S name label." lightbox="./media/tutorial-alias-tm/ip-dns-name-label-expanded.png":::
176185

177-
6. Repeat the previous steps for the **Web-02-ip** public IP address and enter *web02pip* in the **DNS name label**.
186+
6. Repeat the previous steps for the **web-02-ip** public IP address and enter *web02pip* in the **DNS name label**.
178187

179188
## Create a Traffic Manager profile
180189

181-
1. In the **Overview** page of **Web-01-ip** public IP address, note the IP address for later use. Repeat this step for the **Web-02-ip** public IP address.
190+
1. In the **Overview** page of **web-01-ip** public IP address, note the IP address for later use. Repeat this step for the **web-02-ip** public IP address.
182191
2. In the Azure portal, enter *Traffic Manager profile* in the search box at the top of the portal, and then select **Traffic Manager profiles**.
183192
3. Select **+ Create**.
184193
4. In the **Create Traffic Manager profile** page, enter or select the following information:
@@ -200,7 +209,7 @@ Public IP addresses need DNS labels to work with Traffic Manager.
200209
|---------|-------|
201210
| Type | Select **External endpoint**. |
202211
| Name | Enter *EP-Web01*. |
203-
| Fully qualified domain name (FQDN) or IP | Enter the IP address for **Web-01-ip** that you noted previously. |
212+
| Fully qualified domain name (FQDN) or IP | Enter the IP address for **web-01-ip** that you noted previously. |
204213
| Priority | Enter *1*. |
205214

206215
:::image type="content" source="./media/tutorial-alias-tm/add-endpoint-tm-inline.png" alt-text="Screenshot of the Endpoints page in Traffic Manager profile showing selected settings for adding an endpoint." lightbox="./media/tutorial-alias-tm/add-endpoint-tm-expanded.png":::
@@ -212,7 +221,7 @@ Public IP addresses need DNS labels to work with Traffic Manager.
212221
|---------|-------|
213222
| Type | Select **External endpoint**. |
214223
| Name | Enter *EP-Web02*. |
215-
| Fully qualified domain name (FQDN) or IP | Enter the IP address for **Web-02-ip** that you noted previously. |
224+
| Fully qualified domain name (FQDN) or IP | Enter the IP address for **web-02-ip** that you noted previously. |
216225
| Priority | Enter *2*. |
217226

218227
## Create an alias record
@@ -234,9 +243,9 @@ Create an alias record that points to the Traffic Manager profile.
234243

235244
## Test the alias record
236245

237-
1. From a web browser, browse to `contoso.com` or your apex domain name. You see the IIS default page with `Hello World from Web-01`. The Traffic Manager directed traffic to **Web-01** IIS web server because it has the highest priority. Close the web browser and shut down **Web-01** virtual machine. Wait a few minutes for the virtual machine to completely shut down.
246+
1. From a web browser, browse to `contoso.com` or your apex domain name. You see the NGINX page with `Hello World from web-01`. The Traffic Manager directed traffic to **web-01** because it has the highest priority. Close the web browser and shut down **web-01** virtual machine. Wait a few minutes for the virtual machine to completely shut down.
238247
2. Open a new web browser, and browse again to `contoso.com` or your apex domain name.
239-
3. You should see the IIS default page with `Hello World from Web-02`. The Traffic Manager handled the situation and directed traffic to the second IIS server after shutting down the first server that has the highest priority.
248+
3. You should see the NGINX page with `Hello World from web-02`. The Traffic Manager handled the situation and directed traffic to the second web server after shutting down the first server that has the highest priority.
240249

241250
## Clean up resources
242251

0 commit comments

Comments
 (0)