Używanie i nieużywanie instrukcji 'none'

Wszystkie pliki parametrów Bicep muszą zawierać deklarację using lub using none.

Plik parametrów Bicep zwykle używa using instrukcji , aby połączyć plik z plikiem Bicep, szablonem Azure Resource Manager JSON (szablon arm), modułem Bicep lub specyfikacją szablonu. To połączenie umożliwia serwerowi języka Bicep i kompilatorowi zweryfikowanie pliku parametrów, sprawdzając poprawne nazwy, typy i wymagane wartości na podstawie danych wejściowych szablonu.

Natomiast instrukcja jawnie wskazuje, using none że plik parametrów nie jest połączony z żadnym konkretnym szablonem w czasie kompilacji. To stwierdzenie oznacza, że parametry nie są weryfikowane względem określonego szablonu, lecz są przeznaczone do bardziej ogólnych zastosowań, na przykład do wykorzystania przez narzędzia zewnętrzne lub jako współdzielone zestawy parametrów wielokrotnego użytku.

Instrukcja "using"

Składnia using instrukcji:

• Aby korzystać z plików Bicep:

  using '<path>/<file-name>.bicep'
  

• Aby użyć szablonów JSON ARM:

  using '<path>/<file-name>.json'
  

• Aby użyć modułów publicznych:

  using 'br/public:<file-path>:<tag>'
  

  Na przykład:

  using 'br/public:avm/res/storage/storage-account:0.9.0' 
  
  param name = 'mystorage'
  

• Aby użyć modułów prywatnych:

  using 'br:<acr-name>.azurecr.io/bicep/<file-path>:<tag>'
  

  Na przykład:

  using 'br:myacr.azurecr.io/bicep/modules/storage:v1'
  

  Aby użyć modułu prywatnego z aliasem zdefiniowanym w pliku bicepconfig.json :

  using 'br/<alias>:<file>:<tag>'
  

  Na przykład:

  using 'br/storageModule:storage:v1'
  

• Aby użyć specyfikacji szablonu:

  using 'ts:<subscription-id>/<resource-group-name>/<template-spec-name>:<tag>
  

  Na przykład:

  using 'ts:00000000-0000-0000-0000-000000000000/myResourceGroup/storageSpec:1.0'
  

  Aby użyć specyfikacji szablonu z aliasem zdefiniowanym w pliku bicepconfig.json :

  using 'ts/<alias>:<template-spec-name>:<tag>'
  

  Na przykład:

  using 'ts/myStorage:storageSpec:1.0'
  

Instrukcja "using none"

Instrukcja using none w pliku parametrów Bicep (.bicepparam) wskazuje, że plik nie jest powiązany z określonym szablonem Bicep podczas tworzenia lub kompilacji. Ta instrukcja rozdziela plik parametrów z określonego szablonu, co zapewnia większą elastyczność w sposobie definiowania i używania parametrów we wdrożeniach.

Składnia using none instrukcji:

using none

Umieść tę instrukcję na początku pliku parametrów Bicep, aby zasygnalizować, że nie ma odwołania do określonego szablonu.

Główną zaletą using none aplikacji Bicep są scenariusze, w których pliki parametrów są uogólnione, współużytkowane lub dynamicznie zintegrowane z szablonami. Typowe przypadki użycia to:

• Scentralizowane repozytoria parametrów

  Organizacje często utrzymują standardowe wartości parametrów — takie jak regiony domyślne, konwencje nazewnictwa lub tagi globalne — używane w wielu wdrożeniach Bicep. Plik parametrów Bicep z elementem using none może służyć jako centralne repozytorium tych współdzielonych wartości, poprawiając spójność i minimalizując powielanie. Te parametry można scalić programowo z wartościami specyficznymi dla szablonu w czasie wdrażania.

  Na przykład udostępniony plik parametrów Bicep może definiować:

  using none
  
  param location = 'westus2'
  param environmentTag = 'production'
  param projectName = 'myApp'
  

  Ponadto można rozszerzyć ten plik parametrów. Aby uzyskać więcej informacji, zobacz Rozszerzanie pliku parametrów.

• Dynamiczne generowanie i integracja środowiska uruchomieniowego

  W potokach CI/CD lub skryptach automatyzacji możesz tworzyć pliki parametrów na bieżąco lub powiązać je z szablonami w czasie wykonywania. Pominięcie stałego odwołania using none do szablonu umożliwia zachowanie elastyczności i dostosowania tych plików do różnych kontekstów wdrażania.

Po określeniu using none w pliku parametrów Bicep kompilator nie weryfikuje parametrów względem określonego szablonu Bicep. Oznacza to, że kompilator nie zgłasza żadnych ostrzeżeń ani błędów czasu kompilacji dla niezgodnych nazw lub typów z powodu braku połączonego szablonu. Jednak to oddzielenie ma zastosowanie tylko podczas tworzenia i kompilacji. W czasie wdrażania Azure Resource Manager (ARM) nadal wymaga zarówno szablonu Bicep, jak i pliku parametrów. Aparat usługi ARM przeprowadza walidację podczas wdrażania, rozpoznając parametry w pliku względem parametrów zdefiniowanych w szablonie docelowym.

Następne kroki

• Dowiedz się więcej o plikach parametrów Bicep w artykule Create parameters files for Bicep deployment (Tworzenie plików parametrów dla wdrożenia Bicep).
• Dowiedz się, jak konfigurować aliasy w plikach bicepconfig.json, w artykule Konfigurowanie środowiska Bicep.