Skip to content

Commit d580eaa

Browse files
Merge pull request #2363 from madeline-underwood/nginx
Nginx_JA to sign off
2 parents 03ed0e5 + ad2c1bd commit d580eaa

File tree

6 files changed

+183
-183
lines changed

6 files changed

+183
-183
lines changed

content/learning-paths/servers-and-cloud-computing/nginx-on-azure/_index.md

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,19 @@
11
---
2-
title: Deploy NGINX on the Microsoft Azure Cobalt 100 processors
2+
title: Deploy NGINX on Azure Cobalt 100 Arm-based virtual machines
33

4-
draft: true
5-
cascade:
6-
draft: true
7-
84
minutes_to_complete: 30
95

10-
who_is_this_for: This Learning Path introduces NGINX deployment on Microsoft Azure Cobalt 100 (Arm-based) virtual machine. It is intended for system administrators and developers looking to deploy and benchmark NGINX on Arm-based instances.
6+
who_is_this_for: This is an introductory topic for system administrators and developers who want to learn how to deploy and benchmark NGINX on Microsoft Azure Cobalt 100 Arm-based instances.
117

128
learning_objectives:
13-
- Start an Azure Arm64 virtual machine using the Azure console and Ubuntu Pro 24.04 LTS as the base image.
14-
- Deploy the NGINX web server on the Azure Arm64 virtual machine.
15-
- Configure and test a static website using NGINX on the virtual machine.
16-
- Perform baseline testing and benchmarking of NGINX in the Ubuntu Pro 24.04 LTS Arm64 virtual machine environment.
9+
- Create an Arm64 virtual machine on Azure Cobalt 100 (Dpsv6) using the Azure console with Ubuntu Pro 24.04 LTS as the base image
10+
- Install and configure the NGINX web server on the Azure Arm64 virtual machine
11+
- Configure and test a static website with NGINX on the virtual machine
12+
- Run baseline NGINX performance tests with ApacheBench (ab) on Ubuntu Pro 24.04 LTS Arm64
1713

1814

