Sdílet prostřednictvím

Používání a nepoužívání příkazů

Deklarace using nebo using none musí být přítomna ve všech souborech parametrů Bicep.

Soubor parametrů Bicep obvykle používá using příkaz, který soubor sváže se souborem Bicep, JSON šablonou Azure Resource Manageru (ARM šablona),modulem Bicep, nebo specifikací šablony. Toto propojení umožňuje serveru a kompilátoru jazyka Bicep ověřit správnost názvů, typů a nutné hodnoty dle vstupů šablony.

Naproti tomu příkaz explicitně indikuje, using none že soubor parametrů není vázán na žádnou konkrétní šablonu v době kompilace. To znamená, že parametry se neověřují vůči konkrétní šabloně a místo toho jsou určené pro obecnější použití, jako je použití externími nástroji nebo sloužící jako sdílené opakovaně použitelné sady parametrů.

Poznámka:

Soubory parametrů Bicep se podporují jenom v rozhraní příkazového řádku Bicep verze 0.18.4 nebo novější, Azure CLI verze 2.47.0 nebo novější a Azure PowerShell verze 9.7.1 nebo novější. Tato using none funkce je podporovaná v rozhraní příkazového řádku Bicep verze 0.31.0 nebo novější.

Pokud chcete příkaz použít se šablonami JSON ARM, moduly Bicep a specifikacemi šablon, musíte mít Rozhraní příkazového řádku Bicep verze 0.22.6 nebo novější a Azure CLI verze 2.53.0 nebo novější.

Příkaz using

Syntaxe using příkazu:

  • Použití souborů Bicep:

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

  • Použití šablon ARM JSON:

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

  • Použití veřejných modulů:

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

    Příklad:

    using 'br/public:avm/res/storage/storage-account:0.9.0' 

param name = 'mystorage'

  • Použití privátních modulů:

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

    Příklad:

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

    Použití privátního modulu s aliasem definovaným v souboru bicepconfig.json :

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

    Příklad:

    using 'br/storageModule:storage:v1'

  • Použití specifikací šablon:

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

    Příklad:

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

    Použití specifikace šablony s aliasem definovaným v souboru bicepconfig.json :

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

    Příklad:

    using 'ts/myStorage:storageSpec:1.0'

Příkaz using-none

Příkaz using none v souboru parametrů Bicep (.bicepparam) označuje, že soubor není vázán na konkrétní šablonu Bicep během vytváření nebo kompilace. Tím se oddělí soubor parametrů od konkrétní šablony, což umožňuje větší flexibilitu při definování a používání parametrů napříč nasazeními.

Syntaxe using none příkazu:

using none

Tento příkaz je umístěn na začátku souboru parametrů Bicep, aby signalizoval, že se neodkazuje na žádnou konkrétní šablonu.

Hlavní výhoda using none v Bicep spočívá v situacích, kdy jsou soubory parametrů zobecněny, sdíleny nebo dynamicky integrovány se šablonami. Mezi běžné případy použití patří:

  • Centralizovaná úložiště parametrů

    Organizace často udržují standardní hodnoty parametrů, jako jsou výchozí oblasti, zásady vytváření názvů nebo globální značky používané napříč několika nasazeními Bicep. Soubor parametrů Bicep bez použití konkrétních hodnot může sloužit jako centrální úložiště pro tyto sdílené hodnoty, což zlepšuje konzistenci a minimalizuje duplikaci. Tyto parametry se pak dají programově sloučit s hodnotami specifickými pro šablonu v době nasazení.

    Například sdílený soubor parametrů Bicep může definovat:

    using none

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

  • Dynamická generace a integrace za běhu

    V kanálech CI/CD nebo automatizačních skriptech mohou být soubory parametrů vytvořeny za běhu nebo přidruženy k šablonám za běhu. Vynecháním pevného odkazu na šablonu umožníte, using none aby tyto soubory zůstaly flexibilní a přizpůsobitelné různým kontextům nasazení.

Pokud je using none zadán v souboru parametrů Bicep, kompilátor neprovádí ověření parametrů podle konkrétní šablony Bicep, což znamená, že kvůli chybějící propojené šabloně nejsou v době kompilace hlášena žádná upozornění nebo chyby kvůli nesouladu jmen nebo typů. Toto oddělení se ale vztahuje pouze během vytváření a kompilace, v době nasazení Azure Resource Manager (ARM) stále vyžaduje šablonu Bicep i soubor parametrů. Modul ARM provádí ověření během nasazování překladem parametrů v souboru proti parametrům definovaným v cílové šabloně.

Další kroky

  • Last updated on