chef_group Resource — Chef 18

Эта страница сгенерирована из исходного кода клиента Chef Infra. Чтобы предложить изменение, отредактируйте файл chef_group.rb и отправьте запрос на вытягивание в репозиторий Chef Infra Client.

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

Используйте ресурс chef_group для взаимодействия с объектами групп, существующими на сервере Chef.

Синтаксис

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

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

где:

chef_group сообщает клиенту Chef Infra использовать поставщик Chef::Provider::ChefGroup во время выполнения Chef Infra Client
name — имя блока ресурса
attribute — ноль или более свойств, доступных для этого ресурса
action определяет шаги, которые Chef Infra Client предпримет для приведения узла в желаемое состояние

Действия

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

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

Свойства

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

chef_server: URL сервера Chef.

clients: &mldr;

complete: Используется для указания, определяет ли этот ресурс полностью chef-клиент. Когда true, все свойства, не указанные этим ресурсом, будут сброшены до значений по умолчанию.

groups: &mldr;

ignore_failure: Тип Ruby: true, false | Значение по умолчанию: false
Продолжать выполнение рецепта, если ресурс завершился неудачей по какой-либо причине.

notifies

Тип Ruby: Символ, Chef::Resource\[Строка\]

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

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

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

:before: Указывает, что действие над уведомленным ресурсом должно выполняться до обработки блока ресурса, в котором находится уведомление.
:delayed: По умолчанию. Указывает, что уведомление должно помещаться в очередь и выполняться в конце выполнения Chef Infra Client.
:immediate, :immediately: Указывает, что уведомление должно выполняться немедленно для каждого уведомленного ресурса.

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

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

raw_json

Группа в формате JSON. Например:

{
  :groupname => "chef"
}

remove_clients: &mldr;

remove_groups: &mldr;

remove_users: &mldr;

subscribes

Тип Ruby: Символ, Chef::Resource\[Строка\]

Ресурс может следить за другим ресурсом и выполнять действие, если состояние отслеживаемого ресурса изменится. Укажите '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, в котором возникает ошибка, если другой ресурс отсутствует.

:before: Указывает, что действие над уведомленным ресурсом должно выполняться до обработки блока ресурса, в котором находится уведомление.
:delayed: По умолчанию. Указывает, что уведомление должно помещаться в очередь и выполняться в конце выполнения Chef Infra Client.
:immediate, :immediately: Указывает, что уведомление должно выполняться немедленно для каждого уведомленного ресурса.

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

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

users: &mldr;

Примеры

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

Ресурс chef_group

Синтаксис

Действия

Свойства

Примеры