Using azure cdn with nginx

Question

Pulumi · Accepted Answer

To integrate Azure CDN with NGINX, you'll need to perform a few steps:

Set up an NGINX server, which is where your website's content will be hosted.
Create a CDN profile and endpoint in Azure, which will be used to cache and distribute your content globally.
Point the CDN endpoint to your NGINX server's public IP address or domain name.

Below is a Pulumi program in TypeScript that demonstrates how to create an Azure CDN endpoint pointing to an origin represented by your NGINX server. Before you deploy this, ensure that your NGINX server is accessible over the internet.

First, import the required modules:

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

Next, set up the CDN profile and endpoint. A CDN profile is a collection of CDN endpoints, and each endpoint represents a location serving content to users.

You'll need to provide a resource group name and a location for your Azure resources. The originType should be set to WebApp because NGINX would be acting as a web server. Make sure isHttpsAllowed is set to true if your NGINX server is configured with SSL (which it should be for production environments).

const resourceGroupName = "<your-resource-group-name>";
const location = "<location>"; // Example: "West US"

// Create an Azure resource group
const resourceGroup = new azure.core.ResourceGroup("my-resource-group", {
    location: location,
});

// Create a new CDN profile
const cdnProfile = new azure.cdn.Profile("my-cdn-profile", {
    resourceGroupName: resourceGroup.name,
    sku: "Standard_Akamai", // You can choose other CDN providers like Verizon or Microsoft
    location: location,
});

// Create a CDN endpoint
const cdnEndpoint = new azure.cdn.Endpoint("my-cdn-endpoint", {
    resourceGroupName: resourceGroup.name,
    profileName: cdnProfile.name,
    location: location,
    isHttpsAllowed: true,
    isHttpAllowed: true, // Set to false if you want to force HTTPS
    queryStringCachingBehaviour: "IgnoreQueryString", // Adjust based on your caching needs
    origins: [{
        name: "my-nginx-origin",
        hostName: "<your-nginx-server-host-name>", // Replace with your NGINX server hostname or IP
        httpsPort: 443, // NGINX SSL port
        httpPort: 80, // NGINX HTTP port (set to null if you're not using HTTP)
    }],
});

Finally, export the CDN endpoint hostname so that it can be easily accessed. This hostname is the URL you will share with your users for accessing your content.

export const cdnEndpointHostname = cdnEndpoint.hostName;

The above program sets up a basic Azure CDN pointing to an NGINX server. You'll need to handle DNS configurations separately and ensure that your NGINX server is properly set up to serve your content.

Remember, for each cloud resource you want to create (like a resource group, CDN profile, or CDN endpoint), you instantiate a new object and pass the required configuration values to its constructor. In Pulumi, these cloud resources are created using TypeScript classes that mirror the resources available in Azure. Each class requires specific configuration parameters — for example, the CDN endpoint needs the resource group name, the CDN profile name, and information about the origin, including the hostname and ports.

After setting up the above Pulumi program, you can deploy the infrastructure using the Pulumi CLI and then access the CDN endpoint URL to see your NGINX-served content being distributed through Azure CDN.