Avvio rapido: Pubblicare una macchina virtuale Ubuntu come funzione di rete virtualizzata

Questa guida introduttiva descrive come usare l'estensione dell'interfaccia della riga di comando di Azure az aosm per creare e pubblicare la definizione di una 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 qui presentati hanno lo scopo di preparare gli utenti nella creazione di servizi più interessanti.

Prerequisiti

• È richiesto un account Azure con una sottoscrizione attiva. Se non si dispone di una sottoscrizione di Azure, seguire le istruzioni riportate qui Iniziare gratuitamente per creare un account prima di iniziare.

• Seguire l’Avvio rapido: Completare i prerequisiti per distribuire una funzione di rete virtualizzata in Azure Operator Service Manager

• Gruppo di risorse esistente in cui si ha il ruolo Collaboratore, o ruolo di Collaboratore per questa sottoscrizione in modo che l'estensione dell'interfaccia della riga di comando di AOSM possa creare il gruppo di risorse.

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 vnf-input.jsonc.

Ecco un file input-vnf-nfd.jsonc di esempio:

{
  // 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.
  // Will be created if it does not exist
  "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",
  // Name of the network function.
  "nf_name": "ubuntu-vm",
  // Version of the network function definition in 1.1.1 format (three integers separated by dots).
  "version": "1.0.0",
  // If set to true, all NFD configuration parameters are made available to the designer, including optional parameters and those with defaults.
  // If not set or set to false, only required parameters without defaults will be exposed.
  "expose_all_parameters": false,
  // Optional. Name of the storage account Artifact Store resource.
  // Will be created if it does not exist (with a default name if none is supplied).
  "blob_artifact_store_name": "ubuntu-blob-store",
  // ARM template configuration. The ARM templates given here would deploy a VM if run. They will be used to generate the VNF.
  "arm_templates": [
    {
      // Name of the artifact. Used as internal reference only.
      "artifact_name": "ubuntu-template",
      // Version of the artifact in 1.1.1 format (three integers separated by dots).
      "version": "1.0.0",
      // File path (absolute or relative to this configuration file) of the artifact you wish to upload from your local disk.
      // Use Linux slash (/) file separator even if running on Windows.
      "file_path": "ubuntu-template.json"
    }
  ],
  // VHD image configuration.
  "vhd": {
    // Optional. Name of the artifact. Name will be generated if not supplied.
    "artifact_name": "",
    // Version of the artifact in A-B-C format. Note the '-' (dash) not '.' (dot).
    "version": "1-0-0",
    // Supply either file_path or blob_sas_url, not both.
    // File path (absolute or relative to this configuration file) of the artifact you wish to upload from your local disk.
    // Leave as empty string if not required. Use Linux slash (/) file separator even if running on Windows.
    "file_path": "livecd.ubuntu-cpc.azure.vhd",
    // Optional. Specifies the size of empty data disks in gigabytes.
    // This value cannot be larger than 1023 GB. Delete if not required.
    "image_disk_size_GB": "30",
    // Optional. Specifies the HyperVGenerationType of the VirtualMachine created from the image.
    // Valid values are V1 and V2. V1 is the default if not specified. Delete if not required.
    "image_hyper_v_generation": "V1",
    // Optional. The ARM API version used to create the Microsoft.Compute/images resource.
    // Delete if not required.
    "image_api_version": "2023-03-01"
  }
}

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 --config-file input-vnf-nfd.jsonc --definition-type vnf

Al termine della compilazione, esaminare i file generati per comprendere meglio la struttura della definizione della funzione di rete.

Questi file vengono creati in una sottodirectory denominata vnf-cli-output:

Pubblicare la definizione della funzione di rete e caricare gli artefatti

Eseguire il comando seguente per pubblicare la definizione della funzione di rete e caricare gli artefatti associati:

az aosm nfd publish --build-output-folder vnf-cli-output --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.

Vengono create queste risorse:

Passaggi successivi

• Avvio rapido: Progettare un servizio di rete per la funzione di rete virtualizzata