{"canonical_url":"https://engineer.company/uk/glossary/terraform/","content_markdown":"# Terraform\n\n## Що це таке\n\nTerraform — це інструмент HashiCorp для інфраструктури як коду. Ресурси в\nхмарі та у власному дата-центрі описують у звичайних текстових файлах,\nзберігають ці файли в системі контролю версій, а Terraform сам визначає, які\nсправжні об'єкти треба створити, змінити чи знищити, щоб робоче середовище\nвідповідало файлам. Саму програму викликають як `terraform`, малими літерами,\nі саме так назва записана в кожній команді та скрипті.\n\nМова декларативна. Документація HashiCorp описує її як мову, що задає мету, а\nне кроки, які до неї ведуть. Конфігурація каже, що в певній мережі існує\nмашина певного розміру; вона не перелічує викликів API, потрібних, щоб таку\nмашину створити. Файли мають розширення `.tf`, а ще є варіант на основі JSON\nіз розширенням `.tf.json`. Рідний синтаксис визначено через синтаксис під\nназвою HCL, і він має два основні елементи: блок, тобто контейнер для іншого\nвмісту, та аргумент, який надає назві значення.\n\nНа трьох ідеях тримається решта інструмента.\n\nПровайдери — це плагіни. Конфігурація підказує Terraform, які плагіни\nвстановити, а `terraform init` знаходить, завантажує й установлює їх. HashiCorp\nпише, що провайдери дають Terraform змогу працювати практично з будь-якою\nплатформою чи сервісом, які мають доступний API, а загальнодоступні провайдери\nзібрані в Terraform Registry. Провайдер визначає типи ресурсів для своєї\nплатформи, тож та сама основна програма може керувати зоною DNS, віртуальною\nмашиною й правилом моніторингу в трьох різних постачальників.\n\nМодулі — це каталоги. Модуль — це набір файлів `.tf` і `.tf.json`, що лежать\nразом в одному каталозі, а кореневий модуль — це робочий каталог, з якого\nзапускають Terraform.\n\nСтан — це пам'ять. Terraform відстежує справжню інфраструктуру у файлі стану,\nякий вступ до документації називає джерелом істини для середовища. Цей файл\nзіставляє кожен ресурс конфігурації зі справжнім об'єктом, яким керує, і\nзберігає поруч метадані. За замовчуванням це локальний файл\n`terraform.tfstate`, а попередня версія лежить поруч як\n`terraform.tfstate.backup`.\n\nЛіцензія змінилася. 10 серпня 2023 року HashiCorp оголосила, що переводить\nсвій вихідний код з Mozilla Public License 2.0 на Business Source License 1.1\nдля всіх майбутніх випусків своїх продуктів, тоді як API, SDK і майже всі інші\nбібліотеки лишаються під MPL 2.0. OpenTofu називає себе форком Terraform,\nзапочаткованим Gruntwork, Spacelift, Harness, Env0, Scalr та іншими, який\nрозвивається під опікою Linux Foundation. Репозиторій проєкту опубліковано під\nMPL 2.0, а сайт представляє OpenTofu як заміну Terraform, що зберігає наявні\nробочі процеси й конфігурації.\n\n## Чому це важливо\n\nHashiCorp описує основний робочий процес трьома кроками. Write: ви визначаєте\nресурси, які можуть охоплювати кількох провайдерів і сервіси. Plan: Terraform\nскладає план виконання, де описано, що він створить, оновить або знищить.\nApply: після схвалення Terraform виконує заплановані операції в правильному\nпорядку з урахуванням залежностей між ресурсами, які він визначає, будуючи\nграф ресурсів.\n\nНайбільше користі дає середній крок. План — це попередній перегляд, який може\nпрочитати людина, що не писала зміну, ще до того, як щось станеться. Рецензент\nбачить більше, ніж різницю між файлами: він бачить наслідки, тобто два ресурси\nстворено, один оновлено і час від часу один знищено, хоча чіпати його ніхто не\nзбирався. Цей останній рядок дешево помітити в pull request і дуже дорого\nвиявити згодом.\n\nДруга причина — охоплення. Оскільки знання про кожну платформу живе в її провайдері, одна мова, один робочий процес і одні звички рев'ю охоплюють усіх провайдерів, якими користується команда. Компанія з двома хмарами й окремим постачальником DNS може описати всі три в одному репозиторії та перевіряти їх однаково. Bicep від Microsoft робить інший вибір у робочому процесі Azure Resource Manager: він не веде власного файлу стану, бо Azure зберігає стан розгортання. Це не означає, що Bicep працює лише з Azure: його [розширення](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension) підтримують також ресурси поза Resource Manager, зокрема Kubernetes і Microsoft Graph.\n\nТретя причина — стан. Оскільки Terraform записує, який справжній об'єкт належить\nякому блоку, він може відрізнити об'єкт, яким керує, від того, якого ніколи не\nбачив, і може порівняти свій облік із тим, що працює. Цей облік водночас і ціна\nінструмента. Він має лежати там, де до нього дістанеться вся команда, йому\nпотрібне блокування, щоб два запуски не писали в нього одночасно, і в ньому\nможуть опинитися секрети, тож контроль доступу до нього має бути таким самим\nсуворим, як до них.\n\nЄ й менші витрати. HCL — ще одна мова, яку треба вивчити, а кожен провайдер має\nвласні типи ресурсів і примхи. Командам, що будують продукт поверх Terraform,\nварто ще й прочитати ліцензію: у FAQ HashiCorp про ліцензію є окреме питання\nпро те, що вважають конкурентною пропозицією. OpenTofu пропонує той самий\nробочий процес під MPL 2.0.\n\n## Як це виглядає на практиці\n\nСторінка HashiCorp про синтаксис ресурсів наводить як приклад такий блок:\n\n```hcl\nresource \"aws_instance\" \"web\" {\n  ami           = \"ami-a1b2c3d4\"\n  instance_type = \"t2.micro\"\n}\n```\n\n`resource` — це тип блоку, а `aws_instance` — тип ресурсу, який визначає\nпровайдер AWS. `\"web\"` — локальна назва: за цією міткою Terraform відстежує\nресурс у файлі стану, і на налаштування справжньої машини вона не впливає. Два\nрядки всередині блоку — це аргументи.\n\nТри команди переводять файл із тексту в працюючу машину:\n\n```sh\nterraform init\nterraform plan -out=tfplan\nterraform apply tfplan\n```\n\n`terraform init` готує робочий каталог: установлює плагіни провайдерів, яких\nпотребує конфігурація, і налаштовує місце, де зберігатиметься стан. Цю команду\nбезпечно запускати кілька разів, а її документація радить комітити файл\nблокування залежностей у систему контролю версій.\n\n`terraform plan -out=tfplan` обчислює план і записує його у файл у непрозорому форматі. Планування не застосовує запропонованих змін інфраструктури. Потім `terraform apply tfplan` виконує операції з цього файлу, не питаючи підтвердження, бо HashiCorp вважає саму передачу збереженого плану схваленням. З тієї ж причини прапорець `-auto-approve` ігнорується, коли передано файл плану.\n\nУ команді поділ складається сам собою. CI-завдання запускає plan на pull\nrequest і зберігає файл, людина читає план, а не лише різницю у файлах, а після\nзлиття друге завдання застосовує саме цей файл, тож виконується те, що\nпрочитали. Документація apply додає умову, про яку легко забути: подбайте, щоб\nніхто не міг змінити інфраструктуру в обхід робочого процесу Terraform, інакше\nплан описуватиме світ, який уже зрушив.\n\nНа цьому сайті [сторінка про технології](/uk/tech-stack/) ставить Terraform\nпоряд з Ansible: обидва записують бажаний стан машин, тож середовище можна\nпрочитати, а не відновлювати навпомацки. Один запис у портфоліо застосовує ту\nсаму ідею з іншим інструментом:\n[інфраструктуру Azure розгорнули як код](/uk/portfolio/provisioned-azure-infrastructure-as-code/)\nна Bicep. Середовища testing, staging і product збираються з одного набору\nшаблонів, а оскільки шаблони приймають параметри, нове чи змінене середовище —\nце pull request. Поряд із цією статтею приклад показує той самий компроміс, що й\nвище. Bicep не має власного файлу стану, бо облік веде сама Azure, тоді як\nTerraform зберігає власний стан і натомість працює з різними хмарами.\n\n## Де виникають проблеми\n\nБільшість аварій із Terraform мають однакову форму: конфігурація правильна,\nзапуск успішний, а щось справжнє зникло або змінилося.\n\n**Перейменований ресурс знищується.** Змініть мітку `\"web\"` на `\"frontend\"`, і\nресурс отримає нову адресу. Посібник HashiCorp з рефакторингу каже, що за\nзамовчуванням Terraform сприймає змінену адресу як вказівку знищити наявний\nоб'єкт і створити новий. Для машини, яку не шкода викинути, це кілька хвилин;\nдля бази даних це втрачені дані. Вихід — блок `moved`, який оновлює адресу,\nнічого не знищуючи:\n\n```hcl\nmoved {\n  from = aws_instance.web\n  to   = aws_instance.frontend\n}\n```\n\nНе прибирайте блок, коли він зробив свою справу. HashiCorp наполегливо радить\nзберігати старі блоки `moved` і пише, що видалення такого блоку ламає\nсумісність.\n\n**Двоє людей запускають apply з двома копіями локального стану.** Від початку\nстан кожного workspace — це локальний файл. Це годиться для однієї людини на\nодному ноутбуці. Щойно колега запускає Terraform з іншої копії, два файли стану\nрозходяться в тому, що існує, і кожен запуск діє за своєю версією. Вихід —\nтримати стан у HCP Terraform або у віддаленому сховищі з блокуванням і\nконтролем доступу, як радить HashiCorp. Тоді Terraform автоматично блокує стан\nдля кожної операції, що може в нього писати, і не продовжує, якщо блокування\nвзяти не вдалося. Блокування підтримують не всі сховища, тож перевірте це до\nвибору, а прапорець `-lock=false` не чіпайте: він існує, але документація його\nне радить.\n\n**Завислий замок зламують, поки хтось іще працює.** Коли автоматичне\nрозблокування не спрацьовує, замок лишається, і команда `force-unlock` знімає\nйого за ідентифікатором блокування, який вивів Terraform. Документація про\nблокування просить бути дуже обережними: якщо зламати замок, який тримає хтось\nінший, у той самий стан можуть писати двоє, а команда призначена лише для\nвласного замка після невдалого автоматичного розблокування. Вихід — з'ясувати,\nчий це замок і чи той запуск іще живий, перш ніж щось форсувати.\n\n**Файл стану розкриває секрети.** HashiCorp попереджає, що секрети можуть\nпотрапити в стан і що їх можна розкрити, якщо стан лежить у системі без\nнадійного контролю доступу. Файл стану в бакеті, який може прочитати будь-хто,\nабо скопійований в артефакт збірки, — це витік облікових даних. Тримайте його\nпоза репозиторієм, давайте йому такий самий контроль доступу, як секретам, що в\nньому лежать, і ніколи не правте його вручну: для потрібних виправлень існує\nкоманда `terraform state`.\n\n**Схвалення перетворюється на формальність.** Прапорець `-auto-approve`\nпропускає інтерактивне схвалення плану, і збережений файл плану теж його\nпропускає, бо сам файл вважається схваленням. Документація apply наголошує, що\nце стосується й руйнівних операцій, як-от видалення ресурсів. CI-завдання, яке\nвиконує apply після кожного злиття без переглянутого плану, прибрало єдину мить,\nколи людина могла б побачити знищення заздалегідь. Вихід — описаний вище процес\nзі збереженим планом і обов'язковим рев'ю людиною між завданням plan і\nзавданням apply. Там, де `-auto-approve` використовують в автоматизації,\nHashiCorp сама радить спершу виконати plan і переглянути його.\n\n## Що почитати далі\n\n- [What is Terraform?](https://developer.hashicorp.com/terraform/intro)\n  — вступ від HashiCorp: write, plan, apply, провайдери й стан.\n- [terraform apply command](https://developer.hashicorp.com/terraform/cli/commands/apply)\n  — збережені плани, `-auto-approve` і запуск команди в автоматизації.\n- [State Locking](https://developer.hashicorp.com/terraform/language/state/locking)\n  — автоматичні блокування, сховища без них і застереження про `force-unlock`.\n- [Refactor modules](https://developer.hashicorp.com/terraform/language/modules/develop/refactoring)\n  — чому змінена адреса означає знищення й створення, і блок `moved`.\n- [HashiCorp adopts Business Source License](https://www.hashicorp.com/en/blog/hashicorp-adopts-business-source-license)\n  — оголошення серпня 2023 року про перехід з MPL 2.0 на BSL 1.1.\n- [OpenTofu](https://opentofu.org/)\n  — форк Terraform, який розвивається під опікою Linux Foundation.\n\n\u003chttps://engineer.company/uk/glossary/terraform/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Що таке Terraform, як поєднуються write, plan і apply, навіщо файлу стану блокування і як перейменування чи пропущене рев'ю знищує справжні ресурси.","formats":{"gemtext":"https://engineer.company/uk/glossary/terraform/index.gmi","gopher":"https://engineer.company/uk/glossary/terraform/gophermap","html":"https://engineer.company/uk/glossary/terraform/","json":"https://engineer.company/uk/glossary/terraform/index.json","markdown":"https://engineer.company/uk/glossary/terraform/index.md","pdf":"https://engineer.company/uk/glossary/terraform/index.pdf"},"kind":"page","language":"uk","title":"Що таке Terraform?","url":"https://engineer.company/uk/glossary/terraform/","version":1}