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

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

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

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

Доступны следующие поддерживаемые 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