Главная/Разработка/Terraform

Установка Terraform и первый VPS в Таймвеб Клауд

Установка Terraform нужна, чтобы описывать серверы текстом и создавать их одной командой: в Таймвеб Клауд серверами управляют через API, CLI и Terraform. Terraform работает на вашем компьютере, читает файлы .tf, сверяет их с облаком и создаёт недостающее, а провайдер twc подключает его к Таймвеб Клауд.

5 мин чтенияДанные проверены 16 октября 2026

Ответ за 30 секунд

Terraform окупается, когда серверы нужно создавать и удалять повторяемо: стенд под ветку, копия окружения, кластер для теста. Для одного сервера хватит панели. Токен API держите в переменной TWC_TOKEN, а файл состояния terraform.tfstate не отправляйте в Git: в нём лежат идентификаторы и часто секреты.

Почасовая оплата: создайте сервер через terraform apply, проверьте схему и удалите его командой destroy.

Рабочий цикл Terraform: 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#

  1. Создайте каталог и файл main.tf с блоком провайдера из примера.
  2. Получите токен API в разделе ключей панели управления и отключите у него подтверждение удаления серверов через Telegram: документация провайдера требует этого для корректной работы.
  3. Передайте токен в переменной окружения: export TWC_TOKEN=значение_токена.
  4. Скачайте провайдер: 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.

SBРедакция SelfBase · обновлено 16 октября 2026

Запустите свой сервер за пару минут

Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.

  • NVMe-диски и гарантированная доля процессора
  • Root-доступ и любой софт, от Docker до игровых серверов
  • Маркетплейс: 91 приложение в один клик
  • Бесплатный перенос проекта силами специалистов
Команды