azurerm_load_balancer ресурс

[править на GitHub]

Используйте ресурс проверки azurerm_load_balancer InSpec для проверки свойств и конфигурации балансировщика нагрузки Azure.

Версия Azure REST API

Этот ресурс взаимодействует с версией 2018-11-01 API Azure Management. Более подробную информацию можно найти в официальной документации Azure.

В настоящее время не представляется возможным выбрать версию документации API Azure. Если вы заметите упоминание более новой версии в официальной документации, откройте вопрос или отправьте запрос на добавление с обновленной версией.

Доступность

Установка

Этот ресурс доступен в inspec-azure пакете ресурсов. Для его использования добавьте следующее в свой inspec.yml в вашем профиле верхнего уровня:

depends:
  inspec-azure:
    git: https://github.com/inspec/inspec-azure.git

Также вам необходимо настроить свои учетные данные Azure; см. файл README пакета ресурсов.

Версия

Этот ресурс впервые стал доступен в версии 1.7.2 пакета ресурсов inspec-azure.

Синтаксис

Параметрами должны быть указаны resource_group и loadbalancer_name.

describe azurerm_load_balancer(resource_group: 'inspec-resource-group-9', loadbalancer_name: 'example_lb') do
  it { should exist }
end

Примеры

Если балансировщик нагрузки упоминается с допустимым Resource Group и Load balancer Name.

describe azurerm_load_balancer(resource_group: 'my-rg', loadbalancer_name: 'lb-1') do
  it { should exist }
end

Если балансировщик нагрузки упоминается с недопустимым Resource Group или Load balancer Name

describe azurerm_load_balancer(resource_group: 'invalid-rg', loadbalancer_name: 'i-dont-exist') do
  it { should_not exist }
end

Параметры

• resource_group - Группа ресурсов, к которой принадлежит балансировщик нагрузки.
• loadbalancer_name - Уникальное имя балансировщика нагрузки.

Атрибуты

• id
• name
• sku
• location
• properties
• tags
• type

id

Идентификатор ресурса Azure.

name

Имя балансировщика нагрузки, например, lb-1.

sku

SKU балансировщика нагрузки. Это свойства, связанные с оплатой, данного балансировщика нагрузки.

location

Расположение ресурса, например, eastus.

properties

Коллекция дополнительных свойств конфигурации, связанных с балансировщиком нагрузки, например, loadBalancingRules.

tags

Теги ресурса, примененные к балансировщику нагрузки.

type

Тип ресурса, обычно Microsoft.Network/loadBalancers.

Другие атрибуты

Существуют дополнительные атрибуты, к которым можно получить доступ, которые мы не задокументировали. Пожалуйста, ознакомьтесь с документацией Azure. Любой атрибут в ответе можно получить по имени ключа, разделенному точками (.).

API может не всегда возвращать ключи, не имеющие связанных данных. Возможно, во вложенных свойствах на вашем пути вызова не будет нужного атрибута. Если вы обнаружите необходимость проверки свойств, которые могут быть равны null, вильните этот пакет ресурсов и добавьте обработчик для ресурса. В обработчике вы сможете защититься от нулевых ключей. Запросы на добавление всегда приветствуются.

Matchers

Этот ресурс проверки InSpec имеет следующие специальные matchers. Полный список доступных matchers можно найти на нашей странице универсальных matchers.

exists

describe azurerm_load_balancer(resource_group: 'my-rg', loadbalancer_name: 'lb-1') do
    it { should exist }
end

Разрешения Azure

Ваш сервисный принцип должен быть настроен с ролью contributor на подписке, которую вы хотите протестировать.