Global CDN Purge
Global CDN Purge is a way to purge data from several CDNs at the same time, which makes it easier to manage multiple CDNs. It allows you connect the CDNs to be purged, specify the URIs to purge across all of the attached services and click the Purge button. The purge is initiated across all of the connected CDNs.
Global CDN Purge functionality is built on three main components:
- CDN Purge Adapter – A CDN purge adapter needs to be created for each CDN/host name combination that you would like to purge. The CDN Purge Adapter collects information needed to execute purges, such as: service selection, authentication information, host name, and other service specific information. You need a CDN purge adapter for each host name that is to be purged on a CDN.
- URI – Purges are run against a specific location on the CDNs.
- Purge Group – Purge Groups allow you to create a logical collection of CDN purge adapters and URIs that are purged with one command. For example, you can purge the ‘/media’ directory on 2 different CDNs or a directory that exists in development, test and production environment.
CDN purge adapters must be set up to run purges.URIs and multiple CDN purges can be specified individually but it is recommended that your setup purge groups to manage common purges that are run often.
Global CDN Purge can be accessed from the top level of the navigation menu as CDN Purge.
CDN Purge Adapters
The following screen shows all of the configured CDN purge adapters. The list provides an overview of the configured CDN adapters and allows for purge execution.
The columns provide the following information:
Heading | Description |
---|---|
Adapter Name | The name given to the adapter. Optional, will default to “Service - Host” if not specified. |
Service | The name of the CDN service the purge is configured to use. |
ID | The ID of the CDN adapter. This is needed for accessing Fusion via the API. |
Host | The host that the purge is configured to run against. Services sometimes call this setting: host, host name, platform, and so on. |
Last Purge (UTC) | The time and date, in UTC, when the purge was last run. |
Purged By | The user who last ran a purge. |
Creating CDN Purge Adapters
To use Global CDN Purge, you need to add your CDN and host name configurations. When you first open CDN Purge, you are prompted to create a CDN purge adapter.
Click the Get Started button or + to set up a CDN available to purge.
New CDN Purge Adapters
Click the icon of the service for which you would like to create a CDN purge adapter and fill out the required configuration fields.
Each purge adapter requires different configuration parameters. You would need a user name and password or a generated token for authentication and any additional service-specific configuration.
Editing CDN Purge Adapters
Editing a CDN purge adapter is as easy as clicking the CDN purge adapter in the table and clicking the Edit button.
Once you have changed the configuration, click Save. This brings you back to the purge adapter list with your changes saved and applied to the specific CDN purge adapter.
Executing a Purge
To execute a purge, select the CDN purge adapters that must be included in the purge execution.
Click the Purge button to start the purge process.
The Global CDN Purge dialog opens. The dialog shows the CDN purge adapters that were selected and the URIs that are used in the purge execution.
If there are 5 or less CDN purge adapters selected, the purge dialog displays the entire list of the selected CDN purge adapters. If not all CDN Purge Adapters are shown, click the CDNs text box that says X CDNs selected, click to see… to show all of the selected purge adapters.
The list can be hidden by clicking the Hide button to the right of the list of purge adapters.
You can populate the URIs used in the purge by manually entering the URIs or by selecting from the available URI Groups. Selecting a URI group populates the URIs input with the URIs from the selected purge group.
Enter or modify the URIs for the resources that must be purged.
When you are ready to submit the purge request, click the Execute Purge button. The purge is submitted to all of the selected CDNs. The submissions and API responses are shown in the Purge Results dialog.
CDN Purge Adapter History
Fusion collects the purge history each time it runs. You can view the purge status, information about the purge and the messages returned from the service. To view the purge history, click the History button on the CDN Purge Adapters or Purge Groups screens.
The list includes the time and status of the last 100 purge executions. You can see the details of a purge request sent to the CDN service by clicking the desired row in the table. The detail information includes the URIs specified for the purge and the API responses returned from the service during the purge.
If you would like to rerun a specific purge contained the history, click the Reissue button to the right of the purge status information. The purge dialog appears with the data from the previous purge pre-loaded for running.
Purge Groups
Purge groups allow you to organize CDN purge adapters and URIs to make it easy to purge a logical set of resources. For example, you may want to group development, test, and production environments and purge them all at the same time. Or purge all image resources across multiple CDNs at once.
Purge groups can be made up of a collection of CDN purge adapters, purge URIs or both. Typically, a group containing only CDN purge adapters is used for purging different resources across multiple services. A combined group is often used to pre-specify a standard, reusable purge such as “all media across all of my regional websites and CDNs”.
When you have at least one purge group setup, you see this screen when opening CDN Purge.
The columns provide the following information:
Heading | Description |
---|---|
Name | The name of the purge group. |
Type | The content type of the group. + CDN – the purge group contains only CDN purge adapters and the user need to specify URIs when running the purge + URI – the purge group contains only URIs and the user will need to specify services when running the purge + Combined – the purge group contains both CDN purge adapters and URIs; the user will be able to run the purge without need to specify more information |
CDN Configuration and URIs | The CDN purge adapters and/or URIs included in the group definition. |
Creating Purge Groups
To use purge groups, you need to specify the CDN purge adapters or URIs that must be included. There are two ways to create groups:
From the CDN Purge Adapters page, you can check the desired purge adapters and then click Create Purge Group.
From the Purge Groups page, click + to create a group.
In both cases, the Create New Group dialog is shown.
Enter the name for the purge group.
NOTE: You can add or remove CDN purge adapters from the list.
Click Complete to create the group.
Running a Group Purge
On the Purge Group page, select one or more groups then click the Purge button. The CDN Purge dialog opens with the parameters specified by the purge group definition.
Click the Execute Purge button to start the configured purge.