將虛擬網路函式（VNF）上架，以在 Azure 操作員 Nexus 上部署至 Azure 操作員服務管理員（AOSM）

發行項
05/22/2024

在本操作指南中，網路函式發行者和服務設計工具會瞭解如何使用 Azure CLI AOSM 擴充功能將虛擬化網路函式上線至 AOSM。此 VNF 後續可以在 Azure 操作員 Nexus 上部署。上線是一個多步驟的程式。一旦符合必要條件，您將使用 Azure CLI AOSM 擴充功能來：

產生 BICEP 檔案，以定義網路函式定義群組和版本（NFD）。
發佈 NFD 並將 VNF 映射上傳至成品存放區（AOSM 管理的 Azure Container Registry （ACR））。
將已發佈的 NFD 新增至 BICEP 檔案，以定義網路服務設計群組和版本（NSD）。
發佈 NSD。

必要條件

您可以存取 Azure 操作員 Nexus 實例，並已完成工作負載部署的必要條件。
您已在 Azure 訂用帳戶上啟用 AOSM。

注意

強烈建議您在將 VNF 上線至 AOSM 之前，先測試 VM 部署在 Azure 操作員 Nexus 實例上成功。

Azure 操作員 Nexus 虛擬機（VM）映射和 Azure Resource Manager （ARM）範本

您已建立 Azure 操作員 Nexus 虛擬機的映像。此映像必須可在 ACR 中使用。
您已建立部署 Azure 操作員 Nexus 虛擬機的 ARM 範本。
VM ARM 範本（適用於 AzureCore 和 Azure 操作員 Nexus）只能從下列資源提供者部署 ARM 資源
- Microsoft.Compute
- Microsoft.Network
- Microsoft.NetworkCloud
- Microsoft.Storage
- Microsoft.NetworkFabric
- Microsoft.Authorization
- Microsoft.ManagedIdentity
VNF ARM 範本應該部署一個 VM。您可以藉由在 NSDV 中包含多個 NFDV 實例來部署多個 VM。

設定權限

您需要訂用帳戶的參與者角色，才能建立資源群組，或具有參與者角色的現有資源群組。
您需要來源 Reader/AcrPull ACR 上包含映像的角色指派。
您需要訂 Contributor 用帳戶上的和 AcrPush 角色指派，其中包含AOSM受控成品存放區。這些許可權可讓 Azure CLI AOSM 擴充功能執行直接 ACR 對 ACR 複製。直接複製是將影像從一個 ACR 傳輸到另一個 ACR 的最快速方法。
- 您的公司原則可能會防止您擁有訂用帳戶範圍的許可權。 --no-subscription-permissions和 az aosm nsd publish 命令上az aosm nfd publish可用的參數會使用衍生自 AOSM 服務的嚴格範圍許可權，協調本機計算機的雙步驟複本。此雙步驟複製速度較慢，但不需要訂用帳戶範圍許可權。

下載並安裝 Azure CLI

若要在本機安裝 Azure CLI，請參閱如何安裝 Azure CLI。

若要登入 Azure CLI，請使用 az login 命令並完成終端機中顯示的提示以完成驗證。如需更多登入選項，請參閱使用 Azure CLI 登入。

注意

若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。您也可以在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱在 Azure Cloud Shell 中啟動 Cloud Shell 以使用 Bash 環境。

Helm 和 Docker 引擎

在主電腦上安裝 Helm CLI 。您必須使用 Helm v3.8.0 或更新版本。
在主電腦上安裝 Docker。

安裝 AOSM CLI 擴充功能

Az CLI AOSM 擴充功能需要 Azure CLI 2.54.0 版或更新版本。

執行 az version 以查看已安裝的版本和相依連結庫。
執行 az upgrade 以升級至目前版本的 Azure CLI。

使用此指令安裝 AOSM CLI 擴充功能：

az extension add --name aosm

建置網路函式定義群組和版本

本節會在工作目錄中建立一個資料夾，該資料夾會使用 vnf-cli-output AOSM 資源的 BICEP 範本來定義您的網路函式定義群組和版本，以及成品存放區。這些資源最終會包含在您的網路服務設計中

產生 VNF 的 Azure CLI AOSM 擴充功能輸入檔。

az aosm nfd generate-config --definition-type vnf-nexus --output-file <filename.jsonc>

開啟您在上一個步驟中產生的輸入檔，並使用內嵌批注來輸入必要的值。此範例示範在 Azure 操作員 Nexus 上執行的虛構 Contoso VNF Az CLI AOSM 擴充功能輸入檔。

注意

根據預設，Azure CLI AOSM 擴充功能只會公開輸入 ARM 範本中沒有預設值的必要參數。您可以設定 expose_all_parameters 為 true ，以公開網路函式定義版本（NFDV）和組態群組架構（CGS）中的所有 ARM 樣本參數。如需詳細資訊，請參閱使用 AOSM CLI 擴充功能公開參數。

