chef-backend-ctl

[редактировать на GitHub]

Кластер HA бэкенда Chef Infra Server включает утилиту командной строки с именем chef-backend-ctl. Этот инструмент командной строки используется для управления кластером HA бэкенда Chef Infra Server, запуска и остановки отдельных служб и просмотра журналов Chef Infra Server.

Резервное копирование

Используйте подкоманду backup для резервного копирования данных узла в кластере HA бэкенда. Эта команда обычно выполняется на узле-фолловере. Используйте опцию --force для выполнения этой команды для всех узлов в кластере HA бэкенда. Резервная копия создается в формате tar.gz и расположена в /var/opt/chef-backup/.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl backup (options)

Опции

Эта подкоманда имеет следующие опции:

--with-external

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

Примеры

Резервное копирование узла в кластере HA бэкенда

С узла-фолловера выполните следующую команду:

chef-backend-ctl backup

Создание кластера

Используйте подкоманду create-cluster для инициализации состояния кластера, включая хранилище данных PostgreSQL, и для инициализации первого узла в кластере HA бэкенда или для помощи в восстановлении всего кластера HA бэкенда.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl create-cluster (options)

Опции

Эта подкоманда имеет следующие опции:

--elasticsearch-wait-time

Максимальное время (в секундах) ожидания запуска Elasticsearch. Значение по умолчанию: 30.

--etcd-wait-time

Максимальное время (в секундах) ожидания запуска etcd. Значение по умолчанию: 30.

--quorum-loss-recovery

Сбрасывает идентификатор кластера в etcd для этого узла.

Если узлы в кластере HA бэкенда недоступны, etcd может не смочь сформировать кластер. Если etcd не может сформировать кластер, перестройте кластер. Сначала сбросьте идентификатор кластера на активном узле, перестройте узлы, которые будут частью кластера, а затем присоедините перестроенные узлы к кластеру, используя подкоманду chef-backend-ctl join-cluster.

-y, --yes

Не запрашивать подтверждение.

Примеры

Нет.

Очистка

Подкоманда cleanse используется для сброса состояния машины в кластере HA бэкенда Chef Infra Server до состояния, в котором она находилась до первого запуска подкоманды reconfigure. Эта команда уничтожит все данные, конфигурационные файлы и журналы. Программное обеспечение, установленное на диск при установке пакета, останется; запустите chef-backend-ctl reconfigure повторно, чтобы воссоздать стандартные данные и конфигурационные файлы.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl cleanse

Опции

Эта подкоманда имеет следующие опции:

--with-external

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

Примеры

Нет.

Статус кластера

Используйте подкоманду cluster-status для получения списка всех доступных узлов, их роли (лидер, фолловер) и статуса PostgreSQL и Elasticsearch.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl cluster-status (options)

Опции

Эта подкоманда имеет следующие опции:

--json

Возвращает информацию о состоянии кластера в формате JSON.

Примеры

Возврат данных о состоянии кластера в формате JSON

chef-backend-ctl cluster-status --json

Снизить статус

Используйте подкоманду demote для снижения статуса текущего лидера в кластере HA бэкенда, после чего новый лидер выбирается из группы доступных фолловеров в кластере HA бэкенда. Эта команда:

• Завершится с кодом выхода 0, если исходный лидер был понижен в статусе и новый лидер был успешно избран.
• Возвращает сообщение об ошибке и код выхода, отличного от нуля, если выборы лидера предотвращены из-за отключенного failover (для кластера или узла) или если новый лидер не смог быть избран в течение допустимого времени.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl demote

Примеры

Нет.

Принудительное назначение лидера

Используйте подкоманду force-leader для принудительного назначения узла, с которого выполняется команда, лидером в кластере HA бэкенда, если лидер еще не выбран.

Эта команда должна выполняться только в том случае, если:

• Кластер бэкенда, по-видимому, не имеет выбранного и доступного лидера
• Все узлы в кластере HA бэкенда считаются в нормальном состоянии; если один (или несколько) узлов неисправны, сначала удалите неисправные узлы, перестройте их и затем снова подключите к кластеру

