Ресурс chef_data_bag

Редактировать эту страницу в репозитории Chef

Все страницы ресурсов Infra

Мешки данных хранят глобальные переменные в формате JSON. Мешки данных индексированы для поиска и могут загружаться кулинарией или использоваться во время поиска.

Используйте ресурс chef_data_bag для управления мешками данных.

Синтаксис

Синтаксис использования ресурса chef_data_bag в рецепте:

chef_data_bag 'name' do
  attribute 'value' # see properties section below
  ...
  action :action # see actions section below
end

где:

• chef_data_bag сообщает клиенту Chef Infra использовать провайдер Chef::Provider::ChefDataBag во время выполнения
• name — это имя блока ресурса и также имя мешка данных
• attribute — это ноль (или более) свойств, доступных для этого ресурса
• action определяет шаги, которые выполнит клиент Chef Infra, чтобы привести узел к желаемому состоянию

Действия

Ресурс chef_data_bag имеет следующие действия:

:create

По умолчанию. Используется для создания мешка данных.

:delete

Используется для удаления мешка данных.

:nothing

Этот блок ресурса не действует, пока не получит уведомление от другого ресурса о действии. После уведомления этот блок ресурса либо выполняется немедленно, либо помещается в очередь на выполнение в конце выполнения Chef Infra Client.

Свойства

Ресурс chef_data_bag имеет следующие свойства:

chef_server

URL сервера Chef Infra.

ignore_failure

Тип Ruby: true, false | Значение по умолчанию: false

Продолжить выполнение рецепта, если ресурс завершился неудачно по любой причине.

name

Имя мешка данных.

notifies

Тип Ruby: Symbol, Chef::Resource\[String\]

Ресурс может уведомлять другой ресурс о действии при изменении его состояния. Укажите 'resource[name]', :action которое должен выполнить другой ресурс, и :timer для этого действия. Ресурс может уведомлять несколько ресурсов; используйте инструкцию notifies для каждого уведомляемого ресурса.

Если указанный ресурс не существует, будет выброшено исключение. В отличие от subscribes, которая не завершается ошибкой, если исходный ресурс не найден.

Таймер указывает момент выполнения уведомления во время работы Chef Infra Client. Доступны следующие таймеры:

:before

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

:delayed

По умолчанию. Указывает, что уведомление должно быть помещено в очередь и выполнено в конце выполнения Chef Infra Client.

:immediate, :immediately

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

Синтаксис для notifies:

notifies :action, 'resource[name]', :timer

subscribes

Тип Ruby: Symbol, Chef::Resource\[String\]

Ресурс может прослушивать другой ресурс и выполнять действие, если состояние прослушиваемого ресурса изменяется. Укажите 'resource[name]', :action и :timer.

Обратите внимание, что subscribes не применяет указанное действие к ресурсу, который он прослушивает — например:

file '/etc/nginx/ssl/example.crt' do
  mode '0600'
  owner 'root'
end

service 'nginx' do
  subscribes :reload, 'file[/etc/nginx/ssl/example.crt]', :immediately
end

В этом случае свойство subscribes перезапускает службу nginx, когда файл сертификата, расположенный в /etc/nginx/ssl/example.crt, обновляется. subscribes не вносит никаких изменений в сам файл сертификата, а просто прослушивает изменения в файле и выполняет действие :reload для своего ресурса (в этом примере nginx) при обнаружении изменений.

Если другой ресурс не существует, подписка не будет вызывать ошибку. Это отличается от более жёстких семантик notifies, которые вызовут ошибку, если другой ресурс не существует.

Таймер указывает момент выполнения уведомления во время выполнения Chef Infra Client. Доступны следующие таймеры:

:before

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

:delayed

По умолчанию. Указывает, что уведомление должно быть помещено в очередь и выполнено в конце выполнения Chef Infra Client.

:immediate, :immediately

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

Синтаксис для subscribes:

subscribes :action, 'resource[name]', :timer

Примеры

Этот ресурс не имеет примеров.