Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit e5cf53a

Browse files
committedMay 26, 2020
updated
1 parent 65731e5 commit e5cf53a

File tree

5 files changed

+55
-2449
lines changed

5 files changed

+55
-2449
lines changed
 

‎articles/cdn/cdn-verizon-premium-rules-engine-reference-features.md

Lines changed: 2 additions & 1407 deletions
Large diffs are not rendered by default.

‎articles/cdn/cdn-verizon-premium-rules-engine-reference-match-conditions.md

Lines changed: 2 additions & 1035 deletions
Large diffs are not rendered by default.

‎articles/cdn/cdn-verizon-premium-rules-engine-reference.md

Lines changed: 51 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: asudbring
66

77
ms.service: azure-cdn
88
ms.topic: article
9-
ms.date: 05/31/2019
9+
ms.date: 05/26/2020
1010
ms.author: allensu
1111

1212
---
@@ -23,12 +23,6 @@ The rules engine is designed to be the final authority on how specific types of
2323
- Redirect requests.
2424
- Store custom log data.
2525

26-
## Terminology
27-
28-
A rule is defined through the use of [**conditional expressions**](cdn-verizon-premium-rules-engine-reference-conditional-expressions.md), [**match conditions**](cdn-verizon-premium-rules-engine-reference-match-conditions.md), and [**features**](cdn-verizon-premium-rules-engine-reference-features.md). These elements are highlighted in the following illustration:
29-
30-
![CDN match condition](./media/cdn-rules-engine-reference/cdn-rules-engine-terminology.png)
31-
3226
## Syntax
3327

3428
The manner in which special characters are treated varies according to how a match condition or feature handles text values. A match condition or feature may interpret text in one of the following ways:
@@ -69,6 +63,56 @@ Space | A space character is typically treated as a literal character.
6963

7064
Match conditions and features that support regular expressions accept patterns defined by Perl Compatible Regular Expressions (PCRE).
7165

66+
## Key concepts
67+
Key concepts for setting up Rules Engine are described below.
68+
### Draft
69+
A draft of a policy consists of one or more rules meant to identify requests and the set of actions that will be applied to them. A draft is a work in progress that allows frequent configuration updates without impacting site traffic. Once a draft is ready to be finalized, it should be converted into a read-only policy.
70+
71+
### Rule
72+
A rule identifies one or more types of requests and the set of actions that will be applied to them.
73+
74+
It consists of:
75+
76+
- A set of conditional expressions that define the logic through which requests are identified.
77+
- A set of match conditions that define the criteria used to identify requests.
78+
- A set of features that define how the CDN will handle the above requests.
79+
These elements are identified in the following illustration.
80+
81+
![Policy deployment workflow](./media/cdn-verizon-premium-rules-engine-reference/verizon-rules-engine-reference.png)
82+
83+
### Policy
84+
A policy, which consists of a set of read-only rules, provides the means to:
85+
86+
- Create, store, and manage multiple variants of your rules.
87+
- Roll back to a previously deployed version.
88+
- Prepare event-specific rules in advance (e.g., a rule that redirects traffic as a result of a customer origin maintenance.)
89+
90+
> [!NOTE]
91+
> Although only a single policy per environment is allowed, policies may be deployed as needed.
92+
93+
### Deploy request
94+
A deploy request provides a simple and streamlined procedure through which a policy may be quickly applied to the Staging or Production environment. A history of deploy requests is provided to facilitate the tracking of changes applied to those environments.
95+
96+
> [!NOTE]
97+
> Only requests that do not pass our automated validation and error detection system will require manual review and approval.
98+
99+
### Rule precedence
100+
The rules contained in a Policy are typically processed in the order in which they are listed (i.e., top to bottom). If the request matches conflicting rules, then the last rule to be processed will take precedence.
101+
102+
### Policy deployment workflow
103+
The workflow through which a policy may be applied to either the Production or Staging environment is illustrated below.
104+
105+
![Policy deployment workflow](./media/cdn-verizon-premium-rules-engine-reference/policy-deployment-workflow.png)
106+
107+
|Step |Description |
108+
|---------|---------|
109+
|[Create Draft](https://docs.vdms.com/cdn/index.html#HRE/AdministeringDraftsandRules.htm#Create) | A draft consists of a set of rules that define how requests for your content should be handled by the CDN. |
110+
|Lock Draft | Once a draft has been finalized, it should be locked and converted into a read-only policy. |
111+
|[Submit Deploy Request](https://docs.vdms.com/cdn/index.html#HRE/DeployRequest.htm) | <br> A deploy request allows a policy to be applied to either test or production traffic.</br> <br>Submit a deploy request to either the Staging or Production environment.</br> |
112+
|Deploy Request Review | <br>A deploy request undergoes automated validation and error detection.</br><br>Although the majority of deploy requests are automatically approved, manual review is required for more complex policies.</br> |
113+
|Policy Deployment ([Staging](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Staging)) | <br> Upon approval of a deploy request to the Staging environment, a policy will be applied to the Staging environment. This environment allows a policy to be tested against mock site traffic.</br><br>Once the policy is ready to be applied to live site traffic, a new deploy request for the Production environment should be submitted.</br> |
114+
|Policy Deployment ([Production](https://docs.vdms.com/cdn/index.html#HRE/Environment.htm#Producti)) | Upon approval of a deploy request to the Production environment, a policy will be applied to the Production environment. This environment allows a policy to act as the final authority for determining how the CDN should handle live traffic. |
115+
72116
## Next steps
73117

74118
- [Rules engine match conditions](cdn-verizon-premium-rules-engine-reference-match-conditions.md)
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.