Эта команда:

• Выполнит подкоманду chef-backend-ctl cluster-status для определения наличия лидера.

  Предупреждение

  Узлы в кластере HA бэкенда могут быть невидимы друг для друга, когда они находятся в сетевых разделах. Это может помешать проверке статуса кластера обнаружить, что лидер существует. Если узлы находятся в сетевых разделах, для предотвращения этой ситуации сначала выполните chef-backend-ctl cluster-status, а затем проверьте ожидаемое количество узлов в кластере HA бэкенда как исправных и waiting_for_leader перед выполнением этой команды.

• Завершится с кодом выхода 0, если узел, с которого выполняется команда, станет лидером.

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

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl force-leader

Примеры

Нет.

Сбор журналов

Используйте подкоманду gather-logs для сбора файлов журналов машины в кластере HA бэкенда Chef Infra Server в архивный файл tar, который содержит все важные файлы журналов и системную информацию.

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl gather-logs

Генерация образца конфигурации бэкенда

Используйте подкоманду gen-sample-backend-config для генерации вывода, содержащего все настройки кластера HA бэкенда вместе со значениями по умолчанию. Используйте эту подкоманду для получения значений publish_address и vip_interface перед инициализацией нового узла для кластера HA бэкенда.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl gen-sample-backend-config

Пример вывода

Следующий пример показывает результаты выполнения подкоманды chef-backend-ctl gen-sample-backend-config. Настройки и вывод будут отличаться в зависимости от конфигурации. Параметры elasticsearch, etcd, leaderl, и postgresql генерируются автоматически и не должны изменяться:

fqdn = 'be1'
hide_sensitive = true
ip_version = 'ipv4'
publish_address = '10.0.2.15'
vip = '10.0.2.15'
vip_interface = 'eth0'
etcd.client_port = 2379
etcd.enable = true
etcd.log_directory = '/var/log/chef-backend/etcd'
etcd.peer_port = 2380
etcd.log_rotation.file_maxbytes = 104857600
etcd.log_rotation.num_to_keep = 10
postgresql.archive_command = ''
postgresql.archive_mode = 'off'
postgresql.archive_timeout = 0
postgresql.checkpoint_completion_target = 0.5
postgresql.checkpoint_timeout = '5min'
postgresql.checkpoint_warning = '30s'
postgresql.data_dir = '/var/opt/chef-backend/postgresql/9.5/data'
postgresql.db_superuser = 'chef_pgsql'
postgresql.effective_cache_size = '496MB'
postgresql.enable = true
postgresql.hot_standby = 'on'
postgresql.keepalives_count = 2
postgresql.keepalives_idle = 60
postgresql.keepalives_interval = 15
postgresql.log_directory = '/var/log/chef-backend/postgresql/9.5'
postgresql.log_min_duration_statement = -1
postgresql.max_connections = 350
postgresql.max_replication_slots = 12
postgresql.max_wal_senders = 12
postgresql.max_wal_size = 64
postgresql.md5_auth_cidr_addresses = '["samehost", "samenet"]'
postgresql.min_wal_size = 5
postgresql.port = 5432
postgresql.replication_user = 'replicator'
postgresql.shared_buffers = '248MB'
postgresql.shmall = 4194304
postgresql.shmmax = 17179869184
postgresql.username = 'chef_pgsql'
postgresql.wal_keep_segments = 32
postgresql.wal_level = 'hot_standby'
postgresql.wal_log_hints = 'on'
postgresql.work_mem = '8MB'
postgresql.log_rotation.file_maxbytes = 104857600
postgresql.log_rotation.num_to_keep = 10
elasticsearch.data_dir = '/var/opt/chef-backend/elasticsearch/data'
elasticsearch.enable = true
elasticsearch.heap_size = 248
elasticsearch.java_opts = ''
elasticsearch.log_directory = '/var/log/chef-backend/elasticsearch'
elasticsearch.new_size = 32
elasticsearch.plugins_directory = '/var/opt/chef-backend/elasticsearch/plugins'
elasticsearch.port = 9200
elasticsearch.scripts_directory = '/var/opt/chef-backend/elasticsearch/scripts'
elasticsearch.temp_directory = '/var/opt/chef-backend/elasticsearch/'
elasticsearch.log_rotation.file_maxbytes = 104857600
elasticsearch.log_rotation.num_to_keep = 10
leaderl.control_worker_timeout_seconds = 30
leaderl.db_timeout = 2000
leaderl.enable = true
leaderl.health_check_interval_seconds = 2
leaderl.leader_ttl_seconds = 10
leaderl.log_directory = '/var/log/chef-backend/leaderl'
leaderl.status_internal_update_interval_seconds = 5
leaderl.status_post_update_interval_seconds = 10
leaderl.log_rotation.file_maxbytes = 104857600
leaderl.log_rotation.max_messages_per_second = 1000
leaderl.log_rotation.num_to_keep = 10
leaderl.etcd_pool.cull_interval_seconds = 60
leaderl.etcd_pool.http_timeout_ms = 5000
leaderl.etcd_pool.ibrowse_options = '{inactivity_timeout, infinity}'
leaderl.etcd_pool.init_count = 10
leaderl.etcd_pool.max_age_seconds = 60
leaderl.etcd_pool.max_connection_duration_seconds = 300
leaderl.etcd_pool.max_count = 10
ssl.certificate = nil
ssl.certificate_key = nil
ssl.ciphers = (a list of ciphers, not shown)
ssl.company_name = 'YouCorp'
ssl.country_name = 'US'
ssl.data_dir = '/var/opt/chef-backend/ssl/'
ssl.duration = 3650
ssl.key_length = 2048
ssl.organizational_unit_name = 'Operations'