1915
prerequisites:
20-
- A [Microsoft Azure](https://azure.microsoft.com/) account with access to Cobalt 100 based instances (Dpsv6).
16+
- A [Microsoft Azure](https://azure.microsoft.com/) account with access to Cobalt 100 based instances (Dpsv6)
2117

2218
author: Pareena Verma
2319

@@ -31,7 +27,7 @@ armips:
3127

3228
tools_software_languages:
3329
- NGINX
34-
- Apache Bench
30+
- ApacheBench
3531

3632
operatingsystems:
3733
- Linux
@@ -42,11 +38,11 @@ further_reading:
4238
link: https://nginx.org/en/docs/
4339
type: documentation
4440
- resource:
45-
title: Apache Bench official documentation
41+
title: ApacheBench official documentation
4642
link: https://httpd.apache.org/docs/2.4/programs/ab.html
4743
type: documentation
4844
- resource:
49-
title: NGINX on Azure
45+
title: NGINX on Azure virtual machines
5046
link: https://docs.nginx.com/nginx/deployment-guides/microsoft-azure/virtual-machines-for-nginx/
5147
type: documentation
5248

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
2-
title: "Overview"
2+
title: "Overview of Azure Cobalt 100 and NGINX"
33

44
weight: 2
55

66
layout: "learningpathall"
77
---
88

9-
## Cobalt 100 Arm-based processor
9+
## Azure Cobalt 100 Arm-based processor
1010

11-
Azure’s Cobalt 100 is built on Microsoft's first-generation, in-house Arm-based processor: the Cobalt 100. Designed entirely by Microsoft and based on Arm’s Neoverse N2 architecture, this 64-bit CPU delivers improved performance and energy efficiency across a broad spectrum of cloud-native, scale-out Linux workloads. These include web and application servers, data analytics, open-source databases, caching systems, and more. Running at 3.4GHz, the Cobalt 100 processor allocates a dedicated physical core for each vCPU, ensuring consistent and predictable performance.
11+
Azure’s Cobalt 100 is Microsofts first-generation, in-house Arm-based processor. Built on Arm Neoverse N2, Cobalt 100 is a 64-bit CPU that delivers strong performance and energy efficiency for cloud-native, scale-out Linux workloads such as web and application servers, data analytics, open-source databases, and caching systems. Running at 3.4 GHz, Cobalt 100 allocates a dedicated physical core for each vCPU, which helps ensure consistent and predictable performance.
1212

13-
To learn more about Cobalt 100, refer to the blog [Announcing the preview of new Azure virtual machine based on the Azure Cobalt 100 processor](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-azure-vms-based-on-the-azure-cobalt-100-processor/4146353).
13+
To learn more, see the Microsoft blog [Announcing the preview of new Azure VMs based on the Azure Cobalt 100 processor](https://techcommunity.microsoft.com/blog/azurecompute/announcing-the-preview-of-new-azure-vms-based-on-the-azure-cobalt-100-processor/4146353).
1414

1515
## NGINX
1616

17-
NGINX is a high-performance, open-source web server, reverse proxy, load balancer, and HTTP cache. Originally developed by Igor Sysoev, NGINX is known for its event-driven, asynchronous architecture, which enables it to handle high concurrency with low resource usage.
17+
NGINX is a high-performance open-source web server, reverse proxy, load balancer, and HTTP cache. Known for its event-driven, asynchronous architecture, NGINX handles high concurrency with low resource usage.
1818

1919
There are three main variants of NGINX:
20-
- **NGINX Open Source**– Free and [open-source version available at nginx.org](https://nginx.org)
21-
- **NGINX Plus**- [Commercial edition of NGINX](https://www.nginx.com/products/nginx/) with features like dynamic reconfig, active health checks, and monitoring.
22-
- **NGINX Unit**- A lightweight, dynamic application server that complements NGINX. [Learn more at unit.nginx.org](https://unit.nginx.org/).
20+
- Open source NGINX: a free and [open-source version available at nginx.org](https://nginx.org)
21+
- NGINX Plus: a [Commercial edition of NGINX](https://www.nginx.com/products/nginx/) with features like dynamic reconfig, active health checks, and monitoring
22+
- NGINX Unit: a lightweight, dynamic application server that complements NGINX - find out more at the [NGINX website](https://unit.nginx.org/)

content/learning-paths/servers-and-cloud-computing/nginx-on-azure/baseline.md

Lines changed: 29 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,20 @@ weight: 5
66
layout: learningpathall
77
---
88

9+
## Baseline test NGINX with a static website
910

10-
### Baseline testing with a static website on NGINX
11-
Once NGINX is installed and serving the default welcome page, the next step is to verify that it can serve your own content. A baseline test using a simple static HTML site ensures that NGINX is correctly configured and working as expected on your Ubuntu Pro 24.04 LTS virtual machine.
11+
Once NGINX is installed and serving the default welcome page, verify that it can serve your own content. A baseline test with a simple static HTML site confirms that NGINX is correctly configured and working as expected on your Ubuntu Pro 24.04 LTS virtual machine.
1212

13-
1. Create a Static Website Directory:
14-
15-
Prepare a folder to host your HTML content.
13+
## Create a static website directory
14+
Prepare a folder to host your HTML content:
1615
```console
1716
mkdir -p /var/www/my-static-site
1817
cd /var/www/my-static-site
1918
```
20-
2. Create an HTML file and Web page:
2119

22-
Create a simple HTML file to replace the default NGINX welcome page. Using a file editor of your choice create the file `index.html` with the content below:
20+
## Create an HTML file
2321

22+
Create a simple HTML page to replace the default NGINX welcome page. Using a file editor of your choice, create `index.html` with the following content:
2423
```html
2524
<!DOCTYPE html>
2625
<html lang="en">
@@ -56,30 +55,25 @@ Create a simple HTML file to replace the default NGINX welcome page. Using a fil
5655
</head>
5756
<body>
5857
<div class="box">
59-
<h1> Welcome to NGINX on Azure Ubuntu Pro 24.04 LTS!</h1>
60-
<p>Your static site is running beautifully on ARM64 </p>
58+
<h1>Welcome to NGINX on Azure Ubuntu Pro 24.04 LTS!</h1>
59+
<p>Your static site is running beautifully on Arm64</p>
6160
</div>
6261
</body>
6362
</html>
6463
```
65-
3. Adjust Permissions:
66-
67-
Ensure that NGINX (running as the www-data user) can read the files in your custom site directory:
6864

65+
## Adjust permissions
66+
Ensure that NGINX (running as the `www-data` user) can read the files in your custom site directory:
6967
```console
7068
sudo chown -R www-data:www-data /var/www/my-static-site
7169
```
72-
This sets the ownership of the directory and files so that the NGINX process can serve them without permission issues.
73-
74-
4. Update NGINX Configuration:
75-
76-
Point NGINX to serve files from your new directory by creating a dedicated configuration file under /etc/nginx/conf.d/.
7770

71+
## Update NGINX configuration
72+
Point NGINX to serve files from your new directory by creating a dedicated configuration file under `/etc/nginx/conf.d/`:
7873
```console
7974
sudo nano /etc/nginx/conf.d/static-site.conf
8075
```
81-
Add the following configuration to it:
82-
76+
Add the following configuration:
8377
```console
8478
server {
8579
listen 80 default_server;
@@ -97,54 +91,44 @@ server {
9791
error_log /var/log/nginx/static-error.log;
9892
}
9993
```
100-
This configuration block tells NGINX to:
101-
- Listen on port 80 (both IPv4 and IPv6).
102-
- Serve files from /var/www/my-static-site.
103-
- Use index.html as the default page.
104-
- Log access and errors to dedicated log files for easier troubleshooting.
94+
This server block listens on port 80 for both IPv4 and IPv6, serves files from `/var/www/my-static-site/`, and uses `index.html` as the default page. It also writes access and error events to dedicated log files to simplify troubleshooting.
10595

96+
{{% notice Note %}}
10697
Make sure the path to your `index.html` file is correct before saving.
98+
{{% /notice %}}
10799

108-
5. Disable the default site:
109-
110-
By default, NGINX comes with a packaged default site configuration. Since you have created a custom config, it is good practice to disable the default to avoid conflicts:
111-
100+
## Disable the default site
101+
NGINX ships with a packaged default site configuration. Since you created a custom config, disable the default to avoid conflicts:
112102
```console
113103
sudo unlink /etc/nginx/sites-enabled/default
114104
```
115105

116-
6. Test the NGINX Configuration:
117-
118-
Before applying your changes, always test the configuration to make sure there are no syntax errors:
119-
106+
## Test the NGINX configuration
107+
Before applying your changes, test the configuration for syntax errors:
120108
```console
121109
sudo nginx -t
122110
```
123-
You should see output similar to:
111+
Expected output:
124112
```output
125113
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
126114
nginx: configuration file /etc/nginx/nginx.conf test is successful
127115
```
128-
If you see both lines, your configuration is valid.
129-
130-
7. Reload or Restart NGINX:
131116

132-
After testing the configuration, apply your changes by reloading or restarting the NGINX service:
117+
## Reload or restart NGINX
118+
Apply your changes by reloading or restarting the NGINX service:
133119
```console
134120
sudo nginx -s reload
135121
sudo systemctl restart nginx
136122
```
137123

138-
8. Test the Static Website in a browser:
139-
140-
Access your website at your public IP on port 80.
141-
124+
## Test the static website in a browser
125+
Access your website at your public IP on port 80:
142126
```console
143127
http://<your-vm-public-ip>/
144128
```
145129

146-
9. You should see the NGINX welcome page confirming a successful deployment:
147-
148-
![Static Website Screenshot](images/nginx-web.png)
130+
## Verify the page renders
131+
You should see your custom page instead of the default welcome page:
132+
![Custom static website served by NGINX on Azure VM alt-text#center](images/nginx-web.png "Custom static website served by NGINX on an Azure Arm64 VM")
149133

150-
This verifies the basic functionality of NGINX installation and you can now proceed to benchmarking the performance of NGINX on your Arm-based Azure VM.
134+
This verifies the basic functionality of the NGINX installation. You can now proceed to benchmarking NGINX performance on your Arm-based Azure VM.

0 commit comments

Comments
 (0)