Terraform: инфраструктура на уровне кода

Вы уже знаете, как циклически перебирать ресурсы и вложенные блоки. Но если с помощью цикла нужно сгенерировать лишь одно значение? Немного отвлечемся и рассмотрим некоторые примеры, не связанные с кластером веб-серверов. Представьте, что вы написали код Terraform, который принимает на вход список имен:

variable "names" {

  description = "A list of names"

  type        = list(string)

  default     = ["neo", "trinity", "morpheus"]

}

Как бы вы перевели все эти имена в верхний регистр? В языке программирования общего назначения, таком как Python, можно было бы написать следующий цикл:

names = ["neo", "trinity", "morpheus"]

upper_case_names = []

for name in names:

    upper_case_names.append(name.upper())

print upper_case_names

# Выводит: ['NEO', 'TRINITY', 'MORPHEUS']

Python позволяет выразить точно такой же код одной строчкой, используя синта­ксис под названием «абстракция списков» (list comprehension):

names = ["neo", "trinity", "morpheus"]

upper_case_names = [name.upper() for name in names]

print upper_case_names

# Выводит: ['NEO', 'TRINITY', 'MORPHEUS']

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

names = ["neo", "trinity", "morpheus"]

short_upper_case_names = [name.upper() for name in names if len(name) < 5]

print short_upper_case_names

# Выводит: ['NEO']

Terraform предлагает похожие возможности в виде выражения for (не путать с выражением for_each из предыдущего раздела). У него следующий базовый синтаксис:

[for in :

]

LIST — это список, который нужно перебрать, ITEM — имя локальной переменной, которое будет назначено каждому элементу списка, а OUTPUT — выражение, которое каким-то образом преобразует ITEM. Например, вот код Terraform для перевода списка имен в var.names в верхний регистр:

variable "names" {

  description = "A list of names"

  type        = list(string)

  default     = ["neo", "trinity", "morpheus"]

}

output "upper_names" {

  value = [for name in var.names : upper(name)]

}

Если выполнить для этого кода команду terraformapply, получится следующий вывод:

$ terraform apply

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

Outputs:

upper_names = [

  "NEO",

  "TRINITY",

  "MORPHEUS",

]

Как и с абстракциями списков в Python, вы можете задать выражение для фильтрации полученного результата:

variable "names" {

  description = "A list of names"

  type        = list(string)

  default     = ["neo", "trinity", "morpheus"]

}

output "short_upper_names" {

  value = [for name in var.names : upper(name) if length(name) < 5]

}

Выполнив terraformapply для этого кода, вы получите следующее:

short_upper_names = [

  "NEO",

]

Выражение for в Terraform также поддерживает циклический перебор ассоциативных массивов с использованием такого синтаксиса:

[for , in

MAP — это ассоциативный массив, который нужно перебрать, KEY и VALUE — имена локальных переменных, которые назначаются каждой паре «ключ — значение» в MAP, а OUTPUT — выражение, которое каким-то образом преобразует KEY и VALUE. Например:

variable "hero_thousand_faces" {

  description = "map"

  type        = map(string)

  default     = {

    neo      = "hero"

    trinity  = "love interest"

    morpheus = "mentor"

  }

}

output "bios" {

  value = [for name, role in var.hero_thousand_faces : "${name} is the ${role}"]

}

Если выполнить terraformapply для этого кода, получится следующее:

map_example = [

  "morpheus is the mentor",

  "neo is the hero",

  "trinity is the love interest",

]

Выражение for может вернуть ассоциативный массив вместо списка, используя следующий синтаксис:

# Циклический перебор списков

[for in

# Циклический перебор ассоциативных массивов

{for , in

Разница лишь в том, что: а) выражение помещается в фигурные скобки вместо прямоугольных; б) на каждой итерации выводится не только значение, но еще и ключ, отделенный от него стрелкой. Например, так можно перевести в верхний регистр все ключи и значения ассоциативного массива:

variable "hero_thousand_faces" {

  description = "map"

  type        = map(string)

  default     = {

    neo      = "hero"

    trinity  = "love interest"

    morpheus = "mentor"

  }

}

output "upper_roles" {

  value = {for name, role in var.hero_thousand_faces : upper(name) => upper(role)}

}

При выполнении этот код возвращает такой вывод:

upper_roles = {

  "MORPHEUS" = "MENTOR"

  "NEO" = "HERO"

  "TRINITY" = "LOVE INTEREST"

}

Циклы с использованием строковой директивы for

Ранее в этой книге вы узнали о строковой интерполяции, которая позволяет ссылаться на код Terraform внутри строки:

"Hello, ${var.name}"

С помощью строковых директив подобный синтаксис можно использовать и для управляющих конструкций (вроде циклов for и выражения if), но вместо знака доллара (${…}) перед фигурными скобками указывается знак процента (%{…}).

Строковая директива for имеет следующий синтаксис:

%{ for in }%{ endfor }

COLLECTION — список или ассоциативный массив, который нужно перебрать, ITEM — имя локальной переменной, которое назначается каждому элементу COLLECTION, а BODY — это то, что выводится на каждой итерации (здесь можно ссылаться на ITEM). Например: