Deckhouse Platform в существующем кластере: Установка
Выберите редакцию Deckhouse Platform
- Open/Community Edition
- Basic Edition
- Standard Edition
- Standard Edition+
- Ultimate/Enterprise Edition
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Open/Community Edition:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- Так выделены параметры, обязательные для самостоятельного заполнения.
- Так выделены параметры, которые вы, возможно, захотите изменить.
-
Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемого YAML-файла конфигурации UTF-8 (либо удалите примечания на русском языке).
- Ознакомьтесь с разделом Если что-то пошло не так: возможно, там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Создайте файл config.yml.
# Параметры установки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/cr.html#initconfiguration
apiVersion: deckhouse.io/v1
kind: InitConfiguration
deckhouse:
# Адрес хранилища образов контейнеров Deckhouse.
imagesRepo: registry.deckhouse.ru/deckhouse/ce
---
# Настройки модуля deckhouse.
# https://deckhouse.ru/modules/deckhouse/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: deckhouse
spec:
version: 1
enabled: true
settings:
bundle: Minimal
# Канал обновлений Deckhouse. Канал Early Access достаточно стабилен для использования в production-окружениях.
# Если кластеров несколько, установите на них разные каналы обновлений.
# Подробнее: https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/release-channels.html
releaseChannel: EarlyAccess
logLevel: Info
---
# Глобальные настройки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/global.html#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: global
spec:
version: 2
settings:
modules:
# Шаблон, который будет использоваться для составления адресов системных приложений в кластере.
# Например, Grafana для %s.example.com будет доступна на домене 'grafana.example.com'.
# Домен НЕ ДОЛЖЕН совпадать с указанным в параметре network.clusterDomain модуля control-plane-manager.
# Можете изменить на свой сразу, либо следовать шагам руководства и сменить его после установки.
publicDomainTemplate: "%s.example.com"
# При необходимости укажите в массиве customTolerationKeys все taint'ы,
# к которым Deckhouse Platform должен иметь tolerations.
# Далее приведён пример для случая, если нужно, чтобы Deckhouse Platform и его компоненты могли запускаться
# на узлах, имеющих taint SystemLoad.
# Возможно, захотите изменить.
placement:
customTolerationKeys:
- SystemLoad
---
# Настройки модуля cert-manager.
# https://deckhouse.ru/modules/cert-manager/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: cert-manager
spec:
version: 1
enabled: true
---
# Настройки модуля documentation.
# https://deckhouse.ru/modules/documentation/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: documentation
spec:
version: 1
enabled: true
Введите лицензионный ключ
Нет ключа?
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Basic Edition:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- Так выделены параметры, обязательные для самостоятельного заполнения.
- Так выделены параметры, которые вы, возможно, захотите изменить.
-
Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемого YAML-файла конфигурации UTF-8 (либо удалите примечания на русском языке).
- Ознакомьтесь с разделом Если что-то пошло не так: возможно, там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Создайте файл config.yml.
# Параметры установки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/cr.html#initconfiguration
apiVersion: deckhouse.io/v1
kind: InitConfiguration
deckhouse:
# Адрес хранилища образов контейнеров Deckhouse.
imagesRepo: registry.deckhouse.ru/deckhouse/<REVISION>
# Строка авторизации в формате Base64 для доступа к хранилищу образов контейнеров (сгенерирована автоматически из вашего лицензионного ключа).
registryDockerCfg: <YOUR_ACCESS_STRING_IS_HERE>
---
# Настройки модуля deckhouse.
# https://deckhouse.ru/modules/deckhouse/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: deckhouse
spec:
version: 1
enabled: true
settings:
bundle: Minimal
releaseChannel: Stable
logLevel: Info
---
# Глобальные настройки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/global.html#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: global
spec:
version: 2
settings:
modules:
# Шаблон, который будет использоваться для составления адресов системных приложений в кластере.
# Например, Grafana для %s.example.com будет доступна на домене 'grafana.example.com'.
# Домен НЕ ДОЛЖЕН совпадать с указанным в параметре network.clusterDomain модуля control-plane-manager.
# Можете изменить на свой сразу, либо следовать шагам руководства и сменить его после установки.
publicDomainTemplate: "%s.example.com"
# При необходимости укажите в массиве customTolerationKeys все taint'ы,
# к которым Deckhouse Platform должен иметь tolerations.
# Далее приведён пример для случая, если нужно, чтобы Deckhouse Platform и его компоненты могли запускаться
# на узлах, имеющих taint SystemLoad.
# Возможно, захотите изменить.
placement:
customTolerationKeys:
- SystemLoad
---
# Настройки модуля cert-manager.
# https://deckhouse.ru/modules/cert-manager/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: cert-manager
spec:
version: 1
enabled: true
---
# Настройки модуля documentation.
# https://deckhouse.ru/modules/documentation/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: documentation
spec:
version: 1
enabled: true
Введите лицензионный ключ
Нет ключа?
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Standard Edition:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- Так выделены параметры, обязательные для самостоятельного заполнения.
- Так выделены параметры, которые вы, возможно, захотите изменить.
-
Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемого YAML-файла конфигурации UTF-8 (либо удалите примечания на русском языке).
- Ознакомьтесь с разделом Если что-то пошло не так: возможно, там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Создайте файл config.yml.
# Параметры установки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/cr.html#initconfiguration
apiVersion: deckhouse.io/v1
kind: InitConfiguration
deckhouse:
# Адрес хранилища образов контейнеров Deckhouse.
imagesRepo: registry.deckhouse.ru/deckhouse/<REVISION>
# Строка авторизации в формате Base64 для доступа к хранилищу образов контейнеров (сгенерирована автоматически из вашего лицензионного ключа).
registryDockerCfg: <YOUR_ACCESS_STRING_IS_HERE>
---
# Настройки модуля deckhouse.
# https://deckhouse.ru/modules/deckhouse/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: deckhouse
spec:
version: 1
enabled: true
settings:
bundle: Minimal
releaseChannel: Stable
logLevel: Info
---
# Глобальные настройки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/global.html#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: global
spec:
version: 2
settings:
modules:
# Шаблон, который будет использоваться для составления адресов системных приложений в кластере.
# Например, Grafana для %s.example.com будет доступна на домене 'grafana.example.com'.
# Домен НЕ ДОЛЖЕН совпадать с указанным в параметре network.clusterDomain модуля control-plane-manager.
# Можете изменить на свой сразу, либо следовать шагам руководства и сменить его после установки.
publicDomainTemplate: "%s.example.com"
# При необходимости укажите в массиве customTolerationKeys все taint'ы,
# к которым Deckhouse Platform должен иметь tolerations.
# Далее приведён пример для случая, если нужно, чтобы Deckhouse Platform и его компоненты могли запускаться
# на узлах, имеющих taint SystemLoad.
# Возможно, захотите изменить.
placement:
customTolerationKeys:
- SystemLoad
---
# Настройки модуля cert-manager.
# https://deckhouse.ru/modules/cert-manager/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: cert-manager
spec:
version: 1
enabled: true
---
# Настройки модуля documentation.
# https://deckhouse.ru/modules/documentation/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: documentation
spec:
version: 1
enabled: true
Введите лицензионный ключ
Нет ключа?
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Standard Edition+:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- Так выделены параметры, обязательные для самостоятельного заполнения.
- Так выделены параметры, которые вы, возможно, захотите изменить.
-
Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемого YAML-файла конфигурации UTF-8 (либо удалите примечания на русском языке).
- Ознакомьтесь с разделом Если что-то пошло не так: возможно, там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Создайте файл config.yml.
# Параметры установки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/cr.html#initconfiguration
apiVersion: deckhouse.io/v1
kind: InitConfiguration
deckhouse:
# Адрес хранилища образов контейнеров Deckhouse.
imagesRepo: registry.deckhouse.ru/deckhouse/<REVISION>
# Строка авторизации в формате Base64 для доступа к хранилищу образов контейнеров (сгенерирована автоматически из вашего лицензионного ключа).
registryDockerCfg: <YOUR_ACCESS_STRING_IS_HERE>
---
# Настройки модуля deckhouse.
# https://deckhouse.ru/modules/deckhouse/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: deckhouse
spec:
version: 1
enabled: true
settings:
bundle: Minimal
releaseChannel: Stable
logLevel: Info
---
# Глобальные настройки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/global.html#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: global
spec:
version: 2
settings:
modules:
# Шаблон, который будет использоваться для составления адресов системных приложений в кластере.
# Например, Grafana для %s.example.com будет доступна на домене 'grafana.example.com'.
# Домен НЕ ДОЛЖЕН совпадать с указанным в параметре network.clusterDomain модуля control-plane-manager.
# Можете изменить на свой сразу, либо следовать шагам руководства и сменить его после установки.
publicDomainTemplate: "%s.example.com"
# При необходимости укажите в массиве customTolerationKeys все taint'ы,
# к которым Deckhouse Platform должен иметь tolerations.
# Далее приведён пример для случая, если нужно, чтобы Deckhouse Platform и его компоненты могли запускаться
# на узлах, имеющих taint SystemLoad.
# Возможно, захотите изменить.
placement:
customTolerationKeys:
- SystemLoad
---
# Настройки модуля cert-manager.
# https://deckhouse.ru/modules/cert-manager/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: cert-manager
spec:
version: 1
enabled: true
---
# Настройки модуля documentation.
# https://deckhouse.ru/modules/documentation/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: documentation
spec:
version: 1
enabled: true
Введите лицензионный ключ
Нет ключа?
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Ultimate/Enterprise Edition:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора и начальные параметры кластера.
Обратите внимание:
- Так выделены параметры, обязательные для самостоятельного заполнения.
- Так выделены параметры, которые вы, возможно, захотите изменить.
-
Если вы запускаете инсталлятор под Windows, то убедитесь, что кодировка создаваемого YAML-файла конфигурации UTF-8 (либо удалите примечания на русском языке).
- Ознакомьтесь с разделом Если что-то пошло не так: возможно, там описан случай для вашего провайдера. Обращайтесь к нему, если испытываете какие-то проблемы в процессе установки.
Создайте файл config.yml.
# Параметры установки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/cr.html#initconfiguration
apiVersion: deckhouse.io/v1
kind: InitConfiguration
deckhouse:
# Адрес хранилища образов контейнеров Deckhouse.
imagesRepo: registry.deckhouse.ru/deckhouse/<REVISION>
# Строка авторизации в формате Base64 для доступа к хранилищу образов контейнеров (сгенерирована автоматически из вашего лицензионного ключа).
registryDockerCfg: <YOUR_ACCESS_STRING_IS_HERE>
---
# Настройки модуля deckhouse.
# https://deckhouse.ru/modules/deckhouse/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: deckhouse
spec:
version: 1
enabled: true
settings:
bundle: Minimal
releaseChannel: Stable
logLevel: Info
---
# Глобальные настройки Deckhouse.
# https://deckhouse.ru/products/kubernetes-platform/documentation/v1/reference/api/global.html#%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D1%8B
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: global
spec:
version: 2
settings:
modules:
# Шаблон, который будет использоваться для составления адресов системных приложений в кластере.
# Например, Grafana для %s.example.com будет доступна на домене 'grafana.example.com'.
# Домен НЕ ДОЛЖЕН совпадать с указанным в параметре network.clusterDomain модуля control-plane-manager.
# Можете изменить на свой сразу, либо следовать шагам руководства и сменить его после установки.
publicDomainTemplate: "%s.example.com"
# При необходимости укажите в массиве customTolerationKeys все taint'ы,
# к которым Deckhouse Platform должен иметь tolerations.
# Далее приведён пример для случая, если нужно, чтобы Deckhouse Platform и его компоненты могли запускаться
# на узлах, имеющих taint SystemLoad.
# Возможно, захотите изменить.
placement:
customTolerationKeys:
- SystemLoad
---
# Настройки модуля cert-manager.
# https://deckhouse.ru/modules/cert-manager/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: cert-manager
spec:
version: 1
enabled: true
---
# Настройки модуля documentation.
# https://deckhouse.ru/modules/documentation/configuration.html
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
name: documentation
spec:
version: 1
enabled: true
Для установки Deckhouse Platform используется образ контейнера, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
- Linux / macOS
- Windows
Если при включённом VPN контейнер с установщиком не может получить доступ к сети, воспользуйтесь инструкцией в FAQ.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.ru/deckhouse/ce/install:early-access bash
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.ru/deckhouse/ce/install:early-access bash -c "chmod 400 /tmp/.ssh/<SSH_PRIVATE_KEY_FILE>; bash"
Примечание:
- В файл
/kubeconfigконтейнера необходимо смонтировать файл конфигурации kubectl с доступом к API Kubernetes. В руководстве предполагается, что это файл.kube/configв домашней директории пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
Процесс установки может занять от 5 до 30 минут, в зависимости от качества соединения.
По окончании установки инсталлятор выведет IP-адрес master-узла (он вам потребуется далее). Пример вывода:
...
┌ 🎈 ~ Common: Kubernetes Master Node addresses for SSH
│ cloud-demo-master-0 | ssh ubuntu@1.2.3.4
└ 🎈 ~ Common: Kubernetes Master Node addresses for SSH (0.00 seconds)
Почти всё готово для полноценной работы Deckhouse Platform.
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse Platform.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse Platform в существующем кластере, опишите их в issue на GitHub.
Для установки Deckhouse Platform используется образ контейнера, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
- Linux / macOS
- Windows
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров:
echo <LICENSE_TOKEN> | docker login -u license-token --password-stdin registry.deckhouse.ru
Запустите контейнер с установщиком:
Если при включённом VPN контейнер с установщиком не может получить доступ к сети, воспользуйтесь инструкцией в FAQ.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.ru/deckhouse/be/install:stable bash
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров, введя лицензионный ключ на запрос пароля:
docker login -u license-token registry.deckhouse.ru
Запустите контейнер с установщиком:
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.ru/deckhouse/be/install:stable bash -c "chmod 400 /tmp/.ssh/<SSH_PRIVATE_KEY_FILE>; bash"
Примечание:
- В файл
/kubeconfigконтейнера необходимо смонтировать файл конфигурации kubectl с доступом к API Kubernetes. В руководстве предполагается, что это файл.kube/configв домашней директории пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
Процесс установки может занять от 5 до 30 минут, в зависимости от качества соединения.
По окончании установки инсталлятор выведет IP-адрес master-узла (он вам потребуется далее). Пример вывода:
...
┌ 🎈 ~ Common: Kubernetes Master Node addresses for SSH
│ cloud-demo-master-0 | ssh ubuntu@1.2.3.4
└ 🎈 ~ Common: Kubernetes Master Node addresses for SSH (0.00 seconds)
Почти всё готово для полноценной работы Deckhouse Platform.
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse Platform.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse Platform в существующем кластере, опишите их в issue на GitHub.
Для установки Deckhouse Platform используется образ контейнера, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
- Linux / macOS
- Windows
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров:
echo <LICENSE_TOKEN> | docker login -u license-token --password-stdin registry.deckhouse.ru
Запустите контейнер с установщиком:
Если при включённом VPN контейнер с установщиком не может получить доступ к сети, воспользуйтесь инструкцией в FAQ.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.ru/deckhouse/se/install:stable bash
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров, введя лицензионный ключ на запрос пароля:
docker login -u license-token registry.deckhouse.ru
Запустите контейнер с установщиком:
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.ru/deckhouse/se/install:stable bash -c "chmod 400 /tmp/.ssh/<SSH_PRIVATE_KEY_FILE>; bash"
Примечание:
- В файл
/kubeconfigконтейнера необходимо смонтировать файл конфигурации kubectl с доступом к API Kubernetes. В руководстве предполагается, что это файл.kube/configв домашней директории пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
Процесс установки может занять от 5 до 30 минут, в зависимости от качества соединения.
По окончании установки инсталлятор выведет IP-адрес master-узла (он вам потребуется далее). Пример вывода:
...
┌ 🎈 ~ Common: Kubernetes Master Node addresses for SSH
│ cloud-demo-master-0 | ssh ubuntu@1.2.3.4
└ 🎈 ~ Common: Kubernetes Master Node addresses for SSH (0.00 seconds)
Почти всё готово для полноценной работы Deckhouse Platform.
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse Platform.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse Platform в существующем кластере, опишите их в issue на GitHub.
Для установки Deckhouse Platform используется образ контейнера, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
- Linux / macOS
- Windows
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров:
echo <LICENSE_TOKEN> | docker login -u license-token --password-stdin registry.deckhouse.ru
Запустите контейнер с установщиком:
Если при включённом VPN контейнер с установщиком не может получить доступ к сети, воспользуйтесь инструкцией в FAQ.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.ru/deckhouse/se-plus/install:stable bash
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров, введя лицензионный ключ на запрос пароля:
docker login -u license-token registry.deckhouse.ru
Запустите контейнер с установщиком:
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.ru/deckhouse/se-plus/install:stable bash -c "chmod 400 /tmp/.ssh/<SSH_PRIVATE_KEY_FILE>; bash"
Примечание:
- В файл
/kubeconfigконтейнера необходимо смонтировать файл конфигурации kubectl с доступом к API Kubernetes. В руководстве предполагается, что это файл.kube/configв домашней директории пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
Процесс установки может занять от 5 до 30 минут, в зависимости от качества соединения.
По окончании установки инсталлятор выведет IP-адрес master-узла (он вам потребуется далее). Пример вывода:
...
┌ 🎈 ~ Common: Kubernetes Master Node addresses for SSH
│ cloud-demo-master-0 | ssh ubuntu@1.2.3.4
└ 🎈 ~ Common: Kubernetes Master Node addresses for SSH (0.00 seconds)
Почти всё готово для полноценной работы Deckhouse Platform.
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse Platform.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse Platform в существующем кластере, опишите их в issue на GitHub.
Для установки Deckhouse Platform используется образ контейнера, в который необходимо передать конфигурационные файлы.
Запустите установщик на персональном компьютере.
- Linux / macOS
- Windows
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров:
echo <LICENSE_TOKEN> | docker login -u license-token --password-stdin registry.deckhouse.ru
Запустите контейнер с установщиком:
Если при включённом VPN контейнер с установщиком не может получить доступ к сети, воспользуйтесь инструкцией в FAQ.
docker run --pull=always -it -v "$PWD/config.yml:/config.yml" \
-v "$HOME/.kube/config:/kubeconfig" registry.deckhouse.ru/deckhouse/ee/install:stable bash
Авторизуйтесь на персональном компьютере в хранилище образов контейнеров, введя лицензионный ключ на запрос пароля:
docker login -u license-token registry.deckhouse.ru
Запустите контейнер с установщиком:
docker run --pull=always -it -v "%cd%\config.yml:/config.yml" -v "%userprofile%\.kube\config:/kubeconfig" registry.deckhouse.ru/deckhouse/ee/install:stable bash -c "chmod 400 /tmp/.ssh/<SSH_PRIVATE_KEY_FILE>; bash"
Примечание:
- В файл
/kubeconfigконтейнера необходимо смонтировать файл конфигурации kubectl с доступом к API Kubernetes. В руководстве предполагается, что это файл.kube/configв домашней директории пользователя.
Внутри контейнера выполните команду:
dhctl bootstrap-phase install-deckhouse --kubeconfig=/kubeconfig --config=/config.yml
Процесс установки может занять от 5 до 30 минут, в зависимости от качества соединения.
По окончании установки инсталлятор выведет IP-адрес master-узла (он вам потребуется далее). Пример вывода:
...
┌ 🎈 ~ Common: Kubernetes Master Node addresses for SSH
│ cloud-demo-master-0 | ssh ubuntu@1.2.3.4
└ 🎈 ~ Common: Kubernetes Master Node addresses for SSH (0.00 seconds)
Почти всё готово для полноценной работы Deckhouse Platform.
Если что-то пошло не так
Кластеры некоторых провайдеров могут требовать дополнительных действий до или после установки Deckhouse Platform.
Ниже приведены частые проблемы и способы их решения. Если вы столкнулись с другими особенностями установки Deckhouse Platform в существующем кластере, опишите их в issue на GitHub.