Referenzdokumentation zur Regel-Engine für Azure Content Delivery Network Premium von Edgio
Dieser Artikel enthält ausführliche Beschreibungen der verfügbaren Übereinstimmungsbedingungen und Features für die Regel-Engine des Azure Content Delivery Network.
Die Regel-Engine ist als endgültige Autorität dafür konzipiert, wie bestimmte Typen von Anforderungen vom Content Delivery Network verarbeitet werden.
Allgemeine Zwecke:
- Außerkraftsetzen oder Definieren einer benutzerdefinierten Cacherichtlinie
- Schützen oder Ablehnen von Anforderungen vertraulicher Inhalte
- Umleiten von Anforderungen
- Speichern benutzerdefinierter Protokolldaten
Wichtige Begriffe
In diesem Artikel werden die wichtigsten Konzepte zum Einrichten der Regel-Engine beschrieben.
Entwurf
Ein Entwurf einer Richtlinie besteht aus mindestens einer Regel zum Identifizieren von Anforderungen und dem Satz von Aktionen, die darauf angewendet werden. Ein Entwurf ist eine fortlaufende Arbeit, die häufige Konfigurationsaktualisierungen ermöglicht, ohne dass sich dies auf den Websitedatenverkehr auswirkt. Zum Fertigstellen eines Entwurfs sollte dieser in eine schreibgeschützte Richtlinie konvertiert werden.
Regel
Eine Regel identifiziert einen oder mehrere Typen von Anforderungen und den Satz von Aktionen, die darauf angewendet werden.
Sie besteht aus:
- Einem Satz bedingter Ausdrücke, die die Logik zum Identifizieren von Anforderungen definieren.
- Einer Reihe von Übereinstimmungsbedingungen, die die Kriterien zum Identifizieren von Anforderungen definieren.
- Einer Reihe von Features, die definieren, wie das Content Delivery Network die vorstehenden Anforderungen behandelt. Diese Elemente sind in der folgenden Abbildung gekennzeichnet.
Richtlinie
Eine Richtlinie, die aus einem Satz schreibgeschützter Regeln besteht, ermöglicht Folgendes:
- Erstellen, Speichern und Verwalten mehrerer Varianten der Regeln
- Zurücksetzen auf eine zuvor bereitgestellte Version
- Erstellen ereignisspezifischer Regeln im Voraus (beispielsweise einer Regel, die den Datenverkehr aufgrund einer Kundenursprungswartung umleitet).
Hinweis
Obwohl nur eine einzige Richtlinie pro Umgebung zulässig ist, können Richtlinien bei Bedarf bereitgestellt werden.
Bereitstellungsanforderung
Eine Bereitstellungsanforderung bietet ein einfaches und optimiertes Verfahren für die schnelle Anwendung einer Richtlinie auf die Staging- oder Produktionsumgebung. Ein Verlauf der Bereitstellungsanforderungen wird bereitgestellt, um die Nachverfolgung der auf diese Umgebungen angewendeten Änderungen zu erleichtern.
Hinweis
Nur Anforderungen, die von unserem automatisierten Überprüfungs- und Fehlererkennungssystem nicht akzeptiert werden, erfordern eine manuelle Überprüfung und Genehmigung.
Rangfolge der Regeln
Die Regeln in einer Richtlinie werden normalerweise in der Reihenfolge ihrer Auflistung (z. B. von oben nach unten) verarbeitet. Wenn die Anforderung mit in Konflikt stehenden Regeln übereinstimmt, hat die letzte zu verarbeitende Regel Vorrang.
Workflow der Richtlinienbereitstellung
Der Workflow für das Anwenden einer Richtlinie auf die Produktions- oder Stagingumgebung wird im Folgenden dargestellt.
| Schritt | BESCHREIBUNG |
|---|---|
| Erstellen des Entwurfs | Ein Entwurf besteht aus einer Reihe von Regeln, die definieren, wie Anforderungen für Ihre Inhalte vom Content Delivery Network verarbeitet werden. |
| Sperren des Entwurfs | Nach dem Abschließen eines Entwurfs sollte dieser gesperrt und in eine schreibgeschützte Richtlinie konvertiert werden. |
| Übermitteln der Bereitstellungsanforderung | Eine Bereitstellungsanforderung ermöglicht das Anwenden einer Richtlinie auf den Test- oder Produktionsdatenverkehr. Übermitteln Sie eine Bereitstellungsanforderung an die Staging- oder Produktionsumgebung. |
| Überprüfen der Bereitstellungsanforderung | Eine Bereitstellungsanforderung wird einer automatisierten Überprüfung und Fehlererkennung unterzogen. Obwohl die meisten Bereitstellungsanforderungen automatisch genehmigt werden, erfordern komplexere Richtlinien eine manuelle Überprüfung. |
| Richtlinienbereitstellung (Staging) | Nach der Genehmigung einer Bereitstellungsanforderung an die Stagingumgebung wird eine Richtlinie auf diese Umgebung angewendet. Diese Umgebung ermöglicht das erneute Testen der Richtlinie mit simuliertem Websitedatenverkehr. Sobald die Richtlinie auf Live-Websitedatenverkehr angewendet werden kann, sollte eine neue Bereitstellungsanforderung für die Produktionsumgebung übermittelt werden. |
| Richtlinienbereitstellung (Produktion) | Nach der Genehmigung einer Bereitstellungsanforderung an die Produktionsumgebung wird eine Richtlinie auf diese Umgebung angewendet. In dieser Umgebung kann eine Richtlinie als endgültige Stelle fungieren, die bestimmt, wie die Verarbeitung von Livedatenverkehr durch das Content Delivery Network erfolgen soll. |
Syntax
Die Art und Weise, in der Sonderzeichen behandelt werden, hängt davon ab, wie eine Übereinstimmungsbedingung Textwerte behandelt. Eine Übereinstimmungsbedingung (bzw. Feature) kann Text interpretieren als:
Literalwerte
Text, der als Literalwert interpretiert wird, behandelt alle Sonderzeichen (mit Ausnahme des Zeichens „%“) als Teil des Werts, für den eine Übereinstimmung gefunden werden muss. Eine Literalübereinstimmungsbedingung, die auf \'*'\ festgelegt ist, wird demnach nur erfüllt, wenn exakt dieser Wert (d.h. \'*'\) gefunden wird.
Ein Prozentzeichen wird zum Angeben der URL-Codierung verwendet (z.B. %20).
Platzhalterwerte
Text, der als Platzhalterwert interpretiert wird, weist Sonderzeichen eine zusätzliche Bedeutung zu. In der folgenden Tabelle wird beschrieben, wie die folgende Gruppe von Zeichen interpretiert wird:
| Zeichen | BESCHREIBUNG |
|---|---|
| \ | Ein umgekehrter Schrägstrich wird als Escapezeichen für die in dieser Tabelle angegebenen Zeichen verwendet. Direkt vor dem Sonderzeichen, das mit Escapezeichen versehen werden soll, muss ein umgekehrter Schrägstrich eingegeben werden. Es folgt als Beispiel die Syntax für das Escapezeichen eines Sternchens: \* |
| % | Ein Prozentzeichen wird zum Angeben der URL-Codierung verwendet (z.B. %20). |
| * | Ein Sternchen ist ein Platzhalter, der ein oder mehrere Zeichen darstellt. |
| LeerZchn | Ein Leerzeichen gibt an, dass eine Übereinstimmungsbedingung durch die angegebenen Werte oder Muster erfüllt wird. |
| 'Wert' | Ein einfaches Anführungszeichen hat keine spezielle Bedeutung. Jedoch wird eine Gruppe einfacher Anführungszeichen verwendet, um anzugeben, dass ein Wert als Literalwert behandelt werden soll. Es kann auf folgende Weisen verwendet werden: – Es ermöglicht das Erfüllen einer Übereinstimmungsbedingung, sobald der angegebene Wert mit einem beliebigen Teil des Vergleichswerts übereinstimmt. Beispielsweise stimmt 'ma' mit beliebigen der folgenden Zeichenfolgen überein: /business/marathon/asset.htm map.gif /business/template.map – Es ermöglicht die Angabe eines Sonderzeichens als Literalzeichen. Sie können z.B. ein literales Leerzeichen angeben, indem Sie ein Leerzeichen in einfache Anführungszeichen setzen (d.h. ' ' oder 'sample value').– Es ermöglicht die Angabe eines leeren Werts. Geben Sie einen leeren Wert an, indem Sie zwei einfache Anführungszeichen eingeben (d.h. ''). Wichtig: – Wenn der angegebene Wert keinen Platzhalter enthält, wird er automatisch als Literalwert behandelt, d. h., es müssen keine zwei einfachen Anführungszeichen angegeben werden. – Fungiert ein umgekehrter Schrägstrich nicht als Escapezeichen für ein anderes Zeichen in dieser Tabelle, wird er ignoriert, wenn er zwischen zwei einfachen Anführungszeichen angegeben wird. – Eine andere Möglichkeit zum Angeben eines Sonderzeichens als Literalzeichen besteht darin, es mithilfe eines umgekehrten Schrägstrichs (d.h. \) mit einem Escapezeichen zu versehen. |
Reguläre Ausdrücke
Reguläre Ausdrücke definieren ein Muster, das in einem Textwert gesucht wird. Die Notation regulärer Ausdrücke definiert spezifische Bedeutungen für verschiedene Symbole. Die folgende Tabelle zeigt, wie Sonderzeichen durch Übereinstimmungsbedingungen und Features behandelt werden, die reguläre Ausdrücke unterstützen.
| Sonderzeichen | BESCHREIBUNG |
|---|---|
| \ | Ein umgekehrter Schrägstrich als Escapezeichen für das nach diesem folgende Zeichen bewirkt, dass das Zeichen als Literalwert behandelt wird, anstatt seine Bedeutung als regulärer Ausdruck zu haben. Es folgt als Beispiel die Syntax für das Escapezeichen eines Sternchens: \* |
| % | Die Bedeutung eines Prozentzeichens hängt von seiner Verwendung ab.%{HTTPVariable}: Diese Syntax gibt eine HTTP-Variable an.%{HTTPVariable%Pattern}: Diese Syntax verwendet ein Prozentzeichen, um eine HTTP-Variable und ein Trennzeichen anzugeben.\%: Wenn ein Prozentzeichen mit einem Escapezeichen versehen wird, kann es als Literalwert verwendet werden oder die URL-Codierung angeben (z. B. \%20). |
| * | Ein Sternchen ermöglicht, dass für das vorherige Zeichen keine oder mehrere Übereinstimmungen gefunden werden. |
| LeerZchn | Ein Leerzeichen wird in der Regel als Literalzeichen behandelt. |
| 'Wert' | Einfache Anführungszeichen werden als Literalzeichen behandelt. Eine Gruppe einfacher Anführungszeichen hat keine spezielle Bedeutung. |
Übereinstimmungsbedingungen und Features, die reguläre Ausdrücke unterstützen, akzeptieren Muster, die durch PCRE (Perl Compatible Regular Expressions) definiert sind.