Ресурс zypper_repository

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

Страница справочника по ресурсам

Используйте ресурс zypper_repository для создания репозиториев пакетов Zypper в системах SUSE Enterprise Linux и openSUSE. Этот ресурс поддерживает полную совместимость с ресурсом zypper_repository в существующем сборнике рецептов zypper.

Новое в Chef Infra Client 13.3.

Синтаксис

Полный синтаксис для всех свойств, доступных ресурсу zypper_repository, следующий:

zypper_repository 'name' do
  autorefresh            true, false # default value: true
  baseurl                String
  cookbook               String
  description            String
  enabled                true, false # default value: true
  gpgautoimportkeys      true, false # default value: true
  gpgcheck               true, false # default value: true
  gpgkey                 String
  keeppackages           true, false # default value: false
  mirrorlist             String
  mode                   String, Integer # default value: "0644"
  path                   String
  priority               Integer # default value: 99
  refresh_cache          true, false # default value: true
  repo_name              String # default value: 'name' unless specified
  source                 String
  type                   String # default value: "NONE"
  action                 Symbol # defaults to :create if not specified
end

где:

• zypper_repository — это ресурс.
• name — это имя, присвоенное блоку ресурса.
• action определяет, какие действия выполнит Chef Infra Client, чтобы привести узел в желаемое состояние.
• autorefresh, baseurl, cookbook, description, enabled, gpgautoimportkeys, gpgcheck, gpgkey, keeppackages, mirrorlist, mode, path, priority, refresh_cache, repo_name, source, и type — это свойства, доступные для этого ресурса.

Действия

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

:add

Действие по умолчанию. Добавить новый репозиторий Zypper.

:nothing

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

:refresh

Обновить репозиторий Zypper.

:remove

Удалить репозиторий Zypper.

Свойства

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

autorefresh

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

Определяет, следует ли автоматически обновлять репозиторий.

baseurl

Тип Ruby: String

Базовый URL для репозитория Zypper, например http://download.opensuse.org.

cookbook

Тип Ruby: String

Сборник рецептов, из которого должен быть взят файл шаблона репозитория. Необходимо только в том случае, если вы не используете встроенный шаблон.

description

Тип Ruby: String

Описание репозитория, которое будет показано командой zypper repos.

enabled

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

Определяет, должен ли быть включен репозиторий.

gpgautoimportkeys

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

Автоматически импортировать указанный ключ при настройке репозитория.

gpgcheck

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

Определяет, следует ли выполнять проверку подписи GPG для репозитория.

gpgkey

Тип Ruby: String

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

keeppackages

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

Определяет, следует ли сохранять пакеты.

mirrorlist

Тип Ruby: String

URL списка зеркал, который будет использоваться.

mode

Тип Ruby: String, Integer | Значение по умолчанию: 0644

Режим файла репозитория.

path

Тип Ruby: String

Относительный путь от базового URL репозитория.

priority

Тип Ruby: Integer | Значение по умолчанию: 99

Определяет приоритет репозитория Zypper.

refresh_cache

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

Определяет, следует ли обновлять кэш пакетов.

repo_name

Тип Ruby: String | Значение по умолчанию: The resource block's name

Дополнительное свойство для установки имени репозитория, если оно отличается от имени блока ресурса.

source

Тип Ruby: String

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

type

Тип Ruby: String | Значение по умолчанию: NONE

Указывает тип репозитория.

Общие функции ресурса

Ресурсы Chef включают общие свойства, уведомления и средства защиты ресурсов.

Общие свойства

Следующие свойства являются общими для каждого ресурса:

compile_time

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

Управление фазой, во время которой ресурс выполняется на узле. Установите значение true для выполнения во время построения коллекции ресурсов (compile phase). Установите значение false для выполнения во время настройки узла Chef Infra Client (converge phase).

ignore_failure

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

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

retries

Тип Ruby: Integer | Значение по умолчанию: 0

Количество попыток перехватить исключения и повторить выполнение ресурса.

retry_delay

Тип Ruby: Integer | Значение по умолчанию: 2

Задержка повтора (в секундах).

sensitive

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

Обеспечить, чтобы конфиденциальные данные ресурса не регистрировались Chef InfraClient.

Уведомления

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

Средства защиты

Свойство защиты можно использовать для оценки состояния узла на этапе выполнения Chef Infra Client. На основе результатов этой оценки свойство защиты используется для того, чтобы сообщить Chef Infra Client, следует ли продолжать выполнение ресурса. Свойство защиты принимает либо строковое значение, либо значение блока Ruby:

• Строка выполняется как команда оболочки. Если команда возвращает 0, применяется ограничение. Если команда возвращает любое другое значение, свойство ограничения не применяется. Строковые ограничения в powershell_script выполняют команды Windows PowerShell и могут возвращать true в дополнение к 0.
• Блок выполняется как код Ruby, который должен вернуть либо true, либо false. Если блок возвращает true, свойство ограничения применяется. Если блок возвращает false, свойство ограничения не применяется.

Свойство ограничения полезно для обеспечения идемпотентности ресурса, позволяя этому ресурсу проверять желаемое состояние во время выполнения, а затем, если желаемое состояние присутствует, Chef Infra Client ничего не делает.

Следующие свойства могут быть использованы для определения ограничения, которое оценивается во время фазы выполнения выполнения Chef Infra Client:

not_if

Предотвратить выполнение ресурса, когда условие возвращает true.

only_if

Разрешить выполнение ресурса только в том случае, если условие возвращает true.

Примеры

В следующих примерах демонстрируются различные подходы к использованию ресурса zypper_repository в рецептах:

Добавить репозиторий Apache на openSUSE Leap 15:

zypper_repository 'apache' do
  baseurl 'http://download.opensuse.org/repositories/Apache'
  path '/openSUSE_Leap_15.0'
  type 'rpm-md'
  priority '100'
end