Provision
—— XP

Практика: состояние в бакете Object Storage

практика~35 минут+600 XP

Сейчас состояние облачного описания лежит файлом в ~/infra/terraform-yc. Перенесём его в бакет: так с этой инфраструктурой сможет работать коллега и конвейер CI, а с твоего диска уйдёт файл, где открытым текстом лежат все атрибуты.

Статический ключ сервисного аккаунта provision-sa у тебя есть с практики про хранилище: он лежит в ~/devops-lab/secrets/provision-sa-s3.txt, а роль storage.editor у аккаунта уже стоит. Там же ты проверил, что ключ работает, скачав им файл через curl.

Шаг 1. Бакет для состояния

Бакет для состояния создают руками, один раз и до всего остального: Terraform не может хранить состояние в бакете, который сам же и создаёт.

  1. В консоли открой Object Storage и нажми «Создать бакет».
  2. Имя — tfstate- и твой ник, например tfstate-anton.
  3. Доступ на чтение объектов — «Ограниченный»: в состоянии секреты.
  4. Максимальный размер — 1 ГБ. Нажми «Создать бакет».

Запиши имя в файл для команды сдачи.

ubuntu@stand:~$
echo tfstate-anton > ~/devops-lab/tfstate-bucket

Шаг 2. Ключи в переменные окружения

Terraform берёт ключ к бакету из переменных окружения с именами как в AWS. Значения скопируй из файла с ключом. Пробел в начале строки — не опечатка: в Ubuntu команда, начатая с пробела, не попадает в историю шелла.

ubuntu@stand:~$
 export AWS_ACCESS_KEY_ID=YCAJE…
 export AWS_SECRET_ACCESS_KEY=YCN2…

export делает переменную видимой для программ, запущенных из этого терминала. В новом терминале её не будет — дальше работай в этом же.

Шаг 3. Описать backend

Блок backend живёт внутри блока terraform. Положим его в отдельный файл.

nano ~/infra/terraform-yc/backend.tf
terraform {
  backend "s3" {
    endpoints = { s3 = "https://storage.yandexcloud.net" }
    bucket    = "tfstate-anton"
    region    = "ru-central1"
    key       = "provision/terraform.tfstate"

Дальше — четыре строки, выключающие проверки AWS, и две закрывающие скобки.

backend.tf, продолжение
    skip_region_validation      = true
    skip_credentials_validation = true
    skip_requesting_account_id  = true
    skip_s3_checksum            = true
  }
}

Строки взяты из документации Yandex Cloud без изменений. Ключей в файле нет — они в переменных окружения.

Шаг 4. Переехать

Смена backend — это повод для init: Terraform должен подключиться к новому хранилищу.

ubuntu@stand:~$
terraform init
ubuntu@stand:~$
Initializing the backend...
Do you want to copy existing state to the new backend?
  Enter a value: yes

Successfully configured the backend "s3"!

Если в каталоге было локальное состояние, Terraform предложит скопировать его в бакет — отвечай yes. Если упал с AccessDenied, переменные окружения не заданы или заданы в другом терминале.

Шаг 5. Убрать локальные файлы

Посмотрим, что осталось в каталоге после переезда. Флаг -l покажет размеры.

ubuntu@stand:~$
ls -l terraform.tfstate*
ubuntu@stand:~$
-rw-r--r-- 1 anton anton     0 Oct  2 12:22 terraform.tfstate
-rw-r--r-- 1 anton anton 12059 Oct  2 12:22 terraform.tfstate.backup

Звёздочка в конце имени подставляет все файлы, которые начинаются с terraform.tfstate. Сам terraform.tfstate остался, но размер у него 0: Terraform переписал состояние в бакет и оставил пустой файл. А вот terraform.tfstate.backup на 12 КБ — копия старого состояния со всеми атрибутами, ровно то, от чего мы уходим. Удалим оба.

ubuntu@stand:~$
rm terraform.tfstate terraform.tfstate.backup

Если в прошлой практике ты сделал terraform destroy, состояние было пустым и файлы будут меньше, но удалить их всё равно стоит. Дальше Terraform будет читать и писать только бакет.

Шаг 6. Применить

Создадим машину заново: теперь состояние будет записано сразу в бакет.

ubuntu@stand:~$
terraform apply

В плане Plan: 4 to add, после yes — минута и выходное значение public_ip. Внешне всё как в прошлой практике.

Шаг 7. Состояние в бакете

Проверим, что файл состояния действительно лежит в бакете.

ubuntu@stand:~$
yc storage s3api list-objects --bucket tfstate-anton
ubuntu@stand:~$
contents:
  - key: provision/terraform.tfstate
    size: "11873"
name: tfstate-anton

key — путь из backend.tf, size — размер в байтах. Около 12 КБ на четыре ресурса: всё, что Terraform знает о них, включая адреса и идентификаторы.

Шаг 8. Terraform читает состояние из бакета

И последнее: Terraform должен видеть свои ресурсы, хотя файла рядом нет.

ubuntu@stand:~$
terraform state list
ubuntu@stand:~$
data.yandex_compute_image.ubuntu
yandex_compute_instance.web
yandex_vpc_network.main
yandex_vpc_security_group.web
yandex_vpc_subnet.main

Файла в каталоге нет, а список есть: Terraform прочитал его из бакета. Ровно это увидит коллега, у которого есть описание из репозитория и ключ к бакету. Data-блок тоже записан в состояние, но ничего не стоит.

Шаг 9. Удалить машину

Состояние в бакете стоит копейки, а машина — нет.

ubuntu@stand:~$
terraform destroy
ubuntu@stand:~$
Destroy complete! Resources: 4 destroyed.

Это итог после ответа yes. Сам файл состояния в бакете останется: теперь в нём записано, что ресурсов нет. Бакет tfstate-… не удаляй — он понадобится в миссии.

Сдай задание командой из блока проверки в этом же терминале: ей нужны переменные с ключами.

Что дальше

Состояние в общем хранилище. Дальше — снова на бесплатном Docker: импорт ресурса, созданного руками, и расхождение описания с реальностью.

Практика 04+600 XP

Вынести состояние из каталога в общее хранилище, как это делают в команде, и не оставить при этом ключей ни в файлах, ни в истории.

  • Backend описан
  • Локального состояния нет
  • Состояние лежит в бакете
  • Машина удалена
Команда сдачи — выполни на своей машине
команда
cd ~/infra/terraform-yc 2>/dev/null || echo NODIR; grep -A1 'backend' backend.tf; echo "LOCAL=$(find . -maxdepth 1 -name 'terraform.tfstate*' -size +0 | wc -l)"; echo "STATE=$(terraform state list | wc -l)"; yc storage s3api list-objects --bucket $(cat ~/devops-lab/tfstate-bucket); yc compute instance list

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.