Генерация конфигурации сервера

Используйте подкоманду gen-server-config для генерации вывода для файла конфигурации /etc/opscode/chef-server.rb. Эту команду можно запустить с любого узла в кластере HA бэкенда, но её нужно запустить отдельно для каждого узла в группе фронтенда. Эта команда:

• Завершается с кодом выхода 0, если файл chef-server.rb создан успешно.
• Возвращает сообщение об ошибке и код выхода, отличный от нуля, если узел не был инициализирован или добавлен или если не предоставлен FQDN.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl gen-server-config FQDN

Настройка фронтенда

1. На любом узле в кластере HA бэкенда выполните следующую команду для каждого узла в группе фронтенда:

   chef-backend-ctl gen-server-config FQDN -f chef-server.rb.fqdn
   

   где FQDN — FQDN машины фронтенда. Сгенерированный файл chef-server.rb будет содержать все значения, необходимые любому серверу Chef Infra Server фронтенда для подключения и инициализации кластера HA бэкенда.

2. На каждой машине фронтенда установите пакет chef-server-core (версия 12.4.0 или выше).

3. На каждой машине фронтенда скопируйте сгенерированный chef-server.rb.fqdn в /etc/opscode/chef-server.rb.

4. На каждой машине фронтенда с правами root выполните следующую команду:

   chef-server-ctl reconfigure
   

Пример вывода

Следующий пример показывает результаты выполнения подкоманды chef-backend-ctl gen-server-config. Настройки и вывод будут отличаться в зависимости от конфигурации. Эти настройки следует изменять с осторожностью:

fqdn "frontend1.chef-demo.com"
postgresql['external'] = true
postgresql['vip'] = '192.0.2.0'
postgresql['db_superuser'] = 'chef_pgsql'
postgresql['db_superuser_password'] = '...6810e52a01e562'
opscode_solr4['external'] = true
opscode_solr4['external_url'] = 'http://192.0.2.0:9200'
opscode_erchef['search_provider'] = 'elasticsearch'
opscode_erchef['search_queue_mode'] = 'batch'
bookshelf['storage_type'] = :sql
rabbitmq['enable'] = false
rabbitmq['management_enabled'] = false
rabbitmq['queue_length_monitor_enabled'] = false
opscode_expander['enable'] = false
dark_launch['actions'] = false
opscode_erchef['nginx_bookshelf_caching'] = :on
opscode_erchef['s3_url_expiry_window_size'] = '50%'

