chef-backend-ctl

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

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

backup

Используйте подкоманду 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

Используйте подкоманду 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

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

Синтаксис

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

chef-backend-ctl cleanse

Опции

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

--with-external

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

Примеры

Нет.

cluster-status

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

Синтаксис

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

chef-backend-ctl cluster-status (options)

Опции

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

--json

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

Примеры

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

chef-backend-ctl cluster-status --json

demote

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

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

Синтаксис

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

chef-backend-ctl demote

Примеры

Нет.

force-leader

Используйте подкоманду 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

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

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

chef-backend-ctl gather-logs

gen-sample-backend-config

Используйте подкоманду 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

Используйте подкоманду 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 для подключения и инициализации против кластера 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

Используйте подкоманду 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.