Guida introduttiva: Pubblicare una macchina virtuale Ubuntu come funzione Rete virtuale (VNF)
Questa guida introduttiva descrive come usare l'estensione dell'interfaccia della az aosm riga di comando di Azure per creare e pubblicare una definizione di funzione di rete di base. Lo scopo è illustrare il flusso di lavoro delle risorse di Azure Operator Service Manager (AOSM) del server di pubblicazione. I concetti di base presentati qui sono destinati a preparare gli utenti a creare servizi più interessanti.
Prerequisiti
È necessario un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, seguire le istruzioni riportate qui Iniziare gratuitamente per creare un account prima di iniziare.
Ruolo Collaboratore su questa sottoscrizione per creare un gruppo di risorse o un gruppo di risorse esistente in cui si ha il ruolo Collaboratore.
Si presuppone anche di aver seguito i prerequisiti in Avvio rapido: Completare i prerequisiti per distribuire una funzione di rete virtualizzata in Azure Operator Service Manager
Creare un file di input
Eseguire il comando seguente per generare il file di configurazione di input per la definizione della funzione di rete (NFD).
az aosm nfd generate-config --definition-type vnf
Dopo aver eseguito questo comando, viene generato un file input.json.
Nota
Modificare il file input.json, sostituendolo con i valori mostrati nell'esempio. Salvare il file come input-vnf-nfd.json.
Ecco il file input-vnf-nfd.json di esempio:
{
"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"
}
}
| Variabile | Descrizione |
|---|---|
| publisher_name | Nome della risorsa del server di pubblicazione in cui si vuole pubblicare la definizione. Creato se non esiste. |
| publisher_resource_group_name | Gruppo di risorse per la risorsa del server di pubblicazione. Creato se non esiste. |
| acr_artifact_store_name | Nome della risorsa dell'archivio artefatti del Registro Azure Container. Creato se non esiste. |
| location | Località di Azure da usare durante la creazione di risorse. |
| nf_name | Nome della definizione NF. |
| version | Versione della definizione NF in formato A.B.C. |
| blob_artifact_store_name | Nome della risorsa dell'archivio artefatti dell'account di archiviazione. Creato se non esiste. |
| image_name_parameter | Nome del parametro nel modello di Resource Manager della macchina virtuale che specifica il nome dell'immagine da usare per la macchina virtuale. |
| arm_template | artifact_name: nome dell'artefatto. |
| file_path: facoltativo. Percorso del file dell'artefatto da caricare dal disco locale. Eliminare se non necessario. I percorsi relativi sono relativi al file di configurazione. In Windows viene eseguito l'escape di qualsiasi barra rovesciata con un'altra barra rovesciata. | |
| version: versione dell'artefatto. Per la versione dei modelli arm deve essere in formato A.B.C. | |
| Vhd | artifact_name: nome dell'artefatto. |
| file_path: facoltativo. Percorso del file dell'artefatto da caricare dal disco locale. Eliminare se non necessario. I percorsi relativi sono relativi al file di configurazione. In Windows viene eseguito l'escape di qualsiasi barra rovesciata con un'altra barra rovesciata. | |
| blob_sas_url: facoltativo. URL di firma di accesso condiviso dell'artefatto BLOB che si vuole copiare nell'archivio artefatti. Eliminare se non necessario. | |
| version: versione dell'artefatto. Versione dell'artefatto. Per la versione dei dischi rigidi virtuali deve essere in formato A-B-C. | |
| "image_disk_size_GB: facoltativo. Specifica le dimensioni dei dischi dati vuoti in gigabyte. Questo valore non può essere maggiore di 1023 GB. Eliminare se non necessario. | |
| image_hyper_v_generation: facoltativo. Specifica l'HyperVGenerationType di VirtualMachine creato dall'immagine. I valori validi sono V1 e V2. V1 è l'impostazione predefinita, se non specificata. Eliminare se non necessario. | |
| image_api_version: facoltativo. Versione dell'API ARM usata per creare la risorsa Microsoft.Compute/images. Eliminare se non necessario. |
Nota
Quando si usa l'opzione file_path, è essenziale avere una connessione Internet affidabile con larghezza di banda sufficiente, in quanto la durata del caricamento può variare a seconda delle dimensioni del file.
Importante
Ogni variabile descritta nella tabella precedente deve essere univoca. Ad esempio, il nome del gruppo di risorse non può esistere già e i nomi dell'archivio dell'autore e degli artefatti devono essere univoci nell'area.
Compilare la definizione di funzione di rete (NFD)
Per costruire la definizione della funzione di rete (NFD), avviare il processo di compilazione.
az aosm nfd build -f input-vnf-nfd.json --definition-type vnf
Al termine della compilazione, esaminare i file generati per comprendere meglio la struttura NFD (Network Function Definition).
Questi file vengono creati in una sottodirectory denominata nfd-bicep-ubuntu-template:
| File | Descrizione |
|---|---|
| configMappings | Directory contenente i file che eseguono il mapping dei parametri di distribuzione per la versione di definizione della funzione di rete (NFDV) ai parametri necessari per il modello ARM della macchina virtuale . |
| schemas | Directory contenente file che definiscono i parametri di distribuzione necessari per creare una funzione di rete (NF) da questa versione NFDV (Network Function Definition Version). |
| vnfartifactmanifests.bicep | Modello Bicep per la creazione dei manifesti degli artefatti. |
| Vnfdefinition.bicep | Modello Bicep per la creazione della versione NFDV (Network Function Definition Version). |
Nota
Se sono stati apportati errori, l'unica opzione da correggere consiste nell'eseguire di nuovo il comando con le selezioni appropriate.
Pubblicare la definizione della funzione di rete e caricare gli artefatti
Eseguire il comando seguente per pubblicare la definizione della funzione di rete (NFD) e caricare gli artefatti associati:
az aosm nfd publish -f input-vnf-nfd.json --definition-type vnf
Al termine del comando, esaminare le risorse all'interno del gruppo di risorse del server di pubblicazione per osservare i componenti e gli artefatti creati.
Queste risorse vengono create:
| Nome della risorsa | Tipo di risorsa |
|---|---|
| ubuntu-vm-nfdg | Definizione della funzione di rete. |
| 1.0.0 | Versione della definizione della funzione di rete. |
| ubuntu-publisher | Autore. |
| ubuntu-vm-acr-manifest-1-0-0 | Manifesto dell'artefatto del server di pubblicazione. |
| ubuntu-vm-sa-manifest-1-0-0 | Manifesto dell'artefatto del server di pubblicazione. |
| ubuntu-acr | Archivio artefatti del server di pubblicazione. |
| ubuntu-blob-store | Archivio artefatti del server di pubblicazione. |
Nota
La creazione degli archivi artefatti richiede circa 10 minuti. Se la risorsa esiste già, il processo è notevolmente più veloce.