Краткий справочник

Шпаргалка по управлению конфигурацией с Chef

Краткое руководство по Chef: knife CLI, chef-solo, ресурсы Recipe DSL, установка пакетов, удаленные файлы и условные гарды.

· Опубликовано

Chef Chef — это фреймворк для автоматизации инфраструктуры и управления конфигурациями (IaC), написанный на Ruby и Erlang.

Установка и автономный запуск (chef-solo)

Установка клиента Chef на целевой сервер с помощью скрипта Omnitruck:

# Установка клиента Chef
curl -L https://omnitruck.chef.io/install.sh | sudo bash

# Проверка установки
chef-solo -v

Автономное выполнение кукбука:

chef-solo -c solo.rb -j node.json

Команды Knife CLI

# Поиск в реестре Supermarket
knife supermarket search mysql

# Скачивание архива кукбука
knife supermarket download nginx

# Инициализация удаленного узла по SSH
knife bootstrap 192.168.1.50 -x root -P 'password' -N web01

Основные ресурсы Recipe DSL

Пакеты и службы

package 'nginx' do
  action :install
end

service 'nginx' do
  action [:enable, :start]
  supports status: true, restart: true, reload: true
end

Загрузка удаленных файлов

remote_file '/usr/local/src/node.tar.gz' do
  source 'https://nodejs.org/dist/v18.0.0/node-v18.0.0.tar.gz'
  checksum 'sha256checksumhere...'
  mode '0644'
  action :create_if_missing
end

Выполнение shell-команд

execute 'compile_app' do
  command './configure && make && make install'
  cwd '/usr/local/src/app'
  environment 'PATH' => "/usr/local/bin:#{ENV['PATH']}"
  creates '/usr/local/bin/app' # Гард: выполнять только если бинарник отсутствует
end

Условные гарды (only_if и not_if)

execute 'migrate_database' do
  command 'rails db:migrate'
  cwd '/var/www/app/current'
  only_if { File.exist?('/var/www/app/current/Rakefile') }
  not_if  'pg_isready -h localhost'
end

Связанные темы