Deckhouse Platform в существующем кластере
Выберите редакцию Deckhouse Platform
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Community Edition:
config.yml
— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- обязательные для самостоятельного заполнения параметры.
- опциональные параметры.
- Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемых YAML-файлов конфигурации UTF-8 (либо удалите примечания на русском языке).
Ознакомьтесь предварительно с разделом Если что-то пошло не так, возможно там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Deckhouse Platform использует каналы обновлений (release channels), о чём вы можете подробнее узнать в документации.
# секция первичной инициализации кластера Deckhouse (InitConfiguration)
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: InitConfiguration
# секция с параметрами Deckhouse
deckhouse:
# используемый канал обновлений
releaseChannel: Stable
# при установке Deckhouse в существующий кластер используется вариант поставки — Minimal
bundle: Minimal
configOverrides:
global:
modules:
# шаблон, который будет использоваться для составления адресов системных приложений в кластере
# например, Grafana для %s.example.com будет доступна на домене grafana.example.com
publicDomainTemplate: "%s.example.com"
# при необходимости, укажите в массиве customTolerationKeys все taint'ы
# к которым Deckhouse должен иметь toleration
# далее приведен пример для случая, если нужно чтобы Deckhouse и его компоненты смогли запускаться
# на узлах, имеющих taint SystemLoad
# возможно, захотите изменить
placement:
customTolerationKeys:
- SystemLoad
certManagerEnabled: true
deckhouseWebEnabled: true
Лицензионный ключ доступа Deckhouse Platform Enterprise Edition
Лицензионный ключ используется компонентами Deckhouse для доступа к геораспределенному container registry, в котором хранятся все используемые Deckhouse образы.
Приведенные на данной странице команды и файлы конфигурации сгенерированы с учетом введенного лицензионного ключа.
Запросить лицензионный ключ
Заполните форму и мы отправим данные для доступа вам на почту.
Введите лицензионный ключ
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Enterprise Edition:
config.yml
— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- обязательные для самостоятельного заполнения параметры.
- опциональные параметры.
- Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемых YAML-файлов конфигурации UTF-8 (либо удалите примечания на русском языке).
Ознакомьтесь предварительно с разделом Если что-то пошло не так, возможно там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Deckhouse Platform использует каналы обновлений (release channels), о чём вы можете подробнее узнать в документации.
# секция первичной инициализации кластера Deckhouse (InitConfiguration)
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: InitConfiguration
# секция с параметрами Deckhouse
deckhouse:
# адрес Docker registry с образами Deckhouse
imagesRepo: registry.deckhouse.io/deckhouse/ee
# строка с ключом для доступа к Docker registry (сгенерировано автоматически для вашего токена доступа)
registryDockerCfg: <YOUR_ACCESS_STRING_IS_HERE>
# используемый канал обновлений
releaseChannel: Stable
# при установке Deckhouse в существующий кластер используется вариант поставки — Minimal
bundle: Minimal
configOverrides:
global:
modules:
# шаблон, который будет использоваться для составления адресов системных приложений в кластере
# например, Grafana для %s.example.com будет доступна на домене grafana.example.com
publicDomainTemplate: "%s.example.com"
# при необходимости, укажите в массиве customTolerationKeys все taint'ы
# к которым Deckhouse должен иметь toleration
# далее приведен пример для случая, если нужно чтобы Deckhouse и его компоненты смогли запускаться
# на узлах, имеющих taint SystemLoad
# возможно, захотите изменить
placement:
customTolerationKeys:
- SystemLoad
certManagerEnabled: true
deckhouseWebEnabled: true
Для установки Deckhouse Platform используется Docker-образ, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.io/deckhouse/ce/install:stable bash
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.io/deckhouse/ce/install:stable bash -c "chmod 400 /tmp/.ssh/id_rsa; bash"
Примечание:
- В файл
/kubeconfig
контейнера необходимо смонтировать файл конфигурации kubectl с доступом к Kubernetes API. В руководстве предполагается, что он находится в файле.kube/config
домашнего каталога пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
По окончании установки произойдёт возврат к командной строке.
Почти все готово для полноценной работы Deckhouse Platform!
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse в существующем кластере, пожалуйста, опишите ваш опыт в issue.
Для установки Deckhouse Platform используется Docker-образ, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
echo <LICENSE_TOKEN> | docker login -u license-token --password-stdin registry.deckhouse.io
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.io/deckhouse/ee/install:stable bash
Авторизуйтесь на персональном компьютере в container image registry, введя лицензионный ключ на запрос пароля:
docker login -u license-token registry.deckhouse.io
Запустите контейнер с установщиком:
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.io/deckhouse/ee/install:stable bash -c "chmod 400 /tmp/.ssh/id_rsa; bash"
Примечание:
- В файл
/kubeconfig
контейнера необходимо смонтировать файл конфигурации kubectl с доступом к Kubernetes API. В руководстве предполагается, что он находится в файле.kube/config
домашнего каталога пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
По окончании установки произойдёт возврат к командной строке.
Почти все готово для полноценной работы Deckhouse Platform!
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse в существующем кластере, пожалуйста, опишите ваш опыт в issue.