Bicep CLI-opdrachten

Artikel
01/03/2024

In dit artikel worden de opdrachten beschreven die u kunt gebruiken in de Bicep CLI. U hebt twee opties voor het uitvoeren van deze opdrachten: door gebruik te maken van Azure CLI of door bicep CLI-opdrachten rechtstreeks aan te roepen. Voor elke methode is een afzonderlijk installatieproces vereist. Zie Azure CLI installeren en Azure PowerShell installeren voor meer informatie.

In dit artikel wordt beschreven hoe u de opdrachten uitvoert in Azure CLI. Wanneer u azure CLI uitvoert, start u de opdrachten met az. Als u azure CLI niet gebruikt, voert u de opdrachten uit zonder az aan het begin van de opdracht. Wordt bijvoorbeeld az bicep buildbicep build, en az bicep version wordt bicep --version.

build

Met de build opdracht wordt een Bicep-bestand geconverteerd naar een Azure Resource Manager-sjabloon (ARM-sjabloon). Normaal gesproken hoeft u deze opdracht niet uit te voeren, omdat deze automatisch wordt uitgevoerd wanneer u een Bicep-bestand implementeert. Voer deze handmatig uit wanneer u de ARM-sjabloon JSON wilt zien die is gemaakt op basis van uw Bicep-bestand.

In het volgende voorbeeld wordt een Bicep-bestand met de naam main.bicep geconverteerd naar een ARM-sjabloon met de naam main.json. Het nieuwe bestand wordt gemaakt in dezelfde map als het Bicep-bestand.

az bicep build --file main.bicep

In het volgende voorbeeld wordt main.json opgeslagen in een andere map.

az bicep build --file main.bicep --outdir c:\jsontemplates

In het volgende voorbeeld wordt de naam en locatie opgegeven van het bestand dat moet worden gemaakt.

az bicep build --file main.bicep --outfile c:\jsontemplates\azuredeploy.json

Als u het bestand wilt stdoutafdrukken, gebruikt u:

az bicep build --file main.bicep --stdout

Als uw Bicep-bestand een module bevat die verwijst naar een extern register, roept de buildopdracht automatisch herstel aan. Met de herstelopdracht wordt het bestand uit het register opgehaald en opgeslagen in de lokale cache.

Notitie

De herstelopdracht vernieuwt de cache niet. Zie herstellen voor meer informatie.

Als u herstel niet automatisch wilt aanroepen, gebruikt u de --no-restore schakeloptie:

az bicep build --no-restore <bicep-file>

Het buildproces met de switch mislukt als een van de externe modules nog niet in de --no-restore cache is opgeslagen:

The module with reference "br:exampleregistry.azurecr.io/bicep/modules/storage:v1" has not been restored.

Wanneer u deze fout krijgt, voert u de build opdracht uit zonder de --no-restore switch of voert u deze eerst uit bicep restore .

Als u de --no-restore switch wilt gebruiken, moet u Bicep CLI versie 0.4.X of hoger hebben.

build-params

Met de build-params opdracht wordt een BICEPPARAM-bestand gebouwd in een JSON-parametersbestand.

az bicep build-params --file params.bicepparam

Met deze opdracht wordt een parameterbestand params.bicepparam geconverteerd naar een parameterbestand params.json JSON.

Decompileren

Met de decompile opdracht wordt ARM-sjabloon JSON geconverteerd naar een Bicep-bestand.

az bicep decompile --file main.json

Met de opdracht maakt u een bestand met de naam main.bicep in dezelfde map als main.json. Als main.bicep in dezelfde map bestaat, gebruikt u de --force-switch om het bestaande Bicep-bestand te overschrijven.

Zie Decompiling ARM-sjabloon JSON naar Bicep voor meer informatie over het gebruik van deze opdracht.

decompile-params

Met de decompile-params opdracht wordt een JSON-parameterbestand gedecompileer naar een .bicepparam-parametersbestand .

az bicep decompile-params --file azuredeploy.parameters.json --bicep-file ./dir/main.bicep

