Deckhouse Platform на VMware vSphere
Лицензионный ключ доступа Deckhouse Platform Enterprise Edition
Лицензионный ключ используется компонентами Deckhouse для доступа к геораспределенному container registry, в котором хранятся все используемые Deckhouse образы.
Приведенные на данной странице команды и файлы конфигурации сгенерированы с учетом введенного лицензионного ключа.
Запросить лицензионный ключ
Заполните форму и мы отправим данные для доступа вам на почту.
Введите лицензионный ключ
Ниже сгенерированы рекомендованные настройки для установки Deckhouse Platform Enterprise Edition:
config.yml— файл первичной конфигурации кластера. Содержит параметры инсталлятора, параметры доступа облачного проавайдера и начальные параметры кластера.resources.yml— описание ресурсов для создания после установки (настройки узлов и Ingress-контроллера).
Обратите внимание:
- обязательные для самостоятельного заполнения параметры.
- опциональные параметры.
Полное описание параметров конфигурации cloud-провайдеров вы можете найти в документации.
Deckhouse Platform использует каналы обновлений (release channels), о чём вы можете подробнее узнать в документации.
# секция с общими параметрами кластера (ClusterConfiguration)
# используемая версия API Deckhouse Platform
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: ClusterConfiguration
# тип инфраструктуры: bare metal (Static) или облако (Cloud)
clusterType: Cloud
# параметры облачного провайдера
cloud:
# используемый облачный провайдер
provider: vSphere
# префикс для объектов кластера для их отличия (используется, например, при маршрутизации)
prefix: "cloud-demo"
# адресное пространство pod’ов кластера
podSubnetCIDR: 10.111.0.0/16
# адресное пространство для service’ов кластера
serviceSubnetCIDR: 10.222.0.0/16
# устанавливаемая версия Kubernetes
kubernetesVersion: "1.21"
# домен кластера
clusterDomain: "cluster.local"
---
# секция первичной инициализации кластера 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
configOverrides:
global:
modules:
# шаблон, который будет использоваться для составления адресов системных приложений в кластере
# например, Grafana для %s.example.com будет доступна на домене grafana.example.com
publicDomainTemplate: "%s.example.com"
---
# секция, описывающая параметры облачного провайдера
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: VsphereClusterConfiguration
# layout — архитектура расположения ресурсов в облаке
layout: Standard
# параметры доступа к vCenter
provider:
server: *!CHANGE_SERVER*
username: *!CHANGE_USERNAME*
password: *!CHANGE_PASSWORD*
insecure: *!CHANGE_INSECURE*
# путь до Folder, в котором будут создаваться виртуальные машины
# сам Folder будет создан Deckhouse Installer'ом
vmFolderPath: *!CHANGE_FOLDER*
# имена категорий тэгов регионов и зон
regionTagCategory: k8s-region
zoneTagCategory: k8s-zone
# имена тэгов зон и регионов, в которых будет работать кластер
region: *!CHANGE_REGION_TAG_NAME*
zones:
- *!CHANGE_ZONE_TAG_NAME*
# публичная часть SSH-ключа для доступа к узлам облака
sshPublicKey: ssh-rsa <SSH_PUBLIC_KEY>
# имя External Network, у которой есть доступ в Интернет
# в ней должен быть DHCP сервер
externalNetworkNames:
- *!CHANGE_NETWORK_NAME*
# имя Internal Network, которая будет использоваться для трафика между нодами, в данном примере идентично externalNetworkNames
internalNetworkNames:
- *!CHANGE_NETWORK_NAME*
# адресное пространство узлов кластера
internalNetworkCIDR: 10.90.0.0/24
masterNodeGroup:
# количество реплик мастера
# если будет больше одного master-узла, то control-plane на всех master-узлах будет развернут автоматическии
replicas: 1
# параметры инстанса
instanceClass:
numCPUs: 4
memory: 8192
rootDiskSize: 50
# имя образа, созданного в шаге "Сборка образа виртуальных машин"
template: *!CHANGE_TEMPLATE_NAME*
datastore: *!CHANGE_DATASTORE_NAME*
# идентично externalNetworkNames
mainNetwork: *!CHANGE_NETWORK_NAME*
# идентично internalNetworkNames
additionalNetworks:
- *!CHANGE_NETWORK_NAME*
# секция с общими параметрами кластера (ClusterConfiguration)
# используемая версия API Deckhouse Platform
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: ClusterConfiguration
# тип инфраструктуры: bare metal (Static) или облако (Cloud)
clusterType: Cloud
# параметры облачного провайдера
cloud:
# используемый облачный провайдер
provider: vSphere
# префикс для объектов кластера для их отличия (используется, например, при маршрутизации)
prefix: "cloud-demo"
# адресное пространство pod’ов кластера
podSubnetCIDR: 10.111.0.0/16
# адресное пространство для service’ов кластера
serviceSubnetCIDR: 10.222.0.0/16
# устанавливаемая версия Kubernetes
kubernetesVersion: "1.21"
# домен кластера
clusterDomain: "cluster.local"
---
# секция первичной инициализации кластера 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
configOverrides:
global:
modules:
# шаблон, который будет использоваться для составления адресов системных приложений в кластере
# например, Grafana для %s.example.com будет доступна на домене grafana.example.com
publicDomainTemplate: "%s.example.com"
---
# секция, описывающая параметры облачного провайдера
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
# тип секции конфигурации
kind: VsphereClusterConfiguration
# layout — архитектура расположения ресурсов в облаке
layout: Standard
# параметры доступа к vCenter
provider:
server: *!CHANGE_SERVER*
username: *!CHANGE_USERNAME*
password: *!CHANGE_PASSWORD*
insecure: *!CHANGE_INSECURE*
# путь до Folder, в котором будут создаваться виртуальные машины
# сам Folder будет создан Deckhouse Installer'ом
vmFolderPath: *!CHANGE_FOLDER*
# имена категорий тэгов регионов и зон
regionTagCategory: k8s-region
zoneTagCategory: k8s-zone
# имена тэгов зон и регионов, в которых будет работать кластер
region: *!CHANGE_REGION_TAG_NAME*
zones:
- *!CHANGE_ZONE_TAG_NAME*
# публичная часть SSH-ключа для доступа к узлам облака
sshPublicKey: ssh-rsa <SSH_PUBLIC_KEY>
# имя External Network, у которой есть доступ в Интернет
# в ней должен быть DHCP сервер
externalNetworkNames:
- *!CHANGE_NETWORK_NAME*
# имя Internal Network, которая будет использоваться для трафика между нодами, в данном примере идентично externalNetworkNames
internalNetworkNames:
- *!CHANGE_NETWORK_NAME*
# адресное пространство узлов кластера
internalNetworkCIDR: 10.90.0.0/24
masterNodeGroup:
# количество реплик мастера
# если будет больше одного master-узла, то control-plane на всех master-узлах будет развернут автоматическии
replicas: 1
# параметры инстанса
instanceClass:
numCPUs: 4
memory: 8192
rootDiskSize: 50
# имя образа, созданного в шаге "Сборка образа виртуальных машин"
template: *!CHANGE_TEMPLATE_NAME*
datastore: *!CHANGE_DATASTORE_NAME*
# идентично externalNetworkNames
mainNetwork: *!CHANGE_NETWORK_NAME*
# идентично internalNetworkNames
additionalNetworks:
- *!CHANGE_NETWORK_NAME*
Описание ресурсов для набора узлов “Минимальный”.
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 1
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/master: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 1
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/master: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
Описание ресурсов для набора узлов “Мультимастер”.
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 2
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: frontend
spec:
numCPUs: 4
memory: 8192
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 50
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: frontend
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: frontend
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 2
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/frontend: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: frontend
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/frontend: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 2
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: frontend
spec:
numCPUs: 4
memory: 8192
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 50
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: frontend
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: frontend
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 2
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/frontend: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: frontend
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/frontend: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
Описание ресурсов для набора узлов “Рекомендовано для production”.
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 1
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: system
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 100
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: system
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: system
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/system: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: system
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: frontend
spec:
numCPUs: 4
memory: 8192
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 50
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: frontend
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: frontend
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 3
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/frontend: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: frontend
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/frontend: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: worker
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 70
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: worker
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: worker
# максимальное количество инстансов в зоне
maxPerZone: 1
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: system
spec:
numCPUs: 8
memory: 16384
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 100
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: system
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: system
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 1
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/system: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: system
nodeType: CloudEphemeral
---
# секция, описывающая параметры инстанс-класса для рабочего узла
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: VsphereInstanceClass
metadata:
# имя инстанс класса
name: frontend
spec:
numCPUs: 4
memory: 8192
# размер диска для виртуальной машины
# возможно, захотите изменить
rootDiskSize: 50
template: *!CHANGE_TEMPLATE_NAME*
---
# секция, описывающая параметры группы узлов worker
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: NodeGroup
metadata:
# имя группы узлов
name: frontend
spec:
# параметры заказа облачных виртуальных машин
cloudInstances:
# ссылка на объект InstanceClass
classReference:
kind: VsphereInstanceClass
name: frontend
# максимальное количество инстансов в зоне
maxPerZone: 2
# минимальное количество инстансов в зоне
minPerZone: 3
# переопределение перечня зон, в которых создаются инстансы
# возможно, захотите изменить
zones:
- *!CHANGE_ZONE_TAG_NAME*
- *!CHANGE_ANOTHER_ZONE_TAG_NAME*
nodeTemplate:
# аналогично стандартному полю metadata.labels
labels:
node-role.deckhouse.io/frontend: ""
# аналогично полю .spec.taints из объекта Node
# доступны только поля effect, key, value
taints:
- effect: NoExecute
key: dedicated.deckhouse.io
value: frontend
nodeType: CloudEphemeral
---
# секция, описывающая параметры nginx ingress controller
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: IngressNginxController
metadata:
name: nginx
spec:
# имя Ingress-класса для использования Ingress Nginx controller
ingressClass: nginx
# способ поступления трафика из внешнего мира
inlet: HostPort
hostPort:
httpPort: 80
httpsPort: 443
realIPHeader: X-Forwarded-For
nodeSelector:
node-role.kubernetes.io/frontend: ""
tolerations:
- operator: Exists
---
apiVersion: deckhouse.io/v1
kind: ClusterAuthorizationRule
metadata:
name: admin
spec:
# список учётных записей Kubernetes RBAC
subjects:
- kind: User
name: admin@example.com
# предустановленный шаблон уровня доступа
accessLevel: SuperAdmin
# разрешить пользователю делать kubectl port-forward
portForwarding: true
---
# секция, описывающая параметры статического пользователя
# используемая версия API Deckhouse
apiVersion: deckhouse.io/v1
kind: User
metadata:
name: admin
spec:
# e-mail пользователя
email: admin@example.com
# это хэш сгенерированного пароля: <GENERATED_PASSWORD>
# echo "<GENERATED_PASSWORD>" | htpasswd -BinC 10 "" | cut -d: -f2
# возможно, захотите изменить
password: <GENERATED_PASSWORD_HASH>
Для установки Deckhouse Platform используется Docker-образ, в который необходимо передать конфигурационные файлы и SSH-ключи доступа на master-узлы. Выполните на персональном компьютере:
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/.ssh/:/tmp/.ssh/" \
-v "$PWD/resources.yml:/resources.yml" -v "$PWD/dhctl-tmp:/tmp/dhctl" registry.deckhouse.io/deckhouse/ee/install:stable bash
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/.ssh/:/tmp/.ssh/" \
-v "$PWD/resources.yml:/resources.yml" -v "$PWD/dhctl-tmp:/tmp/dhctl" registry.deckhouse.io/deckhouse/ee/install:stable bash
Внутри контейнера выполните команду:
dhctl bootstrap \
--ssh-user=<username> \
--ssh-agent-private-keys=/tmp/.ssh/id_rsa \
--config=/config.yml \
--resources=/resources.yml
dhctl bootstrap \
--ssh-user=<username> \
--ssh-agent-private-keys=/tmp/.ssh/id_rsa \
--config=/config.yml \
--resources=/resources.yml
Здесь, переменная username — ubuntu (для предложенных в этой документации образов).
Примечания:
-
Благодаря использованию параметра
-v "$PWD/dhctl-tmp:/tmp/dhctl"состояние данных Terraform-инстяллятора будет сохранено во временной директории на хосте запуска, что позволит корректно продолжить установку в случае прерывания работы контейнера с инсталлятором. В случае возникновения проблем во время разворачивания кластера, для прерывания процесса установки и удаления созданных при инсталляции объектов воспользуйтесь следующей командой (файл конфигурации должен совпадать с тем, с которым производилось разворачивание кластера):
dhctl bootstrap-phase abort \ --ssh-user=<username> \ --ssh-agent-private-keys=/tmp/.ssh/id_rsa \ --config=/config.ymldhctl bootstrap-phase abort \ --ssh-user=<username> \ --ssh-agent-private-keys=/tmp/.ssh/id_rsa \ --config=/config.yml
По окончании установки произойдет возврат к командной строке.
Почти все готово для полноценной работы Deckhouse Platform!