Wprowadzenie
Jedną z zalet wdrażania infrastruktury jako kodu jest to, że szablony można udostępniać, umożliwiając współpracę nad kodem Bicep z innymi członkami zespołu. Ważne jest, aby kod Bicep był łatwy do odczytania i łatwego w pracy.
W tym module poznasz kilka sposobów tworzenia struktury i stylu kodu Bicep, aby ułatwić innym zrozumienie, modyfikowanie i wdrażanie.
Przykładowy scenariusz
Załóżmy, że jesteś administratorem infrastruktury platformy Azure w firmie z toy. Ty i Twój zespół ustandaryzowali usługę Bicep na potrzeby wdrożeń platformy Azure i utworzyliśmy bibliotekę szablonów wielokrotnego użytku.
Dwóch członków zespołu ds. kontroli jakości zostało zadaniowych w celu uruchomienia ankiety klienta. Aby to osiągnąć, muszą wdrożyć nową witrynę internetową i bazę danych. Mają napięty termin i chcą uniknąć tworzenia zupełnie nowego szablonu, jeśli nie muszą. Po zapoznaniu się z nimi na temat ich wymagań należy pamiętać, że masz już szablon zbliżony do tego, czego potrzebują.
Szablon jest jednym z pierwszych napisanych plików Bicep, więc martwisz się, że może nie być gotowy do użycia. Pytanie brzmi: jak można skorygować szablon, aby upewnić się, że jest on poprawny, łatwy do zrozumienia, łatwy do odczytania i łatwy do zmodyfikowania?
Co zrobimy?
W tym module dowiesz się, jak ulepszać i refaktoryzować pliki Bicep, aby ułatwić innym osobom pracę. Dowiesz się, jak parametry i nazwy są ważną częścią tworzenia kodu Bicep i wdrożeń platformy Azure przydatnych dla innych. Dowiesz się również, jak zdefiniować strukturę szablonu, postępować zgodnie ze spójnym stylem i dodawać komentarze, które pomagają współpracownikom zrozumieć, jak działa szablon.
Jaki jest główny cel?
Po ukończeniu tego modułu będziesz mieć możliwość tworzenia szablonów Bicep, które są jasne, wielokrotnego użytku i dobrze udokumentowane.
Wymagania wstępne
Należy zapoznać się ze strukturą i składnią Bicep, w tym parametrami, pętlami, warunkami i modułami.
Aby wykonać kroki opisane w ćwiczeniach w module, potrzebne są następujące elementy:
- Zainstalowany lokalnie program Visual Studio Code
- Rozszerzenie Bicep dla programu Visual Studio Code zainstalowane lokalnie