Met deze opdracht wordt een bestand met azuredeploy.parameters.json-parameters gedecompileert in een bestand azuredeploy.parameters.bicepparam . --bicep-file hiermee geeft u het pad naar het Bicep-bestand (ten opzichte van het BICEPPARAM-bestand) waarnaar in de using declaratie wordt verwezen.

indeling

Met de format opdracht wordt een Bicep-bestand opgemaakt. Deze heeft dezelfde functie als de SHIFT+ALT+F snelkoppeling in Visual Studio Code.

az bicep format --file main.bicep

generate-params

Met de generate-params opdracht wordt een parameterbestand van het opgegeven Bicep-bestand gebouwd, wordt bijgewerkt als er een bestaand parameterbestand is.

az bicep generate-params --file main.bicep --output-format bicepparam --include-params all

Met de opdracht maakt u een Bicep-parametersbestand met de naam main.bicepparam. Het parameterbestand bevat alle parameters in het Bicep-bestand, ongeacht of deze zijn geconfigureerd met standaardwaarden of niet.

az bicep generate-params --file main.bicep --outfile main.parameters.json

Met de opdracht maakt u een parameterbestand met de naam main.parameters.json. Het parameterbestand bevat alleen de parameters zonder standaardwaarden die zijn geconfigureerd in het Bicep-bestand.

installeren

Met install de opdracht wordt de Bicep CLI toegevoegd aan uw lokale omgeving. Zie Bicep-hulpprogramma's installeren voor meer informatie. Deze opdracht is alleen beschikbaar via Azure CLI.

Als u de nieuwste versie wilt installeren, gebruikt u:

az bicep install

Een specifieke versie installeren:

az bicep install --version v0.3.255

lint

De lint opdracht retourneert de fouten en de schendingen van de linter-regel van een Bicep-bestand.

az bicep lint --file main.bicep

Als uw Bicep-bestand een module bevat die verwijst naar een extern register, roept de lintopdracht automatisch herstellen aan. Met de herstelopdracht wordt het bestand uit het register opgehaald en opgeslagen in de lokale cache.

Notitie

De herstelopdracht vernieuwt de cache niet. Zie herstellen voor meer informatie.

Als u herstel niet automatisch wilt aanroepen, gebruikt u de --no-restore schakeloptie:

az bicep lint --no-restore <bicep-file>

Het lintproces met de switch mislukt als een van de externe modules nog niet in de --no-restore cache is opgeslagen:

The module with reference "br:exampleregistry.azurecr.io/bicep/modules/storage:v1" has not been restored.

Wanneer u deze fout krijgt, voert u de lint opdracht uit zonder de --no-restore switch of voert u deze eerst uit bicep restore .

list-versions

De list-versions opdracht retourneert alle beschikbare versies van de Bicep CLI. Gebruik deze opdracht om te zien of u een nieuwe versie wilt upgraden of installeren . Deze opdracht is alleen beschikbaar via Azure CLI.

az bicep list-versions

De opdracht retourneert een matrix met beschikbare versies.

[
  "v0.20.4",
  "v0.19.5",
  "v0.18.4",
  "v0.17.1",
  "v0.16.2",
  "v0.16.1",
  "v0.15.31",
  "v0.14.85",
  "v0.14.46",
  "v0.14.6",
  "v0.13.1",
  "v0.12.40",
  "v0.12.1",
  "v0.11.1",
  "v0.10.61",
  "v0.10.13",
  "v0.9.1",
  "v0.8.9",
  "v0.8.2",
  "v0.7.4",
  "v0.6.18",
  "v0.6.11",
  "v0.6.1",
  "v0.5.6",
  "v0.4.1318",
  "v0.4.1272",
  "v0.4.1124",
  "v0.4.1008",
  "v0.4.613",
  "v0.4.451"
]

publish

Met de publish opdracht wordt een module toegevoegd aan een register. Het Azure-containerregister moet bestaan en het account dat naar het register wordt gepubliceerd, moet over de juiste machtigingen beschikken. Zie Privéregister gebruiken voor Bicep-modules voor meer informatie over het instellen van een moduleregister. Als u een module wilt publiceren, moet het account over het juiste profiel en de juiste machtigingen beschikken om toegang te krijgen tot het register. U kunt het profiel en de referentieprioriteit configureren voor verificatie bij het register in het Bicep-configuratiebestand.

