Использование

zopush [options] [NETWORK...]

Параметры

--all

Установить на все найденные компьютеры.
Если флаг не указан, то будут выбраны только подсети, включающие данную машину.

-a, --askpass <path>

Путь к программе, которая вернет пароль пользователя в стандартный поток вывода.
Параметр может быть использован в случае, если не сконфигурирован доступ к
удаленному компьютеру по ключу (или ключ требует ввода секретной фразы)
или если не настроено исполнение команд sudo без пароля.

-c, --comm-server-url <url>

Адрес сервера коммуникаций Зодиак. Если не задан, то будет использована
конфигурация данной машины.

-d, --distrib-path <path>

Путь к установочному пакету. Обязательный параметр.
В качестве пути может быть указан URL.

--dry-run

Сканирует указанные подсети и формирует отчет без выполнения установки.

--target-version <version>

Фильтр по версии агента Зодиак. Установка будет выполнена только на компьютеры,
на которых не установлена указанная версия агента.

--help

Печатает данный текст и завершается.

-i, --identity-file <path>

Указывает путь к приватному ключу SSH для доступа к удаленным машинам.
Если не задан, то будет выбран подходящий ключ в соответствии с
конфигурацией SSH (по-умолчанию ключ из папки $HOME/.ssh/)

-o, --os-id <os>

Фильтр идентификаторов операционных систем. Чтобы разрешить установку на несколько ОС,
допустимо указывать несколько параметров -o в командной строке.
Если фильтр не задан, то установка осуществляется на все доступные по SSH
компьютеры Linux с поддержкой rpm или deb пакетов.

-p, --port <port>

Порт SSH. Если не задан, то будет использован порт 22.

--skip-scan

Не выполнять поиск компьютеров, доступных по SSH.

-t, --timeout <seconds>

Время ожидания соединения, по-умолчанию 2с.

--type <rpm|deb>

Тип пакета для установки.

--usage

Короткая информация об использовании программы.

-u, --username <user>

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

--verbose

Выводит диагностику по каждому адресу в stderr.

--version

Печатает номер версии и завершается.

-

Читать список подсетей из stdin.

NETWORK

Имя компьютера или подстети, куда необходимо установить агент Зодиак.

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

Если в качестве значения использован символ -, то список компьютеров и/или подсетей
будет ожидаться из стандартного потока ввода

Комментарии

Если параметр --target-version не задан и агент Зодиак уже установлен,
то никаких действий не предпринимается.

Если параметр --target-version задан, установка выполняется только на машины,
где агент отсутствует или его версия отличается от указанной.

Компьютеры, к которым не удалось установить доступ по указанному порту SSH, не добавляются в отчет об установке.

Идентификатор ОС вычисляется по полю ID файла /etc/os-release.

Если тип пакета не задан через --type, он определяется по расширению файла
или URL: .deb или .rpm.

Примеры

• Установить агент Зодиак на все доступные компьютеры из подсети текущей машины

  zopush -d /opt/zodiac/zopush/agent.deb
  

• Скрипт для глобальной директивы, где перечислены все подсети, на которые требуется распространить агент Зодиак,
  если установлена ОС Astra или Red OS:

  zopush -d /opt/zodiac/zopush/agent.rpm -i /home/svc_adm/id_rsa -u svc_adm -o astra -o redos - <<EOF
  10.0.1.0/24
  10.0.2.0/24
  10.0.3.0/255.255.255.0
  192.168.1.42
  pc01.domain.name
  EOF
  

• Установить пакет по URL только на машины, где еще не стоит версия 1.2.3:

  zopush -d https://repo.example.local/agent-1.2.3.deb --target-version 1.2.3 10.10.1.0/24