{"canonical_url":"https://engineer.company/uk/glossary/bicep/","content_markdown":"# Bicep\n\n## Що це таке\n\nBicep — це мова від Microsoft, якою інфраструктуру Azure записують як текст: які\nресурси існують, як вони називаються, як налаштований кожен і як вони пов'язані\nміж собою. У файлі Bicep немає кроків. Він описує кінцевий результат, а Azure\nResource Manager, шар, через який проходять запити на керування Azure, сам\nвизначає, що створити, що змінити, а що залишити як є. Хто питає «що таке\nBicep?», зазвичай хоче знати, чи може він замінити клацання по порталу Azure.\nМоже, і в цьому більша частина його цінності.\n\nПід капотом Bicep — зручніший спосіб написати те, що Azure і так розумів.\nResource Manager давно приймає шаблони розгортання у форматі JSON: вони повні,\nале їх важко читати й ще важче рецензувати. Під час розгортання інструмент\nкомандного рядка Bicep перетворює файл `.bicep` на такий JSON-шаблон, і Resource\nManager розгортає його так само, як написаний вручну. За словами Microsoft,\nBicep підтримує всі типи ресурсів і версії API одразу, щойно постачальник\nресурсів їх запроваджує, зокрема й попередні версії, тож новою службою можна\nкористуватися, не чекаючи, поки хтось оновить плагін. Наявні JSON-шаблони можна\nдекомпілювати в Bicep, і перенесення старої інфраструктури стає механічною\nроботою, а не переписуванням.\n\nНевеликий файл показує форму. Спершу параметри, далі ресурси, кожен із\nсимвольним ім'ям, на яке може посилатися решта файлу:\n\n```text\nparam env string\nparam location string = resourceGroup().location\n\nresource store 'Microsoft.Storage/storageAccounts@2023-05-01' = {\n  name: 'st${env}${uniqueString(resourceGroup().id)}'\n  location: location\n  sku: {\n    name: 'Standard_LRS'\n  }\n  kind: 'StorageV2'\n}\n```\n\nКоли інший ресурс згадує `store.id`, Bicep сам робить висновок, що той має\nдочекатися облікового запису сховища, тож порядок вручну ніхто не прописує, а\nResource Manager паралельно розгортає все, що ні від чого не залежить. Один файл\nможе викликати інший як модуль, і команда описує «базу даних з її мережевими\nправилами» один раз, а потім використовує всюди. Значення, що відрізняються між\nсередовищами, лежать в окремому файлі `.bicepparam`. Microsoft прямо пише, що\nBicep безкоштовний, має відкритий код і не задуманий як мова програмування\nзагального призначення: цикли, умови й функції в ньому є, але лише для опису\nресурсів.\n\nЯк Bicep співвідноситься з альтернативами? Порівняно з ARM JSON це той самий\nрушій із набагато коротшим кодом. Порівняно з Terraform різниця в охопленні й\nстані: Terraform працює з багатьма хмарами й веде власний файл стану, а процес роботи Bicep через Azure Resource Manager не веде власного файлу стану, бо стан розгортання зберігає Azure. [Розширення](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension) Bicep також підтримують ресурси поза Resource Manager, зокрема Kubernetes і Microsoft Graph. Порівняно з Pulumi, який описує інфраструктуру звичайними мовами\nпрограмування на кшталт TypeScript чи Go, Bicep міняє гнучкість на меншу мову,\nяку швидко прочитати під час рецензування.\n\n## Чому це важливо\n\nІнфраструктура, зібрана вручну, не має історії. Налаштування, змінене в порталі,\nне залишає по собі причини, ніхто не переглядає його до того, як воно стається,\nа відбудова середовища після поганого дня залежить від того, чи хтось пам'ятає\nкожне клацання. Коли інфраструктура — це набір файлів у репозиторії, вона\nотримує те, що код застосунку вже має: pull request, рецензента, історію й шлях\nназад.\n\nДруга перевага — однаковість. Development, staging і production, зібрані з тих\nсамих файлів із різними параметрами, відрізняються лише там, де так кажуть\nпараметри. Розгортання Bicep ідемпотентні: за словами Microsoft, той самий файл,\nрозгорнутий багато разів, дає ті самі типи ресурсів у тому самому стані. Тому\nрозгортання можна спокійно повторювати, а нове середовище — це та сама команда,\nспрямована на нову групу ресурсів.\n\nТретя — видимість до зміни. Операція what-if порівнює файл із тим, що працює, і\nперелічує кожен ресурс, який вона створила б, змінила б чи видалила б, ще до\nтого, як щось буде зачеплено. Разом із pull request такий попередній перегляд\nперетворює «здається, це змінює лише правило брандмауера» на твердження, яке\nрецензент може перевірити.\n\nЦіну теж варто назвати. Підтримка ресурсів залежить від способу розгортання та його розширень, тому для DNS в іншого постачальника чи ресурсів у другій хмарі все ще може знадобитися окремий інструмент. У способі роботи через Resource Manager Bicep описує ресурси Azure; пакети й файли всередині віртуальної машини належать до керування конфігурацією, наприклад Ansible.\nА поведінка Resource Manager за замовчуванням під час видалення й повторного\nрозгортання дивує тих, хто чекає, що інструмент бажаного стану прибере все, чого\nфайл більше не згадує. До цього ми повернемося нижче.\n\n## Як це виглядає на практиці\n\nКілька проєктів на Azure на цьому сайті тримаються на Bicep, і три з них\nпоказують, що він дає команді з часом.\n\nНа одній платформі вся інфраструктура Azure описана в Bicep.\n[Кожне середовище виходить із тих самих шаблонів](/uk/portfolio/provisioned-azure-infrastructure-as-code/):\napi та www як Azure Container Apps, PostgreSQL Flexible Server, Redis для\nкешування, Front Door з політикою WAF попереду й мережа під усім цим (VNet, NSG,\nприватний DNS), з підключеним Log Analytics для діагностики та образами з Azure\nContainer Registry проєкту. Оскільки все параметризовано, нове середовище чи\nзміна наявного — це pull request. Сторінка описує результат так: середовища\nстали відтворюваними й доступними для перегляду, а дрейф перестав бути загадкою,\nбо джерелом істини є код.\n\nТі самі шаблони несуть шлях релізу.\n[Релізи рухаються від development до staging і далі до production](/uk/portfolio/owned-end-to-end-platform-deployments-to-azure/),\nа шаблони Bicep тримають цільову інфраструктуру ідентичною від одного середовища\nдо іншого, тож білд не потрапляє в трохи інше місце. Конфігурація, що різниться\nміж середовищами, зберігається окремо від секретів, і той самий зібраний\nартефакт проходить усі етапи без перезбирання.\n\nА ще Bicep тримає частину плану відновлення.\n[Політику зберігання резервних копій налаштовано в Bicep поруч із базою даних, яку він захищає](/uk/portfolio/implemented-backups-and-disaster-recovery-as-code/),\nтож відновлення на конкретний момент часу є властивістю шаблону, а не\nналаштуванням, яке колись хтось клікнув. Середовище навколо бази теж описане\nкодом, і це важливо: відновити дані в середовище, яке довелося б відбудовувати з\nпам'яті, — навряд чи відновлення. Далі сторінка називає те, що лишається\nвідкритим: геонадлишковість вимкнено, а цільовий час відновлення запропоновано,\nа не виміряно. Шаблон показує, що налаштовано; скільки триває відновлення,\nпоказує лише тестове відновлення.\n\n## Де виникають проблеми\n\nБільшість клопоту з Bicep походить від очікування, що він поводиться як\nінструмент, який володіє всім у групі ресурсів. За замовчуванням він володіє\nлише тим, що згадано у файлі, і лише так, як файл каже.\n\n**Налаштування, змінене в порталі, зникає під час наступного розгортання.**\nПовторне розгортання ресурсу заново застосовує всі його властивості, а кожна\nвластивість, якої шаблон не містить, повертається до значення за замовчуванням.\nВиправлення, зроблене вручну під час інциденту, скасовує наступний звичайний\nреліз. Вважайте файл повним кінцевим станом кожного ресурсу, записуйте в нього\nкожне нестандартне значення, а термінові зміни робіть через pull request.\nНалаштування deny у deployment stack можуть узагалі заблокувати зміни в обхід\nрозгортання.\n\n**Ресурс, прибраний із шаблону, далі працює й далі коштує грошей.** Режим\nрозгортання за замовчуванням — інкрементний: ресурси в групі, яких файл не\nзгадує, залишаються на місці. Видаліть базу даних із коду, і в Azure вона\nзалишиться. Відповідь Microsoft — deployment stacks. Stack записує ресурси,\nякими керує, а його параметр `actionOnUnmanage` вирішує, чи ресурс, що випав із\nфайлу, буде від'єднано чи видалено. Режим complete теж видаляє те, чого у файлі\nнемає, але Microsoft не радить ним користуватися й поступово його виводить.\n\n**Попередній перегляд what-if показує зміни, яких ніхто не робив.** Властивість,\nякої у файлі немає, але яку Azure під час розгортання заповнює значенням за\nзамовчуванням, може бути показана як видалена, і Microsoft називає це шумом.\nБудь-яка властивість, задана через функцію `reference`, щоразу показується як\nзмінена, а значення на кшталт `utcNow()` чи захищеного параметра існують лише\nпід час розгортання, тож what-if показує їх необчисленими. Запускайте його на\nкожен pull request, читайте як чернетку й задавайте шумні властивості явно, щоб\nсправжні зміни було видно:\n\n```sh\naz deployment group what-if \\\n  --resource-group rg-staging \\\n  --template-file main.bicep \\\n  --parameters staging.bicepparam\n```\n\n**Пароль з'являється в історії розгортань.** Звичайний рядковий параметр\nзберігається разом із розгортанням, і його бачить кожен, хто має доступ на\nчитання до історії. Позначайте секретні параметри декоратором `@secure()`, який\nтримає значення поза історією й журналами, а сам секрет зберігайте в Key Vault,\nа не у файлі параметрів у репозиторії.\n\n## Що почитати далі\n\n- [What is Bicep?](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview)\n  — власний огляд від Microsoft: мова, її переваги й те, чим вона не намагається\n  бути.\n- [Bicep modules](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/modules)\n  — як розбити розгортання на файли, що викликають один одного.\n- [Parameters in Bicep files](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/parameters)\n  — типи, декоратори, значення за замовчуванням і те, що `@secure()` тримає поза\n  історією.\n- [Deployment modes](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes)\n  — інкрементний режим проти complete і що кожен робить із ресурсами, яких файл\n  не згадує.\n- [Bicep deployment what-if operation](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deploy-what-if)\n  — попередній перегляд розгортання, типи змін і відомі джерела шуму.\n- [Deployment stacks](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deployment-stacks)\n  — керування ресурсами як однією одиницею, з видаленням і налаштуваннями deny.\n\n\u003chttps://engineer.company/uk/glossary/bicep/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке Bicep, чим він відрізняється від ARM JSON і Terraform, як один набір файлів тримає середовища Azure однаковими і де з ним найчастіше помиляються.","formats":{"gemtext":"https://engineer.company/uk/glossary/bicep/index.gmi","gopher":"https://engineer.company/uk/glossary/bicep/gophermap","html":"https://engineer.company/uk/glossary/bicep/","json":"https://engineer.company/uk/glossary/bicep/index.json","markdown":"https://engineer.company/uk/glossary/bicep/index.md","pdf":"https://engineer.company/uk/glossary/bicep/index.pdf"},"kind":"page","language":"uk","title":"Що таке Bicep?","url":"https://engineer.company/uk/glossary/bicep/","version":1}