{"canonical_url":"https://engineer.company/uk/glossary/infrastructure-as-code/","content_markdown":"# Інфраструктура як код\n\n## Що це таке\n\nІнфраструктура як код — це підхід, за якого все, на чому працює система\n(машини, мережі, правила брандмауера, балансувальники навантаження, записи DNS), описують у текстових файлах,\nзберігають ці файли в системі контролю версій, а справжнє середовище з них\nбудує інструмент. Оригіналом стають файли. Зміна інфраструктури починається як\nзміна у файлі, проходить те саме рев'ю, що й код застосунку, і потрапляє в\nробочу систему лише тоді, коли її застосує інструмент. В англомовній\nдокументації підхід називають Infrastructure as Code, часто скорочено IaC.\n\nПосібник NIST SP 800-204C, присвячений DevSecOps для програм, побудованих із\nмікросервісів, описує інфраструктуру як код так: це код, що створює й налаштовує\nресурси, на яких розгортають програму, і робить це відтворювано й однаково\nщоразу. За тим самим посібником, ці описи тримають під контролем версій тими\nсамими інструментами, що й вихідний код самої програми. У відтворюваності вся\nсуть. Середовище, яке можна створити з файлів, можна створити знову: поруч із\nпершим, після аварії або в тестовому обліковому записі у вівторок по обіді.\n\nОписи бувають двох основних видів. Декларативний опис називає кінцевий\nрезультат, скажімо, сервер певного розміру в певній мережі з одним відкритим\nпортом, а інструмент сам визначає, що створити, що змінити, а що залишити.\nІмперативний опис — це перелік кроків: створи це, приєднай те, потім відкрий\nпорт. SP 800-204C зараховує інфраструктуру як код до декларативного коду:\nкоманда записує, що їй потрібно, а інструмент перетворює це на робочий\nекземпляр. HashiCorp так само описує мову Terraform: вона задає мету, а не кроки\nдо неї. Різниця видна під час другого запуску. Перелік кроків фіксує, як щось\nзробили одного разу, а декларативний опис — що має існувати, і саме це\nінструментові треба знати, коли частина вже існує.\n\nЄдиної мови немає. SP 800-204C зауважує, що залежно від інструмента код пишуть\nабо звичайною скриптовою мовою, як-от Python, JavaScript чи TypeScript, або\nвласною мовою конфігурації інструмента, наприклад HCL від HashiCorp, яка може\nбути сумісною зі стандартним форматом на кшталт JSON, а може й ні. Мова\nTerraform належить до другого виду, і її файли мають розширення `.tf`. Azure\nприймає шаблони Resource Manager у JSON або в коротшій мові Bicep. Ansible пише\nсвої плейбуки в YAML і дістається до машин через SSH з їхніми наявними\nобліковими даними, не встановлюючи на них агента.\n\nКорисно розрізняти два завдання, які обидва потрапляють під цю назву.\nПідготовка ресурсів (provisioning) створює складники: віртуальну машину, диск,\nмережу, брандмауер. Налаштування формує те, що працює всередині вже наявної\nмашини: пакети, облікові записи, службові файли. Одні інструменти тяжіють до\nпершого завдання, інші до другого, і межа між ними розмита. Інфраструктурою як\nкодом обидва робить те, що опис лежить у репозиторії, а інструмент приводить\nсправжню систему у відповідність до нього.\n\nІнструменти ще й по-різному пам'ятають, що вони збудували. Terraform веде файл\nстану, який зіставляє ресурси з конфігурації зі створеними насправді об'єктами,\nі документація називає цей стан джерелом істини для середовища. Bicep файлу\nстану не має, бо Azure сам веде облік розгорнутого. Те, де лежить цей облік,\nвизначає, що станеться, коли двоє людей запустять інструмент одночасно або\nколи облік загубиться.\n\n## Чому це важливо\n\nДо інфраструктури як коду кожне середовище налаштовували вручну й потім так само\nвручну латали. Тестове середовище отримало виправлення, якого не отримав\nпродакшн, порт, відкритий для перевірки, так і не закрили, одна машина з трьох\nдістала новішу версію пакета. SP 800-204C називає це дрейфом: чинні налаштування\nвже не дають того робочого стану, який задумували. Посібник називає й звичайний\nшлях до нього: зміну, зроблену у вебконсолі чи в командному рядку в обхід коду.\nКоли реліз працює на тестовому середовищі й падає в продакшні, причина часто\nсаме в такому розходженні.\n\nІнфраструктура як код виносить оригінал за межі робочої системи. Команда змінює\nопис, а робоча система йде за ним. Ніхто не заходить на сервер, щоб поправити\nправило брандмауера: правлять файл, що описує брандмауер, а зміну виконує\nінструмент. З цього випливають три речі.\n\nПерша — рев'ю та історія. Зміна мережі стає диффом у pull request, який читає\nдруга людина, перш ніж щось станеться. Через кілька місяців на питання, хто й\nнавіщо відкрив порт, відповідає історія комітів, а не чиясь пам'ять. Скасувати\nзміну означає зробити revert і ще раз запустити інструмент.\n\nДруга — повторюваність. Добре написаний опис ідемпотентний: застосований до\nсередовища, яке вже йому відповідає, він залишає все як є, а застосований до\nсередовища, що відхилилося, повертає його назад. Шляхів до цього два: або\nпідлаштувати те, що вже є, або відкинути його й збудувати нове з опису. Другий\nшлях, узятий за правило, — це незмінна інфраструктура.\n\nТретя — дешеві середовища. SP 800-204C описує ці інструменти як автоматизацію\nвсього життя інфраструктури, від створення ресурсів до їх вивільнення, і\nзауважує, що частина її живе так недовго, що підтримувати її немає сенсу.\nКоманда може створювати кілька тестових середовищ на вимогу й потім прибирати\nїх, а сам код можна перевірити, перш ніж він щось зачепить: посібник вимагає\nсканувати кожен його фрагмент на вразливості до злиття. Гілка може отримати\nвласну короткочасну копію продакшн-схеми, а рецензент — побачити попередній\nперегляд зміни до того, як її схвалити.\n\nЦіну теж варто назвати прямо. Змінити одне правило брандмауера через pull\nrequest довше, ніж клацнути у вебконсолі, і під час збою це відчувається\nдорого. Кожен інструмент має власну мову й власну модель стану, які треба\nвивчити. А файл, що вміє збудувати середовище, вміє його й видалити: важіль\nдіє однаково далеко в обидва боки, тому попередній перегляд важить стільки ж,\nскільки й запуск після нього.\n\n## Як це виглядає на практиці\n\nОсь одна зміна на шляху від правки до робочої системи, у налаштуванні, де\nCI-завдання запускає інструмент і публікує пробний прогін у pull request:\n\n```text\nДень 1   09:10  Правка опису мережі: дозволити TCP 443 з офісу\n         09:12  Відкрито pull request; CI робить пробний прогін (план)\n         09:14  План у pull request: одне правило додано, жодне не прибрано\n         10:30  Рецензент читає і план, і дифф, і схвалює\n         10:31  Злиття; CI застосовує саме той план, що пройшов рев'ю\n         10:33  Повторний запуск того самого опису: змін немає\nДень 40         Хтось питає, чому відкритий 443: історія комітів знає хто\n```\n\nПлан — це та частина, що виправдовує весь процес. Дифф показує, що автор хотів\nзмінити, а план — що інструмент справді збирається зробити, зокрема те, чого\nавтор не чекав, наприклад ресурс, який інструмент має намір знищити. Terraform\nуміє зберегти план у файл через `-out`, і `terraform apply` з цим файлом\nвиконує саме записані в ньому операції, тож о 10:31 працює те, що рецензент\nсхвалив о 10:30. Тихий повторний запуск о 10:33 підтверджує, що опис і система\nтепер узгоджені.\n\nНа цьому сайті\n[сторінка послуги Infrastructure as Code](/uk/services/infrastructure-as-code/)\nописує відтворюване розгортання серверів на основі конфігурації під контролем\nверсій, а не з опорою на чиюсь пам'ять.\n\nБезпечний шлях до цього — здебільшого питання порядку, і\n[запис у портфоліо за вересень 2026 року](/uk/portfolio/provisioned-a-second-server-from-code/)\nпоказує чому. Ідеться про ще один сервер, розміщений в іншого провайдера.\nПопередню машину налаштовували вручну й захистили пізніше, тож якийсь час щойно\nстворений хост, що мав лише стандартну політику паролів, був відкритий для\nвсього інтернету. Цього разу сервер створили з репозиторію, і захист з'явився\nраніше за саму машину. Плей брандмауера запускають до плею сервера, а в другого\nпровайдера теги призначають до хмарного брандмауера, адже правилам, націленим на\nтеги, ні до чого прив'язатися, доки тегів немає. Повторний запуск нічого не\nзіпсує: якщо машина вже є, роль просто бере її до роботи замість створювати ще\nодну. Лише ця роль коштує грошей, тому в її власній документації записано\nрегіон, тип машини з характеристиками та місячну ціну в євро. Запис також чесно\nкаже, чого не бачить пробний прогін. Обидва брандмауери налаштовуються викликами\nREST API провайдерів з універсального HTTP-завдання, а це завдання не підтримує\nрежиму перевірки (check mode). Через це пробний прогін його оминає. Справжня\nрепетиція — окремий запуск плею брандмауера: він нічого не коштує, і його можна\nвідкотити.\n\n## Де виникають проблеми\n\nІнфраструктурний код зазвичай ламається так, що це скидається на успіх.\nІнструмент відпрацьовує без помилок, CI-запуск зелений, а файли й справжня\nсистема тихо розходяться.\n\n**Швидку ручну правку під час інциденту скасовує наступний запуск.** Хтось о\nдругій ночі відкриває порт у консолі, збій минає, а за тиждень плановий запуск\nзнову закриває порт, бо файли про нього так і не дізналися. Буває й навпаки:\nінструмент більше ніхто не запускає, і файли перестають описувати реальність.\nПеренесіть аварійну зміну в код того ж дня і заведіть плановий запуск, який\nпорівнює файли з тим, що працює. SP 800-204C вимагає такої звірки одразу після\nкожного розгортання і далі періодично під час роботи системи. У Terraform\nдетальний код виходу команди plan робить із цього коротке нічне завдання:\n\n```sh\nterraform plan -detailed-exitcode\n# exit 0: змін немає, exit 1: помилка, exit 2: є зміни\n```\n\nНа гілці, яку вже застосовано, код виходу 2 означає, що справжня система\nвідійшла від коду, і комусь варто з'ясувати чому.\n\n**Видалення ресурсу з файлу не завжди видаляє сам ресурс.** Інструменти\nпо-різному тлумачать ресурс, якого немає в описі. Для шаблонів Azure Resource\nManager документація Microsoft про what-if пише, що ресурс, який існує, але\nвідсутній у шаблоні, видаляється лише в режимі complete. В інших режимах він\nпрацює далі й далі коштує грошей. Вивчіть правило видалення свого інструмента,\nперш ніж на нього покладатися, і шукайте в попередньому перегляді як очікувані\nвидалення, так і ті, яких боїтеся.\n\n**Пробний прогін бачить не все.** Попередній перегляд — це модель зміни, а не\nгарантія. Документація Microsoft про what-if наводить властивості, які\nпозначаються як видалені, хоча Azure лише підставляє значення за замовчуванням\nпід час розгортання, і називає такий результат шумом; будь-яка властивість,\nзадана через функцію `reference`, показується як змінена при кожному запуску.\nЗапис у портфоліо вище показує іншу прогалину: завдання без підтримки режиму\nперевірки пробний прогін пропускає, тож попередній перегляд про нього мовчить.\nЗнайте відомий шум свого інструмента й вважайте неперевіреним усе, чого\nпопередній перегляд не бачить, доки це не покриє репетиція на чомусь дешевому\nй оборотному.\n\n**Секрети потрапляють у репозиторій або в стан.** Пароль, вписаний у файл\nопису, лишається в історії кожної копії репозиторію. Менш очевидне:\nдокументація Terraform попереджає, що стан може містити секрети, а за\nзамовчуванням цей стан — локальний файл `terraform.tfstate`. Тримайте секрети\nв окремому сховищі секретів і посилайтеся на них за назвою, зберігайте стан\nвіддалено з блокуванням і контролем доступу, як радить HashiCorp, і ніколи не\nправте файл стану вручну: для потрібних змін існує команда `terraform state`.\n\n**Скрипт видають за опис.** Shell-скрипт у репозиторії, що створює сервер,\nперебуває під контролем версій, але він не ідемпотентний: запустіть його двічі,\nі серверів стане два або посередині з'явиться помилка. Користуйтеся\nдекларативними ресурсами або кроками, які спершу перевіряють, а потім діють, як\nроль вище, що підхоплює наявну машину. Документація Ansible формулює планку\nпрямо: коли система вже в стані, описаному плейбуком, повторний запуск\nплейбука її не змінює.\n\n## Що почитати далі\n\n- [Implementation of DevSecOps for a Microservices-based Application with Service Mesh (NIST SP 800-204C)](https://csrc.nist.gov/pubs/sp/800/204/c/final)\n  — декларативний код інфраструктури під контролем версій, дрейф і сканування.\n- [Terraform Language Documentation](https://developer.hashicorp.com/terraform/language)\n  — декларативна мова, її ресурси та блоки.\n- [Command: plan](https://developer.hashicorp.com/terraform/cli/commands/plan)\n  — пробний прогін, збережені плани й детальні коди виходу.\n- [State](https://developer.hashicorp.com/terraform/language/state)\n  — що записує Terraform, де це зберігається і чому це чутливі дані.\n- [Introduction to Ansible](https://docs.ansible.com/ansible/latest/getting_started/introduction.html)\n  — автоматизація без агентів через SSH, плейбуки й бажаний стан.\n- [Template deployment what-if](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deploy-what-if)\n  — попередній перегляд розгортання в Azure, типи змін і відомий шум.\n\n\u003chttps://engineer.company/uk/glossary/infrastructure-as-code/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що таке інфраструктура як код, навіщо командам описувати сервери й мережі файлами, як одна зміна доходить до робочої системи і де цей підхід ламається.","formats":{"gemtext":"https://engineer.company/uk/glossary/infrastructure-as-code/index.gmi","gopher":"https://engineer.company/uk/glossary/infrastructure-as-code/gophermap","html":"https://engineer.company/uk/glossary/infrastructure-as-code/","json":"https://engineer.company/uk/glossary/infrastructure-as-code/index.json","markdown":"https://engineer.company/uk/glossary/infrastructure-as-code/index.md","pdf":"https://engineer.company/uk/glossary/infrastructure-as-code/index.pdf"},"kind":"page","language":"uk","title":"Що таке інфраструктура як код?","url":"https://engineer.company/uk/glossary/infrastructure-as-code/","version":1}