Практическая работа. Создаём виртуальную машину из образа и базу данных

1. Установите Terraform. Дистрибутив для вашей платформы можно скачать из зеркала. После загрузки добавьте путь к папке, в которой находится исполняемый файл, в переменную PATH.
   Настройте провайдер.
   Для Linux: Скачать бинарный файл  сдесь.

   Распоковать в папку /home/administrator/terraform. 
   
   Перейти в папку 
   cd /home/administrator/terraform
   
   Переместите распакованный файл в папку /usr/local/bin:
   sudo mv terraform /usr/local/bin/
   
   Установите разрешения
   chmod +x /usr/local/bin/terraform
   
   Проверьте установку Terraform
   terraform version
   
   Настройка переменных среды
   echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
   source ~/.bashrc
   
   

2. Создайте файл спецификации my-config.tf и укажите в нём Yandex Cloud в качестве провайдера.

    terraform {
      required_providers {
        yandex = {
          source = "yandex-cloud/yandex"
        }
      }
    }
     
    provider "yandex" {
      token  =  "<OAuth-токен>"
      cloud_id  = "<идентификатор_облака>"
      folder_id = "<идентификатор_каталога>"
      zone      = "<зона_доступности_по_умолчанию>"
    } 

    
   Далее мы будем считать, что в качестве зоны доступности по умолчанию выбрана ru-central1-a.