Справка

Используйте подкоманду help для вывода списка всех доступных команд chef-backend-ctl.

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl help

Присоединение к кластеру

Используйте подкоманду join-cluster для настройки узла в качестве участника кластера HA бэкэнда в качестве пары узла по указанному PEER_NODE_IP IP-адресу. Эта команда запросит существующий кластер для определения необходимой конфигурационной информации. Если опции --publish-address и --vip-interface не указаны и указаны в chef-backend.rb, команда предложит список элементов для выбора.

Эта команда вернёт сообщение об ошибке и ненулевой код выхода в следующих случаях:

• Если опция --secrets-file-path указана, непустой файл секретов уже существует по адресу /etc/chef-backend/secrets.json, и пользователь откажется от его перезаписи.
• Если опция --secrets-file-path указана, но не указывает на допустимый файл и/или файл по адресу /etc/chef-backend/secrets.json пустой или не существует.
• Если IP-адрес, указанный в опции --publish-address, не существует на узле.
• Если интерфейс, указанный в опции --vip-interface, не существует на узле.
• Если любой IP-адрес на узле уже зарегистрирован в кластере HA бэкэнда.
• Если узел уже настроен для кластера HA бэкэнда, и опция --recovery не указана.
• Если опция --recovery указана, но не найдена существующая установка.
• --publish-address и/или --vip-interface указаны, но непустой файл chef-backend.rb уже существует. (Эта команда не перезапишет файл chef-backend.rb.)

При успешном выполнении эта команда сгенерирует файл chef-backend.rb по адресу /etc/chef-backend/chef-backend.rb с автоматически добавленными значениями для publish_address, vip_interface, и vip.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl join-cluster PEER_NODE_IP (options)

где PEER_NODE_IP — IP-адрес пары в кластере, к которому необходимо присоединиться.

Параметры

Эта подкоманда имеет следующие параметры:

-i INTERFACE, --vip-interface INTERFACE

Сеть интерфейс, к которому бэкэнд VIP будет привязан в случае, если этот узел станет лидером. Если не указан и не указан в chef-backend.rb, эта команда предложит выбрать из списка интерфейсов, которые в настоящее время доступны на узле.

Примечание

Этот параметр следует использовать только при первом присоединении узла к кластеру HA бэкэнда.

-p IP_ADDRESS, --publish-address IP_ADDRESS

IP-адрес, опубликованный в кластере HA бэкэнда. Этот IP-адрес должен быть доступен всем узлам в кластере HA бэкэнда. Если не указан и не указан в chef-backend.rb, эта команда предложит выбрать из списка IP-адресов, которые в настоящее время привязаны к узлу.

Примечание

Этот параметр следует использовать только при первом присоединении узла к кластеру HA бэкэнда.

--recovery

Принудительно заново присоединить этот узел к кластеру HA бэкэнда, если он был удалён с помощью команд chef-backend-ctl remove-node или chef-backend-ctl bootstrap --with-quorum-recovery.

Примечание

Этот параметр будет работать с существующим файлом chef-backend.rb, что означает, что параметры --vip-interface и --publish-address не должны быть указаны. (Они уже определены в файле chef-backend.rb.)

-s PATH, --secrets-file-path PATH

Абсолютный путь к расположению файла secrets.json на узле инициализации. Путь должен начинаться с «/». Значение по умолчанию: /etc/chef-backend/secrets.json.

-y, --yes

Не запрашивать подтверждение.

Примеры

Нет.

promote

Используйте подкоманду promote для повышения узла с заданным именем до лидера кластера HA бэкэнда. Эта команда будет:

• Завершится с кодом выхода 0, если лидер кластера HA бэкэнда будет заменён узлом с заданным именем.
• Вернуть сообщение об ошибке и ненулевой код выхода, если узел с заданным именем уже является лидером, потому что отказ по очереди отключён (либо для кластера, либо для узла) или если новый лидер не смог быть повышен в течение допустимого времени.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl promote NODE

