快速入門:使用 Nginx 設計容器化網路功能 (CNF) 網路服務設計
本快速入門說明如何使用 az aosm
Azure CLI 擴充功能來建立及發佈基本網路服務設計。
必要條件
- 需要具有作用中訂用帳戶的 Azure 帳戶。 如果您沒有 Azure 訂用帳戶,請依照此處 的指示開始免費 建立帳戶,再開始。
- 完成快速入門:將 Nginx 容器發佈為容器化網路函式 (CNF)。
建立輸入檔
建立用於發佈網路服務設計的輸入檔。 執行下列命令來產生網路服務設計 (NSD) 的輸入組態檔。
az aosm nsd generate-config
執行上述命令會產生 input.json 檔案。
注意
編輯 input.json 檔案。 將它取代為範例中顯示的值。 將檔案儲存為 input-cnf-nsd.json。
以下是範例 input-cnf-nsd.json:
{
"publisher_name": "nginx-publisher",
"publisher_resource_group_name": "nginx-publisher-rg",
"acr_artifact_store_name": "nginx-nsd-acr",
"location": "uksouth",
"network_functions": [
{
"publisher": "nginx-publisher",
"publisher_resource_group": "nginx-publisher-rg",
"name": "nginx-nfdg",
"version": "1.0.0",
"publisher_offering_location": "uksouth",
"type": "cnf",
"multiple_instances": false
}
],
"nsd_name": "nginx-nsdg",
"nsd_version": "1.0.0",
"nsdv_description": "Deploys a basic NGINX CNF"
}
- publisher_name - 您要發佈定義之發行者資源的名稱。 如果它不存在,則建立。
- publisher_resource_group_name - 發行者資源的資源群組。 如果它不存在,則建立。 在本快速入門中,建議您使用發佈網路函式定義時所使用的相同資源群組。
- acr_artifact_store_name - ACR 成品存放區資源的名稱。 如果它不存在,則建立。
- location - 建立資源時要使用的 Azure 位置。
- network_function:
- publisher - 此 NFDV 發行者的名稱。
- publisher_resource_group - 發行者裝載的資源群組。
- name - 使用此 NSD 部署的現有網路函數定義群組名稱。
- version - 要以此 NSD 為基礎的現有網路函式定義版本。 此 NSD 能夠部署任何與這個版本相容的部署參數的 NFDV。
- publisher_offering_location - 發佈 NFDV 的區域。
- type - 網路函式的類型。 有效值為 cnf 或 vnf。
- multiple_instances - 有效值為 true 或 false。 控制 NSD 是否應該允許這種 NF 類型的任意數位。 如果設定為 false,則只允許單一實例。 僅支援 VNF。 對於 CNF,此值必須設定為 false。
- nsd_name - 網路服務設計組名。 網路服務設計版本的集合。 如果它不存在,則建立。
- nsd_version - 要建立的 NSD 版本。 以 A.B.C 的格式表示。
- nsdv_description - NSDV 的描述。
建置網路服務設計 (NSD)
使用下列命令起始網路服務定義 (NSD) 的建置程式:
az aosm nsd build -f input-cnf-nsd.json
建置程式完成之後,請檢閱產生的檔案,以深入瞭解 NSD 的架構和結構。
這些檔案會建立:
Files | 描述 |
---|---|
artifact_manifest.bicep | 用於建立發行者和成品存放區的 bicep 範本。 |
configMappings | 將組態群組值輸入轉換為每個NF所需的部署參數。 |
nsd_definition.bicep | 用於建立 NSDV 本身的 bicep 範本。 |
schemas | 定義此 NSDV 設定群組值所需的輸入。 |
nginx-nfdg_nf.bicep | 用於部署 NF 的 bicep 範本。 上傳至成品存放區。 |
發佈網路服務設計 (NSD)
若要發佈網路服務設計 (NSD) 及其相關聯的成品,請發出下列命令:
az aosm nsd publish -f input-cnf-nsd.json
當發佈程式完成時,流覽至您的發行者資源群組,以觀察並檢閱產生的資源和成品。