Udostępnij przez

Polecenia interfejsu wiersza polecenia Bicep

W tym artykule opisano polecenia, których można użyć w interfejsie wiersza polecenia Bicep. Te polecenia można wykonać przy użyciu interfejsu wiersza polecenia platformy Azure lub bezpośrednio wywołując polecenia interfejsu wiersza polecenia Bicep. Każda metoda wymaga odrębnego procesu instalacji. Aby uzyskać więcej informacji na temat instalacji, zobacz Interfejs wiersza polecenia platformy Azure i program Azure PowerShell.

W tych wskazówkach pokazano, jak uruchamiać polecenia w interfejsie wiersza polecenia platformy Azure. Podczas uruchamiania poleceń w interfejsie wiersza polecenia platformy Azure uruchom je za pomocą polecenia az. Jeśli nie używasz interfejsu wiersza polecenia platformy Azure, uruchom polecenia bez az na początku każdego z nich. Na przykład az bicep build staje się bicep build, a az bicep version staje się .bicep --version

kompilacja

Polecenie build konwertuje plik Bicep na szablon usługi Azure Resource Manager w formacie JSON (szablon usługi ARM). Zazwyczaj nie trzeba uruchamiać tego polecenia, ponieważ jest on uruchamiany automatycznie podczas wdrażania pliku Bicep. Uruchom go ręcznie, gdy chcesz zobaczyć szablon usługi ARM JSON utworzony na podstawie pliku Bicep.

Użycie dowolnych z następujących funkcji Bicep automatycznie włącza generowanie kodu w wersji 2.0 języka:

Poniższy przykład konwertuje plik Bicep o nazwie main.bicep na szablon usługi ARM o nazwie main.json. Nowy plik jest tworzony w tym samym katalogu co plik Bicep:

bicep build main.bicep

Następny przykład zapisuje main.json w innym katalogu:

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

W następnym przykładzie określono nazwę i lokalizację pliku do utworzenia:

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

Aby wydrukować plik w pliku stdout, użyj polecenia :

bicep build main.bicep --stdout

Jeśli plik Bicep zawiera moduł odwołujący się do rejestru zewnętrznego, build polecenie automatycznie wywołuje polecenie restore. Polecenie restore pobiera plik z rejestru i zapisuje go w lokalnej pamięci podręcznej.

Uwaga

Polecenie restore nie odświeża pamięci podręcznej. Aby uzyskać więcej informacji, zobacz przywracanie.

Aby nie wywoływać przywracania automatycznie, użyj przełącznika --no-restore :

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

Aby użyć przełącznika --no-restore , musisz mieć interfejs wiersza polecenia Bicep w wersji 0.4.X lub nowszej.

Proces kompilacji z przełącznikiem kończy się niepowodzeniem --no-restore , jeśli jeden z modułów zewnętrznych nie jest jeszcze buforowany:

The module with reference "br:exampleregistry.azurecr.io/bicep/modules/storage:v1" hasn't been restored.

Po wystąpieniu tego błędu uruchom build polecenie bez przełącznika --no-restore lub uruchom bicep restore polecenie jako pierwsze.

parametry kompilacji

Polecenie build-params kompiluje .bicepparam plik w pliku parametrów JSON:

bicep build-params params.bicepparam

To polecenie konwertuje plik parametrów params.bicepparam na plik parametrów JSON params.json .

dekompilować

Polecenie decompile konwertuje szablon arm JSON na plik Bicep:

bicep decompile main.json

To polecenie tworzy plik o nazwie main.bicep w tym samym katalogu co main.json. Jeśli plik main.bicep istnieje w tym samym katalogu, użyj przełącznika --force , aby zastąpić istniejący plik Bicep.

Aby uzyskać więcej informacji na temat korzystania z tego polecenia, zobacz Decompile JSON ARM template to Bicep (Decompile JSON ARM template to Bicep).

dekompiluj-params

Polecenie decompile-params dekompiluje plik parametrów JSON do .bicepparam pliku parametrów.

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

To polecenie dekompiluje plik parametrów azuredeploy.parameters.json do pliku azuredeploy.parameters.bicepparam . --bicep-file określa ścieżkę do pliku Bicep (względem .bicepparam pliku), do którego odwołuje using się deklaracja.

format

Polecenie format formatuje plik Bicep, tak aby był zgodny z zalecanymi konwencjami stylów. Pomyśl o tym jak "formatator kodu" lub "ładniejszy" dla plików Bicep. Ma tę samą funkcję co SHIFT+ALT+F skrót w programie Visual Studio Code.

bicep format main.bicep

generate-params

Polecenie generate-params tworzy plik parametrów z danego pliku Bicep, aktualizuje, jeśli istnieje istniejący plik parametrów.

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

