Из определённого выше вывода команды terraform plan нам становятся известными все те ресурсы, которые мы намерены создавать и обновлять. В нашем примере показано намерение создания группы ресурсов с названием Terraform-lab-RG.

Давайте разберёмся как сохранять вывод terraform plan в неком файле. Для сохранения вывода terraform plan, нам требуется исполнить команду terraform plan -out <filename> следующим образом:

PS C:\provider> terraform plan -out plan.txt
Acquiring state lock. This may take a few moments...
Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be persisted to local or remote state storage.
------------------------------------------------------------------------
An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  + create
Terraform will perform the following actions:
  # azurerm_resource_group.example will be created
  + resource "azurerm_resource_group" "example" {
      + id       = (known after apply)
      + location = "eastus"
      + name     = "Terraform-lab-RG"
    }
Plan: 1 to add, 0 to change, 0 to destroy.
------------------------------------------------------------------------
This plan was saved to: plan.txt
To perform exactly these actions, run the following command to apply:
    terraform apply "plan.txt"
Releasing state lock. This may take a few moments... 
		

Наша команда terraform plan -out plan.txt создала в представленном локально рабочем каталоге файл plan.txt и будет обладать неким файлом двоичного вывода terraform plan, который видеть ниже в распахнутом каталоге:

PS C:\provider> ls
Directory: C:\provider
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----        09-12-2020     03:53                .terraform
-a----        09-12-2020     16:41           2040 plan.txt
-a----        09-12-2020     03:53            316 providers.tf
-a----        09-12-2020     16:21            105 resourcegroup.tf 
		

Когда мы хотим воспользоваться этим сохранённым двоичным файлом (то есть plan.txt) в процессе команды terraform plan, тогда мы можем исполнить terraform apply "plan.txt".

Двигаясь далее мы попытаемся разобраться следует ли нам входное значение переменной в процессе времени исполнения Terraform или же нам надлежит передавать значение переменной из некого локального файла.

В resourcegroup.tf мы определили такой код:

resource "azurerm_resource_group" "example" {
  name     = var.rgname
  location = "eastus"
}
		

Поскольку мы определили name = var.rgname, нам затем требуется объявить некую переменную rgname, которая будет содержаться в неком отдельном файле, variables.tf, следующим образом:

variable "rgname"{
    description = "name of the resource group"
    type        = string
}
		

После выполнения terraform plan мы можем наблюдать следующий фрагмент кода, в котором Terraform выполняет поиск значения rgname, которое может быть представлено в процессе времени исполнения:

PS C:\provider> terraform plan
var.rgname
  name of the resource group
  Enter a value: 
		

После того, как мы предоставим соответствующие данные на ввод, он продолжит дальнейшее выполнение и даст нам знать какой ресурс он намерен предоставить, что иллюстрируется следующим фрагментом кода:

PS C:\provider> terraform plan
var.rgname
  name of the resource group
  Enter a value: terraform-lab-rg
Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be persisted to local or remote state storage.
------------------------------------------------------------------------
An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  + create
Terraform will perform the following actions:
  # azurerm_resource_group.example will be created
  + resource "azurerm_resource_group" "example" {
      + id       = (known after apply)
      + location = "eastus"
      + name     = "terraform-lab-rg"
    }
Plan: 1 to add, 0 to change, 0 to destroy.
------------------------------------------------------------------------
Note: You didn't specify an "-out" parameter to save this plan, so Terraform can't guarantee that exactly these actions will be performed if "terraform apply" is subsequently run.
		

Если мы хотим передать необходимое значение переменной в качестве ввода из некого файла, мы также можем выполнить и это. Прежде всего, Terraform выполнит поиск любых файлов, заканчивающихся на .tfvars или .auto.tfvars в своём текущем рабочем каталоге. Когда такой файл обнаружен, Terraform считает необходимое значение переменной из такого файла. Допустим, мы задали значение переменной в своём файле testing.txt - в таком случае, в процессе исполнения команды terraform plan, нам требуется предоставить название пути такого файла: terraform plan -var-file="testing.txt". Мы определили значение переменной в своём файле testing.txt - то есть, rgname = "terraformlab-rg".

При исполнении упомянутой выше команды вы получите следующий код вывода:

