Деинсталляция платформы
Инсталляция платформы включает создание временного и постоянного кластера управления. Чтобы инсталлировать новую платформу, заранее потребуется удалить временный кластер, выполнив действия по инструкции.
Начиная с релиза 2.12 вы можете деинсталлировать (удалить) при необходимости развернутую платформу “Штурвал” с помощью утилиты shtil. Для этого:
- Если у вас не установлена утилита shtil, то:
- Скачайте бинарный файл по ссылке https://public.shturval.tech/shtil-2.12.1
- Сделайте его исполняемым с помощью команды:
chmod +x ./shtil-2.12.1
- Для удаления платформы запустите команду
./shtil-2.12.1 delete management, в которую необходимо подставить свои значения параметров.
Все доступные параметры при удалении платформы с shtil-2.12.0
| Наименование параметра | Обязательность | Описание |
|---|---|---|
--bootstrap-kubeconfig [string] |
Нет | Путь до kubeconfig временного кластера управления. Требуется указать, если kubeconfig временного кластера расположен не по дефолтному пути ($HOME/.kube/shturval-installer) |
--help, -h |
Нет | Вызов справки для команды удаления кластера |
--kubeconfig [string] |
Да | Путь до kubeconfig постоянного кластера управления (платформа) |
--license [string] |
Нет | Лицензия к платформе “Штурвал”. Если лицензия содержит специальные символы ($,<, >, *, &, ?, /,\ ), она должна быть указана в одинарных кавычках. Необходимо указать, если нет временного кластера платформы и требуется поднять временный кластер |
--registry [string] |
Нет | Адрес Registry, по умолчанию r.shturval.tech |
--retry [int] |
Нет | Количество повторных попыток при неудачных операциях (по умолчанию: 10) |
--verbosity, -v [int32] |
Нет | Уровень детализации логов (по умолчанию: 0) |
--insecure |
Нет | Пропускает проверку безопасности при подключении к registry (по умолчанию false) |
Обратите внимание!
- Удаление доступно только со статическим kubeconfig постоянного кластера управления, выданном для скачивания по завершении инсталляции. В графическом интерфейсе вы можете найти его в неймспейсе кластера управления, в secret с именем
clustername-kubeconfig. - Удаление постоянного кластера управления происходит только с временным кластером (bootstrap). Поэтому, если временный кластер был удален или недоступен, в команде
./shtil-2.12.1 delete managementукажите лицензию (параметр--license) для поднятия временного кластера в открытом окружении или лицензию и Registry (параметры--license,--registry) в закрытом окружении. - Docker контейнер с временным кластером на локальной машине, с которой запускается удаление, должен работать корректно и не быть приостановленным. Одновременно не может быть поднято два Docker контейнера.
- В процессе удаления кластера управления shtil запросит подтверждение удаления, потребуется ввести имя кластера управления.
- Удалить платформу невозможно, если в платформе развернуты и работают клиентские кластеры.
Примеры деинсталляции (удаления) кластера управления
Пример команды удаления кластера в открытом окружении, временный кластер существует и kubeconfig расположен по дефолтному пути
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА
Пример команды удаления кластера в открытом окружении с увеличенной детализацией логов для отладки, временный кластер существует и kubeconfig расположен по дефолтному пути
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА --verbosity=3 --retry=50
Пример команды удаления кластера в открытом окружении, временный кластер существует, kubeconfig расположен не по дефолтному пути
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА --bootstrap-kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ВРЕМЕННОГО-КЛАСТЕРА
Пример команды удаления кластера в открытом окружении, нет временного кластера
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА --license="ВВЕДИТЕ-ВАШУ-ЛИЦЕНЗИЮ"
По умолчанию временный кластер будет
Пример команды удаления кластера в закрытом окружении, временный кластер существует, kubeconfig расположен не по дефолтному пути
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА --bootstrap-kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ВРЕМЕННОГО-КЛАСТЕРА --registry=ВВЕДИТЕ-АДРЕС-ВАШЕГО-REGISTRY
Обратите внимание! Если registry с самоподписным сертификатом, пропишите registry в конфигурационном файле с реестрами образов контейнеров и пропустите проверку безопасности при подключении к registry (--insecure=true). Для Podman по умолчанию конфигурационный файл расположен по пути - /etc/containers/registries.conf, для Docker - /etc/docker/daemon.json.
Пример команды удаления для закрытого контура без проверки безопасности TLS соединения
./shtil-2.12.1 delete management --kubeconfig=ВВЕДИТЕ-ПУТЬ-ДО-KUBECONFIG-ПОСТОЯННОГО-КЛАСТЕРА --registry=ВВЕДИТЕ-АДРЕС-ВАШЕГО-REGISTRY --insecure=true
Пример registries.conf
# Copied from https://raw.githubusercontent.com/projectatomic/registries/master/registries.fedora
# This is a system-wide configuration file used to
# keep track of registries for various container backends.
# It adheres to TOML format and does not support recursive
# lists of registries.
# The default location for this configuration file is /etc/containers/registries.conf.
# The only valid categories are: 'registries.search', 'registries.insecure',
# and 'registries.block'.
[registries.search]
registries = ['docker.io', 'registry.fedoraproject.org', 'registry.access.redhat.com']
# If you need to access insecure registries, add the registry's fully-qualified name.
# An insecure registry is one that does not have a valid SSL certificate or only does HTTP.
[registries.insecure]
registries = ['АДРЕС-ВАШЕГО-REGISTRY']
# If you need to block pull access from a registry, uncomment the section below
# and add the registries fully-qualified name.
#
# Docker only
[registries.block]
registries = []
Пример daemon.json
{
"insecure-registries" : ["АДРЕС-ВАШЕГО-REGISTRY"]
}