3. Добавьте в файл блок, описывающий создание ВМ. Его сложно написать с нуля, поэтому опирайтесь на пример из документации. Чтобы вам было проще опознать в консоли управления объекты, созданные по этой спецификации, указывайте уникальные имена для ВМ, сети и подсети, а не оставляйте имена по умолчанию (default).
4. Для создания ВМ используйте образ, созданный с помощью Packer в предыдущей практической работе.
   Можно использовать переменные в спецификации Terraform и передавать в них разные значения при запуске команд. Например, если сделать переменную для идентификатора образа image-id, тогда с помощью одного и того же файла спецификации вы сможете создавать ВМ с разным наполнением.
   Переменные Terraform хранятся в файлах с расширением .tfvars. Создайте файл my-variables.tfvars и укажите в нём идентификатор своего образа Packer (узнайте идентификатор с помощью команды yc compute image list):

   image-id = "<идентификатор_образа>"

    
   В файле спецификации my-config.tf объявите эту переменную (ключевое слово variable). Тогда в секции, где описываются настройки ВМ, вы сможете обратиться к переменной как var.image-id:

   ...
    variable "image-id" {
        type = string
    }
    
    resource "yandex_compute_instance" "vm-1" {
    ...   
    
        boot_disk {
            initialize_params {
                image_id = var.image-id
            }
        }
    ...

    
5. Скорректируйте описание для сети и подсети.
   Для сети достаточно указать имя:

     resource "yandex_vpc_network" "network-1" {
         name = "from-terraform-network"
     } 

    
   Для подсети укажите зону доступности и сеть, а также внутренние IP-адреса, уникальные в рамках сети. Используйте адреса из адресного пространства 10.0.0.0/16.

     resource "yandex_vpc_subnet" "subnet-1" {
         name           = "from-terraform-subnet"
         zone           = "ru-central1-a"
         network_id     = "${yandex_vpc_network.network-1.id}"
         v4_cidr_blocks = ["10.2.0.0/16"]
     } 

   Проверьте синтаксис спецификации:

   variable "image-id" {
     type = string
   }
    
   resource "yandex_compute_instance" "vm-1" {
     name = "from-terraform-vm"
     platform_id = "standard-v1"
     zone = "ru-central1-a"
    
     resources {
       cores  = 2
       memory = 2
     }
    
     boot_disk {
       initialize_params {
         image_id = var.image-id
       }
     }
    
     network_interface {
       subnet_id = yandex_vpc_subnet.subnet-1.id
       nat       = true
     }
    
     metadata = {
       ssh-keys = "ubuntu:${file("~/.ssh/id_rsa.pub")}"
     }
   }
    
   resource "yandex_vpc_network" "network-1" {
     name = "from-terraform-network"
   }
    
   resource "yandex_vpc_subnet" "subnet-1" {
     name           = "from-terraform-subnet"
     zone           = "ru-central1-a"
     network_id     = "${yandex_vpc_network.network-1.id}"
     v4_cidr_blocks = ["10.2.0.0/16"]
   }
    
   output "internal_ip_address_vm_1" {
     value = yandex_compute_instance.vm-1.network_interface.0.ip_address
   }
    
   output "external_ip_address_vm_1" {
     value = yandex_compute_instance.vm-1.network_interface.0.nat_ip_address
   }

5. Теперь попробуйте применить спецификацию. Перейдите в папку с файлом спецификации и выполните инициализацию.

   terraform init

    
   Если всё сделано верно, Terraform покажет сообщение:

   ...
    Terraform has been successfully initialized!
   ...

   Важно: выполняйте команды Terraform в папке, где находится файл спецификации.
6. Проверьте спецификацию с помощью команды terraform plan.
   Terraform использует все файлы .tf из папки, в которой запущена команда. Поэтому название файла спецификации my-config.tf указывать не нужно: его Terraform подхватит и так.
   Если файл с переменными называется стандартно (terraform.tfvars), его тоже можно не указывать при запуске команды. А если название файла нестандартное, то его нужно указывать:

   terraform plan -var-file=my-variables.tfvars

    
   Terraform выведет план: объекты, которые будут созданы, и т. п.:

    ...
    Terraform will perform the following actions:
    ... 

    
   На самом деле необязательно помещать переменные в файл, их можно просто указывать при запуске команды. Поскольку у вас только одна переменная, это было бы несложно:

   terraform plan -var="image-id=<идентификатор_образа>"

7. Создайте в облаке инфраструктуру по описанной вами спецификации. Выполните команду:

   terraform apply -var-file=my-variables.tfvars

    
   Terraform запросит подтверждение:

    ...
    Do you want to perform these actions?
         Terraform will perform the actions described above.
         Only 'yes' will be accepted to approve.
         
         Enter a value: 

    
   В ответ введите yes.
   Когда команда будет выполнена, вы увидите сообщение:

     Apply complete! Resources: ... added, 0 changed, 0 destroyed.
      
     Outputs:
   
     external_ip_address_vm_1 = "84.201.133.49"
     internal_ip_address_vm_1 = "10.2.0.24" 

    
8. В консоли управления убедитесь, что ВМ создана. Откройте в браузере страницу с указанным IP-адресом и проверьте, доступна ли ВМ.
9. Как мы говорили на предыдущем уроке, Terraform хранит описание инфраструктуры в стейт-файлах. Посмотрите, как выглядит стейт-файл сейчас:

   terraform state list

    
   Вы увидите список объектов:

    yandex_compute_instance.vm-1
    yandex_vpc_network.network-1
    yandex_vpc_subnet.subnet-1 

    
10. Теперь добавьте в файл спецификации блок, описывающий создание кластера БД PostgreSQL. Подсказки ищите в справочнике ресурсов. Не забудьте заменить в спецификации имя подсети.

10. Теперь примените обновлённую спецификацию. В папке с файлом спецификации выполните команду terraform plan:

    terraform plan -var-file=my-variables.tfvars

     
    Если появляются сообщения об ошибках — исправьте ошибки и снова выполните команду.
11. Обновите инфраструктуру в соответствии с дополненной спецификацией командой terraform apply:

    terraform apply -var-file=my-variables.tfvars

     
    Поскольку спецификация теперь включает создание БД, команда может выполняться довольно долго (около 10 минут)
12. В консоли управления откройте раздел Managed Service for PostgreSQL и убедитесь, что кластер postgres-1 создан и имеет статус Alive.
13. Проверьте, как изменился стейт-файл:

    terraform state list

     
    В списке появился новый объект:

    yandex_compute_instance.vm-1
    yandex_mdb_postgresql_cluster.postgres-1
    yandex_vpc_network.network-1
    yandex_vpc_subnet.subnet-1

     
14. Удалите инфраструктуру:

    terraform destroy -var-file=my-variables.tfvars

     
    В конце вы увидите сообщение о выполнении команды:

    ...
    Destroy complete! Resources: 4 destroyed.

     
    В консоли управления убедитесь, что объекты удалены.

О терраформе

resource "yandex_compute_instance" "vm-1" {
  ...
}
 
resource "yandex_vpc_network" "network-1" {
  ...
}
 
resource "yandex_vpc_subnet" "subnet-1" {
  ...
}

Terraform will perform the following actions:
 
  # yandex_compute_instance.vm-1 will be created
  + resource "yandex_compute_instance" "vm-1" {
    ...
    }
 
  # yandex_vpc_network.network-1 will be created
  + resource "yandex_vpc_network" "network-1" {
    ...
    }
 
  # yandex_vpc_subnet.subnet-1 will be created
  + resource "yandex_vpc_subnet" "subnet-1" {
    ...
    }
 
Plan: ... to add, 0 to change, 0 to destroy.

resource "yandex_compute_instance" "vm-1" {
  ...
  network_interface {
    subnet_id = yandex_vpc_subnet.subnet-1.id
    nat       = true
  }
}
 
resource "yandex_vpc_subnet" "subnet-1" {
  ...
}

Спецификации Terraform

terraform {
  required_providers {
    yandex = {
      source = "yandex-cloud/yandex"
    }
  }
}
 
provider "yandex" {
  token     = "<OAuth-токен>"
  cloud_id  = "<идентификатор_облака>"
  folder_id = "<идентификатор_каталога>"
  zone      = "<зона_доступности_по_умолчанию>"
}

variable "folder-id" {
  type = string
}
 
provider "yandex" {
  token     = "<OAuth-токен>"
  cloud_id  = "<идентификатор_облака>"
  folder_id = var.folder-id
  zone      = "<зона_доступности_по_умолчанию>"
}

Как использовать спецификации Terraform

1. Команда terraform init инициализирует провайдеров, указанных в файле спецификации.
2. Команда terraform plan запускает проверку спецификации. Если есть ошибки — появятся предупреждения. Если ошибок нет, отобразится список элементов, которые будут созданы или удалены.
3. Команда terraform apply запускает развёртывание инфраструктуры.

Оптимизация создания инфраструктуры

О Packer

Для чего нужны образы

Как создать образ при помощи Packer

source "yandex" "ubuntu-nginx" {
  token               = "<OAuth-токен>"
  folder_id           = "<идентификатор_каталога>"
  source_image_family = "ubuntu-2004-lts"
  ssh_username        = "ubuntu"
  use_ipv4_nat        = "true"
  image_description   = "my custom ubuntu with nginx"
  image_family        = "ubuntu-2004-lts"
  image_name          = "my-ubuntu-nginx"
  subnet_id           = "<идентификатор подсети>"
  disk_type           = "network-ssd"
  zone                = "ru-central1-a"
}
 
build {
  sources = ["source.yandex.ubuntu-nginx"]
 
  provisioner "shell" {
    inline = ["sudo apt-get update -y", 
              "sudo apt-get install -y nginx", 
              "sudo systemctl enable nginx.service"
             ]
  }
}

packer build <путь_к_my-ubuntu-nginx.pkr.hcl>