76 lines
4.4 KiB
Markdown
76 lines
4.4 KiB
Markdown
Импортирование ресурсов в 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.
|
||
|
||
|