Примеры

Нет.

reconfigure

Используйте подкоманду reconfigure для перенастройки машины в кластере Chef Infra Server бэкэнда HA. Эта подкоманда также перезапустит все службы, для которых настройка service_name['enabled'] установлена в true.

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl reconfigure

удаление узла

Используйте подкоманду remove-node для удаления узла с заданным именем из кластера HA бэкэнда, удалив статус узла из etcd и удалив его из кластера etcd. Эта команда полезна, когда узел будет заменён или если команда join-cluster не увенчалась успехом.

Эта команда не может быть запущена с узла, который требуется удалить; сам узел должен быть физически выключен или иметь все службы остановлены (через команду chef-backend-ctl stop). Если узел всё ещё работает или по-прежнему доступен кластеру HA бэкэнда, эта команда вернёт сообщение об ошибке и ненулевой код выхода.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl remove-node NODE_NAME

Параметры

Эта подкоманда имеет следующие параметры:

-y, --yes

Не запрашивать подтверждение.

Примеры

Нет.

восстановление

Используйте подкоманду restore для восстановления резервной копии, созданной подкомандой chef-backend-ctl backup. Эта команда должна выполняться на лидере узла в кластере HA бэкэнда. Эта команда удалит все существующие данные и заменит их данными в резервной копии.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl restore PATH (options)

где PATH — путь к файлу tar.gz, созданному подкомандой chef-backend-ctl backup.

Параметры

Эта подкоманда имеет следующие параметры:

-d DIRECTORY, --staging-dir DIRECTORY

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

-y, --yes

Не запрашивать подтверждение.

Примеры

Восстановление данных на лидере бэкэнда

На узле лидера выполните следующую команду:

chef-backend-ctl restore /var/opt/chef-backup/backup_file.tgz

установка отказоустойчивости кластера

Используйте подкоманду set-cluster-failover для включения или отключения отказоустойчивости в кластере HA бэкэнда.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl set-cluster-failover STATE

где STATE может быть одним из on, off, true, false, enabled, или disabled.

установка отказоустойчивости узла

Используйте подкоманду set-node-failover для включения или отключения отказоустойчивости для узла в кластере HA бэкэнда.

Синтаксис

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl set-node-failover STATE

где STATE может быть одним из on, off, true, false, enabled, или disabled.

показать конфигурацию

Подкоманда show-config используется для просмотра конфигурации, которая будет сгенерирована подкомандой reconfigure. Эта команда наиболее полезна на ранних этапах развертывания, чтобы убедиться, что всё построено правильно перед установкой.

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl show-config

статус

Используйте подкоманду status для отображения статуса всех служб, доступных узлу в кластере HA бэкэнда. Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl status

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

chef-backend-ctl status SERVICE_NAME

Например, полный вывод:

chef-backend-ctl status

аналогичен:

Service        Local Status        Time in State  Distributed Node Status
elasticsearch  running (pid 6661)  1d 5h 59m 41s  state: green; nodes online: 3/3
etcd           running (pid 6742)  1d 5h 59m 39s  health: green; healthy nodes: 3/3
leaderl        running (pid 6788)  1d 5h 59m 35s  leader: 1; waiting: 0; follower: 2; total: 3
postgresql     running (pid 6640)  1d 5h 59m 43s  leader: 1; offline: 0; syncing: 0; synced: 2

который отображает статус здорового кластера HA бэкэнда. Первые три столбца—Service, Local Status, и Time in State обобщают локальное состояние. Столбец Distributed Node Status показывает:

• Кластер из трёх узлов
• Все узлы здоровы и онлайн
• Выбран лидер с двумя последователями (как для статуса лидер/последователь для службы leaderl, так и для состояния лидер/синхронизирован для службы postgresql)

Простой вывод:

chef-backend-ctl status --simple

аналогичен:

