# Администрирование системы

Команды администрирования кластера выполняются в консоли специального пода `nsctl`.

Для упрощения операций администрирования можно использовать использовать `invoker`, который позволяет выполнять команды на подах.

```{attention}
invoker.sh производит удаленное выполнение команд, которые не имеют диалога с пользователем. 
```

## Запуск и остановка комплекта приложений

Команды запуска и остановки комплекта приложений останавливают сервера приложений в подах

### Остановка комплекта

Остановить комплект приложений

```bash
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh stop_appkit --name rg-debug"
```

, где

- gs-cls-debug - неймспейс кластера в кубернетес
- rg-debug - группа ресурсов

### Запуск комплекта

```bash
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh start_appkit --name rg-debug"
```

, где

- gs-cls-debug - неймспейс кластера в кубернетес
- rg-debug - группа ресурсов

## Обновление комплекта группы

На Jump хосте подготовить элементы комплекта группы:

- ~/nscli/workspace/groupkit/v1/java/jre/lib/security/cacerts
- ~/nscli/workspace/groupkit/v1/libs

Передать `groupkit` в nfs хранилище

```bash
./groupkit.sh push --namespace gs-cls-debug --source workspace/groupkit/v1 --destination groupkits/v1
```

, где

- gs-cls-debug - неймспейс кластера в кубернетес
- workspace/groupkit/v1 - путь расположения версии `groupkit` на jump хосте
- groupkits/v1 - путь хранения на nfs сервере

Обновление `groupkit`

```bash
# запретить группу ресурсов
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh disable --name rg-debug"
# переключить groupkit
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh switch_groupkit --name rg-debug --path groupkits/v1"
# разрешить группу ресурсов
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh enable --name rg-debug"
# запустить комплект приложений
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh start_appkit --name rg-debug"
```

, где

- gs-cls-debug - неймспейс кластера в кубернетес
- rg-debug - группа ресурсов
- groupkits/v1 - путь хранения на nfs сервере

## Обновление комплекта приложений

На Jump хосте подготовить элементы комплекта приложений:

- ~/nscli/workspace/appkit/gs-cls-debug/v1/applib.zip
- ~/nscli/workspace/appkit/gs-cls-debug/v1/globalserver.zip
- ~/nscli/workspace/appkit/gs-cls-debug/v1/profile/globalscheduler/template/config/quartz.properties
- ~/nscli/workspace/appkit/gs-cls-debug/v1/profile/globalserver/template/config/global3.config.xml

Передать `appkit` в nfs хранилище

```bash
./appkit.sh push --namespace gs-cls-debug --source workspace/appkit/gs-cls-debug/v1 --destination appkits/v1
```

, где

- gs-cls-debug - неймспейс кластера в кубернетес
- workspace/appkit/gs-cls-debug/v1 - путь расположения версии `appkit` на jump хосте
- appkits/v1 - путь хранения на nfs сервере

Обновление `appkit`

```bash
# запуск обновления appkit и нагона релиза
./appkit.sh switch_and_upgrade --namespace gs-cls-debug --resgroup rg-debug  --remote_appkit appkits/v1
# старт кластера
./invoker.sh run --namespace gs-cls-debug --app nsctl --cmd "./resgroup.sh start_appkit --name rg-debug"
```

## Логи кластера

Логи собираются со всех подов и сохраняются в grafana Loki

Доступ к grafana: <http://0.0.0.0:3000/>

, где 0.0.0.0 - адрес публикации grafana

В grafana развернут дашбоард с логами: Dashboards > Logs

![loki](img/grafana-loki.png)