# Обновление

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

Для обновления [комплекта приложения](./020_install.md#подготовка-комплекта-приложений-appkit) (appkit: сервера приложений, прикладного решения) подготовьте его и загрузите на NFS-хранилище (далее `nscli $` означает, что код выполняется на jump-хосте в папке утилиты nscli, `nsctl $` - следовательно, на служебном поде nsctl):

```bash
nscli $ ./appkit.sh push --namespace gs-cluster-k8s --source workspace/appkit/v2 --destination appkits/v2
```

Где `workspace/appkit/v2` - путь к папке нового appkit на jump-хосте, а `appkits/v2` - путь к папке NFS-хранилища, в которую следует загрузить appkit.

Запустите процесс обновления командой:

```bash
nscli $ ./appkit.sh switch_und_upgrade --namespace gs-cluster-k8s --resgroup gs-cluster-1 --remote_appkit appkits/v2
```

Помимо `switch_and_upgrade` есть также команда `switch`. Первая, помимо собственно переключения appkit, также обновляет базу данных. Подробнее о необходимости обновлять БД узнавайте у контактного лица.

После обновления комплекта приложения, ваша группа ресурсов останется в опустошенном состоянии ([сервисном режиме](https://docs.global-system.ru/as/dev/spec/server/server_modes.html#id4)), когда войти могут только администраторы. Чтобы перейти в нормальный режим, воспользуйтесь командой:

```bash
nsctl $ ./resgroup.sh start_appkit --name gs-cluster-1
```

## Обновление кластерных утилит

С версии nscli 4.0.0 доступна команда:

```bash
./namespace.sh upgrade_namespace
```

Она позволяет обновить образа gs-ctk без пересоздания пространства имен. Для использования:

1. [Загрузите и установите](./020_install.md#установка-утилиты-nscli) на jump-хост новую версию nscli.

2. Запустите:

   ```bash
   ./namespace.sh create_namespace
   ```

   Вам будет представлен диалог для введения настроек пространства имен (реестр Docker, NFS). Проверьте, что данные верны.

   ```{warning}
   __Не__ запускайте `./namespace.sh install_namespace`
   ```

3. Если вы используете версию gs-ctk 1.0, то [экспортируйте конфигурацию](./050_restore.md#экспорт). Если на кластере развернута gs-ctk 2.0 и выше, резервная копия будет сделана автоматически.

4. Запустите:

   ```bash
   ./namespace.sh upgrade_namespace
   ```

   После выполнения команды, кластерные утилиты будут обновлены до версии nscli.

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