Azure Operatör Hizmet Yöneticisi (AOSM) CLI uzantısını kullanarak parametre kullanımı hakkında

  • Makale

Bu belgede, Azure Operatör Hizmet Yöneticisi (AOSM) Azure CLI uzantısının ARM şablonlarındaki helm değerlerini ve parametrelerini bir işlecin kullanımına sunulan bir yapılandırma modeline nasıl çevirdiği açıklanmaktadır.

Background

AOSM, Ağ İşlevi Tanım Sürümünün (NFDV) yayımcısının Ağ İşlevi 'ni (NF) dağıtırken hangi parametrelerin yapılandırılabilir olduğunu seçmesine olanak tanır. AOSM, Ağ Hizmeti Tasarım Sürümü (NSDV) tasarımcısının Site Ağ Hizmeti'ni (SNS) dağıtırken hangi parametrelerin yapılandırılabilir olduğunu seçmesine de olanak tanır.

Hangi parametrelerin kullanıma sunulduğu seçimi bir veya daha fazla şemada kodlanır. Yayımcı, şemayı NFDV'nin ( deployParameters özelliği) bir özelliğinde tanımlar; tasarımcı şemayı ayrı bir Azure kaynağında tanımlar: Yapılandırma Grubu Şeması (CGS). CGS ve NSDV, NFDV'deki şemayla eşleşen bir dizi parametre ve değeri NFDV'ye geçirmelidir.

Azure CLI AOSM uzantısı NFDV deployParameters özelliğinin, CGS'nin ve tüm parametrelerin dağıtım zamanında NF'ye doğru şekilde geçirilmesini sağlayan eşlemelerin otomatik oluşturulması için destek içerir.

Giriş dosyası yapılandırması

Azure CLI AOSM uzantısı az aosm nfd generate-config komutu bir giriş dosyası oluşturur. Giriş dosyası parametresine --definition-type göre değişir. Tüm değişkenler aşağıdaki parametreyi içerir:

  // 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,

Bu parametre, AOSM CLI uzantısında parametre açığa çıkarma davranışını denetler.

Uyarı

Tüm parametreleri açığa çıkartarak tüm varsayılan değerlerinizi de ortaya çıkartmış olursunuz. Varsayılanlarınızın herhangi bir hassas bilgi içermediğinden emin olun.

Varsayılan davranış

expose_all_parameters her zaman varsayılan olarak olarak ayarlanır false . The AOSM CLI:

  • Kapsayıcılı Ağ İşlevi (CNF) helm değerlerini veya Sanallaştırılmış Ağ İşlevi (VNF) Azure Resource Manager (ARM) şablon parametrelerini ayrıştırır
  • deployParameters NFDV'de varsayılan değeri olmayan gerekli parametreleri içeren bir şema oluşturur

Örneğin, bir VNF ARM şablonunun bu alıntısı iki parametre tanımlar. Biri gereklidir, diğeri isteğe bağlıdır.

  "parameters": {
    "required": {
      "type": "string",
      "metadata": {
        "description": "A required parameter."
      }
    },
    "optional": {
      "type": "string",
      "defaultValue": "optional"
      "metadata": {
        "description": "An optional parameter."
      }
    },
  }

AOSM CLI özelliğinde deployParameters parametresini required kullanıma sunan bir NFDV oluşturur. optional parametresi kullanıma sunulmaz. Dağıtım zamanında, VNF ile varsayılan değerine optionalayarlanmış olarak optional dağıtılır. Dağıtımı tetikleyen kullanıcının için requiredbir değer sağlaması gerekir.

CNF'ler için davranış benzerdir. AOSM CLI, kullanıcının helm grafiğindeki varsayılan values.yaml dosyayı geçersiz kılan bir values.yaml dosya sağlamasına olanak tanır. Bu geçersiz kılma values.yaml dosyası, değer içeren veya olmayan parametreler içerebilir. Geçersiz kılma dosyasının values.yaml aşağıdaki alıntısı, değeri olan bir parametreyi ve değeri olmayan bir parametreyi gösterir.

optional: "optional"
required:

AOSM CLI özelliğinde deployParameters parametresini required kullanıma sunan bir NFDV oluşturur. optional parametresi kullanıma sunulmaz. Dağıtım zamanında, CNF ile optional varsayılan değerine ayarlanmış olarak optionaldağıtılır. Dağıtımı tetikleyen kullanıcının için requiredbir değer sağlaması gerekir.

Önemli

AOSM CLI, komutunu çalıştırarak helm templatehelm grafiğindeki varsayılan values.yaml dosyanın grafikle tutarlı olduğunu doğrular. Bu helm template komut başarısız olursa CLI bir hata oluşturur.

Tüm parametreleri kullanıma sunma

Azure AOSM CLI Uzantısı, tüm parametrelerin yapılandırılabilir olmasını destekler. tarafından az aosm nfd generate-config oluşturulan giriş dosyasında gerekli yapılandırma:

  // 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": true,

AOSM CLI Uzantısı olarak ayarlandıysa expose_all_parameters true:

  • Kapsayıcılı Ağ İşlevi (CNF) helm değerlerini veya Sanallaştırılmış Ağ İşlevi (VNF) Azure Resource Manager (ARM) şablon parametrelerini ayrıştırır
  • NFDV'de ayrıştırılan parametrelerin tümünü içeren bir deployParameters şema oluşturur
  • ARM şablonundaki tüm varsayılanlar veya helm değerlerinde yapılandırılan değerler NFDV deployParameters şemasında varsayılan olarak yapılandırılır.

CGS inşaatı

Her durumda, komut tarafından az aosm nfd build sunulan tüm parametreler komut sırasında CGS'ye az aosm nsd build eklenir. AOSM CLI uzantısı ayrıca CGS'ye ve gibi customLocationId managedIdentityIdARM Şablonundan veya helm değerlerinden ayrıştırılmayan bazı ek parametreler ekler. Bu parametreler, Site Ağ Hizmeti'ni hedef ortama dağıtmak için gereklidir.

Sonraki Adımlar