[править на GitHub]

Настройка

Приложение Chef Workstation и chef-run конфигурация управляются в config.toml. Chef Workstation создаст config.toml при первом использовании chef-run, если таковой не существует. Для настройки других инструментов см. соответствующие страницы в панели инструментов под Chef Workstation Tools.

По умолчанию

Chef Workstation ищет config.toml в стандартном расположении.

Windows

• Powershell: $env:USERPROFILE\.chef-workstation\config.toml
• cmd.exe: %USERPROFILE%\.chef-workstation\config.toml

Linux и Mac

/home/$USER/.chef-workstation/config.toml

Настройки

Телеметрия

Настройка поведения телеметрии для компонентов Chef Workstation.

Пример

[telemetry]
enable = true
dev = false

Включить

Описание

При true, анонимные данные об использовании и отчеты об ошибках отправляются в Chef. См. Заявление о конфиденциальности Chef для типа и использования собираемых данных.

Значение

true, false

По умолчанию

true

Используется

chef-run

CHEF_TELEMETRY_OPT_OUT

При любом значении, chef-run не будет собирать или отправлять данные телеметрии.

dev

Описание

При любом значении chef-run не будет собирать или отправлять данные телеметрии. Установите только в случае доступа к внутренней среде QA Chef — в противном случае данные телеметрии не будут успешно собраны Chef. Если у вас есть доступ к внутренней среде QA Chef, если dev и enable оба true, анонимные данные сообщаются в среду QA Chef.

Значения

true, false

По умолчанию

false

Используется

chef-run, Chef Workstation App

Логи

Управление уровнем и местоположением ведения журнала.

Пример

[log]
level = "debug"
location = "C:\Users\username\chef-workstation.log"

Уровень

Описание

Определяет, какие сообщения записываются в локальный файл журнала из команд Chef Workstation, запущенных локально.

Значения

"debug", "warn", "info", "error", "fatal"

По умолчанию

"warn"

Используется

chef-run

Расположение

Описание

Местоположение локального файла журнала Chef Workstation.

Значения

Значение должно быть допустимым, записываемым путем к файлу.

По умолчанию

`"$USERHOME/.chef-workstation/logs/default.log"

Используется

chef-run

Кэш

Настройка параметров кэширования.

Пример

[cache]
path = "/home/users/username/.cache/chef-workstation"

Путь

Описание

Базовый путь для хранения кэшированных кулинарных книг и загрузок.

По умолчанию

$USERHOME/.chef-workstation/cache

Значения

Должно ссылаться на допустимую, записываемую директорию.

Используется

chef-run

Подключение

Управление поведением подключения по умолчанию.

Пример

[connection]
default_protocol = "winrm"
default_user = "username"

default_protocol

Описание

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

Значения

"ssh", "winrm"

По умолчанию

"ssh"

Используется

chef-run

Флаг командной строки

--protocol PROTO

default_user

Описание

Имя пользователя по умолчанию для аутентификации целевого хоста.

Значения

Имя пользователя, которое существует на целевых хостах.

По умолчанию

root (Linux), administrator (Windows)

Используется

chef-run

Флаг командной строки

--user USERNAME

Connection.winrm

Управление поведением подключения для протокола WinRM.

Пример

[connection.winrm]
ssl = true
ssl_verify = false

ssl

Описание

Включение SSL для шифрования сеансов WinRM

Значения

true, false

По умолчанию

false

Используется

chef-run

Флаг командной строки

--[no]-ssl

ssl_verify

Описание: Предназначен для использования в тестовых средах, которые используют самозаверяющие сертификаты на узлах Windows.

По умолчанию

true

Значения

true, false

Используется

chef-run

Флаг командной строки

–ssl-[no]-verify

Chef

Настройка удаленного Chef, работающего на экземплярах.

Пример

[chef]
trusted_certs_dir = "/home/username/mytrustedcerts"
cookbook_repo_paths = [
  "/home/username/cookbooks",
  "/var/chef/cookbooks"
]

trusted_certs_dir

Описание

Указывает, где найти доверенные сертификаты Chef. Используется для обеспечения предоставления доверенных сертификатов для chef-client на целевых узлах.

Значения

Директория, содержащая доверенные сертификаты для использования в экосистеме Chef.

По умолчанию

Сначала ищется .chef/config.rb и используется это значение, если оно предоставлено; в противном случае "/opt/chef-workstation/embedded/ssl/certs/"

Используется

chef-run

cookbook_repo_paths

Описание

Путь или пути для разрешения кулинарных книг. Если предоставлено несколько путей к кулинарным книгам, и кулинарная книга существует в нескольких из них, кулинарная книга, найденная в последнем каталоге, будет использоваться. В примере, при разрешении кулинарной книги mycb: если mycb существовало как в /home/username/cookbooks, так и в /var/chef/cookbooks, mycb в /var/chef/cookbooks будет использоваться.

Значения

Строка, ссылающаяся на допустимый путь к кулинарным книгам, или массив таких строк. См. пример для синтаксиса.

По умолчанию

cookbook_path значение из .chef/config.rb, в противном случае не найдено

Используется

chef-run

Флаг командной строки

--cookbook-repo-paths PATH1,PATH2,..PATHn

Обновления

Настройка поведения автоматической проверки обновлений для Chef Workstation.

Пример

[updates]
enable = true
channel = "current"

Включить

Описание

Включить проверку обновлений для обновлений Chef Workstation.

Значения

true, false

По умолчанию

true

Используется

Приложение Chef Workstation

Канал

Описание

Установите канал обновления для проверки обновлений Chef Workstation. "stable" - рекомендуемое значение. Переключение на "current" не гарантирует стабильности и должно использоваться только в случае готовности к риску.

Значения

"stable", "current"

По умолчанию

"stable"

Используется

Приложение Chef Workstation

Data_collector

Настройка отчета о chef-client запусках, вызванных через chef-run.

Пример

[data_collector]
url = "https://1.1.1.1/data-collector/v0/"
token = "ABCDEF0123456789"

url

Описание

URL конечной точки сбора данных Automate. Этот URL предоставляется целевому хосту, позволяя им отправлять отчеты в Automate при использовании chef-run для слияния целей. Требуется действительный токен, сгенерированный Automate.

Значения

Допустимая конечная точка сбора данных automate.

По умолчанию

не установлено.

Используется

chef-run

токен

Описание

Токен API Automate, используемый на целевом хосте для аутентификации на предоставленной url .

Значения

Действительный токен, сгенерированный Automate.

По умолчанию

не установлено.

Используется

chef-run

Dev

Эти параметры предназначены для разработки и отладки инструментов Chef Workstation. Их использование не поддерживается и может измениться.

Пример

[dev]
spinner = false

spinner

Описание

Использование анимированных вращающихся элементов и индикаторов выполнения в выходных данных терминала.

Значения

true, false

По умолчанию

true

Используется

chef-run

Функции

Включение и отключение экспериментальных функций для Chef Workstation.

Пример

[features]
example = true

Описание

Список экспериментальных функций. Булево. По умолчанию: нет. Включить функцию с feature = true, отключить с feature = false. example = true включает одну функцию, которая является example функцией. Вы также можете включать или отключать любые функции из командной строки с помощью переменной окружения. Например, установка CHEF_FEAT_EXAMPLE=true из командной строки включает example функцию на время сеанса терминала.

Значения

name = true, name = false

Используется

Вся экосистема Chef Workstation.