Справочник по универсальным соответствиям Chef InSpec

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

Chef InSpec использует соответствия для сравнения значений ресурсов с ожиданиями. Доступны следующие соответствия:

Вы также можете использовать любое соответствие, предоставляемое RSpec::Expectations, но эти соответствия находятся за пределами области поддержки InSpec’s области поддержки.

Доступны следующие поддерживаемые InSpec универсальные соответствия:

• be - выполнение числовых сравнений
• be_in - поиск значения свойства в списке
• cmp - соответствие для сравнений с меньшими ограничениями (попробуйте это в первую очередь)
• eq - соответствие для сравнения с учётом типа
• include - поиск ожидаемого значения в свойстве со значениями в виде списка
• match - поиск шаблонов в тексте с использованием регулярных выражений

См. «Изучение ресурсов Chef InSpec» на Learn Chef Rally, чтобы узнать больше о встроенных соответствиях InSpec.

be

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

describe file('/proc/cpuinfo') do
  its('size') { should be >= 10 }
  its('size') { should be < 1000 }
end

cmp

В отличие от eq, cmp — это соответствие для сравнений с меньшими ограничениями. Оно будет пытаться привести фактическое значение к типу, с которым вы его сравниваете. Это призвано избавить пользователя от необходимости писать преобразования типов и разрешения.

describe sshd_config do
  its('Protocol') { should cmp 2 }
end

describe passwd.uid(0) do
  its('users') { should cmp 'root' }
end

cmp работает следующим образом:

• Сравнение строк с числами

describe sshd_config do
  # Only `'2'` works
  its('Protocol') { should eq '2' }

  # Both of these work
  its('Protocol') { should cmp '2' }
  its('Protocol') { should cmp 2 }
end

• Сравнение строк не учитывает регистр

describe auditd_conf do
  its('log_format') { should cmp 'raw' }
  its('log_format') { should cmp 'RAW' }
end

• Распознавание версий, встроеных в строки

describe package('curl') do
  its('version') { should cmp > '7.35.0-1ubuntu2.10' }
end

• Сравнение массивов с одним элементом со значением

describe passwd.uids(0) do
  its('users') { should cmp 'root' }
  its('users') { should cmp ['root'] }
end

• Массивы со строками из одного значения также могут быть сравнены с регулярным выражением

describe auditd_conf do
  its('log_format') { should cmp /raw/i }
end

• Улучшен вывод сравнений в восьмеричной форме

describe file('/proc/cpuinfo') do
  its('mode') { should cmp '0345' }
end

expected: 0345
got: 0444

eq

Проверка точного равенства двух значений.

describe sshd_config do
  its('RSAAuthentication') { should_not eq 'no' }
  its('Protocol') { should eq '2' }
end

eq завершается неудачей, если типы не совпадают. Пожалуйста, помните об этом при сравнении записей конфигурации, которые являются числами:

its('Port') { should eq '22' } # ok

its('Port') { should eq 22 }
# fails: '2' != 2 (string vs int)

Для сравнений с меньшими ограничениями используйте cmp.

include

Проверяет, входит ли значение в список.

describe passwd do
  its('users') { should include 'my_user' }
end

be_in

Проверяет, содержится ли элемент в списке.

describe resource do
  its('item') { should be_in LIST }
end

match

Проверка соответствия строки регулярному выражению.

describe sshd_config do
  its('Ciphers') { should_not match /cbc/ }
end