parse_config_file ресурс

[редактировать на GitHub]

Используйте parse_config_file ресурс аудита Chef InSpec, чтобы проверить произвольные конфигурационные файлы. Он работает так же, как и parse_config. Вместо использования вывода команды, этот ресурс работает с файлами.

Доступность

Установка

Этот ресурс распространяется вместе с самим Chef InSpec. Вы можете использовать его автоматически.

Версия

Этот ресурс стал доступен в версии v1.0.0 InSpec.

Синтаксис

Блок parse_config_file ресурса аудита Chef InSpec объявляет расположение конфигурационного файла для проверки и затем, какие настройки в этом файле необходимо проверить.

describe parse_config_file('/path/to/file', { data_config_option: value } ) do
  its('setting') { should eq 1 }
end

или:

options = {
  assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
  multiple_values: true
}

describe parse_config_file('path/to/file', options) do
  its('setting') { should eq 1 }
end

где каждый тест

• Должен объявить расположение конфигурационного файла для проверки
• Должен объявить одну (или несколько) настройку для проверки
• Может выполнить команду для stdout, а затем выполнить тест по этому выводу
• Может использовать опции для определения того, как будет анализироваться конфигурационные данные

Параметры

Этот ресурс поддерживает следующие параметры для анализа данных конфигурации. Используйте их в блоке options указанном вне (и непосредственно перед) самим тестом:

options = {
    assignment_regex: /^\s*([^:]*?)\s*:\s*(.*?)\s*$/,
    multiple_values: true
  }
describe parse_config_file('path/to/file',  options) do
  its('setting') { should eq 1 }
end

Примеры

Следующие примеры показывают, как использовать этот ресурс аудита Chef InSpec.

Проверка конфигурационной настройки

describe parse_config_file('/path/to/file.conf') do
 its('PARAM_X') { should eq 'Y' }
end

Использование параметров, а затем проверка конфигурационной настройки

describe parse_config_file('/path/to/file.conf', { multiple_values: true }) do
 its('PARAM_X') { should include 'Y' }
end

Проверка файла с структурой, похожей на ini (например, yum.conf)

describe parse_config_file('/path/to/yum.conf') do
 its('main') { should include('gpgcheck' => '1') }
end

Сопоставители

Полный список доступных сопоставителей можно найти на нашей странице сопоставителей.

assignment_regex

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

'key = value'

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

assignment_regex: /^\s*([^=]*?)\s*=\s*(.*?)\s*$/

comment_char

Используйте comment_char для проверки комментариев в конфигурационном файле:

comment_char: '#'

key_values

Используйте key_values для проверки количества значений, содержащихся в ключе:

key = a b c

содержит три значения. Чтобы проверить, что значение содержит только одно, используйте:

key_values: 1

multiple_values

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

# # file structure:
# key = a
# key = b
# key2 = c
params['key'] = ['a', 'b']
params['key2'] = ['c']

Чтобы использовать простую сопоставление ключ-значение, используйте multiple_values: false:

# # file structure:
# key = a
# key = b
# key2 = c
params['key'] = 'b'
params['key2'] = 'c'

standalone_comments

Используйте standalone_comments для разбора комментариев как строки, в противном случае разрешаются встроенные комментарии:

'key = value # comment'
params['key'] = 'value # comment'

Используйте standalone_comments: false, для разбора следующего:

'key = value # comment'
params['key'] = 'value'