{
    // Azure location to use when creating resources e.g uksouth
    "location": "eastus",
    // Name of the Publisher resource you want your definition published to.
    // Will be created if it does not exist.
    "publisher_name": "contoso",
    // Resource group for the Publisher resource.
    // Will be created if it does not exist.
    "publisher_resource_group_name": "contoso-vnf",
    // Name of the ACR Artifact Store resource.
    // Will be created if it does not exist.
    "acr_artifact_store_name": "contoso-vnf-artifact-store",
    // Name of the network function.
    "nf_name": "contoso-vnf",
    // 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,
    // 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": "contoso-vnf",
            // 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": "/home/contoso-vnf/contoso-vnf-arm-template.json"
        }
    ],
    // List of images to be pulled from the acr registry.
    // You must provide the source acr registry, the image name and the version.
    // For example: 'sourceacr.azurecr.io/imagename:imageversion'.
    "images": ["contoso-vnf.azurecr.io/contosovnf:1.0.0"]
}```

執行下列命令來建置網路函式定義群組和版本。

az aosm nfd build --definition-type vnf-nexus --config-file <filename.jsonc>

發佈網路函式定義群組和版本

此步驟會建立 AOSM 資源，以定義網路函式定義，以及將用來儲存網路函式 VM 映射的成品存放區。它也會藉由直接從來源 ACR 複製映像至成品存放區，或者，如果您沒有訂用帳戶範圍 Contributor 和 AcrPush 角色，請在本機重新標記 Docker 映像，並使用 AOSM 服務所產生的嚴格範圍認證上傳至成品存放區。

執行下列命令以發佈網路函式定義群組和版本。如果您沒有訂用帳戶範圍 Contributor 和 AcrPush 角色， --no-subscription-permissions 請在命令中包含。

az aosm nfd publish --build-output-folder vnf-cli-output --definition-type vnf

您可以檢視資料夾和檔案結構，並視需要進行修改。

建置網路服務設計群組和版本

本節會在名為 nsd-cli-output的工作目錄中建立資料夾。此資料夾包含定義網路服務設計群組和版本之 AOSM 資源的 BICEP 範本。此網路服務設計是網站網路服務資源中使用的範本，會部署您在上一節中上線的網路功能。

產生 Azure CLI AOSM 擴充功能 NSD 輸入檔。

az aosm nsd generate-config --output-file <nsd-output-filename.jsonc>

開啟您在上一個步驟中產生的輸入檔，並使用內嵌批注來輸入必要的值。產生的輸入檔包含另 resource_element_type 一種類型 ArmTemplate。上線 VNF 時不需要這樣做;您可以刪除它。此範例示範虛構 Contoso NSD 的 Az CLI AOSM 延伸模組輸入檔，可用來將虛構的 Contoso VNF 部署到 Azure 操作員 Nexus 實例。

{
    // Azure location to use when creating resources e.g uksouth
    "location": "eastus",
    // Name of the Publisher resource you want your definition published to.
    // Will be created if it does not exist.
    "publisher_name": "contoso",
    // Resource group for the Publisher resource.
    // Will be created if it does not exist.
    "publisher_resource_group_name": "contoso-vnf",
    // Name of the ACR Artifact Store resource.
    // Will be created if it does not exist.
    "acr_artifact_store_name": "contoso-vnf-artifact-store",
    // Network Service Design (NSD) name. This is the collection of Network Service Design Versions. Will be created if it does not exist.
    "nsd_name": "contoso-vnf-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": "An NSD that deploys the onboarded contoso-vnf NFD",
    // 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": "contoso",
                // The resource group that the publisher is hosted in.
                "publisher_resource_group": "contoso-vnf",
                // 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": "contoso-vnf",
                // 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": "eastus",
                // Type of Network Function. Valid values are 'cnf' or 'vnf'.
                "type": "vnf"
            }
        }
    ]
}

注意

資源元素範本區段會定義NSD中包含哪些NFD。屬性必須符合傳遞至 az aosm nfd build 命令之輸入檔中使用的屬性。這是因為 Azure CLI AOSM 擴充功能會驗證建置 NSD 時，NFD 是否已正確上線。

執行下列命令來建置網路服務設計群組和版本 BICEP 範本。

az aosm nsd build --config-file <nsd-output-filename.jsonc>

您可以檢視資料夾和檔案結構，並視需要進行修改。

發佈網路服務設計（NSD）

此步驟會建立 AOSM 資源，以定義網路服務設計群組和版本。它也會將 NSD 所需的成品上傳至成品存放區（網路函式 ARM 範本）。

執行下列命令以發佈網路服務設計群組和版本。如果您沒有訂用帳戶範圍 Contributor 和 AcrPush 角色， --no-subscription-permissions 請在命令中包含。

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

您現在有一組完整的 AOSM 發行者資源，並準備好執行操作員流程。

共用方式為

將虛擬網路函式（VNF）上架，以在 Azure 操作員 Nexus 上部署至 Azure 操作員服務管理員（AOSM）

必要條件

Azure 操作員 Nexus 虛擬機（VM）映射和 Azure Resource Manager （ARM）範本

設定權限

下載並安裝 Azure CLI

Helm 和 Docker 引擎

安裝 AOSM CLI 擴充功能

建置網路函式定義群組和版本

發佈網路函式定義群組和版本

建置網路服務設計群組和版本

發佈網路服務設計（NSD）

下一步

意見反應

其他資源

共用方式為

將虛擬網路函式 （VNF） 上架，以在 Azure 操作員 Nexus 上部署至 Azure 操作員服務管理員 （AOSM）

必要條件

Azure 操作員 Nexus 虛擬機 （VM） 映射和 Azure Resource Manager （ARM） 範本

設定權限

下載並安裝 Azure CLI

Helm 和 Docker 引擎

安裝 AOSM CLI 擴充功能

建置網路函式定義群組和版本

發佈網路函式定義群組和版本

建置網路服務設計群組和版本

發佈網路服務設計 （NSD）

下一步

意見反應

其他資源

將虛擬網路函式（VNF）上架，以在 Azure 操作員 Nexus 上部署至 Azure 操作員服務管理員（AOSM）

Azure 操作員 Nexus 虛擬機（VM）映射和 Azure Resource Manager （ARM）範本

發佈網路服務設計（NSD）