Azure CDN Purge

This module extends the Purge module by providing a purger, queuer, and processor plugin for Azure CDN. The module also comes with a manual purge form that allows users to send manual purge requests with support for wildcard paths - e.x. /news/*

Setup Azure CDN Purge

The following steps are required in order to get the Azure CDN purge module to work.

Step 1 - Setup your application in Azure

1. Login to the Azure portal - https://portal.azure.com
2. Select the Azure Active Directory option from the menu.
3. Click “App registrations” from the menu on the left and select New registration. Give your application a name.
4. Once created, click on your application and choose Certificates and secrets from the left menu
5. Click New Client Secret, provide a description and select the expiry (recommend the longest period allowed by your IT security policy). IMPORTANT, be sure to record the Client secret value as this will not be retrievable after this process has completed.
6. The overview page for the App will contain the Application ID (Client ID), the Directory ID (Tenant ID) and the Client secret value, all of which are required for configuring access to the Azure CDN purge endpoint.

Step 2 - CDN profile setup

1. From the Azure portal dashboard, click on your CDN profile.
2. The Overview tab will provide the Resource group name and your Subscription ID.
3. In order to have authorization to perform the purge action, you will need to give your application the Contributor role. Click on the Access control (IAM) tab.
4. Click the add button to give the Contributor role to Azure Resource Management (ARM).

Step 3 - Install and configure the Azure CDN Purge module

1. Install as you would normally install a contributed Drupal module.
2. You will also want to install the Purge UI (drupal/purge) module in order to configure your purge settings. The Cron processor (drupal/purge) module can optionally be installed to provide a processor triggered by cron.
3. Configure user permissions by giving the 'administer azure cdn purge' permission to roles that should be able to configure the Azure CDN Purge configuration.
4. Go to the Azure CDN Purge admin form (/admin/config/services/azure) to input all required information (from steps 1 & 2).
5. On the Purge UI admin form (/admin/config/development/performance/purge) click the Add purger button and select Azure CDN.
6. In the queue fieldset, make sure the Path queuer is enabled under the Queuers column, and Cron processor is enabled under the Processors column.
7. Now when you save a node, it will be added to the queue and purged from Azure CDN on next cron run.

Other

• This module also works for Azure FrontDoor
• Highly recommend the drupal/purge_queues module. Specifically, the database_unique plugin that prevents bulk operations from filling up your queues with duplicate items/paths.