To polecenie tworzy plik parametrów Bicep o nazwie main.bicepparam. Plik parameters zawiera wszystkie parametry w pliku Bicep, niezależnie od tego, czy jest skonfigurowany z wartościami domyślnymi, czy nie.

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

To polecenie tworzy plik parametrów o nazwie main.parameters.json. Plik parametrów zawiera tylko parametry bez wartości domyślnych skonfigurowanych w pliku Bicep.

instalować

Polecenie install dodaje interfejs wiersza polecenia Bicep do środowiska lokalnego i jest dostępny tylko za pośrednictwem interfejsu wiersza polecenia platformy Azure. Aby uzyskać więcej informacji, zobacz Instalowanie narzędzi Bicep.

Aby zainstalować najnowszą wersję, użyj:

Aby zainstalować określoną wersję:

N/A

jsonrpc

Polecenie jsonrpc umożliwia uruchomienie interfejsu wiersza polecenia Bicep za pomocą interfejsu JSON-RPC, co umożliwia programową interakcję ze strukturą danych wyjściowych i unikanie opóźnień zimnego startu podczas kompilowania wielu plików. Ta konfiguracja obsługuje również programowe interakcje z plikami Bicep w non-.NET językach.

Format przewodu do wysyłania i odbierania danych wejściowych/wyjściowych jest rozdzielany nagłówkami przy użyciu następującej struktury, gdzie \r i \n reprezentują znaki powrotu karetki i wiersza:

Content-Length: <length>\r\n\r\n<message>\r\n\r\n
  • <length> to długość <message> ciągu, w tym ciąg końcowy \r\n\r\n.
  • <message> to nieprzetworzona wiadomość JSON.

Na przykład:

Content-Length: 72\r\n\r\n{"jsonrpc": "2.0", "id": 0, "method": "bicep/version", "params": {}}\r\n\r\n

Następujące metody są dostępne za pośrednictwem interfejsu JSON-RPC:

  • bicep/format

    Formatuje plik Bicep.

    • Żądanie:

      {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "bicep/format",
  "params": {
    "path": "/path/to/file.bicep"
  }
}

    • Odpowiedź:

      {
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "success": true,
    "diagnostics": [],
    "contents": "param foo string\n\nresource storage 'Microsoft.Storage/storageAccounts@2025-01-01' = {\n  name: 'mystorageaccount'\n  location: 'East US'\n}\n"
  }
}

      Po pomyślnym "success": true zakończeniu zwracana jest zawartość zawierająca sformatowane źródło Bicep. W przypadku awarii z "success": false opisem diagnostics błędu.

  • bicep/wersja

    Zwraca wersję interfejsu wiersza polecenia Bicep.

    • Żądanie:

      {
  "jsonrpc": "2.0",
  "id": 0,
  "method": "bicep/version",
  "params": {}
}

    • Odpowiedź:

      {
  "jsonrpc": "2.0",
  "id": 0,
  "result": {
    "version": "0.24.211"
  }
}

Aby uzyskać dostępne metody i treść żądania/odpowiedzi, zobacz ICliJsonRpcProtocol.cs. Aby zapoznać się z przykładem nawiązywania połączenia JSONRPC i programowego korzystania z plików Bicep przy użyciu węzła, zobacz jsonrpc.test.ts.

Użycie nazwanego potoku

Użyj następującej składni, aby nawiązać połączenie z istniejącym nazwanym potokiem jako klientem JSONRPC:

bicep jsonrpc --pipe <named_pipe>`

<named_pipe> to istniejący nazwany potok do połączenia klienta JSONRPC z.

Aby nawiązać połączenie z nazwanym potokiem w systemie OSX/Linux:

bicep jsonrpc --pipe /tmp/bicep-81375a8084b474fa2eaedda1702a7aa40e2eaa24b3.sock

Aby nawiązać połączenie z nazwanym potokiem w systemie Windows:

bicep jsonrpc --pipe \\.\pipe\\bicep-81375a8084b474fa2eaedda1702a7aa40e2eaa24b3.sock`

Aby uzyskać więcej przykładów, zobacz C# i node.js.

Użycie gniazda TCP

Użyj następującej składni, aby nawiązać połączenie z istniejącym gniazdem TCP jako klientem JSONRPC:

bicep jsonrpc --socket <tcp_socket>

<tcp_socket> to numer gniazda, z którym łączy się klient JSONRPC.

Aby nawiązać połączenie z gniazdem TCP:

bicep jsonrpc --socket 12345

Użycie dla stdin i stdout

Użyj następującej składni i polecenia dla stdinstdout komunikatów, aby uruchomić interfejs JSONRPC:

Lint

Polecenie lint zwraca błędy i naruszenia reguł linter pliku Bicep.

bicep lint main.bicep

