From 9fa004dd2dcbdaf2d9174930be06179bb8f60dbf Mon Sep 17 00:00:00 2001 From: loskutovanl Date: Tue, 9 Apr 2024 08:49:17 +0300 Subject: [PATCH] wiki with versioning --- 01.-Введение.md | 7 - 02.-Пример-работы.md | 92 ---- ...лачной-платформы-DECORT.md | 31 -- ...terraform-провайдером-DECORT.md | 6 - ...-Terraform-провайдера-DECORT.md | 150 ----- ...-Terraform-провайдера-DECORT.md | 64 --- ...ние-между-группами-API.md | 38 -- ...4-Получение-gid-или-grid_id.md | 31 -- ...form-провайдера-в-образ.md | 43 -- 05.-Работа-с-terraform.md | 4 - ...ортирование-ресурсов.md | 75 --- 05.02-Работа-с-таймаутами.md | 100 ---- ...становление-ресурсов.md | 29 - ...урсов.-Мета-аргументы.md | 452 --------------- 05.05-Удаление-ресурсов.md | 262 --------- 05.06-Установка-Terraform.md | 46 -- ...астеров-на-версию-4.2.0.md | 179 ------ ...-Terraform-провайдера-DECORT.md | 4 - ...овательская-группа-API.md | 1 - ...ьной-машине-на-базе-KVM.md | 249 --------- ...ии-о-ресурсной-группе.md | 127 ----- ...ие-информации-о-диске.md | 103 ---- ...чение-информации-о-ViNS.md | 277 ---------- ...формации-об-аккаунте.md | 119 ---- ...нформации-об-образах.md | 88 --- ...-информации-об-образе.md | 77 --- ...а-доступных-площадок.md | 49 -- ...получение-url-площадки.md | 28 - ...тупных-для-образа-stacks.md | 49 -- ...ие-информации-о-snapshots.md | 35 -- ...ех-ресурсных-группах.md | 80 --- ...ормации-о-всех-дисках.md | 172 ------ ...ех-виртуальных-сетях.md | 76 --- ...тупных-внешних-сетях.md | 59 -- ...ней-сети-по-умолчанию.md | 28 - ...ьзующих-внешнюю-сеть.md | 73 --- ...рмации-о-внешней-сети.md | 57 -- ...и-о-запросах-аккаунта.md | 41 -- ...том-экземплярах-computes.md | 67 --- ...ых-ресурсах-аккаунта.md | 42 -- ...емых-ресурсах-по-типу.md | 49 -- ...мых-аккаунтом-дисках.md | 53 -- ...с-плавающим-ip-адресом.md | 67 --- ...ых-ресурсах-аккаунта.md | 42 -- ...ных-группах-аккаунта.md | 58 -- ...и-о-шаблонах-аккаунта.md | 81 --- ...о-всех-сетях-аккаунта.md | 58 -- ...-доступных-аккаунтах.md | 52 -- ...-удаленных-аккаунтах.md | 51 -- ...ных-базовых-сервисах.md | 84 --- ...ных-базовых-сервисах.md | 78 --- ...ах-состояния-сервиса.md | 37 -- ...ции-о-базовом-сервисе.md | 97 ---- ...ппе-базового-сервиса.md | 72 --- ...ансировщике-нагрузки.md | 107 ---- ...нсировщиках-нагрузки.md | 133 ----- ...нсировщиках-нагрузки.md | 124 ----- ...ие-списка-типов-диска.md | 40 -- ...иваемых-типах-дисков.md | 50 -- ...и-об-удаленных-дисках.md | 90 --- ...еподключенных-дисках.md | 157 ------ ...мков-состояния-диска.md | 36 -- ...ии-о-снимке-состояния.md | 40 -- ...ормации-о-кластере-k8s.md | 123 ----- ...-о-списке-кластеров-k8s.md | 127 ----- ...даленных-кластеров-k8s.md | 118 ---- ...-воркеров-кластера-k8s.md | 68 --- ...-воркеров-кластера-k8s.md | 63 --- ...ита-для-указанного-vins.md | 38 -- ...тей-для-указанного-vins.md | 39 -- ...сах-для-указанного-vins.md | 39 -- ...ых-виртуальных-сетях.md | 60 -- ...х-NAT-для-указанного-vins.md | 39 -- ...ии-о-аудитах-компьюта.md | 32 -- ...ии-о-аудитах-компьюта.md | 29 - ...е-url-консоли-компьюта.md | 27 - ...гов-по-заданному-пути.md | 28 - ...ии-о-списке-компьютов.md | 167 ------ ...орвардингов-компьюта.md | 34 -- ...льзователях-компьюта.md | 40 -- ...писке-ресурных-групп.md | 96 ---- ...ютах-аффинити-группы.md | 44 -- ...ии-о-аффинити-группах.md | 53 -- ...ции-о-аффинити-группе.md | 38 -- ...тах-ресурсной-группы.md | 41 -- ...тах-ресурсной-группы.md | 79 --- ...нных-ресурсных-групп.md | 94 ---- ...информации-о-списке-lb.md | 145 ----- ...нформации-о-списке-pfw.md | 44 -- ...нформации-о-списке-vins.md | 58 -- ...ия-об-использовании-rg.md | 51 -- ...ользовании-снапшотов.md | 40 -- ...ных-машинах-кластера.md | 47 -- ...ии-о-плавающей-группе.md | 49 -- ...и-о-плавающих-группах.md | 54 -- ...чение-информации-о-k8ci.md | 51 -- ...ии-о-статическом-пути.md | 41 -- ...ке-статических-путей.md | 36 -- ...рвированных-ресурсов.md | 72 --- ...рвированных-ресурсов.md | 53 -- ...керов-кластера-Kubernetes.md | 41 -- ...ых-виртуальных-машин.md | 216 -------- ...а-устройств-с-шиной-PCI.md | 68 --- ...рафических-устройств.md | 68 --- ...ной-ресурсной-группе.md | 72 --- ...ных-ресурсной-группе.md | 65 --- ...истративная-группа-API.md | 1 - ...ьной-машине-на-базе-KVM.md | 249 --------- ...ии-о-ресурсной-группе.md | 87 --- ...ие-информации-о-диске.md | 110 ---- ...чение-информации-о-ViNS.md | 294 ---------- ...формации-об-аккаунте.md | 79 --- ...нформации-об-образах.md | 118 ---- ...-информации-об-образе.md | 93 ---- ...тупных-для-образа-stacks.md | 116 ---- ...в-доступных-платформ.md | 86 --- ...чение-информации-о-grid.md | 39 -- ...рвированных-ресурсов.md | 72 --- ...рвированных-ресурсов.md | 53 -- ...формации-о-всех-pcidevice.md | 50 -- ...ие-информации-о-pcidevice.md | 43 -- ...афическом-устройстве.md | 40 -- ...ех-ресурсных-группах.md | 99 ---- ...ормации-о-всех-дисках.md | 133 ----- ...ех-виртуальных-сетях.md | 94 ---- ...и-о-запросах-аккаунта.md | 43 -- ...том-экземплярах-computes.md | 119 ---- ...мых-аккаунтом-дисках.md | 81 --- ...с-плавающим-ip-адресом.md | 106 ---- ...ных-группах-аккаунта.md | 145 ----- ...о-всех-сетях-аккаунта.md | 92 ---- ...-доступных-аккаунтах.md | 115 ---- ...-удаленных-аккаунтах.md | 109 ---- ...ции-о-конфигурации-sep.md | 72 --- ...ормации-о-загрузке-sep.md | 46 -- ...сках,-используемых-sep.md | 46 -- ...е-информации-о-всех-sep.md | 72 --- ...ние-информации-о-pool-sep.md | 68 --- ...чение-информации-о-sep.md | 87 --- ...рмации-о-внешней-сети.md | 98 ---- ...мации-о-внешних-сетях.md | 117 ---- ...ение-информации-о-stack.md | 114 ---- ...ие-информации-о-stack_list.md | 116 ---- ...с-плавающим-ip-адресом.md | 65 --- ...с-плавающим-ip-адресом.md | 70 --- ...ансировщике-нагрузки.md | 136 ----- ...нсировщиках-нагрузки.md | 156 ------ ...нсировщиках-нагрузки.md | 152 ----- ...дресов-пользователей.md | 37 -- ...х-ресурсов-во-всех-grid.md | 64 --- ...ованных-ресурсов-в-grid.md | 69 --- ...вности-текущей-среды.md | 35 -- ...ых-виртуальных-сетях.md | 92 ---- ...ии-портов-для-сети-vins.md | 40 -- ...ии-о-внешних-сетях-vins.md | 36 -- ...на-внутренней-сети-vins.md | 37 -- ...ля-внутренней-сети-vins.md | 36 -- ...ля-внутренней-сети-vins.md | 39 -- ...ля-внутренней-сети-vins.md | 35 -- ...ютах-аффинити-группы.md | 48 -- ...ции-о-аффинити-группе.md | 42 -- ...ии-о-аффинити-группах.md | 46 -- ...тах-ресурсной-группы.md | 44 -- ...ной-ресурсной-группе.md | 69 --- ...ных-ресурсной-группе.md | 65 --- ...ия-об-использовании-rg.md | 58 -- ...тах-ресурсной-группы.md | 93 ---- ...нных-ресурсных-групп.md | 105 ---- ...информации-о-списке-lb.md | 166 ------ ...нформации-о-списке-pfw.md | 45 -- ...нформации-о-списке-vins.md | 66 --- ...и-об-удаленных-дисках.md | 127 ----- ...ие-списка-типов-диска.md | 30 - ...иваемых-типах-дисков.md | 39 -- ...еподключенных-дисках.md | 117 ---- ...ии-о-снимке-состояния.md | 36 -- ...мков-состояния-диска.md | 35 -- ...ции-о-событии-системы.md | 45 -- ...сех-событиях-системы.md | 49 -- ...ным-событием-системы.md | 38 -- ...ормации-о-кластере-k8s.md | 143 ----- ...ных-машинах-кластера.md | 49 -- ...-о-списке-кластеров-k8s.md | 98 ---- ...даленных-кластеров-k8s.md | 117 ---- ...-воркеров-кластера-k8s.md | 70 --- ...керов-кластера-Kubernetes.md | 41 -- ...-воркеров-кластера-k8s.md | 63 --- ...-информации-о-всех-k8ci.md | 91 --- ...мации-об-удаленных-k8ci.md | 79 --- ...чение-информации-о-k8ci.md | 44 -- ...авилам-affinity-и-anti-affinity.md | 45 -- ...ии-о-аудитах-компьюта.md | 33 -- ...ке-загрузки-компьюта.md | 29 - ...ии-о-аудитах-компьюта.md | 32 -- ...е-url-консоли-компьюта.md | 29 - ...гов-по-заданному-пути.md | 31 -- ...ии-о-списке-компьютов.md | 249 --------- ...-удаленных-компьютов.md | 235 -------- ...й-миграции-хранилища.md | 29 - ...а-устройств-с-шиной-PCI.md | 77 --- ...орвардингов-компьюта.md | 37 -- ...ользовании-снапшотов.md | 43 -- ...ние-списка-снапшотов.md | 39 -- ...льзователях-компьюта.md | 41 -- ...рафических-устройств.md | 68 --- ...ней-сети-по-умолчанию.md | 27 - ...утов-для-внешней-сети.md | 36 -- ...рута-для-внешней-сети.md | 39 -- ...-Terraform-провайдера-DECORT.md | 2 - ...овательская-группа-API.md | 1 - ...ми-машинами-на-базе-KVM.md | 493 ----------------- ...-ресурсными-группами.md | 168 ------ ...-дисковыми-ресурсами.md | 187 ------- ...-сетевыми-сегментами.md | 462 ---------------- ...правление-снапшотами.md | 39 -- ...ение-кластером-kubernetes.md | 517 ------------------ ...ение-worker-groups-кластера.md | 179 ------ ...-виртуальным-образом.md | 92 ---- ...age-управление-образом.md | 167 ------ ...виртуальных-серверов.md | 61 --- ...управление-аккаунтом.md | 265 --------- ...ние-базовым-сервисом.md | 121 ---- ...пой-базового-сервиса.md | 148 ----- ...нсировщиком-нагрузки.md | 132 ----- ...нсировщиком-нагрузки.md | 56 -- ...нсировщиком-нагрузки.md | 55 -- ...нсировщиком-нагрузки.md | 99 ---- ...нсировщиком-нагрузки.md | 86 --- ...вление-снимком-диска.md | 53 -- ...ие-плавающей-группой.md | 98 ---- ...ение-control-plane-кластера.md | 290 ---------- ...-статическими-путями.md | 62 --- ...истративная-группа-API.md | 1 - ...равление-устройством.md | 65 --- ...ение-конфигурацией-sep.md | 385 ------------- ...-decort_cb_sep-управление-sep.md | 434 --------------- ...правление-cdrom-образом.md | 119 ---- ...управление-аккаунтом.md | 233 -------- ...-виртуальным-образом.md | 108 ---- ...age-управление-образом.md | 127 ----- ...ение-worker-groups-кластера.md | 94 ---- ...ение-кластером-kubernetes.md | 261 --------- ...ми-машинами-на-базе-KVM.md | 462 ---------------- ...-сетевыми-сегментами.md | 378 ------------- ...-дисковыми-ресурсами.md | 155 ------ ...-ресурсными-группами.md | 152 ----- ...ение-внешними-сетями.md | 269 --------- ...ие-плавающей-группой.md | 91 --- ...нсировщиком-нагрузки.md | 160 ------ ...ансировщика-нагрузки.md | 101 ---- ...нсировщиком-нагрузки.md | 87 --- ...нсировщиком-нагрузки.md | 58 -- ...нсировщиком-нагрузки.md | 55 -- ...м-для-внутренней-сети.md | 46 -- ...вление-снимком-диска.md | 44 -- ...ecort_cb_k8ci-управление-k8ci.md | 127 ----- ...утом-для-внешней-сети.md | 46 -- 08.-Полезные-советы.md | 44 -- Home.md | 281 +--------- exp/exp.md | 0 260 files changed, 3 insertions(+), 24044 deletions(-) delete mode 100644 01.-Введение.md delete mode 100644 02.-Пример-работы.md delete mode 100644 03.-Обзор-облачной-платформы-DECORT.md delete mode 100644 04.-Начало-работы-с-terraform-провайдером-DECORT.md delete mode 100644 04.01-Установка-Terraform-провайдера-DECORT.md delete mode 100644 04.02-Инициализация-Terraform-провайдера-DECORT.md delete mode 100644 04.03-Переключение-между-группами-API.md delete mode 100644 04.04-Получение-gid-или-grid_id.md delete mode 100644 04.05-Сборка-terraform-провайдера-в-образ.md delete mode 100644 05.-Работа-с-terraform.md delete mode 100644 05.01-Импортирование-ресурсов.md delete mode 100644 05.02-Работа-с-таймаутами.md delete mode 100644 05.03-Восстановление-ресурсов.md delete mode 100644 05.04-Массовое-создание-ресурсов.-Мета-аргументы.md delete mode 100644 05.05-Удаление-ресурсов.md delete mode 100644 05.06-Установка-Terraform.md delete mode 100644 05.07-Миграция-k8s-кластеров-на-версию-4.2.0.md delete mode 100644 06.-Data-source-функции-Terraform-провайдера-DECORT.md delete mode 100644 06.01-Пользовательская-группа-API.md delete mode 100644 06.01.01-Data-функция-decort_kvmvm-получение-информации-о-виртуальной-машине-на-базе-KVM.md delete mode 100644 06.01.02-Data-функция-decort_resgroup-получение-информации-о-ресурсной-группе.md delete mode 100644 06.01.03-Data-функция-decort_disk-получение-информации-о-диске.md delete mode 100644 06.01.04-Data-функция-decort_vins-получение-информации-о-ViNS.md delete mode 100644 06.01.05-Data-функция-decort_account-получение-информации-об-аккаунте.md delete mode 100644 06.01.06-Data-функция-decort_image_list-получение-информации-об-образах.md delete mode 100644 06.01.07-Data-функция-decort_image-получение-информации-об-образе.md delete mode 100644 06.01.08-Data-функция-decort_locations_list-получение-списка-доступных-площадок.md delete mode 100644 06.01.09-Data-функция-decort_location_url-получение-url-площадки.md delete mode 100644 06.01.10-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md delete mode 100644 06.01.11-Data-функция-decort_snapshot_list-получение-информации-о-snapshots.md delete mode 100644 06.01.12-Data-функция-decort_rg_list-получение-информации-о-всех-ресурсных-группах.md delete mode 100644 06.01.13-Data-функция-decort_disk_list-получение-информации-о-всех-дисках.md delete mode 100644 06.01.14-Data-функция-decort_vins_list-получение-информации-о-всех-виртуальных-сетях.md delete mode 100644 06.01.15-Data-функция-decort_extnet_list-получение-информации-о-всех-доступных-внешних-сетях.md delete mode 100644 06.01.16-Data-функция-decort_extnet_default-получение-информации-о-внешней-сети-по-умолчанию.md delete mode 100644 06.01.17-Data-функция-decort_extnet_computes_list-получение-информации-о-вычислительных-ресурсах,-использующих-внешнюю-сеть.md delete mode 100644 06.01.18-Data-функция-decort_extnet-получение-информации-о-внешней-сети.md delete mode 100644 06.01.19-Data-функция-decort_account_audits_list-получение-информации-о-запросах-аккаунта.md delete mode 100644 06.01.20-Data-функция-decort_account_computes_list-получение-информации-об-используемых-аккаунтом-экземплярах-computes.md delete mode 100644 06.01.21-Data-функция-decort_account_consumed_units-получение-информации-об-используемых-ресурсах-аккаунта.md delete mode 100644 06.01.22-Data-функция-decort_account_consumed_units_by_type-получение-информации-об-используемых-ресурсах-по-типу.md delete mode 100644 06.01.23-Data-функция-decort_account_disks_list-получение-информации-об-используемых-аккаунтом-дисках.md delete mode 100644 06.01.24-Data-функция-decort_account_flipgroups_list-получение-информации-об-используемых-групп-с-плавающим-ip-адресом.md delete mode 100644 06.01.25-Data-функция-decort_account_reserved_units-получение-информации-о-зарезервированных-ресурсах-аккаунта.md delete mode 100644 06.01.26-Data-функция-decort_account_rg_list-получение-информации-о-ресурсных-группах-аккаунта.md delete mode 100644 06.01.27-Data-функция-decort_account_templates_list-получение-информации-о-шаблонах-аккаунта.md delete mode 100644 06.01.28-Data-функция-decort_account_vins_list-получение-информации-о-всех-сетях-аккаунта.md delete mode 100644 06.01.29-Data-функция-decort_account_list-получение-информации-о-всех-доступных-аккаунтах.md delete mode 100644 06.01.30-Data-функция-decort_account_deleted_list-получение-информации-об-удаленных-аккаунтах.md delete mode 100644 06.01.31-Data-функция-decort_bservice_list-получение-информации-о-всех-доступных-базовых-сервисах.md delete mode 100644 06.01.32-Data-функция-decort_bservice_deleted_list-получение-информации-о-всех-удаленных-базовых-сервисах.md delete mode 100644 06.01.33-Data-функция-decort_bservice_snapshot_list-получение-информации-о-всех-доступных-снимках-состояния-сервиса.md delete mode 100644 06.01.34-Data-функция-decort_bservice-получение-информации-о-базовом-сервисе.md delete mode 100644 06.01.35-Data-функция-decort_bservice_group-получение-информации-о-вычислительной-группе-базового-сервиса.md delete mode 100644 06.01.36-Data-функция-decort_lb-получение-информации-о-балансировщике-нагрузки.md delete mode 100644 06.01.37-Data-функция-decort_lb_list-получение-информации-о-балансировщиках-нагрузки.md delete mode 100644 06.01.38-Data-функция-decort_lb_list_deleted-получение-информации-об-удаленных-балансировщиках-нагрузки.md delete mode 100644 06.01.39-Data-функция-decort_disk_list_types-получение-списка-типов-диска.md delete mode 100644 06.01.40-Data-функция-decort_disk_list_types_detailed-расширенное-получение-информации-о-поддерживаемых-типах-дисков.md delete mode 100644 06.01.41-Data-функция-decort_disk_list_deleted-получение-информации-об-удаленных-дисках.md delete mode 100644 06.01.42-Data-функция-decort_disk_list_unattached-получение-информации-о-неподключенных-дисках.md delete mode 100644 06.01.43-Data-функция-decort_disk_snapshot_list-получение-списка-снимков-состояния-диска.md delete mode 100644 06.01.44-Data-функция-decort_disk_snapshot-получение-информации-о-снимке-состояния.md delete mode 100644 06.01.45-Data-функция-decort_k8s-получение-информации-о-кластере-k8s.md delete mode 100644 06.01.46-Data-функция-decort_k8s_list-получение-информации-о-списке-кластеров-k8s.md delete mode 100644 06.01.47-Data-функция-decort_k8s_list_deleted-получение-информации-о-списке-удаленных-кластеров-k8s.md delete mode 100644 06.01.48-Data-функция-decort_k8s_wg-получение-информации-о-группе-воркеров-кластера-k8s.md delete mode 100644 06.01.49-Data-функция-decort_k8s_wg_list-получение-информации-о-списке-групп-воркеров-кластера-k8s.md delete mode 100644 06.01.50-Data-функция-decort_vins_audits-получение-информации-о-записи-аудита-для-указанного-vins.md delete mode 100644 06.01.51-Data-функция-decort_vins_ext_net_list-получение-информации-о-списке-внешних-сетей-для-указанного-vins.md delete mode 100644 06.01.52-Data-функция-decort_vins_ip_list-получение-информации-о-зарезервированных-ip-адресах-для-указанного-vins.md delete mode 100644 06.01.53-Data-функция-decort_vins_list_deleted-получение-информации-о-удаленных-виртуальных-сетях.md delete mode 100644 06.01.54-Data-функция-decort_vins_nat_rule_list-получение-информации-о-правилах-NAT-для-указанного-vins.md delete mode 100644 06.01.55-Data-функция-decort_kvmvm_audits-получения-информации-о-аудитах-компьюта.md delete mode 100644 06.01.56-Data-функция-decort_kvmvm_get_audits-получения-информации-о-аудитах-компьюта.md delete mode 100644 06.01.57-Data-функция-decort_kvmvm_get_console_url-получение-url-консоли-компьюта.md delete mode 100644 06.01.58-Data-функция-decort_kvmvm_get_log-получение-логов-по-заданному-пути.md delete mode 100644 06.01.59-Data-функция-decort_kvmvm_list-получение-информации-о-списке-компьютов.md delete mode 100644 06.01.60-Data-функция-decort_kvmvm_pfw_list-получение-информации-о-списке-порт-форвардингов-компьюта.md delete mode 100644 06.01.61-Data-функция-decort_kvmvm_user_list-получение-информации-о-пользователях-компьюта.md delete mode 100644 06.01.62-Data-функция-decort_rg_list-получение-информации-о-списке-ресурных-групп.md delete mode 100644 06.01.63-Data-функция-decort_rg_affinity_group_computes-получение-информации-о-компьютах-аффинити-группы.md delete mode 100644 06.01.64-Data-функция-decort_rg_affinity_groups_list-получение-информации-о-аффинити-группах.md delete mode 100644 06.01.65-Data-функция-decort_rg_affinity_groups_get-получение-информации-о-аффинити-группе.md delete mode 100644 06.01.66-Data-функция-decort_rg_audits-получение-информации-о-аудитах-ресурсной-группы.md delete mode 100644 06.01.67-Data-функция-decort_rg_list_computes-получение-информации-о-компьютах-ресурсной-группы.md delete mode 100644 06.01.68-Data-функция-decort_rg_list_deleted-получение-информации-о-списке-удаленных-ресурсных-групп.md delete mode 100644 06.01.69-Data-функция-decort_rg_list_lb-получение-информации-о-списке-lb.md delete mode 100644 06.01.70-Data-функция-decort_rg_list_pfw-получение-информации-о-списке-pfw.md delete mode 100644 06.01.71-Data-функция-decort_rg_list_vins-получение-информации-о-списке-vins.md delete mode 100644 06.01.72-Data-функция-decort_rg_usage-информация-об-использовании-rg.md delete mode 100644 06.01.73-Data-функция-decort_kvmvm_snapshot_usage-информация-об-использовании-снапшотов.md delete mode 100644 06.01.74-Data-функция-decort_k8s_computes-получение-информации-о-виртуальных-машинах-кластера.md delete mode 100644 06.01.75-Data-функция-decort_flipgroup-получение-информации-о-плавающей-группе.md delete mode 100644 06.01.75-Data-функция-decort_flipgroup_list-получение-информации-о-плавающих-группах.md delete mode 100644 06.01.76-Data-функция-decort_k8ci_list-получение-информации-о-k8ci.md delete mode 100644 06.01.77-Data-функция-decort_vins_static_route-получение-информации-о-статическом-пути.md delete mode 100644 06.01.78-Data-функция-decort_vins_static_route_list-получение-информации-о-списке-статических-путей.md delete mode 100644 06.01.79-Data-функция-decort_account_resource_consumption_get-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов.md delete mode 100644 06.01.80-Data-функция-decort_account_resource_consumption_list-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов.md delete mode 100644 06.01.81-Data-функция-decort_k8s_wg_cloud_init-получение-информации-об-предустановленных-настройках-группы-воркеров-кластера-Kubernetes.md delete mode 100644 06.01.82-Data-функция-decort_kvmvm_list_deleted-получение-информации-о-списке-удаленных-виртуальных-машин.md delete mode 100644 06.01.83-Data-функция-decort_kvmvm_pci_device_list-получение-информации-о-доступных-компьюту-списка-устройств-с-шиной-PCI.md delete mode 100644 06.01.84-Data-функция-decort_kvmvm_vgpu_list-получение-информации-о-доступных-компьюту-списка-виртуальных-графических-устройств.md delete mode 100644 06.01.85-Data-функция-decort_rg_resource_consumption_get-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов-по-конкретной-ресурсной-группе.md delete mode 100644 06.01.86-Data-функция-decort_rg_resource_consumption_list-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов-доступных-ресурсной-группе.md delete mode 100644 06.02-Административная-группа-API.md delete mode 100644 06.02.01-Data-функция-decort_cb_kvmvm-получение-информации-о-виртуальной-машине-на-базе-KVM.md delete mode 100644 06.02.02-Data-функция-decort_cb_rg-получение-информации-о-ресурсной-группе.md delete mode 100644 06.02.03-Data-функция-decort_cb_disk-получение-информации-о-диске.md delete mode 100644 06.02.04-Data-функция-decort_cb_vins-получение-информации-о-ViNS.md delete mode 100644 06.02.05-Data-функция-decort_cb_account-получение-информации-об-аккаунте.md delete mode 100644 06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах.md delete mode 100644 06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе.md delete mode 100644 06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md delete mode 100644 06.02.09-Data-функция-decort_cb_grid_list-получение-списков-доступных-платформ.md delete mode 100644 06.02.10-Data-функция-decort_cb_grid-получение-информации-о-grid.md delete mode 100644 06.02.100-Data-функция-decort_cb_account_resource_consumption_get-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов.md delete mode 100644 06.02.101-Data-функция-decort_cb_account_resource_consumption_list-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов.md delete mode 100644 06.02.11-Data-функция-decort_cb_pcidevice_list-получение-информации-о-всех-pcidevice.md delete mode 100644 06.02.12-Data-функция-decort_cb_pcidevice-получение-информации-о-pcidevice.md delete mode 100644 06.02.13-Data-функция-decort_vgpu-получение-информации-о-виртуальном-графическом-устройстве.md delete mode 100644 06.02.14-Data-функция-decort_cb_rg_list-получение-информации-о-всех-ресурсных-группах.md delete mode 100644 06.02.15-Data-функция-decort_cb_disk_list-получение-информации-о-всех-дисках.md delete mode 100644 06.02.16-Data-функция-decort_cb_vins_list-получение-информации-о-всех-виртуальных-сетях.md delete mode 100644 06.02.17-Data-функция-decort_cb_account_audits_list-получение-информации-о-запросах-аккаунта.md delete mode 100644 06.02.18-Data-функция-decort_cb_account_computes_list-получение-информации-об-используемых-аккаунтом-экземплярах-computes.md delete mode 100644 06.02.19-Data-функция-decort_cb_account_disks_list-получение-информации-об-используемых-аккаунтом-дисках.md delete mode 100644 06.02.20-Data-функция-decort_cb_account_flipgroups_list-получение-информации-об-используемых-групп-с-плавающим-ip-адресом.md delete mode 100644 06.02.21-Data-функция-decort_cb_account_rg_list-получение-информации-о-ресурсных-группах-аккаунта.md delete mode 100644 06.02.22-Data-функция-decort_cb_account_vins_list-получение-информации-о-всех-сетях-аккаунта.md delete mode 100644 06.02.23-Data-функция-decort_cb_account_list-получение-информации-о-всех-доступных-аккаунтах.md delete mode 100644 06.02.24-Data-функция-decort_cb_account_list_deleted-получение-информации-об-удаленных-аккаунтах.md delete mode 100644 06.02.25-Data-функция-decort_cb_sep_config-получение-информации-о-конфигурации-sep.md delete mode 100644 06.02.26-Data-функция-decort_cb_sep_consumption-получение-информации-о-загрузке-sep.md delete mode 100644 06.02.27-Data-функция-decort_cb_sep_disk_list-получение-информации-о-дисках,-используемых-sep.md delete mode 100644 06.02.28-Data-функция-decort_cb_sep_list-получение-информации-о-всех-sep.md delete mode 100644 06.02.29-Data-функция-decort_cb_sep_pool-получение-информации-о-pool-sep.md delete mode 100644 06.02.30-Data-функция-decort_cb_sep-получение-информации-о-sep.md delete mode 100644 06.02.31-Data-функция-decort_cb_extnet-получение-информации-о-внешней-сети.md delete mode 100644 06.02.32-Data-функция-decort_cb_extnet_list-получение-информации-о-внешних-сетях.md delete mode 100644 06.02.33-Data-функция-decort_cb_stack-получение-информации-о-stack.md delete mode 100644 06.02.34-Data-функция-decort_cb_stack_list-получение-информации-о-stack_list.md delete mode 100644 06.02.35-Data-функция-decort_cb_flipgroup-получение-информации-о-группе-с-плавающим-ip-адресом.md delete mode 100644 06.02.36-Data-функция-decort_cb_flipgroup_list-получение-информации-о-всех-группах-с-плавающим-ip-адресом.md delete mode 100644 06.02.37-Data-функция-decort_cb_lb-получение-информации-о-балансировщике-нагрузки.md delete mode 100644 06.02.38-Data-функция-decort_cb_lb_list-получение-информации-о-балансировщиках-нагрузки.md delete mode 100644 06.02.39-Data-функция-decort_cb_lb_list_deleted-получение-информации-об-удаленных-балансировщиках-нагрузки.md delete mode 100644 06.02.40-Data-функция-decort_cb_grid_list_emails-получение-списков-email-адресов-пользователей.md delete mode 100644 06.02.41-Data-функция-decort_cb_grid_list_consumption-получение-потребленных-и-зарезервированных-ресурсов-во-всех-grid.md delete mode 100644 06.02.42-Data-функция-decort_cb_grid_get_consumption-получение-потребленных-и-зарезервированных-ресурсов-в-grid.md delete mode 100644 06.02.43-Data-функция-decort_cb_grid_get_status-проверка-статуса-активности-текущей-среды.md delete mode 100644 06.02.44-Data-функция-decort_cb_vins_list_deleted-получение-информации-о-всех-удаленных-виртуальных-сетях.md delete mode 100644 06.02.45-Data-функция-decort_cb_vins_nat_rule_list-получение-информации-о-правилах-переадресации-портов-для-сети-vins.md delete mode 100644 06.02.46-Data-функция-decort_cb_vins_ext_net_list-получение-информации-о-внешних-сетях-vins.md delete mode 100644 06.02.47-Data-функция-decort_cb_vins_ip_list-получение-резервированных-ip-адресов-dhcp-на-внутренней-сети-vins.md delete mode 100644 06.02.48-Data-функция-decort_cb_vins_static_route_list-получение-списка-статических-маршрутов-для-внутренней-сети-vins.md delete mode 100644 06.02.49-Data-функция-decort_cb_vins_static_route-получение-статического-маршрута-для-внутренней-сети-vins.md delete mode 100644 06.02.50-Data-функция-decort_cb_vins_audits-получение-записей-аудита-для-внутренней-сети-vins.md delete mode 100644 06.02.51-Data-функция-decort_cb_rg_affinity_group_computes-получение-информации-о-компьютах-аффинити-группы.md delete mode 100644 06.02.52-Data-функция-decort_cb_rg_affinity_groups_get-получение-информации-о-аффинити-группе.md delete mode 100644 06.02.53-Data-функция-decort_cb_rg_affinity_groups_list-получение-информации-о-аффинити-группах.md delete mode 100644 06.02.54-Data-функция-decort_cb_rg_audits-получение-информации-о-аудитах-ресурсной-группы.md delete mode 100644 06.02.55-Data-функция-decort_cb_rg_resource_consumption_get-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов-по-конкретной-ресурсной-группе.md delete mode 100644 06.02.56-Data-функция-decort_cb_rg_resource_consumption_list-получение-информации-о-количестве-потребляемых-и-зарезервированных-ресурсов-доступных-ресурсной-группе.md delete mode 100644 06.02.57-Data-функция-decort_cb_rg_usage-информация-об-использовании-rg.md delete mode 100644 06.02.58-Data-функция-decort_cb_rg_list_computes-получение-информации-о-компьютах-ресурсной-группы.md delete mode 100644 06.02.59-Data-функция-decort_cb_rg_list_deleted-получение-информации-о-списке-удаленных-ресурсных-групп.md delete mode 100644 06.02.60-Data-функция-decort_cb_rg_list_lb-получение-информации-о-списке-lb.md delete mode 100644 06.02.61-Data-функция-decort_cb_rg_list_pfw-получение-информации-о-списке-pfw.md delete mode 100644 06.02.62-Data-функция-decort_cb_rg_list_vins-получение-информации-о-списке-vins.md delete mode 100644 06.02.63-Data-функция-decort_cb_disk_list_deleted-получение-информации-об-удаленных-дисках.md delete mode 100644 06.02.64-Data-функция-decort_cb_disk_list_types-получение-списка-типов-диска.md delete mode 100644 06.02.65-Data-функция-decort_cb_disk_list_types_detailed-расширенное-получение-информации-о-поддерживаемых-типах-дисков.md delete mode 100644 06.02.66-Data-функция-decort_cb_disk_list_unattached-получение-информации-о-неподключенных-дисках.md delete mode 100644 06.02.67-Data-функция-decort_cb_disk_snapshot-получение-информации-о-снимке-состояния.md delete mode 100644 06.02.68-Data-функция-decort_cb_disk_snapshot_list-получение-списка-снимков-состояния-диска.md delete mode 100644 06.02.69-Data-функция-decort_cb_audit-получение-информации-о-событии-системы.md delete mode 100644 06.02.70-Data-функция-decort_cb_audit_list-получение-информации-о-всех-событиях-системы.md delete mode 100644 06.02.71-Data-функция-decort_cb_audit_linked_jobs-получение-списка-заданий-связанных-с-указанным-событием-системы.md delete mode 100644 06.02.72-Data-функция-decort_cb_k8s-получение-информации-о-кластере-k8s.md delete mode 100644 06.02.73-Data-функция-decort_cb_k8s_computes-получение-информации-о-виртуальных-машинах-кластера.md delete mode 100644 06.02.74-Data-функция-decort_cb_k8s_list-получение-информации-о-списке-кластеров-k8s.md delete mode 100644 06.02.75-Data-функция-decort_cb_k8s_list_deleted-получение-информации-о-списке-удаленных-кластеров-k8s.md delete mode 100644 06.02.76-Data-функция-decort_cb_k8s_wg-получение-информации-о-группе-воркеров-кластера-k8s.md delete mode 100644 06.02.77-Data-функция-decort_cb_k8s_wg_cloud_init-получение-информации-об-предустановленных-настройках-группы-воркеров-кластера-Kubernetes.md delete mode 100644 06.02.78-Data-функция-decort_cb_k8s_wg_list-получение-информации-о-списке-групп-воркеров-кластера-k8s.md delete mode 100644 06.02.79-Data-функция-decort_cb_k8ci_list-получение-информации-о-всех-k8ci.md delete mode 100644 06.02.80-Data-функция-decort_cb_k8ci_list_deleted-получение-информации-об-удаленных-k8ci.md delete mode 100644 06.02.81-Data-функция-decort_cb_k8ci-получение-информации-о-k8ci.md delete mode 100644 06.02.82-Data-функция-decort_cb_kvmvm_affinity_relations-получение-словаря-ВМ-разделенного-по-правилам-affinity-и-anti-affinity.md delete mode 100644 06.02.83-Data-функция-decort_cb_kvmvm_audits-получения-информации-о-аудитах-компьюта.md delete mode 100644 06.02.84-Data-функция-decort_cb_kvmvm_boot_order_get-получение-информации-о-текущем-порядке-загрузки-компьюта.md delete mode 100644 06.02.85-Data-функция-decort_cb_kvmvm_get_audits-получения-информации-о-аудитах-компьюта.md delete mode 100644 06.02.86-Data-функция-decort_cb_kvmvm_get_console_url-получение-url-консоли-компьюта.md delete mode 100644 06.02.87-Data-функция-decort_cb_kvmvm_get_log-получение-логов-по-заданному-пути.md delete mode 100644 06.02.88-Data-функция-decort_cb_kvmvm_list-получение-информации-о-списке-компьютов.md delete mode 100644 06.02.89-Data-функция-decort_cb_kvmvm_list_deleted-получение-информации-о-списке-удаленных-компьютов.md delete mode 100644 06.02.90-Data-функция-decort_cb_kvmvm_migrate_storage_info-получение-информации-о-последней-миграции-хранилища.md delete mode 100644 06.02.91-Data-функция-decort_cb_kvmvm_pci_device_list-получение-информации-о-доступных-компьюту-списка-устройств-с-шиной-PCI.md delete mode 100644 06.02.92-Data-функция-decort_cb_kvmvm_pfw_list-получение-информации-о-списке-порт-форвардингов-компьюта.md delete mode 100644 06.02.93-Data-функция-decort_cb_kvmvm_snapshot_usage-информация-об-использовании-снапшотов.md delete mode 100644 06.02.94-Data-функция-decort_cb_kvmvm_snapshot_list-получение-списка-снапшотов.md delete mode 100644 06.02.95-Data-функция-decort_cb_kvmvm_user_list-получение-информации-о-пользователях-компьюта.md delete mode 100644 06.02.96-Data-функция-decort_cb_kvmvm_vgpu_list-получение-информации-о-доступных-компьюту-списка-виртуальных-графических-устройств.md delete mode 100644 06.02.97-Data-функция-decort_cb_extnet_default-получение-информации-о-внешней-сети-по-умолчанию.md delete mode 100644 06.02.98-Data-функция-decort_cb_extnet_static_route_list-получение-списка-статических-маршрутов-для-внешней-сети.md delete mode 100644 06.02.99-Data-функция-decort_cb_extnet_static_route-получение-статического-маршрута-для-внешней-сети.md delete mode 100644 07.-Resource-функции-Terraform-провайдера-DECORT.md delete mode 100644 07.01-Пользовательская-группа-API.md delete mode 100644 07.01.01-Resource-функция-decort_kvmvm-управление-виртуальными-машинами-на-базе-KVM.md delete mode 100644 07.01.02-Resource-функция-decort_resgroup-управление-ресурсными-группами.md delete mode 100644 07.01.03-Resource-функция-decort_disk-управление-дисковыми-ресурсами.md delete mode 100644 07.01.04-Resource-функция-decort_vins-управление-виртуальными-сетевыми-сегментами.md delete mode 100644 07.01.05-Resource-функция-decort_snapshot-управление-снапшотами.md delete mode 100644 07.01.06-Resource-функция-decort_k8s-управление-кластером-kubernetes.md delete mode 100644 07.01.07-Resource-функция-decort_k8s_wg-управление-worker-groups-кластера.md delete mode 100644 07.01.08-Resource-функция-decort_image_virtual-управление-виртуальным-образом.md delete mode 100644 07.01.09-Resource-функция-decort_image-управление-образом.md delete mode 100644 07.01.10-Resource-функция-decort_pfw-управление-правилами-трансляции-сетевых-портов-для-виртуальных-серверов.md delete mode 100644 07.01.11-Resource-функция-decort_account-управление-аккаунтом.md delete mode 100644 07.01.12-Resource-функция-decort_bservice-управление-базовым-сервисом.md delete mode 100644 07.01.13-Resource-функция-decort_bservice_group-управление-группой-базового-сервиса.md delete mode 100644 07.01.14-Resource-функция-decort_lb-управление-балансировщиком-нагрузки.md delete mode 100644 07.01.15-Resource-функция-decort_lb_frontend-управление-фронтендом-балансировщиком-нагрузки.md delete mode 100644 07.01.16-Resource-функция-decort_lb_frontend_bind-управление-привязками-фронтенда-балансировщиком-нагрузки.md delete mode 100644 07.01.17-Resource-функция-decort_lb_backend-управление-бекендом-балансировщиком-нагрузки.md delete mode 100644 07.01.18-Resource-функция-decort_lb_backend_server-управление-сервером-бекендом-балансировщиком-нагрузки.md delete mode 100644 07.01.19-Resource-функция-decort_disk_snapshot-управление-снимком-диска.md delete mode 100644 07.01.20-Resource-функция-decort_flipgroup-управление-плавающей-группой.md delete mode 100644 07.01.21-Resource-функция-decort_k8s_cp-управление-control-plane-кластера.md delete mode 100644 07.01.22-Resource-функция-decort_vins_static_route-управление-статическими-путями.md delete mode 100644 07.02-Административная-группа-API.md delete mode 100644 07.02.01-Resource-функция-decort_cb_pcidevice-управление-устройством.md delete mode 100644 07.02.02-Resource-функция-decort_cb_sep_config-управление-конфигурацией-sep.md delete mode 100644 07.02.03-Resource-функция-decort_cb_sep-управление-sep.md delete mode 100644 07.02.04-Resource-функция-decort_cb_cdrom_image-управление-cdrom-образом.md delete mode 100644 07.02.06-Resource-функция-decort_cb_account-управление-аккаунтом.md delete mode 100644 07.02.07-Resource-функция-decort_cb_virtual_image-управление-виртуальным-образом.md delete mode 100644 07.02.08-Resource-функция-decort_cb_image-управление-образом.md delete mode 100644 07.02.09-Resource-функция-decort_cb_k8s_wg-управление-worker-groups-кластера.md delete mode 100644 07.02.10-Resource-функция-decort_cb_k8s_cp-управление-кластером-kubernetes.md delete mode 100644 07.02.11-Resource-функция-decort_cb_kvmvm-управление-виртуальными-машинами-на-базе-KVM.md delete mode 100644 07.02.12-Resource-функция-decort_cb_vins-управление-виртуальными-сетевыми-сегментами.md delete mode 100644 07.02.13-Resource-функция-decort_cb_disk-управление-дисковыми-ресурсами.md delete mode 100644 07.02.14-Resource-функция-decort_cb_rg-управление-ресурсными-группами.md delete mode 100644 07.02.15-Resource-функция-decort_cb_extnet-управление-внешними-сетями.md delete mode 100644 07.02.16-Resource-функция-decort_cb_flipgroup-управление-плавающей-группой.md delete mode 100644 07.02.17-Resource-функция-decort_cb_lb-управление-балансировщиком-нагрузки.md delete mode 100644 07.02.18-Resource-функция-decort_cb_lb_backend-управление-бекендом-балансировщика-нагрузки.md delete mode 100644 07.02.19-Resource-функция-decort_cb_lb_backend_server-управление-сервером-бекендом-балансировщиком-нагрузки.md delete mode 100644 07.02.20-Resource-функция-decort_cb_lb_frontend-управление-фронтендом-балансировщиком-нагрузки.md delete mode 100644 07.02.21-Resource-функция-decort_cb_lb_frontend_bind-управление-привязками-фронтенда-балансировщиком-нагрузки.md delete mode 100644 07.02.22-Resource-функция-decort_cb_vins_static_route-управление-статическим-маршрутом-для-внутренней-сети.md delete mode 100644 07.02.23-Resource-функция-decort_cb_disk_snapshot-управление-снимком-диска.md delete mode 100644 07.02.24-Resource-функция-decort_cb_k8ci-управление-k8ci.md delete mode 100644 07.02.25-Resource-функция-decort_cb_extnet_static_route-управление-статическим-маршрутом-для-внешней-сети.md delete mode 100644 08.-Полезные-советы.md delete mode 100644 exp/exp.md diff --git a/01.-Введение.md b/01.-Введение.md deleted file mode 100644 index f9be38e..0000000 --- a/01.-Введение.md +++ /dev/null @@ -1,7 +0,0 @@ -DECORT Terraform Provider позволяет управлять облачными ресурсами на платформе Digital Energy Cloud Orchestration Technology (DECORT) версии 3.7.x и выше посредством Terraform. - -С помощью данного провайдера можно организовать программное управление вычислительными ресурсами (_compute_), ресурсными группами, сетевыми и дисковыми ресурсами, образами дисков, кластером, а также другими параметрами облачной платформы DECORT. - -Если вы хорошо знакомы с инструментом Terraform и хотите максимально быстро начать использовать платформу DECORT в своих Terraform-проектах, то можете сразу перейти к разделу [Пример работы](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/02.-Пример-работы), где приведён подробно откомментированный пример работы с основными видами ресурсов платформы. Если у вас всё же возникнут вопросы по облачной платформе DECORT и порядку авторизации в ней, то обратитесь к главе [«Обзор облачной платформы DECORT»](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/03.-Обзор-облачной-платформы-DECORT). Также может оказаться полезной глава [«Инициализация Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT). - -Если вы только начинаете использовать инструмент Terraform и облачную платформу DECORT, то рекомендуем вам начать с главы [«Обзор облачной платформы DECORT»](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/03.-Обзор-облачной-платформы-DECORT), после чего изучить главы [«_Data source_ функции Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.-Data-source-функции-Terraform-провайдера-DECORT) и [«_Resource_ функции Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/07.-Resource-функции-Terraform-провайдера-DECORT). Примеры, приведенные в этих разделах, помогут вам быстро освоить базовые приёмы работы с инструментом Terraform и провайдером DECORT. diff --git a/02.-Пример-работы.md b/02.-Пример-работы.md deleted file mode 100644 index 748ee84..0000000 --- a/02.-Пример-работы.md +++ /dev/null @@ -1,92 +0,0 @@ -Данный раздел предназначен для тех, кто хорошо знаком с инструментом Terraform, а также имеет представление об основных понятиях и способах авторизации в облачной платформе DECORT. - -Ниже приведён подробно откомментированный пример, показывающий, как создать виртуальный сервер (aka _compute_ на базе системы виртуализации KVM x86) в облачной платформе DECORT с помощью соответствующего Terraform провайдера. Сервер будет создан в новой ресурсной группе, к нему будет подключён один предварительно созданный диск, у сервера будет прямое сетевое подключение во внешнюю сеть. - -Идентификатор образа операционной системы, на базе которого должен быть создан виртуальный сервер, считывается из облачной платформы с помощью _data source_ функции `decort_image`. - -Далее мы с помощью _resource_ функции `decort_resgroup` создаём новую ресурсную группу, в которую будет помещён этот виртуальный сервер. В качестве альтернативы, для получения информации об уже имеющейся ресурсной группе можно использовать _data source_ функцию с таким же названием. - -Затем с помощью _resource_ функции `decort_disk` создаётся диск, который будет подключён к виртуальному серверу в качестве дополнительного. Помимо этого дополнительного диска у сервера будет также и загрузочный диск, на который в процессе создания сервера клонируется выбранный образ операционной системы. - -Виртуальный сервер - в данном примере на базе системы виртуализации KVM x86 - создаётся посредством _resource_ функции `decort_kvmvm`. - -Только авторизованные в контроллере облачной платформы пользователи могут управлять облачными ресурсами. Подробнее о способах авторизации см. [Обзор облачной платформы DECORT](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/03.-Обзор-облачной-платформы-DECORT). - -```terraform -# 1. Initialize DECORT plugin and connection to DECORT cloud controller -# NOTE: in this example credentials are expected to come from -# DECORT_APP_ID and DECORT_APP_SECRET environmental variables - set them -# in the shell before calling terraform. -# Alternatively you may define plugin parameters app_id and app_secret in -# the TF file, however, this may not be secure if you plan to share this TF -# file with others. - -provider "decort" { - authenticator = "decs3o" - controller_url = "<>" # specify correct DECORT controller URL, e.g. "https://ds1.digitalenergy.online" - oauth2_url = "<>" # specify corresponding DECORT SSO URL, e.g. "https://sso.digitalenergy.online" - app_id = "<>" # application secret to access DECORT cloud API in 'decs3o' and 'bvs' authentication mode, e.g. "ewqfrvea7s890avw804389qwguf234h0otfi3w4eiu" - app_secret = "<>" # application ID to access DECORT cloud API in 'decs3o' and 'bvs' authentication mode, e.g. "ewqfrvea7s890avw804389qwguf234h0otfi3w4eiu" - # allow_unverified_ssl = true -} - -# 2. Load account to use - new VM will belong to this account -data "decort_account" "my_account" { - account_id = # Specify account ID -} - -# 3. Load OS image to use for VM deployment -data "decort_image" "os_image" { - image_id = # Specify OS image id, e.g. 1234. You can get accessible image id from data source "decort_image_list" -} - -# 4. Create new Resource Group in the selected account, new VM will be created in this RG -resource "decort_resgroup" "my_rg" { - name = "NewRgByTF" - account_id = data.decort_account.my_account.account_id - gid = # Grid (platform) ID - # if you want to set resource quota on this Resource Group, uncomment - # the following code fragment - # quota { - # cpu = 8 # CPU limit - # ram = 8912 # RAM limit in MB - # disk = 96 # disk volume limit in GB - #} -} - -# 5. Create extra disk, which will be attached to the new VM. -# This step is optional - if you do not want extra disks on your VM, skip it -# and comment out extra_disks parameter when creating VM below. -resource "decort_disk" "extra_disk" { - disk_name = "extra-disk-for-vm" - account_id = data.decort_account.my_account.account_id - gid = # Grid (platform) ID - size_max = 5 # disk size in GB - type = "D" # disk type, always use "D" for extra disks - sep_id = data.decort_image.os_image.sep_id # use the same SEP ID as the OS image - pool = "<>" # consult your DECORT platform admin for configured storage pool names -} - -# 6. Create virtual machine (a compute of type KVM VM x86 in this example) -# Now that we have all necessary components at hand, we may create a virtual machine. -# This VM will be based on the previsouly obtained OS image, located in the specified -# Resource Group, directly connected to an external network, have a boot disk of -# specified size and one extra disk attached. -resource "decort_kvmvm" "my_new_vm" { - name = "tf-managed-vm" - driver = "KVM_X86" # Compute virtualization driver - rg_id = decort_resgroup.my_rg.id - cpu = 1 # CPU count - ram = 1024 # RAM size in MB, must be even number, ideally a power of 2 - boot_disk_size = 10 # Boot disk size in GB - image_id = data.decort_image.os_image.image_id - description = "Test KVM VM Compute managed by Terraform" - extra_disks = [ decort_disk.extra_disk.id ] - - network { - net_type = "EXTNET" - net_id = <> # specify external network ID to use, consult your DECORT platform admin for correct IDs - # ip_address = "<>" # you may optionally request a specific IP address - } -} -``` diff --git a/03.-Обзор-облачной-платформы-DECORT.md b/03.-Обзор-облачной-платформы-DECORT.md deleted file mode 100644 index 938223a..0000000 --- a/03.-Обзор-облачной-платформы-DECORT.md +++ /dev/null @@ -1,31 +0,0 @@ -## Основные понятия -Ниже перечислены основные понятия с указанием соответствующих им аргументов в Terraform провайдере DECORT. -1. **Контроллер облачной платформы DECORT** – управляющее приложение, которое обеспечивает авторизацию пользователей и оркестрацию облачных ресурсов. - - Адрес контроллера задается в обязательном аргументе `controller_url` на стадии инициализации Terraform провайдера DECORT. Например, `controller_url= "https://ds1.digitalenergy.online"` -2. **Авторизационный провайдер** – приложение, работающее по протоколу Oauth2, предназначенное для выпуска и валидации токенов доступа к контроллеру облачной платформы в соответствующих режимах авторизации. Все действия в платформе должны выполняться авторизованными пользователями, и авторизационное приложение позволяет получить токен доступа, действующий некоторое ограниченное время, наличие которого подтверждает успешную авторизацию. - - Адрес авторизационного провайдера задается в аргументе`oauth2_url` на стадии инициализации Terraform провайдера DECORT. Например `oauth2_url= "https://sso.digitalenergy.online"` -3. **Подписчик** (_account_) – сущность, которая используется для группирования облачных ресурсов по принадлежности к определенному клиенту для целей учета потребления и биллинга. - - Имя подписчика задается аргументом `account_name` при вызове _resource_ или _data_ функций провайдера. Альтернативной является задание численного идентификатора подписчика в аргументе `account_id`. -4. **Пользователь** (_user_) – пользователь облачной инфраструктуры, представленный учетной записью. Чтобы получить возможность управлять облачными ресурсами (например, создавать виртуальные серверы или дискт) пользователь должен быть ассоциирован с одним или несколькими подписчиками и иметь соответствующие права, определяемые ролевой моделью, принятой в облачной платформе DECORT. Для доступа к платформе пользователь должен авторизоваться одним из способов, описанных ниже в разделе «Способы авторизации». -5. **Ресурсная группа** (_resource group_) – способ группирования вычислительных ресурсов (например, виртуальных серверов по функциональному признаку или принадлежности к одному и тому же проекту). Ресурсную группу можно рассматривать как небольшой персональный дата-центр, в котором размещаются один или несколько серверов и виртуальных сетевых сегментов. Ресурсная группа идентифицируется по комбинации параметров `account` и `name`. Обратите внимание, что имя имя ресурсной группы уникально только в рамках одного и того же `account`. -6. **Вычислительный ресурс** (_compute_) - универсальная абстракция пользовательского сервера в платформе DECORT. Благодаря использованию такой абстракции можно, например, создать одну виртуальную машину на базе KVM Intel x86, а другую - на базе KVM IBM Power, а потом управлять ими - изменять количество CPU/RAM, подключать/отключать диски и т.п. - одинаковым образом, не задумываясь об их архитектурных различиях. В то же время, так как типизация ресурсов в Terraform не поддерживает наследование, различные типы вычислительных ресурсов, доступных на платформе DECORT и абстрагируемых через понятие унифицированный _compute_, в Terraform представлены разными типами (напр., свой тип для виртуальных серверов на базе KVM и свой тип для перспективных x86-совместимых bare metal серверов). -7. **Ресурс хранения** (_disk_) - универсальная абстракция дискового ресурса в платформе DECORT. Платформа поддерживает различные типы систем хранения данных, но при этом управление созданными на разных системах хранения дисками осуществляется посредством унифицированного набора действий, например, "подключить диск к _compute_", "увеличить размер диска", "сделать мгновенный снимок диска", "настроить параметры быстродействия диска". -8. **Виртуальный сервер** – экземпляр _compute_, в основе технической реализации которого лежит виртуальная машина, работающая в облаке DECORT и доступна по сети. Виртуальный сервер характеризуется количеством выделенных ему CPU (аргумент`cpu`), объемом ОЗУ (`ram`), размером загрузочного диска (`boot_disk size`). При создании виртуального сервера на загрузочный диск устанавливается образ операционной системы, заданный в аргументе `image_id`. Помимо загрузочного диска к виртуальному серверу можно подключить несколько дисков для хранения прикладных данных, список которых задается аргументами `extra_disks`. Виртуальный сервер идентифицируется по комбинации аргументов `name` (имя сервера) и `rgid` (идентификатор ресурсной группы). Обратите внимание, что имя виртуального сервера `name` уникально только в рамках одной и той же ресурсной группы. -9. **Виртуальный сетевой сегмент** (_Virtual Network Segment_ или _ViNS_) - сетевой сегмент и обеспечивающая его функционирование виртуальная инфраструктура, которые пользователь может создавать для своих нужд на уровне ресурсной группы или подписчика (_account_). ViNS можно создать полностью изолированным от внешних сетей (см. ниже _External Network_) или с подключением во внешнюю сеть. Внутри ViNS работает DHCP-сервис, обеспечивающий управление IP адресами экземпляров _compute_, подключённых в этот ViNS. -10. **Внешняя сеть** (_External Network_) - сетевой сегмент, через который платформа DECORT взаимодействует с внешними по отношению к ней сетевыми ресурсами. Например, в случае с публичным облаком на базе DECORT в качестве внешней сети выступает сеть Интернет. В отличие от ViNS платформа не управляет внешней сетью, а лишь пользуется её ресурсами. В платформе может быть настроено несколько внешних сетей с различными диапазонами IP адресов, и существует механизм управления доступом пользователей к внешним сетям. -11. Сетевой доступ к экземпляру _compute_ (виртуальному серверу) реализуется через его подключение к ViNS и/или прямое подключение во внешнюю сеть (External Network). Один и тот же экземпляр _compute_ может одновременно иметь несколько подключений в разные ViNS и/или различные внешние сети. - -## Способы авторизации -Облачная платформа DECORT поддерживает три базовых типа авторизации: -1. С использованием авторизационного провайдера, работающего по протоколу _Oauth2_. Данный способ является предпочтительным, так как обеспечивает бОльшую гибкость и безопасность. Для авторизации в этом режиме при инициализации Terrafrom провайдера DECORT необходимо указать параметры `oauth2_url` и `controller_url`, а также предоставить одно из нижеперечисленного: - - Комбинация Application ID & Application secret, соответствующих пользователю, от имени которого будет осуществляться управление облачными ресурсами в текущей сессии. В процессе проверки предоставленных Application ID & Application secret модуль получает от авторизационного провайдера токен (JSON Web Token, JWT), который затем используется для доступа к указанному контроллеру DECORT. Для авторизации по данному варианту, при инициализации Terraform провайдера DECORT следует установить аргумент `authenticator=decs3o` и задать аргументы `app_id` и `app_secret` (или определить соответствующие переменные окружения `DECORT_APP_ID` и `DECORT_APP_SECRET`). - - JSON Web Token – заранее полученный от авторизационного провайдера токен доступа, ассоциированный с определенным пользователем, от имени которого будет осуществляться управление облачными ресурсами в текущей сессии. Для авторизации по данному варианту, при инициализации Terraform провайдера DECORT следует установить аргумент `authenticator=jwt` и задать аргумент `jwt` (или определить переменную окружения `DECORT_JWT`). -2. С использованием комбинации _имя пользователя : пароль_. Данный режим не использует внешних авторизационных провайдеров и подразумевает, что пользователь с такой комбинацией зарегистрирован непосредственно на указанном в параметре `controller_url` контроллере облачной платформы DECORT. - - Чтобы провайдер авторизовался по данному варианту, при его инициализации следует установить аргумент `authenticator=legacy` и задать аргументы `user` и `password` (или определить соответствующие переменные окружения `DECORT_USER` и `DECORT_PASSWORD`). -3. С использованием авторизационного провайдера, работающего по протоколу _Oauth2_oidc_. Для авторизации в этом режиме при инициализации Terrafrom провайдера DECORT необходимо указать параметры `oauth2_url` и `controller_url`, а также Application ID & Application secret, _имя пользователя и пароль_, соответствующих пользователю, от имени которого будет осуществляться управление облачными ресурсами в текущей сессии, и _имя домена_. В процессе проверки предоставленных Application ID & Application secret и пары _имя пользователя-пароль_ модуль получает от авторизационного провайдера токен (JSON Web Token, JWT), который затем используется для доступа к указанному контроллеру DECORT. Для авторизации по данному варианту, при инициализации Terraform провайдера DECORT следует установить аргумент `authenticator=bvs`, задать аргументы `app_id` и `app_secret` (или определить соответствующие переменные окружения `DECORT_APP_ID` и `DECORT_APP_SECRET`), `bvs_user` и `bvs_password` (или определить соответствующие переменные окружения `DECORT_BVS_USER` и `DECORT_BVS_PASSWORD`), а также указать `domain` (или определить соответствующие переменные окружения `DECORT_DOMAIN`). - -После успешной авторизации пользователь (или приложение-клиент) получает доступ к ресурсам, находящимся под управлением соответствующего DECORT контроллера. Доступ предоставляется в рамках подписчиков (_account_), с которыми ассоциирован данный пользователь (_user_), и в соответствии с присвоенными ему ролями. - -## Пользовательская и административная группы API -Пользовательская группа API - группа API платформы DECORT, которая позволяет выполнять операции с платформой с правами обычного пользователя. Покрывает большую часть задач. -Административная группа API - группа API платформы DECORT, которая позволяет выполнять операции с платформой с расширенными правами. Данные права подразумевают расширенный перечень операций над ресурсами, расширенный перечень ресурсов, расширенную информацию. Требуются права администратора для взаимодействия с этой группой API. diff --git a/04.-Начало-работы-с-terraform-провайдером-DECORT.md b/04.-Начало-работы-с-terraform-провайдером-DECORT.md deleted file mode 100644 index edaa664..0000000 --- a/04.-Начало-работы-с-terraform-провайдером-DECORT.md +++ /dev/null @@ -1,6 +0,0 @@ -Данный раздел описывает: -- Системные требования -- Установку провайдера -- Инициализацию провайдера -- Переключение режима работы между разными группами API -- Получение gid/grid_id площадки diff --git a/04.01-Установка-Terraform-провайдера-DECORT.md b/04.01-Установка-Terraform-провайдера-DECORT.md deleted file mode 100644 index 449b296..0000000 --- a/04.01-Установка-Terraform-провайдера-DECORT.md +++ /dev/null @@ -1,150 +0,0 @@ -## Системные требования - -Для запуска провайдера вам потребуется машина, на которой установлен Terraform. - -Кроме того, в связи с тем, что начиная с версии 0.12 Terraform изменил алгоритм поиска и инициализации локальных провайдеров, настройка данного провайдера для работы с Terraform 0.12 или более новыми версиями потребует выполнения ряда дополнительных действий. Подробнее см. [8.3 Настройка локального провайдера для работы с новыми версиями Terraform](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/08.-Полезные-советы#user-content-8-3-настройка-локального-провайдера-для-работы-с-новыми-версиями-terraform). - -## Установка -Начиная с версии провайдера `4.3.0` в релизном архиве находятся скрипты-инсталляторы. -Чтобы выполнить установку, необходимо: -1. Перейти по адресу: https://repository.basistech.ru/BASIS/terraform-provider-decort/releases -2. Выбрать необходимую версию провайдера подходящую под операционную систему. -3. Скачать архив. -4. Распаковать архив. -5. Выполнить скрипт установщика, `install.sh` или `install.bat` для Windows.
-*Для запуска `install.sh` не забудьте изменить права доступа к файлу* -```bash -chmod u+x install.sh -``` -6. Дождаться сообщения об успешной установке. Установщик выведет актуальный блок конфигурации провайдера, скопируйте его -```bash -DECORT provider version 4.3.0 has been successfully installed - -Copy this provider configuration to main.tf file: -terraform { - required_providers { - decort = { - version = "4.3.0" - source = "basis/decort/decort" - } - } -} -``` -7. После этого, создайте файл `main.tf` в рабочей директории, которая может находится в любом удобном для пользователя месте. -В данном примере, рабочая директория с файлом main.tf находится по пути: -```bash -~/work/tfdir/main.tf -``` -8. Вставьте в `main.tf` блок конфигурации провайдера, который был выведен на экран установщиком: -```terraform -terraform { - required_providers { - decort = { - version = "4.3.0" - source = "basis/decort/decort" - } - } -} -``` -9. Добавьте в файл блок с инициализацией провайдера. -```terraform -provider "decort" { - authenticator = "decs3o" - controller_url = "https://mr4.digitalenergy.online" - oauth2_url = "https://sso.digitalenergy.online" - allow_unverified_ssl = true -} -``` - -10. В консоли выполните команду -```bash -terraform init -``` - -11. В случае успешной установки, Terraform инициализирует провайдер и будет готов к дальнейшей работе. - -## Установка из релизов -Terraform провайдер DECORT имеет скомпилированные релизные версии, которые расположены по адресу: [Релизы](https://repository.basistech.ru/BASIS/terraform-provider-decort/releases). -Чтобы выполнить установку из релиза, необходимо: -1. Перейти по адресу: https://repository.basistech.ru/BASIS/terraform-provider-decort/releases -2. Выбрать необходимую версию провайдера подходящую под операционную систему. -3. Скачать архив. -4. Распаковать архив. -5. Полученный файл (в директории `bin/`) необходимо поместить: -Linux: -```bash -~/.terraform.d/plugins/${host_name}/${namespace}/${type}/${version}/${target} -``` -Windows: -```powershell -%APPDATA%\terraform.d\plugins\${host_name}\${namespace}\${type}\${version}\${target} -``` -Где: -- host_name - имя хоста, держателя провайдера, например, basis -- namespace - пространство имен хоста, например decort -- type - тип провайдера, может совпадать с пространством имен, например, decort -- version - версия провайдера, например 4.3.0 -- target - архитектура операционной системы, например windows_amd64 - -В примере ниже используется путь до провайдера на машине с ОС Linux: - -```bash -~/.terraform.d/plugins/basis/decort/decort/4.3.0/linux_amd64/tf-provider - ^ ^ ^ ^ ^ ^ - host_name | | | | | | - | | | | | - namespace | | | | | - | | | | - type | | | | - | | | - version | | | - | | - target | | - | - исполняемый файл | -``` - -6. После этого, создайте файл `main.tf` в рабочей директории, которая может находится в любом удобном для пользователя месте. -В данном примере, рабочая директория с файлом main.tf находится по пути: -```bash -~/work/tfdir/main.tf -``` -7. Добавьте в `main.tf` следующий блок -```terraform -terraform { - required_providers { - decort = { - version = "4.3.0" - source = "basis/decort/decort" - } - } -} -``` -В поле `version` указывается версия провайдера. -
-**ВНИМАНИЕ: Версии в блоке и в пути к исполняемому файлу провайдера должны совпадать!** - -В поле `source` помещается путь до репозитория с версией вида: - -```bash -${host_name}/${namespace}/${type} -``` - -**ВНИМАНИЕ: Версии в блоке и в пути к исполняемому файлу провайдера должны совпадать!** - -8. Добавьте в файл блок с инициализацией провайдера. -```terraform -provider "decort" { - authenticator = "decs3o" - controller_url = "https://mr4.digitalenergy.online" - oauth2_url = "https://sso.digitalenergy.online" - allow_unverified_ssl = true -} -``` - -9. В консоли выполните команду -```bash -terraform init -``` - -10. В случае успешной установки, Terraform инициализирует провайдер и будет готов к дальнейшей работе. diff --git a/04.02-Инициализация-Terraform-провайдера-DECORT.md b/04.02-Инициализация-Terraform-провайдера-DECORT.md deleted file mode 100644 index 0cf8d28..0000000 --- a/04.02-Инициализация-Terraform-провайдера-DECORT.md +++ /dev/null @@ -1,64 +0,0 @@ -## Список аргументов для инициализации -Перед началом использования любой Terraform провайдер должен быть инициализирован. - -В процессе инициализации Terraform провайдера DECORT проверяется корректность переданных аргументов и выполняется авторизация в указанном контроллере облачной инфраструктуры. Подробнее о способах авторизации в платформе DECORT смотри соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/03.-Обзор-облачной-платформы-DECORT#user-content-способы-авторизации). - -При инициализации Terraform провайдера DECORT используются следующие аргументы: - -| Аргумент | Переменная окружения | Описание | -| --- | --- | --- | -| allow_unverified_ssl | - | Если данный аргумент явно установлен в `true`, то провайдер **не будет** проверять SSL сертификаты при взаимодействии с авторизационным сервисом OAuth2 и контроллером облачной платформы.
Отключение проверок может быть полезным при работе в доверенной среде, использующей самоподписанные SSL сертификаты. Однако, так как отключение проверок несёт потенциальные риски безопасности, данную настройку следует использовать с осторожностью.
Разрешённые значения: `false` (значение по умолчанию) и `true`. | -| app_id | DECORT_APP_ID | Идентификатор приложения (клиента) для авторизации в контроллере облачной платформы в режиме `decs3o` или `bvs`.
Аргументы `app_id` и `app_secret` являются обязательными для режимов авторизации `authenticator=decs3o` и `authenticator=bvs`.
Если `app_id` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_APP_ID`. | -| app_secret | DECORT_APP_SECRET | Секретный код приложения (клиента) для авторизации в контроллере облачной платформы в режиме `decs3o` или `bvs`.
Аргументы `app_id` и `app_secret` являются обязательными для режимов авторизации `authenticator=decs3o` и `authenticator=bvs`.
Если `app_secret` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_APP_SECRET`. | -| authenticator | - | Режим авторизации при подключении к контроллеру облачной платформы.
Доступные режимы: `decs3o`, `legacy`, `jwt` или `bvs`.
Данный аргумент является обязательным. | -| bvs_user | DECORT_BVS_USER | Имя пользователя для авторизации в контроллере облачной платформы в режиме `bvs`.
Аргументы `bvs_password` и `bvs_user` являются обязательными для режима авторизации `authenticator=bvs`.
Если `bvs_user` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_BVS_USER`. | -| bvs_password | DECORT_BVS_PASSWORD | Пароль пользователя для авторизации в контроллере облачной платформы в режиме `bvs`.
Аргументы `bvs_user` и `bvs_password` являются обязательными для режима авторизации `authenticator=bvs`.
Если `bvs_password` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_BVS_PASSWORD`. | -| domain | DECORT_DOMAIN | Имя домена в контроллере облачной платформы в режиме `bvs`.
Данный аргумент является обязательным.
Если `domain` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_DOMAIN`. | -| controller_url | - | URL контроллера облачной платформы, через который будет осуществляться управление облачными ресурсами.
Данный аргумент является обязательным. | -| jwt | DECORT_JWT | JSON Web Token (JWT), который используется для авторизации в контроллере облачной платформы в режиме `jwt`.
Данный аргумент является обязательным для режима авторизации `authenticator=jwt`.
Если `jwt` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_JWT` | -| oauth2_url | DECORT_OAUTH2_URL | URL авторизационного сервиса OAuth2, который используется для управления доступом пользователей (или программных клиентов) к контроллеру облачной платформы.
Данный аргумент является обязательным для режимов авторизации `authenticator=decs3o`, `authenticator=bvs` и `authenticator=jwt`.
Если `oauth2_url` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_OAUTH2_URL` | -| password | DECORT_PASSWORD | Пароль для авторизации в контроллере облачной платформы в режиме `legacy`.
Аргументы `password` и `user` являются обязательными для режима авторизации `authenticator=legacy`.
Если `password` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_PASSWORD`. | -| user | DECORT_USER | Имя пользователя для авторизации в контроллере облачной платформы в режиме `legacy`.
Аргументы `user` и `password` являются обязательными для режима авторизации `authenticator=legacy`.
Если `user` не задан в tf-файле, то провайдер будет использовать значение из переменной окружения `DECORT_USER`. | - -## Пример инициализации в режиме авторизации `decs3o` -Пример инициализации Terraform провайдера DECORT: -```terraform -provider "decort" { - authenticator = "decs3o" - controller_url = "https://ctrl.decort.online" - oauth2_url = "https://oauth2.decort.online:7777" -} -``` - -В данном примере используется режим авторизации `decs3o`. - -Как отмечено выше, в данном режиме требуется указать аргументы `app_id` и `app_secret`, идентифицирующие пользователя (или приложение-клиент), от лица которого будут выполняться дальнейшие действия. Однако, так как данная информация является конфиденциальной (по сути, она эквивалентна паре _имя пользователя : пароль_), то в общем случае заносить такого рода данные в tf-файл не следует. Рекомендуется определять в среде запуска Terraform переменные окружения `DECORT_APP_ID` и `DECORT_APP_SECRET`, из которых провайдер извлечёт нужные данные. Приведенный пример подразумевает, что нужная информация будет получена из этих переменных окружения. - -Пользователь, от лица которого Terrafrom будет выполнять действия в облачной платформе, должен заранее создать пару _Application ID_ и _Application Secret_ в авторизационном приложении OAuth2. Именно эти значения, а также URL авторизационного приложения Oauth2, должны присваиваться аргументам `app_id`, `app_secret` и `oauth2_url` соответственно для успешной инициализации провайдера. - -Также обратите внимание на формат задания аргументов `controller_url` и `oauth2_url`. В общем случае они должны содержать идентификатор протокола (_https://_) и сетевой порт, если он отличается от порта по умолчанию (в примере для авторизационного сервиса OAuth2 указан порт _7777_). Эту информацию вы можете узнать у администратора вашей облачной инфраструктуры DECORT. - -## Пример инициализации в режиме авторизации `bvs` -Пример инициализации Terraform провайдера DECORT: -```terraform -provider "decort" { - authenticator = "bvs" - controller_url = "https://delta.qa.loc" - oauth2_url = "https://bvs-delta.qa.loc:8443" - app_id = "delta" - app_secret = "" - bvs_password = "" - bvs_user = "" - domain = "dynamix" -} -``` - -В данном примере используется режим авторизации `bvs`. - -Как отмечено выше, в данном режиме требуется указать аргументы `app_id` - идентификатор площадки - delta, alpha, poc, etc. Можно найти на странице администратора по следующему пути: вкладка безопасность - клиентские сервисы - наименование площадки. `app_secret` - пароль площадки. Можно найти на странице администратора по следующему пути: вкладка безопасность - клиентские сервисы - наименование площадки (символ i) - поле "Пароль". Однако, так как данная информация является конфиденциальной, то в общем случае заносить такого рода данные в tf-файл не следует. Рекомендуется определять в среде запуска Terraform переменные окружения `DECORT_APP_ID` и `DECORT_APP_SECRET`, из которых провайдер извлечёт нужные данные. Приведенный пример подразумевает, что нужная информация будет получена из этих переменных окружения. -Также обязательными аргументами являются: `bvs_user` - имя пользователя, `bvs_password` - пароль пользователя. Рекомендуется не заносить их в tf-файл, а определять в среде запуска Terraform переменные окружения `DECORT_BVS_USER` и `DECORT_BVS_PASSWORD`, из которых провайдер извлечёт нужные данные. Приведенный пример подразумевает, что нужная информация будет получена из этих переменных окружения. -Домен для подключения `domain` - указывается наименование площадки. Данный аргумент является обязательным. Рекомендуется не заносить его в tf-файл, а определять в среде запуска Terraform переменную окружения `DECORT_DOMAIN`, из которой провайдер извлечёт нужные данные. Приведенный пример подразумевает, что нужная информация будет получена из этих переменных окружения. - -Пользователь, от лица которого Terrafrom будет выполнять действия в облачной платформе, должен заранее получить от администратора _Application ID_ и _Application Secret_, _bvs user_ и _bvs password_, а также _domain_. А также осуществить первичный вход на платформу посредством браузера. - -Также обратите внимание на формат задания аргументов `controller_url` и `oauth2_url`. В общем случае они должны содержать идентификатор протокола (_https://_) и сетевой порт, если он отличается от порта по умолчанию (в примере для авторизационного сервиса OAuth2 указан порт _8443_). Эту информацию вы можете узнать у администратора вашей облачной инфраструктуры DECORT. diff --git a/04.03-Переключение-между-группами-API.md b/04.03-Переключение-между-группами-API.md deleted file mode 100644 index fb722ac..0000000 --- a/04.03-Переключение-между-группами-API.md +++ /dev/null @@ -1,38 +0,0 @@ -Так как платформа DECORT предоставляет для работы две группы API, то terraform провайдер позволяет свободно переключать режимы работы между этими группами. -По умолчанию стоит пользовательская группа API. Ее можно сменить на административную группу. -Если прав у пользователя будет достаточно, то запрос будет выполнен, если нет, то будет ошибка: -```bash -Permission denied -``` -Которая говорит о том, что прав недостаточно. Тогда для выполнения операции обратитесь к администратору платформы. -Установка режима взаимодействия с группами API осуществляется через установку переменной окружения _DECORT_ADMIN_MODE_. -Для более подробного описания возможностей каждой группы API см. соответствующий раздел. - -## Переключение режима работы в Windows -Используйте сл. команду: -```Powershell -$Env:DECORT_ADMIN_MODE=1 -``` -Для отключения: -```Powershell -$Env:DECORT_ADMIN_MODE=0 -``` -## Переключение режима работы в Linux -Используйте сл. команду: -```bash -DECORT_ADMIN_MODE=1 -``` -или -```bash -export DECORT_ADMIN_MODE=1 -``` -Для отключения: -```bash -DECORT_ADMIN_MODE=0 -``` -или -```bash -export DECORT_ADMIN_MODE=0 -``` -**ОБРАТИТЕ ВНИМАНИЕ** -Переменные окружения создаются для терминальной сессии. В сл. раз их придется задавать еще раз, если требуется режим, отличный от пользовательского. diff --git a/04.04-Получение-gid-или-grid_id.md b/04.04-Получение-gid-или-grid_id.md deleted file mode 100644 index 4b316ac..0000000 --- a/04.04-Получение-gid-или-grid_id.md +++ /dev/null @@ -1,31 +0,0 @@ -Платформа может располагаться на нескольких площадках(grid). -Такие площадки имеют свой id. -Для создания некоторых ресурсов требуется ввести grid_id или gid площадки. -Получение gid различается для пользовательского и административного API. - -## Получение gid для пользовательского API -Для получения gid с помощью пользовательского API, необходимо получить информацию из _data_source_ функции _decort_locations_list_, как указано ниже: -```terraform -data "decort_locations_list" "ll" { - -} - -output "test" { - value = data.decort_locations_list.ll -} -``` -В файл состояния будет сохранен результат, где можно посмотреть доступные для работы площадки. - -## Получение gid для административного API -Для получения gid с помощью административного API, необходимо получить информацию из _data_source_ функции _decort_grid_list_, как указано ниже: -```terraform -data "decort_grid_list" "gl" { - -} - -output "test" { - value = data.decort_grid_list.gl -} - -``` -В файл состояния будет сохранен результат, где можно посмотреть доступные для работы площадки. diff --git a/04.05-Сборка-terraform-провайдера-в-образ.md b/04.05-Сборка-terraform-провайдера-в-образ.md deleted file mode 100644 index 02bc8b7..0000000 --- a/04.05-Сборка-terraform-провайдера-в-образ.md +++ /dev/null @@ -1,43 +0,0 @@ -Образ приложения - современный способ запуска приложений. Образ приложения представляет собой контейнер, в который входит ОС и необходимые для работы приложения пакеты. -Способов создать образ приложения довольно много, для этого существуют программы контейнеризации: -- Docker -- Podman -- и другие -Образ представляет собой "зафиксированную" версию приложения, что означает, что никакие изменения в приложения внесены быть не могут. Так же означает то, что приложение не может создавать побочные файлы при работе. -Контейнер - это запущенный экземпляр образа. То есть, один образ может порождать множество контейнеров, каждый из которых будет включать в себя отдельный экземпляр приложения. -Одно из преимуществ работы приложения в контейнере - кроссплатформенность. Это преимущество обуславливается тем, что образ приложения уже включает в себя все необходимое для успешной работы приложения, в том числе операционную систему. Поэтому, пользователю достаточно установить на вычислительной машине программу, которая обеспечивает работу с образами приложений. - -## Docker -Docker является одной из самых популярных программ для работы с образами. -Docker позволяет: -- Создавать образы -- Запускать контейнеры -- Управлять контейнерами -- Управлять образами -Скачать и установить Docker можно по ссылке https://docs.docker.com/get-docker/ - -## Сборка terraform провайдера -### Требования: -- Docker -- git -- Компилятор языка GO -= make -### Установка необходимых программ -1. Компилятор языка GO можно скачать и установить по ссылке: https://go.dev/dl/ -2. Docker можно скачать и установить по ссылке выше. -3. Git можно скачать и установить по ссылке: https://git-scm.com/ -4. Программа make входит в пакет установленных программ для ОС Linux. Для Windows можно воспользоваться инструкцией со stack overflow: https://stackoverflow.com/questions/32127524/how-to-install-and-use-make-in-windows -### Порядок действий -1. Склонировать репозиторий с провайдером: -```bash -git clone https://github.com/rudecs/terraform-provider-decort.git -``` -2. Перейти в директорию со скачанным кодом: -```bash -cd terraform-provider-decort -``` -3. Выполнить команду: -```bash -make image -``` -В результате выполнения данной последовательности, будет создан docker образ, который содержит в себе приложение terraform, terraform провайдер. diff --git a/05.-Работа-с-terraform.md b/05.-Работа-с-terraform.md deleted file mode 100644 index 675f2ea..0000000 --- a/05.-Работа-с-terraform.md +++ /dev/null @@ -1,4 +0,0 @@ -Раздел описывает некоторые практики работы с terraform, которые могут быть полезны пользователю. -Раздел включает в себя следующие статьи: -- Импортирование ресурсов -- Работа с таймаутами diff --git a/05.01-Импортирование-ресурсов.md b/05.01-Импортирование-ресурсов.md deleted file mode 100644 index 8a419d3..0000000 --- a/05.01-Импортирование-ресурсов.md +++ /dev/null @@ -1,75 +0,0 @@ -Импортирование ресурсов в terraform позволяет привести в соответствие состояние terraform (.tfstate) к состоянию ресурса в платформе. -Необходимость такого приведения возникает в нескольких случаях: -- Ресурс был создан через портал платформы, работа продолжается через terraform провайдер, -- Ресурс был создан через terraform провайдер, однако был изменен через портал платформы, -- Ресурс был создан через terraform провайдер, однако был изменен другим пользователем через terraform провайдер, -- И так далее - -Такие расхождения в состоянии ресурсов нередки, путей их решения несколько: -- Использовать импортирование ресурсов, -- Использовать общие файлы состояний ресурсов, к которым будут иметь доступ все участники, занятые в работе с платформой. -В текущем разделе рассматривается первый вариант. - -## Импортирование ресурсов -Импортирование ресурсов позволяет совершить запрос к платформе, чтобы сформировать файл состояния. -Чтобы совершить импортирование ресурсов необходимо ввести сл. команду: -```bash -terraform import . -``` -## Пример -Предположим, что у нас ресурс, описывающий диск: -```terraform -resource "decort_disk" "disk" { - account_id = 121212 - gid = 3333 - disk_name = "mySuperDisk" - size_max = 100500 -} -``` -Если запустить команду: -```bash -terraform apply -``` -То у нас будет создан новый диск. -Но, такой диск уже есть на площадке и мы хотели бы сформировать .tfstate для этого ресурса. -Поэтому, для начала, необходимо получить список дисков: -```terraform -data "decort_disk_list" "dl"{ - -} -output "test" { - value = data.decort_disk_list.dl -} -``` -В полученных данных необходимо найти требуемый диск, получить его id - параметр disk_id. Пусть это будет - 777777 -Теперь можно выполнить импортирование: -```bash -terraform import decort_disk.disk 777777 -``` -Команда должна успешно завершиться, появиться файл состояний, который позволит манипулировать ресурсом. - -## Ошибки при импортировании -При импортировании ресурса может возникнуть сл. ошибка: -```bash -Error: : required field is not set -``` -Где - наименование поля. -Ошибка возникает в том случае, если в описании ресурса отсутствует обязательное поле. -Например: -```terraform -resource "decort_disk" "disk" { - account_id = 121212 - gid = 3333 - size_max = 100500 -} -``` -В приведенном выше описании отсутствует поле disk_name, поэтому, при попытке импортирования возникнет ошибка. -Для ее устранения, необходимо выполнить запрос на получение списка дисков, найти недостающее поле, после чего добавить его в описание ресурса. -После этого повторить попытку импортирования. - -## Общий алгоритм устранения ошибок -1. Выполнить запрос импортирования -2. В случае ошибки - внести недостающие поля. -3. Повторить п.1. - - diff --git a/05.02-Работа-с-таймаутами.md b/05.02-Работа-с-таймаутами.md deleted file mode 100644 index 9a739b4..0000000 --- a/05.02-Работа-с-таймаутами.md +++ /dev/null @@ -1,100 +0,0 @@ -Terraform провайдер DECORT поддерживает тонкую настройку таймаутов выполнения запросов к платформе. Таймауты необходимы для определения максимального времени выполнения запроса. При превышении этого времени соединение рвется и запрос считается невыполненным. -Таймауты применяются при работе с _resource_ функциями провайдера. _Data source_ функции по-умолчанию имеют таймаут в 20 минут и изменяться не может. - -## Стандартные таймауты terraform -| Операция | Время | Описание | -| --- | --- | --- | -| create | 20 минут | Создание ресурса | -| read | 20 минут | Чтение ресурса | -| update | 20 минут | Обновление ресурса | -| delete | 20 минут | Удаление ресурса | -| default | 20 минут | Значение по умолчанию. Устанавливает значение для всех операций | - -## Стандартные таймауты провайдера DECORT -В провайдере DECORT таймауты переопределены для того, чтобы уменьшить нагрузку на платформу. -| Операция | Время | Описание | -| --- | --- | --- | -| create | 10 минут | Создание ресурса | -| read | 5 минут | Чтение ресурса | -| update | 5 минут | Обновление ресурса | -| delete | 5 минут | Удаление ресурса | -| default | 5 минут | Значение по умолчанию. Устанавливает значение для всех операций | - -## Установка таймаутов -Все таймауты можно установить самостоятельно для каждого ресурса. -Для этого используется блок _timeouts_, который имеется в каждом ресурсе провайдера. -Пример: -```terraform -resource "decort_res" "res_name" { - timeouts { - create = "10m" - update = "1m" - delete = "2m" - read = "7m" - #default = "15m" - } -} -``` -Где: -- create - операция создания ресурса -- read - операция чтения ресурса -- update - операция обновления ресурса -- delete - операция удаления ресурса -- default - установит заданное время для всех операций -## Формат установления времени -Как видно из примера выше, провайдер принимает на вход строку вида: -``` -"" -``` -Где: -- time-num - число -- time-val - сокращенная запись значения временного отрезка. - -Таблица с временными отрезками: - -| Отрезок | Значение | -| --- | --- | -| n | наносекунда | -| ms | миллисекунда | -| s | секунда | -| m | минута | -| h | час | - -Примеры: -``` -"10m" -"1s" -"1h10m" -``` -И так далее - -## Работа с таймером через .tf-файл -В .tf-файле, в блоке ресурса можно задавать таймауты для операций над ресурсом, однако, при работе с таймаутом, следует помнить о правиле: -__В случае изменения таймаутов в .tf-файле, операции с новыми таймаутами будут производиться только после apply/plan/destroy__ -То есть, если изменить таймауты и выполнить операцию, то она выполнится со старыми таймаутами, а сл. операция уже будет выполнена с новыми таймаутами. -Это объясняется тем, что значения таймаутов считываются из файла состояний .tfstate при выполнении операции, и новые значения таймаутов попадут туда только при успешно выполненной операции. - -## Ошибки при работе с таймаутом -### context deadline exceeded -Если время таймаута слишком короткое, то можно получить сл. ошибку: -``` -context deadline exceeded -``` -Которая говорит, что было выполнено прерывание работы программы из-за истечения времени на операцию. -Для исправления можно увеличить размер окна таймаута и выполнить успешный запрос (например, с помощью терминала), чтобы новое значения таймаутов было добавлено в .tfstate. В противном случае, файл состояния придется править в ручную, либо удалить его и импортировать ресурс для формирования .tfstate. - -### 504 ошибка -Данная ошибка говорит о том, что сервер принудительно разорвал соединения из-за истечения времени на ответ. -В случае получения данной ошибки, обратитесь в службу технической поддержки. - -## Работа с таймаутами через терминал -Сл. команда выполнит операцию terraform с заданным таймаутом: -```bash -timeout