azurerm_load_balancers ресурс

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

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

Версия Azure REST API

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

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

Доступность

Установка

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

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

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

Версия

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

Синтаксис

Блок ресурса azurerm_load_balancers возвращает все балансировщики нагрузки Azure, либо внутри группы ресурсов (если указана), либо во всей подписке.

describe azurerm_load_balancer do
  ...
end

или

describe azurerm_load_balancers(resource_group: 'my-rg') do
  ...
end

Примеры

В следующих примерах показано, как использовать этот ресурс проверки InSpec.

Проверка наличия балансировщиков нагрузки

describe azurerm_load_balancers do
  it            { should exist }
  its('names')  { should include 'my-lb' }
end

Критерии фильтрации

names

Фильтрует результаты, включая только те балансировщики нагрузки, которые соответствуют заданному имени. Это строковое значение.

describe azurerm_load_balancers.where{ name.eql?('production-lb-5') } do
  it { should exist }
end

location

Фильтрует результаты, включая только те балансировщики нагрузки, которые находятся в заданном месте. Это строковое значение.

describe azurerm_load_balancers.where{ location.eql?('eastus') } do
  it { should exist }
end

Атрибуты

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

ids

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

names

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

its('names') { should include 'my-lb' }

SKU

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

locations

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

its('locations') { should_not include 'eastus' }

properties

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

tag

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

type

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

Обработчики соответствия

У этого ресурса проверки InSpec есть следующие специальные обработчики соответствия. Полный список доступных обработчиков можно найти на нашей странице Универсальные обработчики.

exists

Контроль пройдет, если фильтр вернет хотя бы один результат. Используйте should_not если ожидается ноль совпадений.

describe azurerm_load_balancers do
  it { should exist }
end

Разрешения Azure

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