Rychlý start: Návrh návrhu síťové služby (NSD) pro virtuální počítač s Ubuntu jako virtualizované síťové funkce (VNF)
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
Vyžaduje se účet Azure s aktivním předplatným. Pokud nemáte předplatné Azure, postupujte podle pokynů uvedených tady , abyste si mohli vytvořit účet, než začnete.
Musíte postupovat podle požadavků v rychlém startu: Publikování virtuálního počítače s Ubuntu jako funkce virtuální sítě (VNF).
Vytvoření vstupního souboru
Vytvořte vstupní soubor pro publikování návrhu síťové služby. Spuštěním následujícího příkazu vygenerujte vstupní konfigurační soubor pro návrh síťové služby (NSD).
az aosm nsd generate-config
Při nsd-input.jsonc spuštění tohoto příkazu se vygeneruje soubor.
Poznámka:
Upravte soubor nsd-input.jsonc a nahraďte ho hodnotami zobrazenými v ukázce. Odeberte oddíl, ve kterém je resource_element_type nastavená na ArmTemplate. Jde o přidání infrastruktury (například virtuálních sítí) do složitějších disků NSD, které není v tomto rychlém startu potřeba. Uložte soubor jako input-vnf-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).
{
// 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": "ubuntu-publisher",
// Resource group for the Publisher resource.
// You should create this before running the publish command.
"publisher_resource_group_name": "ubuntu-publisher-rg",
// Name of the ACR Artifact Store resource.
// Will be created if it does not exist.
"acr_artifact_store_name": "ubuntu-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": "ubuntu-nsd",
// 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": "Plain ubuntu VM",
// 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": "ubuntu-publisher",
// The resource group that the publisher is hosted in.
"publisher_resource_group": "ubuntu-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": "ubuntu-vm",
// 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": "vnf"
}
}
]
}
| Proměnná | Popis |
|---|---|
| publisher_name | Název prostředku publisheru, do kterého chcete definici publikovat. Vytvořeno, pokud neexistuje. |
| publisher_resource_group_name | Skupina prostředků pro prostředek Publisheru Vytvořeno, pokud neexistuje. |
| acr_artifact_store_name | Název prostředku úložiště artefaktů Azure Container Registry (ACR). Vytvořeno, pokud neexistuje. |
| location | Umístění Azure, které se má použít při vytváření prostředků. |
| síťové funkce | vydavatel: Název vydavatele, pod kterým je publikována tato verze definice síťové funkce (NFDV). |
| 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. | |
| verze: Verze existující definice síťové funkce, na které má být tato sada NSD založená. 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. | |
| nsd_name | Název skupiny návrhu síťové služby Kolekce verzí návrhu síťových služeb. Vytvořeno, pokud neexistuje. |
| nsd_version | Verze NSD, která se má vytvořit. Formát by měl být A.B.C. |
| nsdv_description | Popis NSDV. |
Sestavení návrhu síťové služby (NSD)
Pomocí následujícího příkazu zahajte proces sestavení pro návrh síťové služby (NSD):
az aosm nsd build --config-file input-vnf-nsd.jsonc
Po dokončení procesu sestavení si projděte následující vygenerované soubory a získejte přehled o architektuře a struktuře NSD.
Tyto soubory se vytvářejí v podadresáři s názvem nsd-cli-output:
| Adresář / soubor | Popis |
|---|---|
| nsd-cli-output/artifactManifest | |
| deploy.bicep | Šablona Bicep pro vytvoření manifestu artefaktů s artefakty vyplněnými ze vstupního souboru |
| nsd-cli-output/artifacts | |
| artifacts.json | Seznam artefaktů (obrázků a šablon ARM), které se mají nahrát při publikování Koreluje s manifestem artefaktu. |
| <nf-name.bicep> | Šablona Bicep pro NF (Network Function) RET poskytovaná ve vstupním souboru pro nasazení NF. Tato šablona se při spuštění příkazu publish převede na šablonu ARM a nahraje se do úložiště artefaktů. |
| nsd-cli-output/base | |
| deploy.bicep | Šablona Bicep pro vytvoření skupiny návrhů vydavatele, účtů úložiště a síťových služeb sdílených všemi skupinami NSD této skupiny NSD |
| nsd-cli-output/nsdDefinition | |
| deploy.bicep | Šablona Bicep pro vytvoření verze návrhu síťové služby (NSDV). Tato šablona obsahuje podřízené šablony elementů prostředků, které pocházejí z publikovaných NF nebo šablon ARM (pro infrastrukturu) definovaných v souboru nsd-input.jsonc. |
| config-group-schema.json | Kombinované schéma skupiny konfigurace pro všechny NF v tomto NSDV. Toto schéma definuje vstupy, které operátor musí zadat v hodnotách konfigurační skupiny při nasazování NSDV jako součást síťové služby lokality (SNS). |
| <název nf>-mappings.json | Soubor, který mapuje hodnoty konfigurační skupiny poskytnuté operátorem na parametry nasazení definované v NSDV. Ve vašem NSDV je jeden na NF. |
| nsd-cli-output | |
| all_deploy.parameters.json | Nadmnožina všech parametrů nasazení NF poskytuje jeden soubor pro přizpůsobení názvů prostředků. Hodnoty výstupu tohoto souboru příkazem build jsou převzaty ze souboru nsd-input.jsonc. Hodnoty v tomto souboru můžete před spuštěním publikování upravit, například publikovat do jiného umístění nebo použít jiný název vydavatele. |
| index.json | Soubor používaný interně při publikování prostředků. Neupravovat |
Publikování návrhu síťové služby (NSD)
Pokud chcete publikovat návrh síťové služby (NSD) a související artefakty, zadejte následující příkaz:
az aosm nsd publish --build-output-folder nsd-cli-output
Přejděte do skupiny prostředků vydavatele, abyste mohli sledovat a kontrolovat prostředky a artefakty, které byly vytvořeny.
Vytvoří se tyto prostředky:
| Název prostředku | Typ prostředku |
|---|---|
| ubuntu-nsd | Návrh síťové služby. |
| 1.0.0 (ubuntu-nsd/1.0.0) | Verze návrhu síťové služby. |
| ubuntu-nsd-nsd-manifest-1-0-0 | Manifest artefaktů vydavatele. |
| ConfigGroupSchema | Schéma skupiny konfigurace. |