Sdílet prostřednictvím

Rychlý start: Návrh návrhu síťové služby CNF (Containerized Network Function) pomocí Nginx

  • Článek

Tento rychlý start popisuje, jak pomocí az aosm rozšíření Azure CLI vytvořit a publikovat základní návrh síťové služby.

Požadavky

Vytvoření vstupního souboru

Vytvořte vstupní soubor pro publikování verze návrhu síťové služby a přidružených prostředků. Spuštěním následujícího příkazu vygenerujte vstupní konfigurační soubor pro verzi NSDV (Network Service Design Version).

az aosm nsd generate-config

Spuštění předchozího příkazu vygeneruje soubor nsd-input.jsonc.

Poznámka:

Upravte soubor input.json. Nahraďte ho hodnotami zobrazenými v ukázce níže. Uložte soubor jako input-cnf-nsd.jsonc.

Pokud jste při publikování NFDV změnili název vydavatele, použijte název vydavatele pro publisher_name pole i publisher pole (ten se nachází v resource_element_templates poli).

Pokud jste použili jiný název skupiny prostředků, aktualizujte pole i publisher_resource_group_name publisher_resource_group pole (druhá je v resource_element_templates poli).

Tady je ukázkový input-cnf-nsd.jsonc:

{
  // Azure location to use when creating resources e.g uksouth
  "location": "uksouth",
  // Name of the Publisher resource you want your definition published to.
  // Will be created if it does not exist.
  "publisher_name": "nginx-publisher",
  // Resource group for the Publisher resource.
  // Will be created if it does not exist.
  "publisher_resource_group_name": "nginx-publisher-rg",
  // Name of the ACR Artifact Store resource.
  // Will be created if it does not exist.
  "acr_artifact_store_name": "nginx-nsd-acr",
  // Network Service Design (NSD) name. This is the collection of Network Service Design Versions. Will be created if it does not exist.
  "nsd_name": "nginx-nsdg",
  // Version of the NSD to be created. This should be in the format A.B.C
  "nsd_version": "1.0.0",
  // Optional. Description of the Network Service Design Version (NSDV).
  "nsdv_description": "Deploys a basic NGINX CNF",
  // List of Resource Element Templates (RETs).
  // There must be at least one NF RET.
  // ArmTemplate RETs are optional. Delete if not required.
  "resource_element_templates": [
    {
      // Type of Resource Element. Either NF or ArmTemplate
      "resource_element_type": "NF",
      "properties": {
        // The name of the existing publisher for the NSD.
        "publisher": "nginx-publisher",
        // The resource group that the publisher is hosted in.
        "publisher_resource_group": "nginx-publisher-rg",
        // The name of the existing Network Function Definition Group to deploy using this NSD.
        // This will be the same as the NF name if you published your NFDV using the CLI.
        "name": "nginx",
        // The version of the existing Network Function Definition to base this NSD on.
        // This NSD will be able to deploy any NFDV with deployment parameters compatible with this version.
        "version": "1.0.0",
        // The region that the NFDV is published to.
        "publisher_offering_location": "uksouth",
        // Type of Network Function. Valid values are 'cnf' or 'vnf'.
        "type": "cnf"
      }
    }
  ]
}
  • publisher_name – název prostředku publisheru, do kterého chcete svou definici publikovat. Vytvořeno, pokud ještě neexistuje.
  • publisher_resource_group_name – skupina prostředků pro prostředek Publisheru. Vytvořeno, pokud ještě neexistuje. Pro účely tohoto rychlého startu doporučujeme použít stejnou skupinu prostředků, kterou jste použili při publikování definice síťové funkce.
  • acr_artifact_store_name – název prostředku ACR Artifact Store. Vytvořeno, pokud ještě neexistuje.
  • location – Umístění Azure, které se má použít při vytváření prostředků.
  • nsd_name – název skupiny návrhu síťové služby Kolekce verzí Network Service Design. Vytvořeno, pokud ještě neexistuje.
  • nsd_version – verze vytvářené služby NSD. Ve formátu A.B.C.
  • nsdv_description – popis NSDV.
  • resource_element_templates:
    • vydavatel – název vydavatele, pod kterým je tento NFDV publikován.
    • publisher_resource_group – skupina prostředků, ve které je vydavatel hostovaný.
    • name – název existující skupiny definic síťových funkcí, kterou chcete nasadit pomocí této NSD. Pokud publikujete NFDV pomocí rozhraní příkazového řádku, bude to stejné jako název NFDV.
    • version – verze existující definice síťové funkce, na které se tato sada NSD založí. Tento NSD dokáže nasadit jakýkoli NFDV s parametry nasazení kompatibilními s touto verzí.
    • publisher_offering_location – oblast, do které se publikuje NFDV.
    • type – typ síťové funkce. Platné hodnoty jsou cnf nebo vnf.

Sestavení verze návrhu síťové služby (NSDV)

Pomocí následujícího příkazu zahajte proces sestavení pro NSDV:

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

Proces sestavení vygeneruje složku s názvem nsd-cli-output. Po dokončení procesu sestavení zkontrolujte vygenerované soubory a získejte přehled o architektuře a struktuře NSDV a o přidružených prostředcích.

Vytvoří se tyto soubory:

Adresář nebo soubor Popis
nsdDefinition/config-group-schema.json Definuje schéma pro parametry nasazení potřebné k vytvoření služby SNS (Site Network Service) z tohoto NSDV.
nsdDefinition/nginx-nsd-mappings.json Mapuje parametry NSDV na hodnoty požadované pro šablonu ARM NF.
nsdDefinition/deploy.bicep Šablona Bicep pro vytvoření samotného NSDV
Artefakty Obsahuje šablonu bicep pro šablonu ARM NF a seznam artefaktů, které se mají zahrnout do manifestu artefaktů.
artifactManifest/deploy.bicep Šablona Bicep pro vytvoření manifestu artefaktů
base/deploy.bicep Šablona Bicep pro vytvoření vydavatele, skupiny návrhu síťové služby a prostředků úložiště artefaktů

Publikování verze návrhu síťové služby (NSDV)

Pokud chcete publikovat NSDV a související artefakty, zadejte následující příkaz:

az aosm nsd publish --build-output-folder nsd-cli-output

Po dokončení procesu publikování přejděte do skupiny prostředků vydavatele, abyste mohli sledovat a kontrolovat prostředky a artefakty, které byly vytvořeny.

Další kroky