Share via

Snabbstart: Publicera Ubuntu Virtual Machine (VM) som virtuell nätverksfunktion (VNF)

  • Artikel

Den här snabbstarten az aosm beskriver hur du använder Azure CLI-tillägget för att skapa och publicera en grundläggande definition för nätverksfunktioner. Syftet är att demonstrera arbetsflödet för AOSM-resurserna (Publisher Azure Operator Service Manager). De grundläggande begrepp som presenteras här är avsedda att förbereda användarna för att skapa mer spännande tjänster.

Förutsättningar

Skapa indatafil

Kör följande kommando för att generera indatakonfigurationsfilen för NFD (Network Function Definition).

az aosm nfd generate-config --definition-type vnf

När du kör det här kommandot genereras en input.json-fil.

Kommentar

Redigera filen input.json och ersätt den med de värden som visas i exemplet. Spara filen som input-vnf-nfd.json.

Här är exempel på filen input-vnf-nfd.json:

{ 
    "publisher_name": "ubuntu-publisher", 
    "publisher_resource_group_name": "ubuntu-publisher-rg", 
    "nf_name": "ubuntu-vm", 
    "version": "1.0.0", 
    "acr_artifact_store_name": "ubuntu-acr", 
    "location": "uksouth", 
    "blob_artifact_store_name": "ubuntu-blob-store", 
    "image_name_parameter": "imageName", 
    "arm_template": { 
        "file_path": "ubuntu-template.json", 
        "version": "1.0.0" 
    }, 
    "vhd": { 
        "file_path": "livecd.ubuntu-cpc.azure.vhd", 
        "version": "1-0-0",
        "image_disk_size_GB": 30,
        "image_hyper_v_generation": "V1",
        "image_api_version": "2023-03-01"
    } 
}
Olika beskrivning
publisher_name Namnet på den Publisher-resurs som du vill att definitionen ska publiceras till. Skapas om den inte finns.
publisher_resource_group_name Resursgrupp för Publisher-resursen. Skapas om den inte finns.
acr_artifact_store_name Namnet på resursen ACR Artifact Store. Skapas om den inte finns.
Plats Azure-plats att använda när du skapar resurser.
nf_name Namn på NF-definition.
Version Version av NF-definitionen i A.B.C-format.
blob_artifact_store_name Namnet på lagringskontot Artifact Store-resursen. Skapas om den inte finns.
image_name_parameter Parameternamnet i ARM-mallen för den virtuella datorn som anger namnet på avbildningen som ska användas för den virtuella datorn.
arm_template artifact_name: Artefaktens namn.
file_path: Valfritt. Filsökväg för artefakten som du vill ladda upp från den lokala disken. Ta bort om det inte behövs. Relativa sökvägar är relativa till konfigurationsfilen. I Windows slipper du omvänt snedstreck med ett annat omvänt snedstreck.
version: Version av artefakten. För ARM-mallar måste versionen vara i formatet A.B.C.
Vhd artifact_name: Artefaktens namn.
file_path: Valfritt. Filsökväg för artefakten som du vill ladda upp från den lokala disken. Ta bort om det inte behövs. Relativa sökvägar är relativa till konfigurationsfilen. I Windows slipper du omvänt snedstreck med ett annat omvänt snedstreck.
blob_sas_url: Valfritt. SAS-URL:en för blobartefakten som du vill kopiera till artefaktarkivet. Ta bort om det inte behövs.
version: Version av artefakten. Version av artefakten. För VHD-version måste vara i formatet A-B-C.
"image_disk_size_GB: Valfritt. Anger storleken på tomma datadiskar i gigabyte. Det här värdet får inte vara större än 1 023 GB. Ta bort om det inte behövs.
image_hyper_v_generation: Valfritt. Anger HyperVGenerationType för VirtualMachine som skapats från avbildningen. Giltiga värden är V1 och V2. V1 är standardvärdet om det inte anges. Ta bort om det inte behövs.
image_api_version: Valfritt. ARM API-versionen som används för att skapa resursen Microsoft.Compute/images. Ta bort om det inte behövs.

Kommentar

När du använder alternativet file_path är det viktigt att ha en tillförlitlig Internetanslutning med tillräcklig bandbredd, eftersom uppladdningstiden kan variera beroende på filstorleken.

Viktigt!

Varje variabel som beskrivs i föregående tabell måste vara unik. Resursgruppens namn kan till exempel inte redan finnas, och namn på utgivare och artefaktarkiv måste vara unika i regionen.

Skapa nätverksfunktionsdefinitionen (NFD)

Om du vill skapa NFD (Network Function Definition) initierar du byggprocessen.

az aosm nfd build -f input-vnf-nfd.json --definition-type vnf

När bygget är klart undersöker du de genererade filerna för att bättre förstå NFD-strukturen (Network Function Definition).

Dessa filer skapas i en underkatalog med namnet nfd-bicep-ubuntu-template:

Fil beskrivning
configMappings Katalog som innehåller filer som mappar distributionsparametrarna för NFDV (Network Function Definition Version) till de parametrar som krävs för ARM-mallen för virtuell dator (VM).
Scheman Katalog som innehåller filer som definierar de distributionsparametrar som krävs för att skapa en nätverksfunktion (NF) från den här NFDV-versionen (Network Function Definition Version).
vnfartifactmanifests.bicep Bicep-mall för att skapa artefaktmanifesten.
Vnfdefinition.bicep Bicep-mall för att skapa själva NFDV-versionen (Network Function Definition Version).

Kommentar

Om fel har gjorts är det enda alternativet att korrigera att köra kommandot igen med rätt val.

Publicera nätverksfunktionsdefinitionen och ladda upp artefakter

Kör följande kommando för att publicera NFD (Network Function Definition) och ladda upp de associerade artefakterna:

az aosm nfd publish -f input-vnf-nfd.json --definition-type vnf

När kommandot har slutförts kontrollerar du resurserna i publisher-resursgruppen för att se de skapade komponenterna och artefakterna.

Dessa resurser skapas:

Resursnamn Resurstyp
ubuntu-vm-nfdg Definition av nätverksfunktion.
1.0.0 Definitionsversion för nätverksfunktion.
ubuntu-publisher Utgivare.
ubuntu-vm-acr-manifest-1-0-0 Publisher Artifact Manifest.
ubuntu-vm-sa-manifest-1-0-0 Publisher Artifact Manifest.
ubuntu-acr Publisher Artifact Store.
ubuntu-blob-store Publisher Artifact Store.

Kommentar

Det tar cirka 10 minuter att skapa artefaktarkiven. Om resursen redan finns är processen betydligt snabbare.

Nästa steg