將容器化網路功能（CNF）上線至 Azure 操作員服務管理員（AOSM）

發行項
05/22/2024

在本操作指南中，網路函式發行者和服務設計工具會瞭解如何使用 Azure CLI AOSM 擴充功能將容器化網路函式上線至 AOSM。 CNF 稍後可以部署到 Azure Arc 連線的 Kubernetes 叢集，包括 Azure 操作員 Nexus 叢集。

上線是一個多步驟的程式。一旦符合必要條件，您將使用 Azure CLI AOSM 擴充功能來：

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

必要條件

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

注意

強烈建議您在目標 Arc 連線的 Kubernetes 環境中測試 helm install Helm 套件的成功。

設定權限

您需要訂用帳戶的參與者角色，才能建立資源群組，或具有參與者角色的現有資源群組。
您需要來源 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 服務的嚴格範圍許可權，協調本機計算機的雙步驟複本。此雙步驟複製速度較慢，但不需要訂用帳戶範圍許可權。

Helm 套件

您要上線的 Helm 套件必須存在於您執行 CLI 的電腦本機記憶體上。
- 根據預設，Azure CLI AOSM 擴充功能會使用 values.yaml helm 套件中的檔案。 CLI 支援使用替代 values.yaml的覆寫此行為。此替代檔案必須存在於您執行 CLI 的電腦本機記憶體上。

注意

強烈建議 Helm 套件包含 helm 值的架構，以及當使用您打算在上線至 AOSM 時使用 values.yaml 執行時 helm template 所預期的 helm 套件範本。

容器映像

您的容器映像存在於現有的 ACR 或支援 Docker API 的替代容器登錄中。容器映像必須儲存在來源登錄中，結構中符合您 helm 圖表中定義的映像位置。 CLI CNF 映像探索和上傳中會說明這項需求。
docker login使用命令登入裝載容器映射的非 Azure 容器登錄，再執行任何az aosm命令。如果您使用 ACR，則不需要此步驟：Azure CLI AOSM 擴充功能會自動登入。

Helm 和 Docker 引擎

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

下載並安裝 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 環境。

安裝 AOSM CLI 擴充功能

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

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

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

az extension add --name aosm

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

此步驟會在工作目錄中 cnf-cli-output 建立名為的資料夾，其中包含AOSM資源的BICEP 範本，這些範本會定義您的網路函式定義群組和版本，以及成品存放區。這些資源最終會包含在您的網路服務設計中。

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

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

開啟您在上一個步驟中產生的輸入檔，並使用內嵌批注來輸入必要的值。此範例顯示虛構 Contoso CNF 的 Az CLI AOSM 延伸模組輸入檔。

注意

Azure CLI AOSM 擴充功能只會公開必要的參數，而預設不會在輸入 values.yaml 中公開預設值。您可以設定 expose_all_parameters 為 true ，以公開網路函數定義版本（NFDV）和組態群組架構（CGS）中的所有 helm 值。如需詳細資訊，請參閱使用 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.
  // You should create this before running the publish command
  "publisher_resource_group_name": "contoso",
  // Name of the ACR Artifact Store resource.
  // Will be created if it does not exist.
  "acr_artifact_store_name": "contoso-artifact-store",
  // Name of NF definition.
  "nf_name": "contoso-cnf-nfd",
  // Version of the NF 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,
  // List of registries from which to pull the image(s).
  // For example ["sourceacr.azurecr.io/test", "myacr2.azurecr.io", "ghcr.io/path"].
  // For non Azure Container Registries, ensure you have run a docker login command before running build.
  "image_sources": ["contoso.azuercr.io/contoso", "docker.io"],
  // List of Helm packages to be included in the CNF.
  "helm_packages": [
      {
          // The name of the Helm package.
          "name": "contoso-helm-package",
          // The file path to the helm chart on the local disk, relative to the directory from which the command is run.
          // Accepts .tgz, .tar or .tar.gz, or an unpacked directory. Use Linux slash (/) file separator even if running on Windows.
          "path_to_chart": "/home/cnf-onboard/contoso-cnf-helm-chart-0-1-0.tgz",
          // The file path (absolute or relative to this configuration file) of YAML values file on the local disk which will be used instead of the values.yaml file present in the helm chart.
          // Accepts .yaml or .yml. Use Linux slash (/) file separator even if running on Windows.
          "default_values": "",
      }
  ]
}

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

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

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

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

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

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

注意

如果您使用 Windows，您必須在發佈步驟期間執行 Docker Desktop。

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

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

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

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

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

開啟您在上一個步驟中產生的輸入檔，並使用內嵌批注來輸入必要的值。產生的輸入檔包含另 resource_element_type 一種類型 ArmTemplate。在上線 CNF 時，這是不必要的;您可以刪除它。結果看起來應該像這個範例。此範例顯示虛構 Contoso NSD 的 Az CLI AOSM 延伸模組輸入檔，可用來將虛構的 Contoso CNF 部署到 Arc 連接的 Nexus Kubernetes 叢集。

{
    // 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",
    // Name of the ACR Artifact Store resource.
    // Will be created if it does not exist.
    "acr_artifact_store_name": "contoso-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-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-cnf 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",
                // 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-cnf-nfd",
                // 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": "cnf"
            }
        }
    ]
}

注意

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

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

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

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

發佈網路服務設計群組和版本

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

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

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

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

共用方式為

將容器化網路功能（CNF）上線至 Azure 操作員服務管理員（AOSM）

必要條件

設定權限

Helm 套件

容器映像

Helm 和 Docker 引擎

下載並安裝 Azure CLI

安裝 AOSM CLI 擴充功能

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

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

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

發佈網路服務設計群組和版本

下一步

意見反應

其他資源

共用方式為

將容器化網路功能 （CNF） 上線至 Azure 操作員服務管理員 （AOSM）

必要條件

設定權限

Helm 套件

容器映像

Helm 和 Docker 引擎

下載並安裝 Azure CLI

安裝 AOSM CLI 擴充功能

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

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

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

發佈網路服務設計群組和版本

下一步

意見反應

其他資源

將容器化網路功能（CNF）上線至 Azure 操作員服務管理員（AOSM）