Функция доступна в провайдере версии 4.5.1 и выше.

_Resource_ функция **decort_cb_k8ci** служит для управления конфигурацией Кластера Kubernetes (K8ci).

## Аргументы

_Resource_ функция **decort_cb_k8ci** для создания кластера принимает следующие аргументы:

| Аргумент       | Тип       | Обязательный                                 | Описание                                                           |
|----------------|-----------|----------------------------------------------|--------------------------------------------------------------------|
| name           | string    | :heavy_check_mark:                           | Наименование K8ci, <br/>при изменении - изменяет наименование K8ci |
| version | string | :heavy_check_mark:                           | Версия                                                             |
| master_driver | string | :heavy_check_mark:                           | Драйвер master-узла                                                |
|master_image_id|int| :heavy_check_mark:                           | ID образа master-узла k8ci                                         |
|max_master_count|int| :heavy_check_mark:                           | Ограничение политики на максимальное количество master-узлов       |
|max_worker_count|int| :heavy_check_mark:                           | Ограничение политики на максимальное количество worker-узлов       |
|worker_image_id|int| :heavy_check_mark:                           | ID образа worker-узла k8ci                                         |
| worker_driver | string | :heavy_check_mark:                           | Драйвер worker-узла                                                |
| network_plugins | []string | :heavy_check_mark:                           | Список доступных плагинов сети ["flannel", "calico", "weavenet"]   |
| enabled      | bool  | :x:                                          | Доступность k8ci                                                   |
| permanently | bool | :x:                                          | Флаг для моментального удаления k8ci                               |
| desc | string | :x:                                          | Описание k8ci                                                      |
| shared_with | []int | :x: |  Список аккаунтов, имеющих доступ к k8ci                           |

## Возвращаемые значения

В случае успешного выполнения _resource_ функция **decort_cb_k8ci** возвращает в указанную при вызове переменную следующие значения:

| Параметр      | Тип      | Описание                                                     |
| ------------    | -------  |--------------------------------------------------------------|
| desc            | string   | Описание                                                     |
| gid | int | Grid ID                                                      |
| guid | int | ID ресурса                                                   |
| k8ci_id         | int      | ID k8ci                                                      |
| lb_image_id     | int      | ID образа балансировщика                                     |
| master_driver | string | Драйвер master-узла                                          |
|master_image_id|int| ID образа master-узла k8ci                                   |
|max_master_count|int| Ограничение политики на максимальное количество master-узлов |
|max_worker_count|int| Ограничение политики на максимальное количество worker-узлов |
| milestones | int | Вехи                                                         |
| name            | string   | Наименование k8ci                                            |
| network_plugins | []string | Список доступных плагинов сети                               |
| shared_with | []int                                         | Список ресурсов, имеющих доступ к k8ci                       |
| status          | string   | Статус k8ci                                                  |
| version         | string   | Версия                                                       |
| worker_driver | string | Драйвер worker-узла                                          |
|worker_image_id|int| ID образа worker-узла k8ci                                   |

## Пример использования

Пример вызова _resource_ функции **decort_cb_k8ci**:

```terraform
resource "decort_cb_k8ci" "k8ci" {
  #имя k8ci
  #обязательный параметр
  #тип - строка
  name =    "test"

  #тег версии
  #обязательный параметр
  #тип - строка
  version =        "1.1.1"

  #тип master driver
  #обязательный параметр
  #тип - строка
  master_driver =    "KVM_X86"

  #тип worker driver
  #обязательный параметр
  #тип - строка
  worker_driver =  "KVM_X86"

  #максимальное число master компутов
  #обязательный параметр
  #тип - число
  max_master_count = 1

  #максимальное число worker компутов
  #обязательный параметр
  #тип - число
  max_worker_count = 1

  #id образа для master 
  #обязательный параметр
  #тип - число
  master_image_id = 4

  #id образа для worker 
  #обязательный параметр
  #тип - число
  worker_image_id = 4

  #network plugins
  #обязательный параметр
  #тип - список строк
  network_plugins = ["flannel"]

  #доступность k8ci
  #опциональный параметр
  #тип - булево значение
  #enabled = false

  #флаг для моментального удаления k8ci
  #опциональный параметр
  #тип - булевый
  #permanently = true

  #описание 
  #опциональный параметр
  #тип - строка
  #desc =  "some"

  #доступность k8ci другим аккаунтам
  #опциональный параметр
  #тип - список чисел
  #shared_with = [1111]
}

# once the above directive completes, k8ci configuration will be accessible
# as decort_cb_k8ci.k8ci
```

Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/src/branch/main/wiki/4.5.3/04.02-Инициализация-Terraform-провайдера-DECORT.md)).

После успешного завершения такого вызова **decort_cb_k8ci** в переменной `decort_cb_k8ci.k8ci` будут сохранены возвращаемые значения.
