From 74c30e7ae8c4c2ea56c59f94b7dc4bafeb474031 Mon Sep 17 00:00:00 2001 From: stSolo Date: Mon, 28 Mar 2022 16:16:30 +0300 Subject: [PATCH] Create resource decort_k8s page, add description --- ...-decort_k8s:-управление-кластером-kubernetes..md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 07.6-Resource-функция-decort_k8s:-управление-кластером-kubernetes..md diff --git a/07.6-Resource-функция-decort_k8s:-управление-кластером-kubernetes..md b/07.6-Resource-функция-decort_k8s:-управление-кластером-kubernetes..md new file mode 100644 index 0000000..d99039a --- /dev/null +++ b/07.6-Resource-функция-decort_k8s:-управление-кластером-kubernetes..md @@ -0,0 +1,54 @@ +_Resource_ функция **decort_k8s** служит для управления кластером. + +## Аргументы +_Resource_ функция **decort_k8s** для создания кластера принимает следующие аргументы: + +| Аргумент | Тип | Описание | +| --- | --- | --- | +| name | string | Обязательный параметр, наименование кластера,
при изменении - изменяет наименование кластера | +| rg_id | int | Обязательный параметр, id ресурсной группы | +| k8sci_id | int | Обязательный параметр, id catalogue item | +| wg_name | string | Обязательный параметр, имя для первой worker group,
созданной в кластере | +| masters | object{
num: int,
cpu: int,
ram: int,
disk: int} |Опциональный параметр, настройка мастер node или nodes
Обязательный параметр, кол-во nodes
Обязательный параметр, количество cpu
Обязательный параметр, кол-во RAM в Mбайтах
Обязательный параметр, размер диска в Гбайтах | +| workers | object{
num: int,
cpu: int,
ram: int,
disk: int} | Опциональный параметр, настройка worker node или nodes
Обязательный параметр, кол-во nodes
Обязательный параметр, количество cpu
Обязательный параметр, кол-во RAM в Mбайтах
Обязательный параметр, размер диска в Гбайтах | + +## Возвращаемые значения +В случае успешного выполнения _resource_ функция **decort_k8s** возвращает в указанную при вызове переменную следующие значения: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| default_wg_id | int | ID рабочей группы (worker group) для этого экземпляра кластера. | +| kubeconfig | string | kubeconfig для доступа к кластеру. | + + +## Пример использования +Пример вызова _resource_ функции **decort_k8s**: +```terraform +resource "decort_k8s" "cluster" { + name = "tftest" + rg_id = 123 + k8sci_id = 9 + wg_name = "workers" + + 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://github.com/rudecs/terraform-provider-decort/wiki/05.-%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-Terraform-%D0%BF%D1%80%D0%BE%D0%B2%D0%B0%D0%B9%D0%B4%D0%B5%D1%80%D0%B0-DECORT.)). + +После успешного завершения такого вызова **decort_k8s** в переменной `decort_k8s` будут сохранены возвращаемые значения. \ No newline at end of file