Jinja-Syntax und Beispiele für Konfigurationsvorlagen

Jinja-Syntax und CSO-Schlüsselwörter

In den folgenden Tabellen sind die Jinja-Syntax aufgeführt, die häufig in Konfigurationsvorlagen verwendet wird, und die Schlüsselwörter, die in Konfigurationsvorlagen verwendet werden.

{{tenant_name}}

{# This is an example of comment in Jinja syntax #}

{% for prefix in Trusted_Network_Prefix_List %}
set groups trusted‐prefix policy‐options prefix‐list re‐ssh {{prefix.Trusted_Network_Prefix_List}}
{% endfor %}

Beispiel 1: Konvertieren eines einzelnen Junos OS-Befehls in die Jinja-Syntax

Gehen Sie wie folgt vor, wenn Sie einen einzelnen Junos OS-Befehl zur Verwendung in einer Konfigurationsvorlage in Jinja-Syntax konvertieren möchten:

1. Identifizieren Sie die Variablen, die im Junos OS-Befehl konfiguriert sind.

   Im Befehl set snmp trap-group CSO-Trp-Grp targets 192.0.2.100sind z. B. die Variablen CSO-Trp-Grp und 192.0.2.100 konfiguriert.

2. Konvertieren Sie den Junos OS CLI-Befehl in die Jinja-Syntax, indem Sie jede Variable wie folgt in doppelte geschweifte Klammern einschließen: {{ Variable_Name }}.

   Wenn wir also in diesem Beispiel und SNMP_Host_IP_Address als Variablennamen verwendenTrap_Group_Name, lautet die Jinja-Syntax für den Befehl wie folgt:

3. Wenn Sie diese in den Abschnitt "Vorlagenkonfiguration" des Workflows "Konfigurationsvorlage hinzufügen" einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

4. Wenn Sie die Vorschaufunktion zum Rendern der Konfiguration verwenden (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test) und dabei die im ersten Schritt angegebenen Werte verwenden, rendert CSO die Konfiguration wie folgt:

   Beachten Sie, dass, obwohl Sie die JInja-Syntax für einen einzelnen Junos OS-Befehl angegeben haben, CSO der Konfiguration zusätzliche Befehle hinzugefügt hat. Dies liegt daran, dass CSO standardmäßig Junos OS-Gruppen zum Generieren der Konfiguration verwendet. Junos OS-Gruppen erleichtern das Anwenden und Löschen von Konfigurationen. Weitere Informationen finden Sie unter Grundlegendes zu Junos OS-Konfigurationsgruppen.

   Wenn Sie keine Junos OS-Gruppen verwenden möchten, müssen Sie den erweiterten Modus in der Konfigurationsvorlage aktivieren, wenn Sie die Konfiguration in der Jinja-Syntax angeben.

Beispiel 2: Konvertieren eines Junos OS-Konfigurations-Snippets in die Jinja-Syntax

In diesem Beispiel konvertieren wir das folgende Junos OS-Konfigurations-Snippet in Jinja-Syntax zur Verwendung in einer Konfigurationsvorlage:

So konvertieren Sie die Junos OS-Konfiguration in die Jinja-Syntax:

1. Identifizieren Sie die Variablen, die in den Junos OS-Befehlen konfiguriert sind. Zur besseren Verständlichkeit sind die Variablen im folgenden Beispiel in eckige Klammern (<>) eingeschlossen.

   Anmerkung:

   In diesem Beispiel wird DHCP-SERVER nicht als Variable betrachtet.

2. Konvertieren Sie jeden Junos OS-CLI-Befehl in Jinja-Syntax, indem Sie die Variablen identifizieren, einen Namen für jede Variable angeben und jede Variable in doppelte geschweifte Klammern einschließen. In diesem Fall lautet die Jinja-Syntax wie folgt:

3. Wenn Sie diese im Abschnitt "Vorlagenkonfiguration" des Workflows "Konfigurationsvorlage hinzufügen" einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

4. Wenn Sie die Vorschaufunktion verwenden, um die Konfiguration zu rendern (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test), rendert CSO die Konfiguration mit den Werten für dieses Beispiel wie folgt:

Beispiel 3: Verwenden bedingter Logik

In diesem Beispiel, bei dem es sich um eine modifizierte Version des vorherigen Beispiels handelt, sehen wir, wie Sie bedingte Logik (if und for Anweisungen) in einer Konfigurationsvorlage verwenden können.

Die Erklärung des obigen Beispiels lautet wie folgt:

1. In diesem Beispiel fügen wir eine if Anweisung hinzu und schließen die Konfiguration wie folgt in diese Anweisung ein:

   Dies bedeutet, dass die Konfiguration nur angewendet wird, wenn der enable_Forwarding_Options auf True festgelegt ist. Wenn enable_Forwarding_Options auf False festgelegt ist, wird keine Konfiguration angewendet.

   Trinkgeld:

   Wenn Sie eine andere Konfiguration anwenden möchten, wenn enable_Forwarding_Options auf False festgelegt ist, können Sie die else Anweisung verwenden.

2. Anschließend fügen wir eine for Anweisung hinzu, um die Konfiguration von mehr als einem Satz von Werten für die Relay_Group_NameVariablen , Relay_Interfaceund Relay_Zone zu ermöglichen.

   Wenn Sie eine for Anweisung verwenden, werden die Variablen in der von CSO gerenderten GUI (wenn Sie die Vorschaufunktion verwenden) in der Tabelle (Raster) angezeigt. Sie können dann das Symbol Hinzufügen (+) verwenden, um der Tabelle Zeilen hinzuzufügen und bei Bedarf einen oder mehrere Wertesätze zu konfigurieren.

3. Wenn Sie die Jinja-Befehle in den Abschnitt "Vorlagenkonfiguration" des Workflows "Konfigurationsvorlage hinzufügen" einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

4. Wenn Sie die Vorschaufunktion verwenden, um die Konfiguration zu rendern (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test) und Werte für die Parameter angeben, einschließlich zweier Wertesätze für Relay_Group_Name, Relay_Interfaceund , rendert Relay_ZoneCSO die Konfiguration wie folgt:

Beispiel 4: Verwenden der Variablenersetzung

In diesem Beispiel verwenden wir eine Variable als Teil des Konfigurationsbefehls, sodass der Wert , den wir für die Variable angeben, im Befehl verwendet wird.

Die Erklärung des obigen Beispiels lautet wie folgt:

1. Wir verwenden das VLAN_Id Attribut des pool Parameters, um die Junos OS-Konfigurationsparameter vlans festzulegen und vlan-idfestzulegen.

2. Wenn Sie den Jinja-Befehl set groups MIST vlans V-{{pool.VLAN_Id}} vlan-id {{pool.VLAN_Id}} im Abschnitt Vorlagenkonfiguration des Workflows Konfigurationsvorlage hinzufügen einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

   Dies liegt daran, dass wir den Punktoperator (.) verwendet haben, um auf das Attribut VLAN_Id des Parameters poolzu verweisen.

3. Wenn Sie die Vorschaufunktion zum Rendern der Konfiguration verwenden (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test) und den Wert 120 für VLAN_Ideingeben, rendert CSO die Konfiguration wie folgt:

   Im gerenderten Konfigurationsbefehl können Sie sehen, dass die Parameter vlans und auf und 120 bzw. festgelegt V-120 sind, basierend auf dem Wert, den wir für den Parameter vlan-id VLAN_Id angegeben haben.

Beispiel 5: Verwenden von Filtern, Verkettungen und Festlegen von Variablen

In diesem Beispiel sehen wir uns an, wie Sie eine Variable mithilfe von Verkettung und Filtern festlegen und diese Variable dann in einem Junos OS-Konfigurationsbefehl verwenden.

Die Erklärung des obigen Beispiels lautet wie folgt:

1. Die Jinja-Anweisung {% set pool_name = Dhcp_Server_Name + ’_’ + Interface | replace(“/”,”_”) %} wird verwendet, um eine Variable mit dem Namen pool_namefestzulegen, wobei zwei andere Variablen Dhcp_Server_Name Interfaceund wie folgt verwendet werden:

   1. Der | (Pipe-)Operator wird verwendet, um Variablen von Filtern zu trennen, bei denen es sich um Funktionen handelt, die Variablen ändern. In diesem Beispiel verwenden wir den replace(“/”,”_”) Filter, um die Interface Variable zu ändern, indem wir die Zeichen / (Schrägstrich) durch _-Zeichen (Unterstrich) ersetzen.

   2. Dann verwenden wir den Operator + , um die resultierende Zeichenfolge mit der Variablen Dhcp_Server_Namezu verketten.

      Anmerkung:

      Der Operator + wird in der Regel zum Hinzufügen von Zahlen verwendet, aber wenn es sich bei den Werten um Zeichenfolgen handelt, werden die Zeichenfolgen verkettet.

   3. Schließlich wird das Tag set (zusammen mit dem = Operator) verwendet, um die aufgerufene pool_name Variable auf die verkettete Variable festzulegen.

2. Anschließend wird der Befehl set system services dhcp-local-server overrides process-inform pool {{pool_name}} Junos OS verwendet, um die Junos OS-Konfigurationsanweisung pool mithilfe der Variablen pool_name zu konfigurieren, die wir im vorherigen Schritt festgelegt haben.

3. Wenn Sie die Jinja-Befehle in den Abschnitt "Vorlagenkonfiguration" des Workflows "Konfigurationsvorlage hinzufügen" einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

   Wie Sie sehen können, werden der Junos OS-Befehl oder die Variablen pool_name nicht angezeigt, da wir die Interface Variablen und Dhcp_Server_Name verwenden, um zur endgültigen Junos OS-Konfiguration zu gelangen.

4. Wenn Sie die Vorschaufunktion verwenden, um die Konfiguration zu rendern (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test) und die Werte LA_dhcp_srvr für Dhcp_Server_Name und ge-0/1/2 für die Interface, rendert CSO die Konfiguration wie folgt:

   Wie in einem vorherigen Schritt erläutert, werden die Zeichen / in ge-0/1/2 zunächst durch _-Zeichen ersetzt, wodurch die Zeichenfolge in ge-0_1_2 geändert wird. Diese Zeichenfolge wird mit LA_dhcp_srvr verkettet, um die Zeichenfolge LA_dhcp_srvr_ge-0_1_2 zu erzeugen, die im Konfigurationsbefehl Junos OS verwendet wird.

   Daher wird der Junos OS-Konfigurationsbefehl generiert set system services dhcp-local-server overrides process-inform pool LA_dhcp_srvr_ge-0_1_2.

Beispiel 6: Testen eines Werts

In diesem Beispiel sehen wir uns an, wie ein Wert getestet und Aktionen basierend auf dem Ergebnis der Testbedingungen ausgeführt werden.

Die Erklärung des obigen Beispiels lautet wie folgt:

1. Wir testen den Parameter NewNetwork.VLAN_Id auf zwei Bedingungen:

   1. Gibt an, ob der Parameter definiert ist (mithilfe der NewNetwork.VLAN_Id is defined Bedingung)

   2. Gibt an, ob die Länge des Parameters größer als zwei ist (unter Verwendung der Bedingung (NewNetwork.VLAN_Id | count) > 2)

   Weil wir das Schlüsselwort andverwenden:

   • Der Konfigurationsbefehl set vlan-id {{NewNetwork.VLAN_Id}} wird der Konfiguration (die von CSO generiert wird) hinzugefügt, wenn beide Bedingungen erfüllt sind.

   • Die Konfiguration set vlans VL-{{NewNetwork.VLAN_Id}} wird der Konfiguration hinzugefügt, wenn eine der Bedingungen false ist.

2. Wenn Sie die Jinja-Befehle in den Abschnitt "Vorlagenkonfiguration" des Workflows "Konfigurationsvorlage hinzufügen" einfügen, erkennt CSO die Parameter wie folgt:

   Parameter

3. Wenn Sie die Vorschaufunktion zum Rendern der Konfiguration verwenden (für ein OpCo mit dem Namen Juniper und eine Konfigurationsvorlage mit dem Namen Test), und:

   • Geben Sie den Wert 125 für VLAN_Idan, CSO rendert die Konfiguration wie folgt, da beide Bedingungen erfüllt sind:

   • Geben Sie den Wert 65 für VLAN_Idein, CSO rendert die Konfiguration wie folgt, da eine der Bedingungen false ist (Länge des Parameters ist nicht größer als 2):