PS C:\provider> terraform plan -var-file="testing.txt"
Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be persisted to local or remote state storage.
------------------------------------------------------------------------
An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  + create
Terraform will perform the following actions:
  # azurerm_resource_group.example will be created
  + resource "azurerm_resource_group" "example" {
      + id       = (known after apply)
      + location = "eastus"
      + name     = "terraform-lab-rg"
    }
Plan: 1 to add, 0 to change, 0 to destroy.
------------------------------------------------------------------------
Note: You didn't specify an "-out" parameter to save this plan, so Terraform can't guarantee that exactly these actions will be performed if "terraform apply" is subsequently run.
		

Отсюда мы понимаем как terraform plan способен получать значения переменной множеством вариантов. Terraform получает значения переменной в следующей последовательности:

Terraform CLI >> any filename/terraform.tfvars >> default value provided in the variable declaration
 	   

Мы уже представляли список тех подчинённых команд/ аргументов, которые поддерживаются командой terraform plan (с их описанием) в самом начале данной темы, а потому мы не будем пояснять здесь все подчинённые команды. Чтобы дополнительно ознакомиться с terraform plan, вы можете проследовать на https://www.terraform.io/docs/commands/plan.html.

После выполнения terraform init и terraform plan, если вы сочли изменения соответствующие вашим ожиданиям, вы затем можете выполнить terraform apply, что поможет вам предоставить необходимую инфраструктуру или обновить её. Это обновит файл состояния Terrafor и получит его сохранённым в ваней локальной или удалённой серверной основе. Вот перечень необходимых флагов подчинённых команд, которые вы можете исполнять при помощи terraform apply - вы можете обнаружить этот список выполнив команду terraform apply -h:

В продолжение примера с этапа terraform plan (то есть, когда testing.txt содержит необходимое значение переменной Terraform), давайте попробуем разобраться как сработает с этим примером terraform apply:

PS C:\provider> terraform apply -var-file="testing.txt"
An execution plan has been generated and is shown below.  
Resource actions are indicated with the following symbols:
  + create
Terraform will perform the following actions:     
  # azurerm_resource_group.example will be created
  + resource "azurerm_resource_group" "example" {
      + id       = (known after apply)
      + location = "eastus"
      + name     = "terraform-lab-rg"
    }
Plan: 1 to add, 0 to change, 0 to destroy.
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 или же мы можем предоставить отличное от yes значение для прекращения terraform apply и выхода в свой терминал исполнения. Если мы желаем чтобы на протяжении нашего этапа terraform apply не было бы последующих подтверждений, мы бы просто могли поместить terraform apply -auto-approve. В нашем случае мы можем определить terraform apply -var-file="testing.txt" -auto-approve для получения в результате такого вывода:

azurerm_resource_group.example: Creating...
azurerm_resource_group.example: Creation complete after 3s [id=/subscriptions/97c3799f-2753-40b7-a4bd-157ab464d8fe/resourceGroups/terraform-lab-rg]
Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
		

Как вы можете видеть, наша предыдущая команда не выдаёт никакого приглашения на ввод подтверждения и управилась с созданием в Azure группы ресурсов.

В самом начале этого раздела мы ознакомились со всеми флагами подчинённых команд, поддерживаемых terraform apply. Вы можете прочитать и проверить вывод каждой из команд в CLI Terraform. Для получения дополнительных сведений относительно terraform apply вы можете посетить https://www.terraform.io/docs/commands/apply.html.

	Замечание
	Мы не рекомендуем вам применять команду terraform apply -auto-approve по той причине, что во множестве случаев существенно в точности проверять что именно собирается осуществлять Terraform и мы можем прекращать исполнение, когда мы не желаем продолжать со своим этапом terraform apply.

Вы можете удивиться зачем нужно в жизненном цикле вашей инфраструктуры иметь destroy. Могут иметься ситуации, когда вы хотите избавиться от ресурсов, которые вы предоставили при помощи terraform apply, и в таком случае вы можете выполнять команду terraform destroy. Это удалит все те ресурсы или службы, которые вы определили в своём файле конфигурации и обновит соответствующим образом файл состояния. Команда terraform destroy очень мощная и когда вы выполняете её, она предоставит вам план исполнения для всех ресурсов, которые она намерена удалить и после этого запросит подтверждения, так как после того как эта команда исполнится, нет возможности возврата. Некоторые из флагов подчинённых команд или аргументов, поддерживаемых terraform destroy, мы перечислили здесь - вы можете получить полный список поддерживаемых аргументов, запустив terraform destroy -h:

Вы могли заметить, что все имеющиеся подчинённые команды, поддерживаемые terraform apply, также поддерживаются и terraform destroy. terraform destroy исполняет в точности противоположные действия команде terraform apply. Точно так же как мы наблюдаем, что команда terraform apply помогает нам предоставлять или обновлять инфраструктуру, команда terraform destroy помогает нам удалять всю ту инфраструктуру, которая представлена в имеющемся файле состояния.

Мы не обсуждаем здесь подчинённые команды/ аргументы terraform destroy, но вы можете обратиться за справкой к вариантам использования подчинённых команд terraform apply и, соответственно, когда вы планируете воспользоваться terraform destroy, просто замените terraform apply на terraform destroy с идущими следом надлежащими подчинёнными командами.

Вы можете удивиться как мы можем удалять некую инфраструктуру не применяя команду terraform destroy, поэтому давайте рассмотрим как мы можем предпринимать такие действия. В своём разделе Применение Terraform мы создали имя группы ресурса terraform-lab-rg. Давайте попробуем удалить эту группу ресурсов непосредственно при помощи команды terraform destroy следующим образом:

PS C:\provider> terraform apply -var-file="testing.txt" -auto-approve
azurerm_resource_group.example: Creating...
azurerm_resource_group.example: Creation complete after 3s [id=/subscriptions/97c3799f-2753-40b7-a4bd-157ab464d8fe/resourceGroups/terraform-lab-rg]
		

В конце концов, мы исполним terraform plan с флагом destroy и сохраним вывод terraform plan в delete.txt (то есть, командой terraform plan -destroy -out delete.txt), а затем будем следовать ему при помощи terraform apply "delete.txt", как то иллюстрирует наш следующий фрагмент кода:

PS C:\provider> terraform plan -var-file="testing.txt" -destroy -out delete.txt
Refreshing Terraform state in-memory prior to plan...
The refreshed state will be used to calculate this plan, but will not be persisted to local or remote state storage.
azurerm_resource_group.example: Refreshing state... [id=/subscriptions/97c3799f-2753-40b7-a4bd-157ab464d8fe/resourceGroups/terraform-lab-rg]
------------------------------------------------------------------------
An execution plan has been generated and is shown below.
Resource actions are indicated with the following symbols:
  - destroy
Terraform will perform the following actions:
  # azurerm_resource_group.example will be destroyed
  - resource "azurerm_resource_group" "example" {
      - id       = "/subscriptions/97c3799f-2753-40b7-a4bd-157ab464d8fe/resourceGroups/terraform-lab-rg" -> null
      - location = "eastus" -> null
      - name     = "terraform-lab-rg" -> null
      - tags     = {} -> null
    }
------------------------------------------------------------------------
This plan was saved to: delete.txt
To perform exactly these actions, run the following command to apply:
    terraform apply "delete.txt"
PS C:\provider> terraform apply "delete.txt"
azurerm_resource_group.example: Destroying... [id=/subscriptions/97c3799f-2753-40b7-a4bd-157ab464d8fe/resourceGroups/terraform-lab-rg]
azurerm_resource_group.example: Still destroying... [id=/subscriptions/97c3799f-2753-40b7-a4bd-...4d8fe/resourceGroups/terraform-lab-rg, 10s elapsed]
azurerm_resource_group.example: Destruction complete after 11s

Apply complete! Resources: 0 added, 0 changed, 1 destroyed.
		

Отсюда мы узнаём насколько просто мы можем удалять ресурсы при помощи последовательного terraform plan и terraform apply без использования terraform destroy. Это просто иной способ удаления ресурсов и вы можете применять его вместо команды terraform destroy.

Замечание

Выполняйте terraform destroy только когда вы хотите осуществлять полную очистку ресурсов, потому что это окончательно удаляет все ресурсы или службы, которые вы создали в процессе операции terraform apply. Это работает точно противоположным способом к terraform apply. По умолчанию Terraform перед исполнением операций terraform init, terraform plan, terraform apply или terraform destroy выполняет terraform refresh. Всякий раз когда вы исполняете команды рабочего процесса Terraform, такие как terraform init, terraform plan, terraform apply или terraform destroy, имеющийся файл состояния Terraform переходит в состояние блокированного во избежание одновременного внесения изменений в этот файл состояния.