update k8s resources
@@ -0,0 +1,94 @@
|
|||||||
|
Функция доступна в провайдере версии 4.5.1 и выше.
|
||||||
|
|
||||||
|
_Resource_ функция **decort_cb_k8s_wg** служит для управления worker groups (рабочики группами, wg) кластера.
|
||||||
|
|
||||||
|
## Аргументы
|
||||||
|
_Resource_ функция **decort_cb_k8s_wg** для создания worker group принимает следующие аргументы:
|
||||||
|
|
||||||
|
| Аргумент | Тип | Обязательный | Описание |
|
||||||
|
| --- |----------|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| k8s_id | int | :heavy_check_mark: | ID экземпляра k8s |
|
||||||
|
| name | string | :heavy_check_mark: | Наименование worker group |
|
||||||
|
| num | int | :x: | Количество worker node для создания |
|
||||||
|
| cpu | int | :x: | Количество cpu для 1 worker node<br/>по - умолчанию - 1 |
|
||||||
|
| ram | int | :x: | Количество RAM для одной worker node в Мбайтах, <br/>по-умолчанию - 1024 |
|
||||||
|
| disk | int | :x: | Размер загрузочного диска для worker node, в Гбайтах<br/>по - умолчанию - 0<br/>если установлен параметр 0, то размер диска будет равен размеру образа |
|
||||||
|
| cloud_init | string | :x: | Предустановленные настройки группы воркеров кластера Kubernetes (k8s) |
|
||||||
|
| labels | []string | :x: | Лейблы группы воркеров в формате: ["label1=value1", "label2=value2"] |
|
||||||
|
| annotations | []string | :x: | Аннотации группы workers в формате: ["key1=value1", "key2=value2"] |
|
||||||
|
|taints| []string | :x: | Список строк с taints для worker группы, в формате: ["key1=value1:NoSchedule", "key2=value2:NoExecute"] |
|
||||||
|
|worker_sep_id| int |:x:| ID СХД для создания загрузочных дисков для Worker-групп по умолчанию. Использует sepId образа, если не указан. Значение по умолчанию 0. |
|
||||||
|
|worker_sep_pool|string|:x:| Пул для хранения Workers. Если не заполнить, будет выбран системой. |
|
||||||
|
|
||||||
|
## Возвращаемые значения
|
||||||
|
|
||||||
|
В случае успешного выполнения _resource_ функция **decort_cb_k8s_wg** возвращает в указанную при вызове переменную следующие значения:
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| wg_id | int | ID группы воркеров кластера |
|
||||||
|
| detailed_info | []Struct{} [см. ниже](#описание-структуры-списка-detailed_info) | Детальная информация о группе |
|
||||||
|
| k8s_id | int | ID экземпляра k8s |
|
||||||
|
| name | string | Наименование worker group |
|
||||||
|
| num | int | Количество worker node для создания |
|
||||||
|
| cpu | int | Количество cpu для 1 worker node |
|
||||||
|
| ram | int | Количество RAM для одной worker node в Мбайтах |
|
||||||
|
| disk | int | Размер загрузочного диска для worker node, в Гбайтах |
|
||||||
|
| labels | []string | Лейблы ресурса |
|
||||||
|
| guid | int | ID ресурса |
|
||||||
|
| annotations | []string | Аннотации ресурса |
|
||||||
|
| taints | []string | ограничители группы workers |
|
||||||
|
|
||||||
|
### Описание структуры списка detailed_info
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| compute_id | int | ID компьюта в составе группы |
|
||||||
|
| name | string | Имя компьюта в составе группы |
|
||||||
|
| status | string | Статус компьюта в составе группы |
|
||||||
|
| tech_status | string | Технический статус компьюта в составе группы |
|
||||||
|
| interfaces | []Struct{} [см. ниже](#описание-структуры-списка-interfaces) | Список интерфейсов группы |
|
||||||
|
|
||||||
|
### Описание структуры списка interfaces
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| def_gw | string | Шлюз по умолчанию |
|
||||||
|
| ip_address | string | IP интерфейса |
|
||||||
|
|
||||||
|
## Пример использования
|
||||||
|
Пример вызова _resource_ функции **decort_cb_k8s_wg**:
|
||||||
|
```terraform
|
||||||
|
resource "decort_cb_k8s_wg" "wg" {
|
||||||
|
k8s_id = 1234 //это значение должно быть результатом вызова decort_cb_k8s_cp.cluster.k8s_id
|
||||||
|
name = "workers-2"
|
||||||
|
#num = 2
|
||||||
|
#cpu = 1
|
||||||
|
#ram = 1024
|
||||||
|
#disk = 10
|
||||||
|
#labels = ["label1=value1", "label2=value2"]
|
||||||
|
#annotations = ["key1=value1", "key2=value2"]
|
||||||
|
#taints = ["key1=value1", "key2=value2"]
|
||||||
|
#worker_sep_id = 1
|
||||||
|
#worker_sep_pool = "worker_pool"
|
||||||
|
#cloud_init = file("initconfig.tftpl")
|
||||||
|
}
|
||||||
|
|
||||||
|
# once the above directive completes, k8s wg will be accessible
|
||||||
|
# as decort_cb_k8s_wg.wg
|
||||||
|
```
|
||||||
|
|
||||||
|
Пример содержимого файла _initconfig.tftpl_:
|
||||||
|
```tftpl
|
||||||
|
---
|
||||||
|
users:
|
||||||
|
- groups: users, wheel
|
||||||
|
name: user
|
||||||
|
plain_text_passwd: examplePassword
|
||||||
|
primary_group: user
|
||||||
|
ssh_authorized_keys:
|
||||||
|
- ssh-rsa EXAMPLE%id_rsa.pub
|
||||||
|
sudo: ALL=(ALL) NOPASSWD:ALL
|
||||||
|
```
|
||||||
|
|
||||||
|
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
|
||||||
@@ -1,45 +0,0 @@
|
|||||||
Функция доступна в провайдере версии 2.0 и выше.
|
|
||||||
|
|
||||||
_Resource_ функция **decort_k8s_wg** служит для управления worker groups (рабочики группами, wg) кластера.
|
|
||||||
|
|
||||||
## Аргументы
|
|
||||||
_Resource_ функция **decort_k8s_wg** для создания worker group принимает следующие аргументы:
|
|
||||||
|
|
||||||
| Аргумент | Тип | Обязательный | Описание |
|
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| k8s_id | int | :heavy_check_mark: | ID экземпляра k8s |
|
|
||||||
| name | string | :heavy_check_mark: | Наименование worker group |
|
|
||||||
| num | int | :x: | Количество worker node для создания |
|
|
||||||
| cpu | int | :x: | Количество cpu для 1 worker node<br/>по - умолчанию - 1|
|
|
||||||
| ram | int | :x: | Количество RAM для одной worker node в Мбайтах, <br/>по-умолчанию - 1024|
|
|
||||||
| disk | int | :x: | Размер загрузочного диска для worker node, в Гбайтах<br/>по - умолчанию - 0<br/>если установлен параметр 0, то размер диска будет равен размеру образа |
|
|
||||||
|
|
||||||
## Возвращаемые значения
|
|
||||||
|
|
||||||
В случае успешного выполнения _resource_ функция **decort_k8s_wg** возвращает в указанную при вызове переменную следующие значения:
|
|
||||||
| Параметр | Тип | Описание |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| k8s_id | int | ID экземпляра k8s |
|
|
||||||
| name | string | Наименование worker group |
|
|
||||||
| num | int | Количество worker node для создания |
|
|
||||||
| cpu | int | Количество cpu для 1 worker node |
|
|
||||||
| ram | int | Количество RAM для одной worker node в Мбайтах |
|
|
||||||
| disk | int | Размер загрузочного диска для worker node, в Гбайтах |
|
|
||||||
|
|
||||||
## Пример использования
|
|
||||||
Пример вызова _resource_ функции **decort_k8s_wg**:
|
|
||||||
```terraform
|
|
||||||
resource "decort_k8s_wg" "wg" {
|
|
||||||
k8s_id = 1234 //это значение должно быть результатом вызова decort_k8s.cluster.id
|
|
||||||
name = "workers-2"
|
|
||||||
num = 2
|
|
||||||
cpu = 1
|
|
||||||
ram = 1024
|
|
||||||
disk = 10
|
|
||||||
}
|
|
||||||
|
|
||||||
# once the above directive completes, will be accessible
|
|
||||||
# as decort_k8s_wg.wg
|
|
||||||
```
|
|
||||||
|
|
||||||
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
|
|
||||||
@@ -0,0 +1,261 @@
|
|||||||
|
Функция доступна в провайдере версии 4.5.1 и выше.
|
||||||
|
|
||||||
|
_Resource_ функция **decort_cb_k8s_cp** служит для управления кластером.
|
||||||
|
|
||||||
|
## Аргументы
|
||||||
|
|
||||||
|
_Resource_ функция **decort_cb_k8s_cp** для создания кластера принимает следующие аргументы:
|
||||||
|
|
||||||
|
| Аргумент | Тип | Обязательный | Описание |
|
||||||
|
|----------------|-----------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| name | string | :heavy_check_mark: | Наименование кластера, <br/>при изменении - изменяет наименование кластера |
|
||||||
|
| rg_id | int | :heavy_check_mark: | ID ресурсной группы |
|
||||||
|
| k8sci_id | int | :heavy_check_mark: | ID catalogue item |
|
||||||
|
| network_plugin | string | :heavy_check_mark: | Сетевой плагин |
|
||||||
|
| num | int | :x: | кол-во компьютов в ресурсе |
|
||||||
|
| cpu | int | :x: | Кол-во cpu на нодах |
|
||||||
|
| ram | int | :x: | Кол-во ram на нодах |
|
||||||
|
| disk | int | :x: | Размер диска мастер-узла |
|
||||||
|
| sep_id | int | :x: | storage endpoint provider ID |
|
||||||
|
| sep_pool | string | :x: | SEP пул мастер-узла (если установлен sepId) |
|
||||||
|
| with_lb | bool | :x: | Создать кластер с/без балансировщика нагрузки |
|
||||||
|
| extnet_only | bool | :x: | Использовать только extnet для работы кластера |
|
||||||
|
|join_config| string | :x: | Используется для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Это позволяет вам настраивать такие вещи, как регистрация node, настройка network и другие задачи инициализации. |
|
||||||
|
|kube_proxy_config| string | :x: | Используется для настройки поведения и параметров присоединения node к кластеру. Он включает в себя такие параметры, как режим прокси-сервера, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. |
|
||||||
|
|kubelet_config| string | :x: | Используется для настройки поведения и параметров Kubelet, который является агентом primary node, запускаемым на каждом node кластера. Он включает в себя такие параметры, как IP-адрес node, распределение ресурсов, политики удаления модулей и другие конфигурации, специфичные для Kubelet. |
|
||||||
|
| cluster_config | string | :x: | используется для определения глобальных настроек и конфигураций для всего кластера. Она включает в себя такие параметры, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации в масштабах кластера. вставьте допустимую строку JSON со всеми уровнями вложенности. |
|
||||||
|
|init_config| string | :x: | Используется для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Это позволяет вам настраивать такие вещи, как регистрация node, настройка network и другие задачи инициализации. |
|
||||||
|
|additional_sans| []string | :x: | Дополнительные SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Возможность взаимодействовать с кластером по FQDN. Параметр получает список строк – IP-адреса и/или DNS (по формату RFC 1123 c поддержкой wildcard). |
|
||||||
|
| ha_mode | bool | :x: | Флаг, показывающий, включен ли режим haproxy |
|
||||||
|
| oidc_cert | string | :x: | ssl-сертификат в формате x509 pem |
|
||||||
|
| extnet_id | int | :x: | ID внешней сети для соединения workers.<br/>Если не задано,<br/>то сеть будет выбрана платформой. |
|
||||||
|
| vins_id | int | :x: | ID виртуальной сети |
|
||||||
|
| desc | string | :x: | Текстовое описание кластера |
|
||||||
|
| start |bool| :x: | Старт/Стоп кластера |
|
||||||
|
|enabled|bool| :x: | Включить/отключить кластер |
|
||||||
|
| permanently | bool | :x: | Безвозвратное удаление кластера. Используется при удалении. |
|
||||||
|
|restore|bool| :x: |Восстановить кластер из корзины|
|
||||||
|
|
||||||
|
## Возвращаемые значения
|
||||||
|
|
||||||
|
В случае успешного выполнения _resource_ функция **decort_cb_k8s_cp** возвращает в указанную при вызове переменную следующие значения:
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| ------------- | ----------------------------------------------------------------- |----------------------------------------------------------------|
|
||||||
|
| detailed_info | []Struct{} [см. ниже](#описание-структуры-списка-detailed_info) | Детальная информация о группе |
|
||||||
|
| master_id | int | ID группы master |
|
||||||
|
| master_name | string | Наименование мастер-узла |
|
||||||
|
| lb_ip | string | IP адрес балансировщика нагрузки (load balancer) по-умолчанию. |
|
||||||
|
| default_wg_id | int | ID рабочей группы (worker group) для этого экземпляра кластера. |
|
||||||
|
| kubeconfig | string | Kubeconfig для доступа к кластеру. |
|
||||||
|
| k8s_id | int | ID кластера |
|
||||||
|
| acl | []Struct [см. ниже](#описание-структуры-acl)| Cписок Acces Control |
|
||||||
|
| account_id | int | ID аккаунта - владельца кластера |
|
||||||
|
| account_name | string | Имя аккаунта - владельца кластера |
|
||||||
|
| bservice_id | int | ID bservice |
|
||||||
|
| created_by | string | Аккаунт, создавший кластер |
|
||||||
|
| created_time | int | Время создания кластера |
|
||||||
|
| deleted_by | string | Кем удален кластер |
|
||||||
|
| deleted_time | int | Время удаления кластера |
|
||||||
|
| gid | int | GRID ID |
|
||||||
|
| guid | int | ID ресурса |
|
||||||
|
| k8s_ci_name | string | Имя образа кластера |
|
||||||
|
| lb_id | int | ID балансировщика нагрзуки |
|
||||||
|
| milestones | int | Вехи |
|
||||||
|
| rg_name | string | Название ресурсной группы |
|
||||||
|
| ssh_key | string | Публичный SSH ключ |
|
||||||
|
| status | string | Статус кластера |
|
||||||
|
| tech_status | string | Технический статус кластера |
|
||||||
|
| updated_by | string | Кем был обновлен кластер |
|
||||||
|
| updated_time | int | Время последнего обновления кластера |
|
||||||
|
|
||||||
|
### Описание структуры списка detailed_info
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| compute_id | int | ID компьюта в составе группы |
|
||||||
|
| name | string | Имя компьюта в составе группы |
|
||||||
|
| status | string | Статус компьюта в составе группы |
|
||||||
|
| tech_status | string | Технический статус компьюта в составе группы |
|
||||||
|
| interfaces | []Struct{} [см. ниже](#описание-структуры-списка-interfaces) | Список интерфейсов группы |
|
||||||
|
|
||||||
|
### Описание структуры списка interfaces
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| def_gw | string | Шлюз по умолчанию |
|
||||||
|
| ip_address | string | IP интерфейса |
|
||||||
|
|
||||||
|
### Описание структуры acl
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
|-------------| --- | --- |
|
||||||
|
| account_acl | []Struct [см. ниже](#описание-структуры-List-acl) | Информация о списке пользователей аккаунтов |
|
||||||
|
| k8s_acl | []Struct [см. ниже](#описание-структуры-List-acl) | Информация о списке пользователей компьютов |
|
||||||
|
| rg_acl | []Struct [см. ниже](#описание-структуры-List-acl) | Информация о списке пользователей ресурной группы |
|
||||||
|
|
||||||
|
### Описание структуры List acl
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| explicit | bool | Явно ли указан доступ |
|
||||||
|
| guid | string | guid Ресурса |
|
||||||
|
| right | string | Права на ресурс |
|
||||||
|
| status | string | Статус ресурса |
|
||||||
|
| type | string | Тип ресурса |
|
||||||
|
| user_group_id | string | ID user group |
|
||||||
|
|
||||||
|
## Пример использования
|
||||||
|
|
||||||
|
Пример вызова _resource_ функции **decort_cb_k8s_cp**:
|
||||||
|
|
||||||
|
```terraform
|
||||||
|
resource "decort_cb_k8s_cp" "cluster" {
|
||||||
|
# Название кластера
|
||||||
|
# Обязательный параметр
|
||||||
|
# string
|
||||||
|
name = "k8s-cp"
|
||||||
|
|
||||||
|
# K8sCI ID
|
||||||
|
# Обязательный параметр
|
||||||
|
# int
|
||||||
|
k8sci_id = 55
|
||||||
|
|
||||||
|
# Плагин сети (flannel, weavenet или calico)
|
||||||
|
# Обязательный параметр
|
||||||
|
# string
|
||||||
|
network_plugin = "flannel"
|
||||||
|
|
||||||
|
# ID ресурсной группы
|
||||||
|
# Обязательный параметр
|
||||||
|
# int
|
||||||
|
rg_id = 1387
|
||||||
|
|
||||||
|
# Кол-во ядер мастер-узла
|
||||||
|
# Опциональный параметр
|
||||||
|
# int
|
||||||
|
cpu = 2
|
||||||
|
|
||||||
|
# Объем RAM мастер-узла
|
||||||
|
# Опциональный параметр
|
||||||
|
# int
|
||||||
|
ram = 2048
|
||||||
|
|
||||||
|
# Кол-во ВМ мастер-узла (1 или 3)
|
||||||
|
# Опциональный параметр
|
||||||
|
# int
|
||||||
|
num = 1
|
||||||
|
|
||||||
|
# Размер диска мастер-узла
|
||||||
|
# Опциональный параметр
|
||||||
|
# int
|
||||||
|
disk = 10
|
||||||
|
|
||||||
|
# Описание кластера
|
||||||
|
# Опциональный параметр
|
||||||
|
# string
|
||||||
|
desc = "<DESCRIPTION>"
|
||||||
|
|
||||||
|
# id extnet
|
||||||
|
#опциональный параметр
|
||||||
|
#тип - число
|
||||||
|
extnet_id = 0
|
||||||
|
|
||||||
|
# id vins
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - число
|
||||||
|
vins_id = 1234
|
||||||
|
|
||||||
|
# Storage Endpoint ID
|
||||||
|
# Опциональный параметр
|
||||||
|
# id
|
||||||
|
sep_id = 0
|
||||||
|
|
||||||
|
# SEP Pool
|
||||||
|
# Опциональный параметр
|
||||||
|
# string
|
||||||
|
sep_pool = "pool"
|
||||||
|
|
||||||
|
# Старт/Стоп кластера
|
||||||
|
# Опциональный параметр
|
||||||
|
# bool
|
||||||
|
start = true
|
||||||
|
|
||||||
|
# Включить/отключить кластер
|
||||||
|
# Опциональный параметр
|
||||||
|
# bool
|
||||||
|
enabled = true
|
||||||
|
|
||||||
|
# Удалить кластер безвозвратно
|
||||||
|
# Опциональный параметр
|
||||||
|
# bool
|
||||||
|
permanently = true
|
||||||
|
|
||||||
|
# Восстановить кластер из корзины
|
||||||
|
# Опциональный параметр
|
||||||
|
# bool
|
||||||
|
restore = true
|
||||||
|
|
||||||
|
# Создать кластер с/без балансировщика нагрузки
|
||||||
|
# Опциональный параметр
|
||||||
|
# bool
|
||||||
|
with_lb = true
|
||||||
|
|
||||||
|
# позволяет создать схему отказоустройчивой LB
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - булев тип
|
||||||
|
ha_mode = true
|
||||||
|
|
||||||
|
# дополнительные SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes;
|
||||||
|
# возможность взаимодействовать с кластером по FQDN
|
||||||
|
# параметр получает список строк – IP-адреса и/или DNS (по формату RFC 1123 c поддержкой wildcard)
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - массив строк
|
||||||
|
additional_sans = ["192.168.201.0", "192.168.201.1"]
|
||||||
|
|
||||||
|
# используется для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере
|
||||||
|
# это позволяет вам настраивать такие вещи, как регистрация node, настройка network и другие задачи инициализации
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - строка
|
||||||
|
init_config = "{JSON string}"
|
||||||
|
|
||||||
|
# используется для определения глобальных настроек и конфигураций для всего кластера
|
||||||
|
# он включает в себя такие параметры, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации в масштабах кластера
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - строка
|
||||||
|
cluster_config = "{JSON string}"
|
||||||
|
|
||||||
|
# используется для настройки поведения и параметров Kubelet, который является агентом primary node, запускаемым на каждом node кластера
|
||||||
|
# он включает в себя такие параметры, как IP-адрес node, распределение ресурсов, политики удаления модулей и другие конфигурации, специфичные для Kubelet
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - строка
|
||||||
|
kubelet_config = "{JSON string}"
|
||||||
|
|
||||||
|
# используется для настройки поведения и параметров присоединения node к кластеру
|
||||||
|
# он включает в себя такие параметры, как режим прокси-сервера, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - строка
|
||||||
|
kube_proxy_config = "{JSON string}"
|
||||||
|
|
||||||
|
# используется для настройки поведения и параметров присоединения node к кластеру
|
||||||
|
# он включает в себя такие параметры, как cluster's control plane endpoint, токен и ключ сертификата
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - строка
|
||||||
|
join_config = "{JSON string}"
|
||||||
|
|
||||||
|
# при создании кластре использовать подключение только к сети ExtNet
|
||||||
|
# опциональный параметр
|
||||||
|
# тип - булев тип
|
||||||
|
extnet_only = true
|
||||||
|
|
||||||
|
# добавить ssl-сертификат в формате x509 pem
|
||||||
|
# необязательный параметр
|
||||||
|
# тип - файл
|
||||||
|
oidc_cert = file("ca.crt")
|
||||||
|
}
|
||||||
|
|
||||||
|
# once the above directive completes, k8s cluster will be accessible
|
||||||
|
# as decort_cb_k8s_cp.cluster
|
||||||
|
```
|
||||||
|
|
||||||
|
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
|
||||||
|
|
||||||
|
После успешного завершения такого вызова **decort_cb_k8s_cp** в переменной `decort_cb_k8s_cp.cluster` будут сохранены возвращаемые значения.
|
||||||
@@ -1,73 +0,0 @@
|
|||||||
Функция доступна в провайдере версии 2.0 и выше.
|
|
||||||
|
|
||||||
_Resource_ функция **decort_k8s** служит для управления кластером.
|
|
||||||
|
|
||||||
## Аргументы
|
|
||||||
|
|
||||||
_Resource_ функция **decort_k8s** для создания кластера принимает следующие аргументы:
|
|
||||||
|
|
||||||
| Аргумент | Тип | Обязательный | Описание |
|
|
||||||
| --------- | ----------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
||||||
| name | string | :heavy_check_mark: | Наименование кластера, <br/>при изменении - изменяет наименование кластера |
|
|
||||||
| rg_id | int | :heavy_check_mark: | ID ресурсной группы |
|
|
||||||
| k8sci_id | int | :heavy_check_mark: | ID catalogue item |
|
|
||||||
| wg_name | string | :heavy_check_mark: | Имя для первой worker group, <br/> созданной в кластере |
|
|
||||||
| masters | object{<br/>num: int, <br/>cpu: int,<br/>ram: int,<br/>disk: int} | :x: | Настройка мастер node или nodes<br/>Обязательный параметр, кол-во nodes<br/>Обязательный параметр, количество cpu<br/>Обязательный параметр, кол-во RAM в Mбайтах<br/>Обязательный параметр, размер диска в Гбайтах |
|
|
||||||
| workers | object{<br/>num: int, <br/>cpu: int,<br/>ram: int,<br/>disk: int} | :x: | Настройка worker node или nodes<br/>Обязательный параметр, кол-во nodes<br/>Обязательный параметр, количество cpu<br/>Обязательный параметр, кол-во RAM в Mбайтах<br/>Обязательный параметр, размер диска в Гбайтах |
|
|
||||||
| extnet_id | int | :x: | ID внешней сети для соединения workers.<br/>Если не задано,<br/>то сеть будет выбрана платформой. |
|
|
||||||
|
|
||||||
## Возвращаемые значения
|
|
||||||
|
|
||||||
В случае успешного выполнения _resource_ функция **decort_k8s** возвращает в указанную при вызове переменную следующие значения:
|
|
||||||
|
|
||||||
| Параметр | Тип | Описание |
|
|
||||||
| ------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
||||||
| default_wg_id | int | ID рабочей группы (worker group) для этого экземпляра кластера. |
|
|
||||||
| kubeconfig | string | Kubeconfig для доступа к кластеру. |
|
|
||||||
| lb_ip | string | IP адрес балансировщика нагрузки (load balancer) по-умолчанию. |
|
|
||||||
| name | string | Наименование кластера |
|
|
||||||
| rg_id | int | ID ресурсной группы |
|
|
||||||
| k8sci_id | int | ID catalogue item |
|
|
||||||
| wg_name | string | Имя для первой worker group, <br/> созданной в кластере |
|
|
||||||
| masters | object{<br/>num: int, <br/>cpu: int,<br/>ram: int,<br/>disk: int} | Настройка мастер node или nodes<br/>Кол-во nodes<br/>Количество cpu<br/>Кол-во RAM в Mбайтах<br/>Размер диска в Гбайтах |
|
|
||||||
| workers | object{<br/>num: int, <br/>cpu: int,<br/>ram: int,<br/>disk: int} | Настройка worker node или nodes<br/>Кол-во nodes<br/>Количество cpu<br/>Кол-во RAM в Mбайтах<br/>Размер диска в Гбайтах |
|
|
||||||
| extnet_id | int | ID внешней сети для соединения workers |
|
|
||||||
|
|
||||||
## Пример использования
|
|
||||||
|
|
||||||
Пример вызова _resource_ функции **decort_k8s**:
|
|
||||||
|
|
||||||
```terraform
|
|
||||||
resource "decort_k8s" "cluster" {
|
|
||||||
name = "tftest"
|
|
||||||
rg_id = 123
|
|
||||||
k8sci_id = 9
|
|
||||||
wg_name = "workers"
|
|
||||||
|
|
||||||
#extnet_id = 11111
|
|
||||||
/*
|
|
||||||
masters {
|
|
||||||
num = 1
|
|
||||||
cpu = 2
|
|
||||||
ram = 2048
|
|
||||||
disk = 10
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*
|
|
||||||
workers {
|
|
||||||
num = 1
|
|
||||||
cpu = 2
|
|
||||||
ram = 2048
|
|
||||||
disk = 10
|
|
||||||
}
|
|
||||||
*/
|
|
||||||
}
|
|
||||||
|
|
||||||
# once the above directive completes, will be accessible
|
|
||||||
# as decort_k8s.cluster
|
|
||||||
```
|
|
||||||
|
|
||||||
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
|
|
||||||
|
|
||||||
После успешного завершения такого вызова **decort_k8s** в переменной `decort_k8s` будут сохранены возвращаемые значения.
|
|
||||||
4
Home.md
4
Home.md
@@ -227,8 +227,8 @@ Terraform провайдер для платформы DECORT с API верси
|
|||||||
- [**decort_cb_extnet**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.15-Resource-функция-decort_cb_extnet-управление-внешними-сетями) - управление внешними сетями
|
- [**decort_cb_extnet**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.15-Resource-функция-decort_cb_extnet-управление-внешними-сетями) - управление внешними сетями
|
||||||
- [**decort_cb_disk**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.13-Resource-функция-decort_cb_disk-управление-дисковыми-ресурсами) - управление дисковыми ресурсами.
|
- [**decort_cb_disk**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.13-Resource-функция-decort_cb_disk-управление-дисковыми-ресурсами) - управление дисковыми ресурсами.
|
||||||
- [**decort_cb_vins**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.12-Resource-функция-decort_cb_vins-управление-виртуальными-сетевыми-сегментами) - управление виртуальными сетевыми сегментами.
|
- [**decort_cb_vins**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.12-Resource-функция-decort_cb_vins-управление-виртуальными-сетевыми-сегментами) - управление виртуальными сетевыми сегментами.
|
||||||
- [**decort_k8s**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.10-Resource-функция-decort_k8s-управление-кластером-kubernetes) - управление кластером
|
- [**decort_cb_k8s_cp**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.10-Resource-функция-decort_cb_k8s_cp-управление-кластером-kubernetes) - управление кластером
|
||||||
- [**decort_k8s_wg**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.09-Resource-функция-decort_k8s_wg-управление-worker-groups-кластера) - управление worker group кластера
|
- [**decort_cb_k8s_wg**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.09-Resource-функция-decort_cb_k8s_wg-управление-worker-groups-кластера) - управление worker group кластера
|
||||||
- [**decort_cb_virtual_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.07-Resource-функция-decort_cb_virtual_image-управление-виртуальным-образом) - управление виртуальным образом
|
- [**decort_cb_virtual_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.07-Resource-функция-decort_cb_virtual_image-управление-виртуальным-образом) - управление виртуальным образом
|
||||||
- [**decort_cb_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.08-Resource-функция-decort_cb_image-управление-образом) - управление образом
|
- [**decort_cb_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.08-Resource-функция-decort_cb_image-управление-образом) - управление образом
|
||||||
- [**decort_cb_cdrom_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.04-Resource-функция-decort_cb_cdrom_image-управление-cdrom-образом) - управление cdrom образом
|
- [**decort_cb_cdrom_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.02.04-Resource-функция-decort_cb_cdrom_image-управление-cdrom-образом) - управление cdrom образом
|
||||||
|
|||||||
Reference in New Issue
Block a user