Nadat u het bestand naar het register hebt gepubliceerd, kunt u ernaar verwijzen in een module.

Als u de opdracht Publiceren wilt gebruiken, moet u Bicep CLI versie 0.14.X of hoger hebben. Als u de --documentationUri/-d parameter wilt gebruiken, moet u Bicep CLI versie 0.14.X of hoger hebben.

Als u een module naar een register wilt publiceren, gebruikt u:

az bicep publish --file <bicep-file> --target br:<registry-name>.azurecr.io/<module-path>:<tag> --documentationUri <documentation-uri>

Voorbeeld:

az bicep publish --file storage.bicep --target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 --documentationUri https://www.contoso.com/exampleregistry.html

De publish opdracht herkent geen aliassen die zijn opgegeven in een bicepconfig.json-bestand . Geef het volledige modulepad op.

Waarschuwing

Als u naar hetzelfde doel publiceert, wordt de oude module overschreven. U wordt aangeraden de versie bij het bijwerken te verhogen.

De pagina Restore

Wanneer uw Bicep-bestand modules gebruikt die naar een register worden gepubliceerd, worden met de restore opdracht kopieën opgehaald van alle vereiste modules uit het register. Deze kopieën worden opgeslagen in een lokale cache. Een Bicep-bestand kan alleen worden gebouwd wanneer de externe bestanden beschikbaar zijn in de lokale cache. Normaal gesproken is het uitvoeren van herstel niet nodig omdat deze automatisch wordt geactiveerd door het buildproces.

Als u externe modules wilt herstellen naar de lokale cache, moet het account over het juiste profiel en de juiste machtigingen beschikken om toegang te krijgen tot het register. U kunt het profiel en de referentieprioriteit configureren voor verificatie bij het register in het Bicep-configuratiebestand.

Als u de herstelopdracht wilt gebruiken, moet u Bicep CLI versie 0.4.X of hoger hebben. Deze opdracht is momenteel alleen beschikbaar wanneer u de Bicep CLI rechtstreeks aanroept. Deze is momenteel niet beschikbaar via de Azure CLI-opdracht.

Als u de externe modules voor een bestand handmatig wilt herstellen, gebruikt u:

az bicep restore --file <bicep-file> [--force]

Het Bicep-bestand dat u opgeeft, is het bestand dat u wilt implementeren. Deze moet een module bevatten die is gekoppeld aan een register. U kunt bijvoorbeeld het volgende bestand herstellen:

module stgModule 'br:exampleregistry.azurecr.io/bicep/modules/storage:v1' = {
  name: 'storageDeploy'
  params: {
    storagePrefix: 'examplestg1'
  }
}

De lokale cache vindt u in:

In Windows

%USERPROFILE%\.bicep\br\<registry-name>.azurecr.io\<module-path\<tag>

In Linux
```
/home/<username>/.bicep
```
Op Mac
```
~/.bicep
```

De restore opdracht vernieuwt de cache niet als een module al in de cache is opgeslagen. Als u de cache wilt verfraaien, kunt u het modulepad uit de cache verwijderen of de --force switch gebruiken met de restore opdracht.

upgrade

Met upgrade de opdracht wordt uw geïnstalleerde versie bijgewerkt met de nieuwste versie. Deze opdracht is alleen beschikbaar via Azure CLI.

az bicep upgrade

version

De version opdracht retourneert de geïnstalleerde versie.

az bicep version

Met de opdracht wordt het versienummer weergegeven.

Bicep CLI version 0.22.6 (d62b94db31)

Als u deze opdracht rechtstreeks wilt aanroepen via de Bicep CLI, gebruikt u:

bicep --version

Als de Bicep CLI niet is geïnstalleerd, krijgt u een foutbericht te zien waarin wordt aangegeven dat Bicep CLI niet is gevonden.

Volgende stappen

Zie voor meer informatie over het implementeren van een Bicep-bestand: