4.9.5

4.5.2/05.01-Импортирование-ресурсов.md

@@ -0,0 +1,75 @@
+Импортирование ресурсов в terraform позволяет привести в соответствие состояние terraform (.tfstate) к состоянию ресурса в платформе.  
+Необходимость такого приведения возникает в нескольких случаях:
+- Ресурс был создан через портал платформы, работа продолжается через terraform провайдер,
+- Ресурс был создан через terraform провайдер, однако был изменен через портал платформы,
+- Ресурс был создан через terraform провайдер, однако был изменен другим пользователем через terraform провайдер,
+- И так далее  
+
+Такие расхождения в состоянии ресурсов нередки, путей их решения несколько:
+- Использовать импортирование ресурсов,
+- Использовать общие файлы состояний ресурсов, к которым будут иметь доступ все участники, занятые в работе с платформой.
+В текущем разделе рассматривается первый вариант.
+
+## Импортирование ресурсов
+Импортирование ресурсов позволяет совершить запрос к платформе, чтобы сформировать файл состояния.  
+Чтобы совершить импортирование ресурсов необходимо ввести сл. команду:
+```bash
+terraform import <resource-name>.<resource-variable> <resource-id> 
+```
+## Пример
+Предположим, что у нас ресурс, описывающий диск:
+```terraform
+resource "decort_disk" "disk" {
+  account_id  = 121212
+  gid         = 3333
+  disk_name = "mySuperDisk"
+  size_max    = 100500
+}
+```
+Если запустить команду:
+```bash
+terraform apply
+```
+То у нас будет создан новый диск.  
+Но, такой диск уже есть на площадке и мы хотели бы сформировать .tfstate для этого ресурса.
+Поэтому, для начала, необходимо получить список дисков:
+```terraform
+data "decort_disk_list" "dl"{
+
+}
+output "test" {
+  value = data.decort_disk_list.dl
+}
+```
+В полученных данных необходимо найти требуемый диск, получить его id - параметр disk_id. Пусть это будет - 777777  
+Теперь можно выполнить импортирование:
+```bash
+terraform import decort_disk.disk 777777
+```
+Команда должна успешно завершиться, появиться файл состояний, который позволит манипулировать ресурсом.
+
+## Ошибки при импортировании
+При импортировании ресурса может возникнуть сл. ошибка:
+```bash
+Error: <field-name>: required field is not set
+```
+Где <field-name> - наименование поля.  
+Ошибка возникает в том случае, если в описании ресурса отсутствует обязательное поле.
+Например:
+```terraform
+resource "decort_disk" "disk" {
+  account_id  = 121212
+  gid         = 3333
+  size_max    = 100500
+}
+```
+В приведенном выше описании отсутствует поле disk_name, поэтому, при попытке импортирования возникнет ошибка.  
+Для ее устранения, необходимо выполнить запрос на получение списка дисков, найти недостающее поле, после чего добавить его в описание ресурса.
+После этого повторить попытку импортирования.
+
+## Общий алгоритм устранения ошибок
+1. Выполнить запрос импортирования
+2. В случае ошибки - внести недостающие поля.
+3. Повторить п.1.
+
+