Ресурс docker_image

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

Используйте ресурс аудита Chef InSpec, чтобы проверить образ Docker.

Доступность

Установка

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

Версия

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

Синтаксис

Блок ресурса docker_image объявляет образ:

describe docker_image('alpine:latest') do
  it { should exist }
  its('id') { should eq 'sha256:4a415e...a526' }
  its('repo') { should eq 'alpine' }
  its('tag') { should eq 'latest' }
end

Примеры параметров ресурса

Ресурс позволяет передать идентификатор образа:

describe docker_image(id: alpine_id) do
  ...
end

Если метка отсутствует для образа, latest используется по умолчанию:

describe docker_image('alpine') do
  ...
end

Вы также можете передать репозиторий и метку как отдельные значения

describe docker_image(repo: 'alpine', tag: 'latest') do
  ...
end

Примеры свойств

id

Свойство id возвращает полный идентификатор образа:

its('id') { should eq 'sha256:4a415e3663882fbc554ee830889c68a33b3585503892cc718a4698e91ef2a526' }

image

Свойство image проверяет значение образа. Это комбинация repository/tag:

its('image') { should eq 'alpine:latest' }

repo

Свойство repo проверяет значение имени репозитория:

its('repo') { should eq 'alpine' }

tag

Свойство tag проверяет значение метки образа:

its('tag') { should eq 'latest' }

Проверка образа Docker

describe docker_image('alpine:latest') do
  it { should exist }
  its('id') { should eq 'sha256:4a415e...a526' }
  its('image') { should eq 'alpine:latest' }
  its('repo') { should eq 'alpine' }
  its('tag') { should eq 'latest' }
end

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

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

exist

Сопоставитель exist проверяет, доступен ли образ на узле:

it { should exist }