﻿---
title: Infrastructure as Code
description: "IaC: декларативная инфраструктура, state, plan/apply, configuration management, модули, drift, тестирование и выбор против PaaS."
---

## Что такое IaC

**Infrastructure as Code (IaC)** — управление инфраструктурой через версионируемые конфигурации и автоматизированный процесс. Серверы, сети, базы данных, DNS и даже настройки SaaS описываются в файлах, после чего инструмент приводит реальные ресурсы к желаемому состоянию.

Основная ценность — воспроизводимость и проверяемость изменений. Конфигурация проходит review, один и тот же набор параметров можно применить к разным окружениям, а история объясняет, когда и зачем появился ресурс.

## Provisioning и configuration management

| Задача | Что происходит | Типичные инструменты |
|---|---|---|
| **Provisioning** | Создание и изменение облачных ресурсов: VPC, VM, БД, DNS | Terraform, OpenTofu, Pulumi |
| **Configuration management** | Настройка ОС и приложений на существующих машинах | Ansible, Chef, SaltStack |
| **Image building** | Подготовка воспроизводимого образа машины или контейнера | Packer, Docker |
| **GitOps-контроллер** | Согласование желаемого состояния из Git с целевой средой | Argo CD, Flux |

Инструменты можно комбинировать: Terraform создаёт VM и сеть, Ansible настраивает пакеты, Docker упаковывает приложение. Не стоит описывать один и тот же ресурс в двух независимых системах без явного владельца.

## Декларативное состояние и state

Декларативная конфигурация описывает **что должно существовать**, а не последовательность ручных команд. Императивный скрипт описывает шаги; на практике инструменты могут сочетать оба подхода.

Для Terraform-подобных систем **state** связывает объявления конфигурации с реальными ресурсами и помогает рассчитать изменение. State:

- не заменяет резервную копию данных;
- может содержать чувствительные значения;
- требует защищённого хранения и контроля доступа;
- не должен редактироваться вручную как обычный способ администрирования;
- требует согласованной работы команды и блокировки там, где она поддерживается.

## Рабочий цикл

```text
Изменение ветки → review → fmt/validate/test → plan
              → проверка последствий → apply → проверка результата
```

**Plan** особенно важен: перед применением видно, какие ресурсы будут созданы, изменены или уничтожены. Замена и удаление stateful-ресурса — не косметическая операция; для БД, дисков и бакетов нужны отдельные правила защиты и восстановления.

## Модули и окружения

Модуль инкапсулирует повторяемый набор ресурсов и явные входы/выходы. Хороший модуль не скрывает важные решения и не содержит секреты или уникальные имена проекта.

Окружения различаются параметрами, а не случайными копиями конфигурации. Общие модули переиспользуются, но production может отличаться размером, числом зон и политикой защиты.

## Drift и ручные изменения

**Drift** — расхождение желаемого состояния в коде с фактической инфраструктурой. Он возникает после ручных изменений, действий других автоматизаций или сбоев применения.

Обнаружение drift не означает автоматический откат: сначала нужно понять, какое состояние правильное и безопасно ли применять план. Аварийное ручное изменение затем вносят в код или осознанно импортируют в процесс.

## Проверки IaC

- форматирование, validate и статический анализ;
- политики безопасности: публичные бакеты, открытые порты, широкие IAM;
- unit/property tests для модулей и программной конфигурации;
- plan в CI с review разрушительных операций;
- интеграционная проверка во временном окружении;
- проверка фактического результата и удаление временных ресурсов.

## Когда IaC не нужен

Для одного сайта на managed-хостинге ручная панель может быть проще и дешевле. IaC становится полезнее при нескольких окружениях, повторяемых проектах, регулярных изменениях, требованиях audit trail или необходимости восстановить инфраструктуру по коду. PaaS остаётся разумным выбором, если операционная сложность перевешивает потребность в контроле.

## Страницы направления

- [GitOps](https://wpcraft.ru/kb/infrastructure/iac/gitops.md) — Git как источник желаемого состояния и автоматическое согласование.
- [IaC для WordPress](https://wpcraft.ru/kb/infrastructure/iac/iac-wordpress.md) — архитектурные шаблоны и прикладная реализация.

## Связанные инструменты

- [Terraform](https://wpcraft.ru/kb/infrastructure/tools/terraform.md) — провайдеры, state и write/plan/apply.
- [OpenTofu](https://wpcraft.ru/kb/infrastructure/tools/opentofu.md) — open-source-совместимый рабочий процесс IaC.
- [Pulumi](https://wpcraft.ru/kb/infrastructure/tools/pulumi.md) — IaC на общих языках программирования.
- [Ansible](https://wpcraft.ru/kb/infrastructure/tools/ansible.md) — настройка систем и оркестрация.
- [Argo CD](https://wpcraft.ru/kb/infrastructure/tools/argo-cd.md) — GitOps для Kubernetes.

## Связанные материалы

- [DevOps](https://wpcraft.ru/kb/infrastructure/devops.md) — доставка приложений и окружения.
- [Окружения](https://wpcraft.ru/kb/infrastructure/devops/environments.md) — параметры и продвижение изменений.
- [SRE](https://wpcraft.ru/kb/infrastructure/sre.md) — надёжность как критерий инфраструктурных решений.

## Материалы и источники

- [Terraform: Introduction](https://developer.hashicorp.com/terraform/intro) — providers, state и write/plan/apply.
- [OpenTofu: Introduction](https://opentofu.org/docs/intro/) — декларативное управление ресурсами и state.
- [Pulumi: Infrastructure as Code](https://www.pulumi.com/docs/iac/) — языки, ресурсы, тестирование и operations.
- [DORA: Flexible infrastructure](https://dora.dev/capabilities/flexible-infrastructure/) — эластичность, воспроизводимость и видимость стоимости.