Главная/Разработка/Terraform
Установка Terraform и первый VPS в Таймвеб Клауд
Установка Terraform нужна, чтобы описывать серверы текстом и создавать их одной командой: в Таймвеб Клауд серверами управляют через API, CLI и Terraform. Terraform работает на вашем компьютере, читает файлы .tf, сверяет их с облаком и создаёт недостающее, а провайдер twc подключает его к Таймвеб Клауд.
Ответ за 30 секунд
Terraform окупается, когда серверы нужно создавать и удалять повторяемо: стенд под ветку, копия окружения, кластер для теста. Для одного сервера хватит панели. Токен API держите в переменной TWC_TOKEN, а файл состояния terraform.tfstate не отправляйте в Git: в нём лежат идентификаторы и часто секреты.
Почасовая оплата: создайте сервер через terraform apply, проверьте схему и удалите его командой destroy.
Рабочий цикл Terraform: init, plan, apply и destroy0.13+версии Terraform для провайдера
twcимя провайдера в конфиге
4 командыinit, plan, apply, destroy
01 · 1 мин
Что делает Terraform и когда он нужен для VPS#
Terraform это инструмент, в котором вы описываете желаемое состояние инфраструктуры в файлах формата HCL: какие серверы, диски, домены и сети должны существовать. Команда plan показывает разницу между описанием и облаком, команда apply её устраняет.
| Способ управления | Для чего подходит |
|---|---|
| Панель управления | Один-два сервера, разовые действия |
| API и CLI | Скрипты и интеграции с вашим кодом |
| Terraform | Повторяемые окружения, откат изменений по плану, хранение описания в Git |
Почасовая оплата делает Terraform удобным для временных стендов: сервер живёт пока идёт проверка, потом его удаляет destroy. После создания сервер настраивают отдельно, например плейбуком из страницы установка Ansible.
02 · 1 мин
Установка Terraform на Ubuntu, Windows и macOS#
Terraform ставится на ваш компьютер или на сервер CI, где запускаются сборки, а не на создаваемый VPS. Провайдер Таймвеб Клауд поддерживает Terraform версии 0.13 и выше, на более старых работа не заявлена.
- Ubuntu и Debian: пакет из apt-репозитория HashiCorp либо архив с одним файлом
terraform, который кладут в/usr/local/bin. - Windows: архив с файлом
terraform.exeв каталоге из переменной PATH или менеджер пакетов. - macOS: пакет через Homebrew или тот же архив.
Проверка одинакова везде: terraform version. Инструкция HashiCorp со всеми способами лежит на её сайте, а открытый форк OpenTofu читает те же файлы .tf. Совместимость провайдера Таймвеб Клауд с OpenTofu проверьте командой init на тестовом каталоге.
03 · 1 мин
Провайдер Таймвеб Клауд для Terraform: токен и первый main.tf#
- Создайте каталог и файл
main.tfс блоком провайдера из примера. - Получите токен API в разделе ключей панели управления и отключите у него подтверждение удаления серверов через Telegram: документация провайдера требует этого для корректной работы.
- Передайте токен в переменной окружения:
export TWC_TOKEN=значение_токена. - Скачайте провайдер:
terraform init.
terraform {
required_providers {
twc = {
source = "tf.timeweb.cloud/timeweb-cloud/timeweb-cloud"
}
}
required_version = ">= 0.13"
}
data "twc_configurator" "configurator" {
location = "ru-1"
disk_type = "nvme"
}
data "twc_os" "os" {
name = "ubuntu"
version = "22.04"
}
resource "twc_server" "example-server" {
name = "Example server"
os_id = data.twc_os.os.id
configuration {
configurator_id = data.twc_configurator.configurator.id
disk = 1024 * 15
cpu = 1
ram = 1024
}
}
Пример взят из README провайдера: сервер на 1 ядро, 1 ГБ памяти и NVMe-диск, по составу он соответствует тарифу MSK Ultra 15 (цена тарифа 1 920 ₽ в месяц на 14 октября 2026, итог для конфигуратора смотрите в панели). Значения памяти и диска задаются числами в стиле 1024 * 15. Пароль к серверу приходит на почту, а для входа по ключу используют ресурс twc_server вместе с источником данных twc_ssh_keys.
Инструмент · 1 мин
Рабочий цикл Terraform: init, plan, apply и destroy#
| Команда | Что делает |
|---|---|
terraform init | Скачивает провайдер в каталог .terraform |
terraform validate | Проверяет, что файлы корректны |
terraform plan | Показывает, что будет создано, изменено или удалено, ничего не применяя |
terraform apply | Применяет план после ввода yes |
terraform destroy | Удаляет все ресурсы, созданные этой конфигурацией |
Провайдер умеет управлять не только серверами. В его документации перечислены ресурсы для проектов, DNS-записей (twc_dns_rr), S3-хранилищ, управляемых баз данных, файрвола, VPC, плавающих IP и кластеров Kubernetes (twc_k8s_cluster). Так что рядом с сервером можно описать и базу, и домен. Про самодельный кластер на сервере читайте на странице установка k3s.
Подготовка к первому terraform apply
Отметьте, что готово: калькулятор покажет следующий шаг
05 · 1 мин
Файл состояния Terraform: где хранить и как не потерять#
После первого apply рядом появляется terraform.tfstate. Это таблица соответствия между вашим описанием и реальными серверами. Потеряете её, и Terraform решит, что серверов нет, а попытка создать их заново даст дубликаты.
- Добавьте в
.gitignoreстроки*.tfstateи.terraform/: в состоянии бывают пароли и токены. - Для работы вдвоём и больше храните состояние в удалённом бэкенде, например в S3-совместимом хранилище. S3 в Таймвеб Клауд стоит от 1 ₽ в месяц за 1 ГБ на 14 октября 2026. Для нестандартного адреса у бэкенда s3 нужны дополнительные параметры, они описаны в документации Terraform.
- Ценному серверу добавьте блок
lifecycle { prevent_destroy = true }: тогда destroy откажется его удалять.
Копии данных внутри самого сервера Terraform не делает, эту работу описывает страница сервер для бэкапов.
06 · 1 мин
Вопросы об установке Terraform#
Как установить Terraform на Ubuntu для работы с Таймвеб Клауд?
Поставьте пакет из репозитория HashiCorp или распакуйте архив в /usr/local/bin, проверьте terraform version и добавьте в main.tf блок провайдера twc. После terraform init провайдер скачается.
Как установить Terraform на Windows?
Скачайте архив для Windows, положите terraform.exe в каталог из PATH и проверьте terraform version в новом окне PowerShell. Токен задавайте переменной TWC_TOKEN.
Нужен ли отдельный сервер, чтобы запускать Terraform?
Нет. Terraform работает на любом компьютере с доступом в интернет. Сервер под него нужен, только если вы запускаете его из CI или хотите хранить состояние на общей машине.
Какой токен нужен провайдеру Terraform для Таймвеб Клауд?
Токен API из панели управления. Его передают переменной TWC_TOKEN или параметром token в блоке provider. У токена должно быть отключено подтверждение удаления серверов через Telegram.
Почему этому можно верить
Как мы проверяли
Источники цифр на этой странице: VPS и VDS серверы Таймвеб Клауд, timeweb.cloud/services/vds-vps, проверено 14 октября 2026; Облачные базы данных Таймвеб Клауд, timeweb.cloud/services/dbaas, проверено 14 октября 2026; S3-хранилище Таймвеб Клауд, timeweb.cloud/services/s3-storage, проверено 14 октября 2026; Маркетплейс приложений Таймвеб Клауд, timeweb.cloud/marketplace, проверено 14 октября 2026; Провайдер Terraform для Timeweb Cloud: README на GitHub, github.com/timeweb-cloud/terraform-provider-timeweb-cloud, проверено 15 октября 2026.
Запустите свой сервер за пару минут
Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.
- NVMe-диски и гарантированная доля процессора
- Root-доступ и любой софт, от Docker до игровых серверов
- Маркетплейс: 91 приложение в один клик
- Бесплатный перенос проекта силами специалистов