Jeśli plik Bicep zawiera moduł odwołujący się do rejestru zewnętrznego, lint polecenie automatycznie wywołuje polecenie restore. Polecenie restore pobiera plik z rejestru i zapisuje go w lokalnej pamięci podręcznej.

Uwaga

Polecenie restore nie odświeża pamięci podręcznej. Aby uzyskać więcej informacji, zobacz przywracanie.

Aby nie wywoływać przywracania automatycznie, użyj przełącznika --no-restore :

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

Proces lint z przełącznikiem kończy się niepowodzeniem --no-restore , jeśli jeden z modułów zewnętrznych nie jest jeszcze buforowany:

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

Po wystąpieniu tego błędu uruchom lint polecenie bez przełącznika --no-restore lub uruchom bicep restore polecenie jako pierwsze.

list-versions

Polecenie list-versions zwraca wszystkie dostępne wersje interfejsu wiersza polecenia Bicep. Użyj tego polecenia, aby sprawdzić, czy chcesz uaktualnić lub zainstalować nową wersję. To polecenie jest dostępne tylko za pośrednictwem interfejsu wiersza polecenia platformy Azure.

N/A

publikować

Polecenie publish dodaje moduł do rejestru. Rejestr kontenerów platformy Azure musi istnieć, a konto publikowania w rejestrze musi mieć odpowiednie uprawnienia. Aby uzyskać więcej informacji na temat konfigurowania rejestru modułów, zobacz Używanie rejestru prywatnego dla modułów Bicep. Aby opublikować moduł, konto musi mieć prawidłowy profil i uprawnienia dostępu do rejestru. Możesz skonfigurować pierwszeństwo profilu i poświadczeń na potrzeby uwierzytelniania w rejestrze w pliku konfiguracji Bicep.

Po opublikowaniu pliku w rejestrze można odwoływać się do niego w module.

Aby użyć polecenia i parametru, musisz mieć interfejs wiersza polecenia Bicep w wersji 0.14.X lub nowszejpublish--documentationUri/.-d

Aby opublikować moduł w rejestrze, użyj:

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

Na przykład:

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

Polecenie publish nie rozpoznaje aliasów określonych w pliku bicepconfig.json. Podaj pełną ścieżkę modułu.

Ostrzeżenie

Publikowanie w tym samym obiekcie docelowym zastępuje stary moduł. Zalecamy zwiększanie wersji podczas aktualizowania.

przywracać

Gdy plik Bicep używa modułów publikowanych w rejestrze, restore polecenie pobiera kopie wszystkich wymaganych modułów z rejestru. Przechowuje te kopie w lokalnej pamięci podręcznej. Plik Bicep można skompilować tylko wtedy, gdy pliki zewnętrzne są dostępne w lokalnej pamięci podręcznej. Zwykle uruchamianie przywracania nie jest konieczne, ponieważ jest ono automatycznie wyzwalane przez proces kompilacji.

Aby przywrócić moduły zewnętrzne do lokalnej pamięci podręcznej, konto musi mieć prawidłowy profil i uprawnienia dostępu do rejestru. Możesz skonfigurować pierwszeństwo profilu i poświadczeń na potrzeby uwierzytelniania w rejestrze w pliku konfiguracji Bicep.

Aby użyć restore polecenia , musisz mieć interfejs wiersza polecenia Bicep w wersji 0.14.X lub nowszej.

Aby ręcznie przywrócić moduły zewnętrzne dla pliku, użyj:

bicep restore <bicep-file>

Plik Bicep, który podajesz, to plik, który chcesz wdrożyć. Musi zawierać moduł, który łączy się z rejestrem. Można na przykład przywrócić następujący plik:

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

Lokalna pamięć podręczna znajduje się w:

  • W systemie Windows

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

  • W systemie Linux

    /home/<username>/.bicep

  • Na komputerze Mac

    ~/.bicep

Polecenie restore nie odświeża pamięci podręcznej, jeśli moduł jest już buforowany. Aby odświeżyć pamięć podręczną, możesz usunąć ścieżkę modułu z pamięci podręcznej lub użyć przełącznika --forcerestore za pomocą polecenia .

aktualizować

Polecenie upgrade aktualizuje zainstalowaną wersję przy użyciu najnowszej wersji. To polecenie jest dostępne tylko za pośrednictwem interfejsu wiersza polecenia platformy Azure.

wersja

Polecenie version zwraca zainstalowaną wersję:

bicep --version

Jeśli interfejs wiersza polecenia Bicep nie został zainstalowany, zostanie wyświetlony komunikat o błędzie z informacją, że interfejs wiersza polecenia Bicep nie został znaleziony.

Polecenie wyświetla numer wersji:

Bicep CLI version 0.29.45 (57a44c0230)

Następne kroki

Aby dowiedzieć się więcej na temat wdrażania pliku Bicep, zobacz:

  • Last updated on