Schnellstart: Entwerfen eines CNF-Netzwerkdienstentwurfs (Containernetzwerkfunktion) mit NGINX

Artikel
11/17/2023

In diesem Schnellstart wird beschrieben, wie Sie die Azure CLI-Erweiterung az aosm verwenden, um einen einfachen Netzwerkdienstentwurf zu erstellen und zu veröffentlichen.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement ist erforderlich. Wenn Sie kein Azure-Abonnement haben, folgen Sie vorab den Anweisungen unter Kostenlos starten, um ein Konto zu erstellen.
Führen Sie den Schnellstart: Veröffentlichen eines NGINX-Containers als CNF (Containernetzwerkfunktion) aus.

Erstellen einer Eingabedatei

Erstellen Sie eine Eingabedatei zum Veröffentlichen des Netzwerkdienstentwurfs. Führen Sie den folgenden Befehl aus, um die Eingabekonfigurationsdatei für den Netzwerkdienstentwurf (Network Service Design, NSD) zu generieren.

az aosm nsd generate-config

Mit der Ausführung des obigen Befehls generieren Sie eine Datei „input.json“.

Hinweis

Bearbeiten Sie die Datei „input.json“. Ersetzen Sie darin die Werte, die im Beispiel gezeigt werden. Speichern Sie die Datei unter dem Namen input-cnf-nsd.json.

Hier ist ein Beispiel für die Datei input-cnf-nsd.json:

{
    "publisher_name": "nginx-publisher",
    "publisher_resource_group_name": "nginx-publisher-rg",
    "acr_artifact_store_name": "nginx-nsd-acr",
    "location": "uksouth",
    "network_functions": [
        {
            "publisher": "nginx-publisher",
            "publisher_resource_group": "nginx-publisher-rg",
            "name": "nginx-nfdg",
            "version": "1.0.0",
            "publisher_offering_location": "uksouth",
            "type": "cnf",
            "multiple_instances": false
        }
    ],
    "nsd_name": "nginx-nsdg",
    "nsd_version": "1.0.0",
    "nsdv_description": "Deploys a basic NGINX CNF"
}

publisher_name: Name der Herausgeberressource, unter der Ihre Definition veröffentlicht werden soll. Diese wird erstellt, falls sie noch nicht vorhanden ist.
publisher_resource_group_name: Ressourcengruppe für die Herausgeberressource. Diese wird erstellt, falls sie noch nicht vorhanden ist. Für diesen Schnellstart wird empfohlen, dieselbe Ressourcengruppe zu verwenden, die Sie beim Veröffentlichen der Netzwerkfunktionsdefinition verwendet haben.
acr_artifact_store_name: Name der ACR-Artefaktspeicherressource. Diese wird erstellt, falls sie noch nicht vorhanden ist.
location: Azure-Standort für das Erstellen von Ressourcen.
network_function:
- publisher: Name des Herausgebers, unter dem dieser NFDV veröffentlicht wird.
- publisher_resource_group: Ressourcengruppe, in der der Herausgeber gehostet wird.
- name: Name der vorhandenen Netzwerkfunktionsdefinitionsgruppe, die mithilfe dieses NSD bereitgestellt werden soll.
- version: Version der vorhandenen Netzwerkfunktionsdefinition, auf der dieser NSD basieren soll. Dieser NSD kann alle NFDV mit Bereitstellungsparametern bereitstellen, die mit dieser Version kompatibel sind.
- publisher_offering_location: Region, in der der NFDV veröffentlicht wird.
- type: Typ der Netzwerkfunktion. Gültige Werte sind „cnf“ oder „vnf“.
- multiple_instances: Gültige Werte sind TRUE oder FALSE. Legt fest, ob der NSD eine beliebige Anzahl dieses NF-Typs zulassen soll. Wenn dieser Wert auf FALSE festgelegt wird, ist nur eine einzelne Instanz zulässig. Wird nur für VNFs unterstützt. Für CNFs muss dieser Wert auf FALSE festgelegt werden.
nsd_name: Name der Netzwerkdienstentwurfsgruppe. Die Sammlung der Versionen des Netzwerkdienstentwurfs. Diese wird erstellt, falls sie noch nicht vorhanden ist.
nsd_version: Version des erstellten NSD. Das Format lautet: A.B.C.
nsdv_description: Beschreibung des NSDV.

Erstellen des Netzwerkdienstentwurfs (Network Service Design, NSD)

Initiieren Sie den Buildprozess für die Netzwerkdienstdefinition (Network Service Definition, NSD) mithilfe des folgenden Befehls:

az aosm nsd build -f input-cnf-nsd.json

Überprüfen Sie nach Abschluss des Buildprozesses die generierten Dateien, um Erkenntnisse zur Architektur und Struktur der NSD zu gewinnen.

Diese Dateien werden erstellt:

Dateien	Beschreibung
artifact_manifest.bicep	Eine Bicep-Vorlage zum Erstellen der Herausgeber- und Artefaktspeicher.
configMappings	Konvertiert die Eingaben für die Konfigurationsgruppenwerte in die Bereitstellungsparameter, die für jede NF erforderlich sind.
nsd_definition.bicep	Eine Bicep-Vorlage zum Erstellen des NSDV selbst.
schemas	Definiert die Eingaben, die in den Konfigurationsgruppenwerten für diesen NSDV erforderlich sind.
nginx-nfdg_nf.bicep	Eine Bicep-Vorlage für die Bereitstellung der NF. Diese wird in den Artefaktspeicher hochgeladen.

Veröffentlichen des Netzwerkdienstentwurfs (Network Service Design, NSD)

Um den Netzwerkdienstentwurf (Network Service Design, NSD) und die zugehörigen Artefakte zu veröffentlichen, geben Sie den folgenden Befehl aus:

az aosm nsd publish -f input-cnf-nsd.json

Navigieren Sie nach Abschluss des Veröffentlichungsprozesses zu Ihrer Herausgeberressourcengruppe, um die erstellten Ressourcen und Artefakte anzuzeigen und zu überprüfen.

Nächste Schritte

Schnellstart: Voraussetzungen für Betreiber und Containernetzwerkfunktionen (CNF)

Share via