vRA 8: шпаргалка vracli

Подборка наиболее часто используемых команд для управления vRealize Automation 8: в одном месте собраны и упорядочены команды из различных источников (онлайн справка vRA, база знаний VMware, справочная система vracli, переписка со службой поддержки).

Проверка состояния vRA
Остановка и запуск
Работа с логами
Сетевые параметры
Диски
Установка обновлений
Работа с внутренней БД

Описание синтаксиса команды vracli и всех её опций можно посмотреть во встроенной справочной системе. Для каждого из аргументов также доступна справочная информация:

vracli --help
vracli status --help

Также рекомендую ознакомиться с официальной документацией: Administering vRealize Automation, а для автоматизированной настройки и мониторинга можно использовать REST API.

Проверка состояния vRA

# Показать статус кластера
vracli status

# Показать текущую версию vRA
vracli version

# Показать версию установленного патча
vracli version patch

# Проверить состояние служб и приложений
vracli service status

# Статус операции deploy
vracli status deploy

# Проверка состояния подов vRA
kubectl -n prelude get pods

# Проверка состояния подов с фильтрацией и расширенным форматом данных
kubectl -n prelude get pods -o wide | grep postgres

Остановка и запуск

# Остановка vRA версии 8.6 и старше
/opt/scripts/deploy.sh --shutdown

# Остановка vRA версии 8.5 и младше
/opt/scripts/svc-stop.sh
sleep 120
/opt/scripts/deploy.sh --onlyClean

# Запуск vRA
/opt/scripts/deploy.sh

# Просмотр лога развёртывания vRA
tail -f /var/log/deploy.log

Работа с логами

# Просмотр логов по имени пода
vracli logs postgres-0

# Просмотр логов сервиса
vracli logs --service rabbitmq-ha

Создание Log Bundle:

# Создать log-bundle и сохранить в /home/root
vracli log-bundle

# Ограничить время создания log-bundle
vracli log-bundle --collector-timeout $CUSTOM_TIMEOUT_IN_SECONDS

# Собрать логи за последние N дней
vracli log-bundle --since-days 1

# Собрать логи только с указанных сервисов
vracli log-bundle --services ebs-app,vco-app,abx-service-app

Настройка передачи логов:

# Настройка передачи логов в vRealize Log Insight
vracli vrli
vracli vrli set https://vrli.zabedu.ru:9543
vracli vrli set --insecure https://vrli.zabedu.ru:9543

# Отмена передачи логов в Log Insight
vracli vrli unset

# Настройка передачи логов на внешний сервер Syslog
vracli remote-syslog set --help

# Отмена передачи логов в Syslog
vracli remote-syslog unset

Сетевые параметры

# Настройка DNS
vracli network dns status
vracli network dns set --servers DNS1,DNS2

# Смена IP
vracli network ip --address 192.168.3.10 --gateway 192.168.3.1 --dns 192.168.3.1
# после изменения сетевых настроек потребуется перезапуск vRA

# Настройка NTP
vracli ntp status
vracli ntp esxi
vracli ntp systemd --set 'NTP1', 'NTP2'

Диски

# Просмотр информации по дискам
vracli disk-mgr stats

# Изменение размера разделов после расширения диска
vracli disk-mgr resize
# результат работы в /var/log/disk_resize.log

Установка обновлений

# Просмотр текущей версии
vracli version

# Монтирование диска с обновлением
mount /dev/sr0 /mnt/cdrom

# Подготовка vRA к обновлению, остановка служб, после этой операции нужно сделать снимок VM
vracli upgrade exec --prepare --profile lcm --repo cdrom://

# Запуск обновления
vracli upgrade exec

# Просмотр текущего статуса обновления
vracli upgrade status --detail

Работа с внутренней БД

Внимание! Изменение данных напрямую в БД vRA является нежелательной и очень рискованной операцией. Вы должны чётко понимать что и зачем Вы делаете. Перед внесением изменений обязательно сделайте резервную копию vRA или базы данных.

# Просмотр списка баз данных
vracli dev psql --list

# Подключение к БД PostgreSQL
vracli dev psql
\c identity-db

# Подключение с выбором БД
vracli dev psql abx-db

# Выход из PostgreSQL
\q

# Создание резервной копии БД
vracli db dump identity-db > identity-db-data.dump

# Восстановление БД из резервной копии
vracli db restore -d identity-db identity-db-data.dump

"Всё, что нажито…"