run: elasticsearch: (pid 6661) 106983s; run: log: (pid 6667) 106983s
run: etcd: (pid 6742) 106981s; run: log: (pid 6630) 106984s
run: leaderl: (pid 6788) 106976s; run: log: (pid 6739) 106982s
run: postgresql: (pid 6640) 106984s; run: log: (pid 6653) 106983s

который показывает состояние служб, идентификаторы процессов и время активности (в секундах). Простой вывод полезен, если один (или более) узлов в кластере HA бэкэнда неисправны или находятся в деградированном состоянии.

удаление

Подкоманда uninstall используется для удаления приложения Chef Infra Server с машины в кластере HA бэкэнда, но без удаления данных. Эта подкоманда остановит все службы (включая диспетчер процессов runit).

Эта подкоманда имеет следующий синтаксис:

chef-backend-ctl uninstall

Подкоманды служб

У данной команды есть встроенный диспетчер процессов, который гарантирует, что все необходимые службы находятся в соответствующем состоянии в любое время. Диспетчер запускает по две задачи на каждую службу и предоставляет следующие подкоманды для управления службами: hup, int, kill, once, restart, service-list, start, status, stop, tail, и term.

hup

Используйте подкоманду hup для отправки SIGHUP всем службам на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl hup SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.

int

Используйте подкоманду int для отправки SIGINT всем службам на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl int SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.

kill

Используйте подкоманду kill для отправки SIGKILL всем службам на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl kill SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.

once

Диспетчер процессов для машины в кластере HA бэкенда Chef Infra Server настроен на перезапуск любой службы, которая завершится ошибкой, если только эта служба не запросила изменение своего состояния. Подкоманда once используется для того, чтобы указать диспетчеру не пытаться перезапускать любые завершившиеся ошибкой службы.

Эта команда полезна при устранении неполадок в конфигурации, которые препятствуют запуску службы. Запустите подкоманду once и далее status для поиска служб в состоянии «остановки» и/или определения проблемных служб. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl once SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.

restart

Используйте подкоманду restart для перезапуска всех включенных служб на машине в кластере HA бэкенда Chef Infra Server или для перезапуска отдельной службы, указав имя этой службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl restart SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list . При успешном перезапуске службы вывод должен быть похож на:

ok: run: service_name: (pid 12345) 1s

список-служб

Используйте подкоманду service-list для отображения списка всех доступных служб на машине в кластере HA бэкенда Chef Infra Server. Служба, которая включена, помечена звездочкой (*).

У этой подкоманды следующий синтаксис:

chef-backend-ctl service-list

start

Используйте подкоманду start для запуска всех включенных служб на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl start SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list . При успешном запуске службы вывод должен быть похож на:

ok: run: service_name: (pid 12345) 1s

Диспетчер процессов для машины в кластере HA бэкенда Chef Infra Server настроен на ожидание семь секунд в ответ на команду от диспетчера. Если вы видите вывод, связанный с таймаутом, это означает, что сигнал был отправлен процессу, но процесс еще не выполнил его. В целом, процессы с таймаутами не вызывают сильной озабоченности, если только они вообще не отвечают на сигналы. Если процесс не отвечает, используйте команду, подобную подкоманде kill для остановки процесса, найдите причину (по необходимости), а затем используйте подкоманду start для повторного включения.

stop

Используйте подкоманду stop для остановки всех включенных служб в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl stop SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list . При успешной остановке службы вывод должен быть похож на:

ok: diwb: service_name: 0s, normally up

Например:

chef-backend-ctl stop

вернёт что-то подобное:

ok: down: etcd: 393s, normally up
ok: down: postgresql: 388s, normally up

tail

Используйте подкоманду tail для отслеживания всех логов всех служб на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl tail SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.

term

Используйте подкоманду term для отправки SIGTERM всем службам на машине в кластере HA бэкенда Chef Infra Server. Эту команду также можно запустить для отдельной службы, указав имя службы в команде.

У этой подкоманды следующий синтаксис:

chef-backend-ctl term SERVICE_NAME

где SERVICE_NAME представляет имя любой службы, которая отображается после выполнения подкоманды service-list.