From 3e79c8073b79c69167b175e2663c1f400b3af520 Mon Sep 17 00:00:00 2001 From: asteam Date: Fri, 18 Jul 2025 16:24:52 +0300 Subject: [PATCH] 4.9.2 --- 4.9.2/01.-Введение.md | 7 + 4.9.2/02.-Пример-работы.md | 78 ++ ...лачной-платформы-DECORT.md | 30 + ...terraform-провайдером-DECORT.md | 6 + ...-Terraform-провайдера-DECORT.md | 149 +++ ...-Terraform-провайдера-DECORT.md | 64 + ...4-Получение-gid-или-grid_id.md | 31 + ...орка-terraform-провайдера.md | 34 + 4.9.2/05.-Работа-с-terraform.md | 4 + ...ортирование-ресурсов.md | 84 ++ ...02-Работа-с-таймаутами.md | 100 ++ ...становление-ресурсов.md | 27 + ...урсов.-Мета-аргументы.md | 436 +++++++ ...05.05-Удаление-ресурсов.md | 262 ++++ 4.9.2/05.06-Установка-Terraform.md | 41 + ...астеров-на-версию-4.2.0.md | 179 +++ ...-Terraform-провайдера-DECORT.md | 4 + ...овательская-группа-API.md | 1 + 4.9.2/06.01.01-Data_decort_kvmvm.md | 316 +++++ 4.9.2/06.01.02-Data_decort_resgroup.md | 100 ++ 4.9.2/06.01.03-Data_decort_disk.md | 123 ++ 4.9.2/06.01.04-Data_decort_vins.md | 292 +++++ 4.9.2/06.01.05-Data_decort_account.md | 116 ++ 4.9.2/06.01.06-Data_decort_image_list.md | 161 +++ 4.9.2/06.01.07-Data_decort_image.md | 88 ++ 4.9.2/06.01.08-Data_decort_locations_list.md | 79 ++ 4.9.2/06.01.09-Data_decort_location_url.md | 25 + 4.9.2/06.01.11-Data_decort_snapshot_list.md | 36 + 4.9.2/06.01.13-Data_decort_disk_list.md | 195 +++ 4.9.2/06.01.14-Data_decort_vins_list.md | 116 ++ 4.9.2/06.01.15-Data_decort_extnet_list.md | 96 ++ 4.9.2/06.01.16-Data_decort_extnet_default.md | 26 + ....01.17-Data_decort_extnet_computes_list.md | 78 ++ 4.9.2/06.01.18-Data_decort_extnet.md | 82 ++ ...6.01.19-Data_decort_account_audits_list.md | 38 + ...01.20-Data_decort_account_computes_list.md | 120 ++ ...1.21-Data_decort_account_consumed_units.md | 40 + ...a_decort_account_consumed_units_by_type.md | 48 + ...06.01.23-Data_decort_account_disks_list.md | 84 ++ ....24-Data_decort_account_flipgroups_list.md | 106 ++ ...1.25-Data_decort_account_reserved_units.md | 40 + 4.9.2/06.01.26-Data_decort_account_rg_list.md | 148 +++ ...1.27-Data_decort_account_templates_list.md | 86 ++ .../06.01.28-Data_decort_account_vins_list.md | 96 ++ 4.9.2/06.01.29-Data_decort_account_list.md | 89 ++ ....01.30-Data_decort_account_deleted_list.md | 83 ++ 4.9.2/06.01.31-Data_decort_bservice_list.md | 118 ++ ...01.32-Data_decort_bservice_deleted_list.md | 83 ++ ...1.33-Data_decort_bservice_snapshot_list.md | 35 + 4.9.2/06.01.34-Data_decort_bservice.md | 94 ++ 4.9.2/06.01.35-Data_decort_bservice_group.md | 86 ++ 4.9.2/06.01.36-Data_decort_lb.md | 111 ++ 4.9.2/06.01.37-Data_decort_lb_list.md | 183 +++ 4.9.2/06.01.38-Data_decort_lb_list_deleted.md | 169 +++ 4.9.2/06.01.39-Data_decort_disk_list_types.md | 47 + ...40-Data_decort_disk_list_types_detailed.md | 54 + .../06.01.41-Data_decort_disk_list_deleted.md | 154 +++ ....01.42-Data_decort_disk_list_unattached.md | 162 +++ ...06.01.43-Data_decort_disk_snapshot_list.md | 34 + 4.9.2/06.01.44-Data_decort_disk_snapshot.md | 40 + 4.9.2/06.01.45-Data_decort_k8s.md | 134 ++ 4.9.2/06.01.46-Data_decort_k8s_list.md | 173 +++ .../06.01.47-Data_decort_k8s_list_deleted.md | 158 +++ 4.9.2/06.01.48-Data_decort_k8s_wg.md | 68 ++ 4.9.2/06.01.49-Data_decort_k8s_wg_list.md | 63 + 4.9.2/06.01.50-Data_decort_vins_audits.md | 39 + .../06.01.51-Data_decort_vins_ext_net_list.md | 39 + 4.9.2/06.01.52-Data_decort_vins_ip_list.md | 40 + .../06.01.53-Data_decort_vins_list_deleted.md | 98 ++ ...06.01.54-Data_decort_vins_nat_rule_list.md | 41 + 4.9.2/06.01.55-Data_decort_kvmvm_audits.md | 35 + .../06.01.56-Data_decort_kvmvm_get_audits.md | 32 + ...01.57-Data_decort_kvmvm_get_console_url.md | 30 + 4.9.2/06.01.58-Data_decort_kvmvm_get_log.md | 36 + 4.9.2/06.01.59-Data_decort_kvmvm_list.md | 267 ++++ 4.9.2/06.01.60-Data_decort_kvmvm_pfw_list.md | 37 + 4.9.2/06.01.61-Data_decort_kvmvm_user_list.md | 43 + 4.9.2/06.01.62-Data_decort_rg_list.md | 156 +++ ...-Data_decort_rg_affinity_group_computes.md | 50 + ....64-Data_decort_rg_affinity_groups_list.md | 54 + ...1.65-Data_decort_rg_affinity_groups_get.md | 44 + 4.9.2/06.01.66-Data_decort_rg_audits.md | 42 + .../06.01.67-Data_decort_rg_list_computes.md | 139 +++ 4.9.2/06.01.68-Data_decort_rg_list_deleted.md | 142 +++ 4.9.2/06.01.69-Data_decort_rg_list_lb.md | 194 +++ 4.9.2/06.01.70-Data_decort_rg_list_pfw.md | 45 + 4.9.2/06.01.71-Data_decort_rg_list_vins.md | 100 ++ 4.9.2/06.01.72-Data_decort_rg_usage.md | 52 + ....01.73-Data_decort_kvmvm_snapshot_usage.md | 45 + 4.9.2/06.01.74-Data_decort_k8s_computes.md | 47 + 4.9.2/06.01.75-Data_decort_flipgroup.md | 49 + 4.9.2/06.01.75-Data_decort_flipgroup_list.md | 125 ++ 4.9.2/06.01.76-Data_decort_k8ci_list.md | 101 ++ .../06.01.77-Data_decort_vins_static_route.md | 41 + ...1.78-Data_decort_vins_static_route_list.md | 36 + ...decort_account_resource_consumption_get.md | 70 ++ ...ecort_account_resource_consumption_list.md | 51 + .../06.01.81-Data_decort_k8s_wg_cloud_init.md | 41 + ...06.01.82-Data_decort_kvmvm_list_deleted.md | 236 ++++ ...01.83-Data_decort_kvmvm_pci_device_list.md | 86 ++ 4.9.2/06.01.84-Data_decort_kvmvm_vgpu_list.md | 94 ++ ...Data_decort_rg_resource_consumption_get.md | 70 ++ ...ata_decort_rg_resource_consumption_list.md | 63 + 4.9.2/06.01.87-Data_decort_vfpool.md | 65 + 4.9.2/06.01.88-Data_decort_vfpool_list.md | 124 ++ 4.9.2/06.01.89-Data_decort_stack.md | 44 + 4.9.2/06.01.90-Data_decort_stack_list.md | 78 ++ 4.9.2/06.01.91-Data_decort_dpdknet.md | 46 + 4.9.2/06.01.92-Data_decort_dpdknet_list.md | 95 ++ .../06.01.93-Data_decort_disk_replication.md | 120 ++ 4.9.2/06.01.94-Data_decort_audit.md | 46 + ....95-Data_decort_extnet_reserved_ip_list.md | 52 + ...ata_decort_sep_and_pools_available_list.md | 52 + ...истративная-группа-API.md | 1 + 4.9.2/06.02.01-Data_decort_cb_kvmvm.md | 317 +++++ 4.9.2/06.02.02-Data_decort_cb_rg.md | 86 ++ 4.9.2/06.02.03-Data_decort_cb_disk.md | 129 ++ 4.9.2/06.02.04-Data_decort_cb_vins.md | 314 +++++ 4.9.2/06.02.05-Data_decort_cb_account.md | 78 ++ 4.9.2/06.02.06-Data_decort_cb_image_list.md | 181 +++ 4.9.2/06.02.07-Data_decort_cb_image.md | 95 ++ ....02.08-Data_decort_cb_image_list_stacks.md | 145 +++ 4.9.2/06.02.09-Data_decort_cb_grid_list.md | 108 ++ 4.9.2/06.02.10-Data_decort_cb_grid.md | 42 + ...ort_cb_account_resource_consumption_get.md | 70 ++ ...rt_cb_account_resource_consumption_list.md | 51 + ...ort_cb_account_available_templates_list.md | 36 + 4.9.2/06.02.103-Data_decort_cb_user.md | 58 + 4.9.2/06.02.104-Data_decort_cb_user_list.md | 87 ++ ...06.02.105-Data_decort_cb_user_get_audit.md | 76 ++ 4.9.2/06.02.106-Data_decort_cb_node.md | 144 +++ 4.9.2/06.02.107-Data_decort_cb_node_list.md | 190 +++ 4.9.2/06.02.108-Data_decort_cb_vfpool.md | 65 + 4.9.2/06.02.109-Data_decort_cb_vfpool_list.md | 124 ++ .../06.02.11-Data_decort_cb_pcidevice_list.md | 82 ++ ....110-Data_decort_cb_grid_post_diagnosis.md | 34 + ...2.111-Data_decort_cb_grid_get_diagnosis.md | 41 + 4.9.2/06.02.112-Data_decort_cb_dpdknet.md | 46 + .../06.02.113-Data_decort_cb_dpdknet_list.md | 97 ++ ....02.114-Data_decort_cb_disk_replication.md | 128 ++ ...15-Data_decort_cb_audits_export_to_file.md | 36 + ...02.116-Data_decort_cb_grid_get_settings.md | 83 ++ ...-Data_decort_cb_extnet_reserved_ip_list.md | 52 + ..._decort_cb_sep_and_pools_available_list.md | 52 + .../06.02.118-Data_decort_cb_sep_template.md | 85 ++ 4.9.2/06.02.12-Data_decort_cb_pcidevice.md | 46 + 4.9.2/06.02.13-Data_decort_vgpu.md | 42 + 4.9.2/06.02.14-Data_decort_cb_rg_list.md | 144 +++ 4.9.2/06.02.15-Data_decort_cb_disk_list.md | 202 +++ 4.9.2/06.02.16-Data_decort_cb_vins_list.md | 148 +++ ...2.17-Data_decort_cb_account_audits_list.md | 41 + ...18-Data_decort_cb_account_computes_list.md | 124 ++ ...02.19-Data_decort_cb_account_disks_list.md | 87 ++ ...-Data_decort_cb_account_flipgroups_list.md | 112 ++ ...06.02.21-Data_decort_cb_account_rg_list.md | 151 +++ ....02.22-Data_decort_cb_account_vins_list.md | 99 ++ 4.9.2/06.02.23-Data_decort_cb_account_list.md | 122 ++ ....24-Data_decort_cb_account_list_deleted.md | 116 ++ 4.9.2/06.02.25-Data_decort_cb_sep_config.md | 73 ++ ...06.02.26-Data_decort_cb_sep_consumption.md | 47 + .../06.02.27-Data_decort_cb_sep_disk_list.md | 53 + 4.9.2/06.02.28-Data_decort_cb_sep_list.md | 111 ++ 4.9.2/06.02.29-Data_decort_cb_sep_pool.md | 72 ++ 4.9.2/06.02.30-Data_decort_cb_sep.md | 84 ++ 4.9.2/06.02.31-Data_decort_cb_extnet.md | 100 ++ 4.9.2/06.02.32-Data_decort_cb_extnet_list.md | 123 ++ 4.9.2/06.02.33-Data_decort_cb_stack.md | 114 ++ 4.9.2/06.02.34-Data_decort_cb_stack_list.md | 148 +++ 4.9.2/06.02.35-Data_decort_cb_flipgroup.md | 62 + .../06.02.36-Data_decort_cb_flipgroup_list.md | 135 ++ 4.9.2/06.02.37-Data_decort_cb_lb.md | 139 +++ 4.9.2/06.02.38-Data_decort_cb_lb_list.md | 214 ++++ ...06.02.39-Data_decort_cb_lb_list_deleted.md | 201 +++ ...6.02.40-Data_decort_cb_grid_list_emails.md | 44 + ...41-Data_decort_cb_grid_list_consumption.md | 63 + ....42-Data_decort_cb_grid_get_consumption.md | 70 ++ ...06.02.43-Data_decort_cb_grid_get_status.md | 33 + ....02.44-Data_decort_cb_vins_list_deleted.md | 130 ++ ...02.45-Data_decort_cb_vins_nat_rule_list.md | 39 + ....02.46-Data_decort_cb_vins_ext_net_list.md | 37 + 4.9.2/06.02.47-Data_decort_cb_vins_ip_list.md | 38 + ...8-Data_decort_cb_vins_static_route_list.md | 37 + ....02.49-Data_decort_cb_vins_static_route.md | 44 + 4.9.2/06.02.50-Data_decort_cb_vins_audits.md | 36 + ...ta_decort_cb_rg_affinity_group_computes.md | 55 + ...2-Data_decort_cb_rg_affinity_groups_get.md | 49 + ...-Data_decort_cb_rg_affinity_groups_list.md | 57 + 4.9.2/06.02.54-Data_decort_cb_rg_audits.md | 45 + ...a_decort_cb_rg_resource_consumption_get.md | 70 ++ ..._decort_cb_rg_resource_consumption_list.md | 63 + 4.9.2/06.02.57-Data_decort_cb_rg_usage.md | 58 + ...6.02.58-Data_decort_cb_rg_list_computes.md | 143 +++ ...06.02.59-Data_decort_cb_rg_list_deleted.md | 145 +++ 4.9.2/06.02.60-Data_decort_cb_rg_list_lb.md | 205 ++++ 4.9.2/06.02.61-Data_decort_cb_rg_list_pfw.md | 46 + 4.9.2/06.02.62-Data_decort_cb_rg_list_vins.md | 102 ++ ....02.63-Data_decort_cb_disk_list_deleted.md | 184 +++ ...06.02.64-Data_decort_cb_disk_list_types.md | 46 + ...Data_decort_cb_disk_list_types_detailed.md | 55 + ....66-Data_decort_cb_disk_list_unattached.md | 164 +++ .../06.02.67-Data_decort_cb_disk_snapshot.md | 43 + ...02.68-Data_decort_cb_disk_snapshot_list.md | 36 + 4.9.2/06.02.69-Data_decort_cb_audit.md | 47 + 4.9.2/06.02.70-Data_decort_cb_audit_list.md | 100 ++ ....02.71-Data_decort_cb_audit_linked_jobs.md | 41 + 4.9.2/06.02.72-Data_decort_cb_k8s.md | 153 +++ 4.9.2/06.02.73-Data_decort_cb_k8s_computes.md | 49 + 4.9.2/06.02.74-Data_decort_cb_k8s_list.md | 150 +++ ...6.02.75-Data_decort_cb_k8s_list_deleted.md | 161 +++ 4.9.2/06.02.76-Data_decort_cb_k8s_wg.md | 70 ++ ....02.77-Data_decort_cb_k8s_wg_cloud_init.md | 41 + 4.9.2/06.02.78-Data_decort_cb_k8s_wg_list.md | 63 + 4.9.2/06.02.79-Data_decort_cb_k8ci_list.md | 98 ++ ....02.80-Data_decort_cb_k8ci_list_deleted.md | 86 ++ 4.9.2/06.02.81-Data_decort_cb_k8ci.md | 44 + ...Data_decort_cb_kvmvm_affinity_relations.md | 43 + 4.9.2/06.02.83-Data_decort_cb_kvmvm_audits.md | 36 + ....84-Data_decort_cb_kvmvm_boot_order_get.md | 32 + ...6.02.85-Data_decort_cb_kvmvm_get_audits.md | 33 + ...86-Data_decort_cb_kvmvm_get_console_url.md | 32 + .../06.02.87-Data_decort_cb_kvmvm_get_log.md | 38 + 4.9.2/06.02.88-Data_decort_cb_kvmvm_list.md | 307 +++++ ...02.89-Data_decort_cb_kvmvm_list_deleted.md | 250 ++++ ...ta_decort_cb_kvmvm_migrate_storage_info.md | 32 + ...91-Data_decort_cb_kvmvm_pci_device_list.md | 88 ++ .../06.02.92-Data_decort_cb_kvmvm_pfw_list.md | 38 + ....93-Data_decort_cb_kvmvm_snapshot_usage.md | 48 + ...2.94-Data_decort_cb_kvmvm_snapshot_list.md | 40 + ...06.02.95-Data_decort_cb_kvmvm_user_list.md | 44 + ...06.02.96-Data_decort_cb_kvmvm_vgpu_list.md | 94 ++ .../06.02.97-Data_decort_cb_extnet_default.md | 25 + ...Data_decort_cb_extnet_static_route_list.md | 37 + ...2.99-Data_decort_cb_extnet_static_route.md | 44 + ...-Terraform-провайдера-DECORT.md | 2 + ...овательская-группа-API.md | 1 + 4.9.2/07.01.01-Resource_decort_kvmvm.md | 1081 +++++++++++++++++ 4.9.2/07.01.02-Resource_decort_resgroup.md | 314 +++++ 4.9.2/07.01.03-Resource_decort_disk.md | 184 +++ 4.9.2/07.01.04-Resource_decort_vins.md | 542 +++++++++ 4.9.2/07.01.05-Resource_decort_snapshot.md | 64 + 4.9.2/07.01.06-Resource_decort_k8s.md | 669 ++++++++++ 4.9.2/07.01.07-Resource_decort_k8s_wg.md | 191 +++ .../07.01.08-Resource_decort_image_virtual.md | 84 ++ 4.9.2/07.01.09-Resource_decort_image.md | 178 +++ 4.9.2/07.01.10-Resource_decort_pfw.md | 64 + 4.9.2/07.01.11-Resource_decort_account.md | 231 ++++ 4.9.2/07.01.12-Resource_decort_bservice.md | 156 +++ ...07.01.13-Resource_decort_bservice_group.md | 287 +++++ 4.9.2/07.01.14-Resource_decort_lb.md | 221 ++++ 4.9.2/07.01.15-Resource_decort_lb_frontend.md | 78 ++ ....01.16-Resource_decort_lb_frontend_bind.md | 86 ++ 4.9.2/07.01.17-Resource_decort_lb_backend.md | 172 +++ ...01.18-Resource_decort_lb_backend_server.md | 170 +++ .../07.01.19-Resource_decort_disk_snapshot.md | 53 + 4.9.2/07.01.20-Resource_decort_flipgroup.md | 106 ++ 4.9.2/07.01.21-Resource_decort_k8s_cp.md | 393 ++++++ ...01.22-Resource_decort_vins_static_route.md | 61 + ...esource_decort_image_from_blank_compute.md | 135 ++ ...esource_decort_image_from_platform_disk.md | 159 +++ ....01.25-Resource_decort_disk_replication.md | 163 +++ ...истративная-группа-API.md | 1 + .../07.02.01-Resource_decort_cb_pcidevice.md | 110 ++ .../07.02.02-Resource_decort_cb_sep_config.md | 405 ++++++ 4.9.2/07.02.03-Resource_decort_cb_sep.md | 673 ++++++++++ ...07.02.04-Resource_decort_cb_cdrom_image.md | 185 +++ 4.9.2/07.02.06-Resource_decort_cb_account.md | 260 ++++ ....02.07-Resource_decort_cb_virtual_image.md | 158 +++ 4.9.2/07.02.08-Resource_decort_cb_image.md | 223 ++++ 4.9.2/07.02.09-Resource_decort_cb_k8s_wg.md | 163 +++ 4.9.2/07.02.10-Resource_decort_cb_k8s_cp.md | 311 +++++ 4.9.2/07.02.11-Resource_decort_cb_kvmvm.md | 1014 ++++++++++++++++ 4.9.2/07.02.12-Resource_decort_cb_vins.md | 574 +++++++++ 4.9.2/07.02.13-Resource_decort_cb_disk.md | 229 ++++ 4.9.2/07.02.14-Resource_decort_cb_rg.md | 290 +++++ 4.9.2/07.02.15-Resource_decort_cb_extnet.md | 326 +++++ .../07.02.16-Resource_decort_cb_flipgroup.md | 112 ++ 4.9.2/07.02.17-Resource_decort_cb_lb.md | 228 ++++ .../07.02.18-Resource_decort_cb_lb_backend.md | 167 +++ ...19-Resource_decort_cb_lb_backend_server.md | 164 +++ ...07.02.20-Resource_decort_cb_lb_frontend.md | 73 ++ ....21-Resource_decort_cb_lb_frontend_bind.md | 80 ++ ...22-Resource_decort_cb_vins_static_route.md | 62 + ....02.23-Resource_decort_cb_disk_snapshot.md | 65 + 4.9.2/07.02.24-Resource_decort_cb_k8ci.md | 141 +++ ...-Resource_decort_cb_extnet_static_route.md | 68 ++ ...urce_decort_cb_image_from_blank_compute.md | 195 +++ ...urce_decort_cb_image_from_platform_disk.md | 210 ++++ 4.9.2/07.02.28-Resource_decort_cb_user.md | 86 ++ 4.9.2/07.02.29-Resource_decort_cb_vfpool.md | 123 ++ ....30-Resource_decort_cb_disk_replication.md | 170 +++ 4.9.2/07.02.31-Resource_decort_cb_dpdknet.md | 103 ++ 4.9.2/08.-Полезные-советы.md | 55 + 4.9.2/Home.md | 309 +++++ Home.md | 1 + 294 files changed, 33965 insertions(+) create mode 100644 4.9.2/01.-Введение.md create mode 100644 4.9.2/02.-Пример-работы.md create mode 100644 4.9.2/03.-Обзор-облачной-платформы-DECORT.md create mode 100644 4.9.2/04.-Начало-работы-с-terraform-провайдером-DECORT.md create mode 100644 4.9.2/04.01-Установка-Terraform-провайдера-DECORT.md create mode 100644 4.9.2/04.02-Инициализация-Terraform-провайдера-DECORT.md create mode 100644 4.9.2/04.04-Получение-gid-или-grid_id.md create mode 100644 4.9.2/04.05-Сборка-terraform-провайдера.md create mode 100644 4.9.2/05.-Работа-с-terraform.md create mode 100644 4.9.2/05.01-Импортирование-ресурсов.md create mode 100644 4.9.2/05.02-Работа-с-таймаутами.md create mode 100644 4.9.2/05.03-Восстановление-ресурсов.md create mode 100644 4.9.2/05.04-Массовое-создание-ресурсов.-Мета-аргументы.md create mode 100644 4.9.2/05.05-Удаление-ресурсов.md create mode 100644 4.9.2/05.06-Установка-Terraform.md create mode 100644 4.9.2/05.07-Миграция-k8s-кластеров-на-версию-4.2.0.md create mode 100644 4.9.2/06.-Data-source-функции-Terraform-провайдера-DECORT.md create mode 100644 4.9.2/06.01-Пользовательская-группа-API.md create mode 100644 4.9.2/06.01.01-Data_decort_kvmvm.md create mode 100644 4.9.2/06.01.02-Data_decort_resgroup.md create mode 100644 4.9.2/06.01.03-Data_decort_disk.md create mode 100644 4.9.2/06.01.04-Data_decort_vins.md create mode 100644 4.9.2/06.01.05-Data_decort_account.md create mode 100644 4.9.2/06.01.06-Data_decort_image_list.md create mode 100644 4.9.2/06.01.07-Data_decort_image.md create mode 100644 4.9.2/06.01.08-Data_decort_locations_list.md create mode 100644 4.9.2/06.01.09-Data_decort_location_url.md create mode 100644 4.9.2/06.01.11-Data_decort_snapshot_list.md create mode 100644 4.9.2/06.01.13-Data_decort_disk_list.md create mode 100644 4.9.2/06.01.14-Data_decort_vins_list.md create mode 100644 4.9.2/06.01.15-Data_decort_extnet_list.md create mode 100644 4.9.2/06.01.16-Data_decort_extnet_default.md create mode 100644 4.9.2/06.01.17-Data_decort_extnet_computes_list.md create mode 100644 4.9.2/06.01.18-Data_decort_extnet.md create mode 100644 4.9.2/06.01.19-Data_decort_account_audits_list.md create mode 100644 4.9.2/06.01.20-Data_decort_account_computes_list.md create mode 100644 4.9.2/06.01.21-Data_decort_account_consumed_units.md create mode 100644 4.9.2/06.01.22-Data_decort_account_consumed_units_by_type.md create mode 100644 4.9.2/06.01.23-Data_decort_account_disks_list.md create mode 100644 4.9.2/06.01.24-Data_decort_account_flipgroups_list.md create mode 100644 4.9.2/06.01.25-Data_decort_account_reserved_units.md create mode 100644 4.9.2/06.01.26-Data_decort_account_rg_list.md create mode 100644 4.9.2/06.01.27-Data_decort_account_templates_list.md create mode 100644 4.9.2/06.01.28-Data_decort_account_vins_list.md create mode 100644 4.9.2/06.01.29-Data_decort_account_list.md create mode 100644 4.9.2/06.01.30-Data_decort_account_deleted_list.md create mode 100644 4.9.2/06.01.31-Data_decort_bservice_list.md create mode 100644 4.9.2/06.01.32-Data_decort_bservice_deleted_list.md create mode 100644 4.9.2/06.01.33-Data_decort_bservice_snapshot_list.md create mode 100644 4.9.2/06.01.34-Data_decort_bservice.md create mode 100644 4.9.2/06.01.35-Data_decort_bservice_group.md create mode 100644 4.9.2/06.01.36-Data_decort_lb.md create mode 100644 4.9.2/06.01.37-Data_decort_lb_list.md create mode 100644 4.9.2/06.01.38-Data_decort_lb_list_deleted.md create mode 100644 4.9.2/06.01.39-Data_decort_disk_list_types.md create mode 100644 4.9.2/06.01.40-Data_decort_disk_list_types_detailed.md create mode 100644 4.9.2/06.01.41-Data_decort_disk_list_deleted.md create mode 100644 4.9.2/06.01.42-Data_decort_disk_list_unattached.md create mode 100644 4.9.2/06.01.43-Data_decort_disk_snapshot_list.md create mode 100644 4.9.2/06.01.44-Data_decort_disk_snapshot.md create mode 100644 4.9.2/06.01.45-Data_decort_k8s.md create mode 100644 4.9.2/06.01.46-Data_decort_k8s_list.md create mode 100644 4.9.2/06.01.47-Data_decort_k8s_list_deleted.md create mode 100644 4.9.2/06.01.48-Data_decort_k8s_wg.md create mode 100644 4.9.2/06.01.49-Data_decort_k8s_wg_list.md create mode 100644 4.9.2/06.01.50-Data_decort_vins_audits.md create mode 100644 4.9.2/06.01.51-Data_decort_vins_ext_net_list.md create mode 100644 4.9.2/06.01.52-Data_decort_vins_ip_list.md create mode 100644 4.9.2/06.01.53-Data_decort_vins_list_deleted.md create mode 100644 4.9.2/06.01.54-Data_decort_vins_nat_rule_list.md create mode 100644 4.9.2/06.01.55-Data_decort_kvmvm_audits.md create mode 100644 4.9.2/06.01.56-Data_decort_kvmvm_get_audits.md create mode 100644 4.9.2/06.01.57-Data_decort_kvmvm_get_console_url.md create mode 100644 4.9.2/06.01.58-Data_decort_kvmvm_get_log.md create mode 100644 4.9.2/06.01.59-Data_decort_kvmvm_list.md create mode 100644 4.9.2/06.01.60-Data_decort_kvmvm_pfw_list.md create mode 100644 4.9.2/06.01.61-Data_decort_kvmvm_user_list.md create mode 100644 4.9.2/06.01.62-Data_decort_rg_list.md create mode 100644 4.9.2/06.01.63-Data_decort_rg_affinity_group_computes.md create mode 100644 4.9.2/06.01.64-Data_decort_rg_affinity_groups_list.md create mode 100644 4.9.2/06.01.65-Data_decort_rg_affinity_groups_get.md create mode 100644 4.9.2/06.01.66-Data_decort_rg_audits.md create mode 100644 4.9.2/06.01.67-Data_decort_rg_list_computes.md create mode 100644 4.9.2/06.01.68-Data_decort_rg_list_deleted.md create mode 100644 4.9.2/06.01.69-Data_decort_rg_list_lb.md create mode 100644 4.9.2/06.01.70-Data_decort_rg_list_pfw.md create mode 100644 4.9.2/06.01.71-Data_decort_rg_list_vins.md create mode 100644 4.9.2/06.01.72-Data_decort_rg_usage.md create mode 100644 4.9.2/06.01.73-Data_decort_kvmvm_snapshot_usage.md create mode 100644 4.9.2/06.01.74-Data_decort_k8s_computes.md create mode 100644 4.9.2/06.01.75-Data_decort_flipgroup.md create mode 100644 4.9.2/06.01.75-Data_decort_flipgroup_list.md create mode 100644 4.9.2/06.01.76-Data_decort_k8ci_list.md create mode 100644 4.9.2/06.01.77-Data_decort_vins_static_route.md create mode 100644 4.9.2/06.01.78-Data_decort_vins_static_route_list.md create mode 100644 4.9.2/06.01.79-Data_decort_account_resource_consumption_get.md create mode 100644 4.9.2/06.01.80-Data_decort_account_resource_consumption_list.md create mode 100644 4.9.2/06.01.81-Data_decort_k8s_wg_cloud_init.md create mode 100644 4.9.2/06.01.82-Data_decort_kvmvm_list_deleted.md create mode 100644 4.9.2/06.01.83-Data_decort_kvmvm_pci_device_list.md create mode 100644 4.9.2/06.01.84-Data_decort_kvmvm_vgpu_list.md create mode 100644 4.9.2/06.01.85-Data_decort_rg_resource_consumption_get.md create mode 100644 4.9.2/06.01.86-Data_decort_rg_resource_consumption_list.md create mode 100644 4.9.2/06.01.87-Data_decort_vfpool.md create mode 100644 4.9.2/06.01.88-Data_decort_vfpool_list.md create mode 100644 4.9.2/06.01.89-Data_decort_stack.md create mode 100644 4.9.2/06.01.90-Data_decort_stack_list.md create mode 100644 4.9.2/06.01.91-Data_decort_dpdknet.md create mode 100644 4.9.2/06.01.92-Data_decort_dpdknet_list.md create mode 100644 4.9.2/06.01.93-Data_decort_disk_replication.md create mode 100644 4.9.2/06.01.94-Data_decort_audit.md create mode 100644 4.9.2/06.01.95-Data_decort_extnet_reserved_ip_list.md create mode 100644 4.9.2/06.01.96-Data_decort_sep_and_pools_available_list.md create mode 100644 4.9.2/06.02-Административная-группа-API.md create mode 100644 4.9.2/06.02.01-Data_decort_cb_kvmvm.md create mode 100644 4.9.2/06.02.02-Data_decort_cb_rg.md create mode 100644 4.9.2/06.02.03-Data_decort_cb_disk.md create mode 100644 4.9.2/06.02.04-Data_decort_cb_vins.md create mode 100644 4.9.2/06.02.05-Data_decort_cb_account.md create mode 100644 4.9.2/06.02.06-Data_decort_cb_image_list.md create mode 100644 4.9.2/06.02.07-Data_decort_cb_image.md create mode 100644 4.9.2/06.02.08-Data_decort_cb_image_list_stacks.md create mode 100644 4.9.2/06.02.09-Data_decort_cb_grid_list.md create mode 100644 4.9.2/06.02.10-Data_decort_cb_grid.md create mode 100644 4.9.2/06.02.100-Data_decort_cb_account_resource_consumption_get.md create mode 100644 4.9.2/06.02.101-Data_decort_cb_account_resource_consumption_list.md create mode 100644 4.9.2/06.02.102-Data_decort_cb_account_available_templates_list.md create mode 100644 4.9.2/06.02.103-Data_decort_cb_user.md create mode 100644 4.9.2/06.02.104-Data_decort_cb_user_list.md create mode 100644 4.9.2/06.02.105-Data_decort_cb_user_get_audit.md create mode 100644 4.9.2/06.02.106-Data_decort_cb_node.md create mode 100644 4.9.2/06.02.107-Data_decort_cb_node_list.md create mode 100644 4.9.2/06.02.108-Data_decort_cb_vfpool.md create mode 100644 4.9.2/06.02.109-Data_decort_cb_vfpool_list.md create mode 100644 4.9.2/06.02.11-Data_decort_cb_pcidevice_list.md create mode 100644 4.9.2/06.02.110-Data_decort_cb_grid_post_diagnosis.md create mode 100644 4.9.2/06.02.111-Data_decort_cb_grid_get_diagnosis.md create mode 100644 4.9.2/06.02.112-Data_decort_cb_dpdknet.md create mode 100644 4.9.2/06.02.113-Data_decort_cb_dpdknet_list.md create mode 100644 4.9.2/06.02.114-Data_decort_cb_disk_replication.md create mode 100644 4.9.2/06.02.115-Data_decort_cb_audits_export_to_file.md create mode 100644 4.9.2/06.02.116-Data_decort_cb_grid_get_settings.md create mode 100644 4.9.2/06.02.117-Data_decort_cb_extnet_reserved_ip_list.md create mode 100644 4.9.2/06.02.118-Data_decort_cb_sep_and_pools_available_list.md create mode 100644 4.9.2/06.02.118-Data_decort_cb_sep_template.md create mode 100644 4.9.2/06.02.12-Data_decort_cb_pcidevice.md create mode 100644 4.9.2/06.02.13-Data_decort_vgpu.md create mode 100644 4.9.2/06.02.14-Data_decort_cb_rg_list.md create mode 100644 4.9.2/06.02.15-Data_decort_cb_disk_list.md create mode 100644 4.9.2/06.02.16-Data_decort_cb_vins_list.md create mode 100644 4.9.2/06.02.17-Data_decort_cb_account_audits_list.md create mode 100644 4.9.2/06.02.18-Data_decort_cb_account_computes_list.md create mode 100644 4.9.2/06.02.19-Data_decort_cb_account_disks_list.md create mode 100644 4.9.2/06.02.20-Data_decort_cb_account_flipgroups_list.md create mode 100644 4.9.2/06.02.21-Data_decort_cb_account_rg_list.md create mode 100644 4.9.2/06.02.22-Data_decort_cb_account_vins_list.md create mode 100644 4.9.2/06.02.23-Data_decort_cb_account_list.md create mode 100644 4.9.2/06.02.24-Data_decort_cb_account_list_deleted.md create mode 100644 4.9.2/06.02.25-Data_decort_cb_sep_config.md create mode 100644 4.9.2/06.02.26-Data_decort_cb_sep_consumption.md create mode 100644 4.9.2/06.02.27-Data_decort_cb_sep_disk_list.md create mode 100644 4.9.2/06.02.28-Data_decort_cb_sep_list.md create mode 100644 4.9.2/06.02.29-Data_decort_cb_sep_pool.md create mode 100644 4.9.2/06.02.30-Data_decort_cb_sep.md create mode 100644 4.9.2/06.02.31-Data_decort_cb_extnet.md create mode 100644 4.9.2/06.02.32-Data_decort_cb_extnet_list.md create mode 100644 4.9.2/06.02.33-Data_decort_cb_stack.md create mode 100644 4.9.2/06.02.34-Data_decort_cb_stack_list.md create mode 100644 4.9.2/06.02.35-Data_decort_cb_flipgroup.md create mode 100644 4.9.2/06.02.36-Data_decort_cb_flipgroup_list.md create mode 100644 4.9.2/06.02.37-Data_decort_cb_lb.md create mode 100644 4.9.2/06.02.38-Data_decort_cb_lb_list.md create mode 100644 4.9.2/06.02.39-Data_decort_cb_lb_list_deleted.md create mode 100644 4.9.2/06.02.40-Data_decort_cb_grid_list_emails.md create mode 100644 4.9.2/06.02.41-Data_decort_cb_grid_list_consumption.md create mode 100644 4.9.2/06.02.42-Data_decort_cb_grid_get_consumption.md create mode 100644 4.9.2/06.02.43-Data_decort_cb_grid_get_status.md create mode 100644 4.9.2/06.02.44-Data_decort_cb_vins_list_deleted.md create mode 100644 4.9.2/06.02.45-Data_decort_cb_vins_nat_rule_list.md create mode 100644 4.9.2/06.02.46-Data_decort_cb_vins_ext_net_list.md create mode 100644 4.9.2/06.02.47-Data_decort_cb_vins_ip_list.md create mode 100644 4.9.2/06.02.48-Data_decort_cb_vins_static_route_list.md create mode 100644 4.9.2/06.02.49-Data_decort_cb_vins_static_route.md create mode 100644 4.9.2/06.02.50-Data_decort_cb_vins_audits.md create mode 100644 4.9.2/06.02.51-Data_decort_cb_rg_affinity_group_computes.md create mode 100644 4.9.2/06.02.52-Data_decort_cb_rg_affinity_groups_get.md create mode 100644 4.9.2/06.02.53-Data_decort_cb_rg_affinity_groups_list.md create mode 100644 4.9.2/06.02.54-Data_decort_cb_rg_audits.md create mode 100644 4.9.2/06.02.55-Data_decort_cb_rg_resource_consumption_get.md create mode 100644 4.9.2/06.02.56-Data_decort_cb_rg_resource_consumption_list.md create mode 100644 4.9.2/06.02.57-Data_decort_cb_rg_usage.md create mode 100644 4.9.2/06.02.58-Data_decort_cb_rg_list_computes.md create mode 100644 4.9.2/06.02.59-Data_decort_cb_rg_list_deleted.md create mode 100644 4.9.2/06.02.60-Data_decort_cb_rg_list_lb.md create mode 100644 4.9.2/06.02.61-Data_decort_cb_rg_list_pfw.md create mode 100644 4.9.2/06.02.62-Data_decort_cb_rg_list_vins.md create mode 100644 4.9.2/06.02.63-Data_decort_cb_disk_list_deleted.md create mode 100644 4.9.2/06.02.64-Data_decort_cb_disk_list_types.md create mode 100644 4.9.2/06.02.65-Data_decort_cb_disk_list_types_detailed.md create mode 100644 4.9.2/06.02.66-Data_decort_cb_disk_list_unattached.md create mode 100644 4.9.2/06.02.67-Data_decort_cb_disk_snapshot.md create mode 100644 4.9.2/06.02.68-Data_decort_cb_disk_snapshot_list.md create mode 100644 4.9.2/06.02.69-Data_decort_cb_audit.md create mode 100644 4.9.2/06.02.70-Data_decort_cb_audit_list.md create mode 100644 4.9.2/06.02.71-Data_decort_cb_audit_linked_jobs.md create mode 100644 4.9.2/06.02.72-Data_decort_cb_k8s.md create mode 100644 4.9.2/06.02.73-Data_decort_cb_k8s_computes.md create mode 100644 4.9.2/06.02.74-Data_decort_cb_k8s_list.md create mode 100644 4.9.2/06.02.75-Data_decort_cb_k8s_list_deleted.md create mode 100644 4.9.2/06.02.76-Data_decort_cb_k8s_wg.md create mode 100644 4.9.2/06.02.77-Data_decort_cb_k8s_wg_cloud_init.md create mode 100644 4.9.2/06.02.78-Data_decort_cb_k8s_wg_list.md create mode 100644 4.9.2/06.02.79-Data_decort_cb_k8ci_list.md create mode 100644 4.9.2/06.02.80-Data_decort_cb_k8ci_list_deleted.md create mode 100644 4.9.2/06.02.81-Data_decort_cb_k8ci.md create mode 100644 4.9.2/06.02.82-Data_decort_cb_kvmvm_affinity_relations.md create mode 100644 4.9.2/06.02.83-Data_decort_cb_kvmvm_audits.md create mode 100644 4.9.2/06.02.84-Data_decort_cb_kvmvm_boot_order_get.md create mode 100644 4.9.2/06.02.85-Data_decort_cb_kvmvm_get_audits.md create mode 100644 4.9.2/06.02.86-Data_decort_cb_kvmvm_get_console_url.md create mode 100644 4.9.2/06.02.87-Data_decort_cb_kvmvm_get_log.md create mode 100644 4.9.2/06.02.88-Data_decort_cb_kvmvm_list.md create mode 100644 4.9.2/06.02.89-Data_decort_cb_kvmvm_list_deleted.md create mode 100644 4.9.2/06.02.90-Data_decort_cb_kvmvm_migrate_storage_info.md create mode 100644 4.9.2/06.02.91-Data_decort_cb_kvmvm_pci_device_list.md create mode 100644 4.9.2/06.02.92-Data_decort_cb_kvmvm_pfw_list.md create mode 100644 4.9.2/06.02.93-Data_decort_cb_kvmvm_snapshot_usage.md create mode 100644 4.9.2/06.02.94-Data_decort_cb_kvmvm_snapshot_list.md create mode 100644 4.9.2/06.02.95-Data_decort_cb_kvmvm_user_list.md create mode 100644 4.9.2/06.02.96-Data_decort_cb_kvmvm_vgpu_list.md create mode 100644 4.9.2/06.02.97-Data_decort_cb_extnet_default.md create mode 100644 4.9.2/06.02.98-Data_decort_cb_extnet_static_route_list.md create mode 100644 4.9.2/06.02.99-Data_decort_cb_extnet_static_route.md create mode 100644 4.9.2/07.-Resource-функции-Terraform-провайдера-DECORT.md create mode 100644 4.9.2/07.01-Пользовательская-группа-API.md create mode 100644 4.9.2/07.01.01-Resource_decort_kvmvm.md create mode 100644 4.9.2/07.01.02-Resource_decort_resgroup.md create mode 100644 4.9.2/07.01.03-Resource_decort_disk.md create mode 100644 4.9.2/07.01.04-Resource_decort_vins.md create mode 100644 4.9.2/07.01.05-Resource_decort_snapshot.md create mode 100644 4.9.2/07.01.06-Resource_decort_k8s.md create mode 100644 4.9.2/07.01.07-Resource_decort_k8s_wg.md create mode 100644 4.9.2/07.01.08-Resource_decort_image_virtual.md create mode 100644 4.9.2/07.01.09-Resource_decort_image.md create mode 100644 4.9.2/07.01.10-Resource_decort_pfw.md create mode 100644 4.9.2/07.01.11-Resource_decort_account.md create mode 100644 4.9.2/07.01.12-Resource_decort_bservice.md create mode 100644 4.9.2/07.01.13-Resource_decort_bservice_group.md create mode 100644 4.9.2/07.01.14-Resource_decort_lb.md create mode 100644 4.9.2/07.01.15-Resource_decort_lb_frontend.md create mode 100644 4.9.2/07.01.16-Resource_decort_lb_frontend_bind.md create mode 100644 4.9.2/07.01.17-Resource_decort_lb_backend.md create mode 100644 4.9.2/07.01.18-Resource_decort_lb_backend_server.md create mode 100644 4.9.2/07.01.19-Resource_decort_disk_snapshot.md create mode 100644 4.9.2/07.01.20-Resource_decort_flipgroup.md create mode 100644 4.9.2/07.01.21-Resource_decort_k8s_cp.md create mode 100644 4.9.2/07.01.22-Resource_decort_vins_static_route.md create mode 100644 4.9.2/07.01.23-Resource_decort_image_from_blank_compute.md create mode 100644 4.9.2/07.01.24-Resource_decort_image_from_platform_disk.md create mode 100644 4.9.2/07.01.25-Resource_decort_disk_replication.md create mode 100644 4.9.2/07.02-Административная-группа-API.md create mode 100644 4.9.2/07.02.01-Resource_decort_cb_pcidevice.md create mode 100644 4.9.2/07.02.02-Resource_decort_cb_sep_config.md create mode 100644 4.9.2/07.02.03-Resource_decort_cb_sep.md create mode 100644 4.9.2/07.02.04-Resource_decort_cb_cdrom_image.md create mode 100644 4.9.2/07.02.06-Resource_decort_cb_account.md create mode 100644 4.9.2/07.02.07-Resource_decort_cb_virtual_image.md create mode 100644 4.9.2/07.02.08-Resource_decort_cb_image.md create mode 100644 4.9.2/07.02.09-Resource_decort_cb_k8s_wg.md create mode 100644 4.9.2/07.02.10-Resource_decort_cb_k8s_cp.md create mode 100644 4.9.2/07.02.11-Resource_decort_cb_kvmvm.md create mode 100644 4.9.2/07.02.12-Resource_decort_cb_vins.md create mode 100644 4.9.2/07.02.13-Resource_decort_cb_disk.md create mode 100644 4.9.2/07.02.14-Resource_decort_cb_rg.md create mode 100644 4.9.2/07.02.15-Resource_decort_cb_extnet.md create mode 100644 4.9.2/07.02.16-Resource_decort_cb_flipgroup.md create mode 100644 4.9.2/07.02.17-Resource_decort_cb_lb.md create mode 100644 4.9.2/07.02.18-Resource_decort_cb_lb_backend.md create mode 100644 4.9.2/07.02.19-Resource_decort_cb_lb_backend_server.md create mode 100644 4.9.2/07.02.20-Resource_decort_cb_lb_frontend.md create mode 100644 4.9.2/07.02.21-Resource_decort_cb_lb_frontend_bind.md create mode 100644 4.9.2/07.02.22-Resource_decort_cb_vins_static_route.md create mode 100644 4.9.2/07.02.23-Resource_decort_cb_disk_snapshot.md create mode 100644 4.9.2/07.02.24-Resource_decort_cb_k8ci.md create mode 100644 4.9.2/07.02.25-Resource_decort_cb_extnet_static_route.md create mode 100644 4.9.2/07.02.26-Resource_decort_cb_image_from_blank_compute.md create mode 100644 4.9.2/07.02.27-Resource_decort_cb_image_from_platform_disk.md create mode 100644 4.9.2/07.02.28-Resource_decort_cb_user.md create mode 100644 4.9.2/07.02.29-Resource_decort_cb_vfpool.md create mode 100644 4.9.2/07.02.30-Resource_decort_cb_disk_replication.md create mode 100644 4.9.2/07.02.31-Resource_decort_cb_dpdknet.md create mode 100644 4.9.2/08.-Полезные-советы.md create mode 100644 4.9.2/Home.md diff --git a/4.9.2/01.-Введение.md b/4.9.2/01.-Введение.md new file mode 100644 index 00000000..d781b73c --- /dev/null +++ b/4.9.2/01.-Введение.md @@ -0,0 +1,7 @@ +DECORT Terraform Provider версии 4.9.x позволяет управлять облачными ресурсами на платформе Digital Energy Cloud Orchestration Technology (DECORT) версии 4.3.x и выше посредством Terraform. + +С помощью данного провайдера можно организовать программное управление вычислительными ресурсами (_compute_), ресурсными группами, сетевыми и дисковыми ресурсами, образами дисков, кластером, а также другими параметрами облачной платформы DECORT. + +Если вы хорошо знакомы с инструментом Terraform и хотите максимально быстро начать использовать платформу DECORT в своих Terraform-проектах, то можете сразу перейти к разделу [Пример работы](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/02.-Пример-работы.md), где приведён подробно откомментированный пример работы с основными видами ресурсов платформы. Если у вас всё же возникнут вопросы по облачной платформе DECORT и порядку авторизации в ней, то обратитесь к главе [«Обзор облачной платформы DECORT»](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/03.-Обзор-облачной-платформы-DECORT.md). Также может оказаться полезной глава [«Инициализация Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/04.02-Инициализация-Terraform-провайдера-DECORT.md). + +Если вы только начинаете использовать инструмент Terraform и облачную платформу DECORT, то рекомендуем вам начать с главы [«Обзор облачной платформы DECORT»](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/03.-Обзор-облачной-платформы-DECORT.md), после чего изучить главы [«_Data source_ функции Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/06.-Data-source-функции-Terraform-провайдера-DECORT.md) и [«_Resource_ функции Terraform провайдера DECORT»](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/07.-Resource-функции-Terraform-провайдера-DECORT.md). Примеры, приведенные в этих разделах, помогут вам быстро освоить базовые приёмы работы с инструментом Terraform и провайдером DECORT. diff --git a/4.9.2/02.-Пример-работы.md b/4.9.2/02.-Пример-работы.md new file mode 100644 index 00000000..6ca4d30d --- /dev/null +++ b/4.9.2/02.-Пример-работы.md @@ -0,0 +1,78 @@ +Данный раздел предназначен для тех, кто хорошо знаком с инструментом 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/wiki-terraform-provider-decort/src/branch/main/4.9.2/03.-Обзор-облачной-платформы-DECORT.md). + +```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 OAUTH2 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 + #} +} + +# 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" + + 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/4.9.2/03.-Обзор-облачной-платформы-DECORT.md b/4.9.2/03.-Обзор-облачной-платформы-DECORT.md new file mode 100644 index 00000000..72c67b1e --- /dev/null +++ b/4.9.2/03.-Обзор-облачной-платформы-DECORT.md @@ -0,0 +1,30 @@ +## Основные понятия +Ниже перечислены основные понятия с указанием соответствующих им аргументов в 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. **Ресурс хранения** (_disk_) - универсальная абстракция дискового ресурса на платформе DECORT. Платформа поддерживает различные типы систем хранения данных, но при этом управление созданными на разных системах хранения дисками осуществляется посредством унифицированного набора действий, например, "подключить диск к _compute_", "увеличить размер диска", "сделать мгновенный снимок диска", "настроить параметры быстродействия диска". +7. **Виртуальный сервер** – экземпляр _compute_, в основе технической реализации которого лежит виртуальная машина, работающая в облаке DECORT и доступна по сети. Виртуальный сервер характеризуется количеством выделенных ему CPU (аргумент`cpu`), объемом ОЗУ (`ram`), размером загрузочного диска (`boot_disk_size`). При создании виртуального сервера на загрузочный диск устанавливается образ операционной системы, заданный в аргументе `image_id`. Помимо загрузочного диска к виртуальному серверу можно подключить несколько дисков для хранения прикладных данных, список которых задается аргументами `extra_disks`. Виртуальный сервер идентифицируется по комбинации аргументов `name` (имя сервера) и `rgid` (идентификатор ресурсной группы). Обратите внимание, что имя виртуального сервера `name` уникально только в рамках одной и той же ресурсной группы. +8. **Виртуальный сетевой сегмент** (_Virtual Network Segment_ или _ViNS_) - сетевой сегмент и обеспечивающая его функционирование виртуальная инфраструктура, которые пользователь может создавать для своих нужд на уровне ресурсной группы или подписчика (_account_). ViNS можно создать полностью изолированным от внешних сетей (см. ниже _External Network_) или с подключением во внешнюю сеть. Внутри ViNS работает DHCP-сервис, обеспечивающий управление IP адресами экземпляров _compute_, подключённых в этот ViNS. +9. **Внешняя сеть** (_External Network_) - сетевой сегмент, через который платформа DECORT взаимодействует с внешними по отношению к ней сетевыми ресурсами. Например, в случае с публичным облаком на базе DECORT в качестве внешней сети выступает сеть Интернет. В отличие от ViNS платформа не управляет внешней сетью, а лишь пользуется её ресурсами. на платформе может быть настроено несколько внешних сетей с различными диапазонами IP адресов, и существует механизм управления доступом пользователей к внешним сетям. +10. Сетевой доступ к экземпляру _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/4.9.2/04.-Начало-работы-с-terraform-провайдером-DECORT.md b/4.9.2/04.-Начало-работы-с-terraform-провайдером-DECORT.md new file mode 100644 index 00000000..edaa6641 --- /dev/null +++ b/4.9.2/04.-Начало-работы-с-terraform-провайдером-DECORT.md @@ -0,0 +1,6 @@ +Данный раздел описывает: +- Системные требования +- Установку провайдера +- Инициализацию провайдера +- Переключение режима работы между разными группами API +- Получение gid/grid_id площадки diff --git a/4.9.2/04.01-Установка-Terraform-провайдера-DECORT.md b/4.9.2/04.01-Установка-Terraform-провайдера-DECORT.md new file mode 100644 index 00000000..f24b4753 --- /dev/null +++ b/4.9.2/04.01-Установка-Terraform-провайдера-DECORT.md @@ -0,0 +1,149 @@ +## Системные требования + +Для запуска провайдера вам потребуется машина, на которой установлен Terraform. + +Кроме того, в связи с тем, что начиная с версии 0.12 Terraform изменил алгоритм поиска и инициализации локальных провайдеров, настройка данного провайдера для работы с Terraform 0.12 или более новыми версиями потребует выполнения ряда дополнительных действий. Подробнее см. [8.3 Настройка локального провайдера для работы с новыми версиями Terraform](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/08.-Полезные-советы.md#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.9.2 has been successfully installed + +Copy this provider configuration to main.tf file: +terraform { + required_providers { + decort = { + version = "4.9.2" + source = "basis/decort/decort" + } + } +} +``` +7. После этого, создайте файл `main.tf` в рабочей директории, которая может находится в любом удобном для пользователя месте. +В данном примере, рабочая директория с файлом main.tf находится по пути: +```bash +~/work/tfdir/main.tf +``` +8. Вставьте в `main.tf` блок конфигурации провайдера, который был выведен на экран установщиком: +```terraform +terraform { + required_providers { + decort = { + version = "4.9.2" + 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 инициализирует провайдер и будет готов к дальнейшей работе. + +## Ручная установка +Чтобы выполнить установку из релиза вручную, необходимо: +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.9.2" + 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/4.9.2/04.02-Инициализация-Terraform-провайдера-DECORT.md b/4.9.2/04.02-Инициализация-Terraform-провайдера-DECORT.md new file mode 100644 index 00000000..638695a6 --- /dev/null +++ b/4.9.2/04.02-Инициализация-Terraform-провайдера-DECORT.md @@ -0,0 +1,64 @@ +## Список аргументов для инициализации +Перед началом использования любой Terraform провайдер должен быть инициализирован. + +В процессе инициализации Terraform провайдера DECORT проверяется корректность переданных аргументов и выполняется авторизация в указанном контроллере облачной инфраструктуры. Подробнее о способах авторизации на платформе DECORT смотри соответствующий [раздел](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.9.2/03.-Обзор-облачной-платформы-DECORT.md#способы-авторизации). + +При инициализации 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 | DECORT_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/4.9.2/04.04-Получение-gid-или-grid_id.md b/4.9.2/04.04-Получение-gid-или-grid_id.md new file mode 100644 index 00000000..07f3c5ff --- /dev/null +++ b/4.9.2/04.04-Получение-gid-или-grid_id.md @@ -0,0 +1,31 @@ +Платформа может располагаться на нескольких площадках(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_cb_grid_list_, как указано ниже: +```terraform +data "decort_cb_grid_list" "gl" { + +} + +output "test" { + value = data.decort_cb_grid_list.gl +} + +``` +В файл состояния будет сохранен результат, где можно посмотреть доступные для работы площадки. diff --git a/4.9.2/04.05-Сборка-terraform-провайдера.md b/4.9.2/04.05-Сборка-terraform-провайдера.md new file mode 100644 index 00000000..7264d919 --- /dev/null +++ b/4.9.2/04.05-Сборка-terraform-провайдера.md @@ -0,0 +1,34 @@ +## Сборка terraform провайдера +### Требования: +- Docker +- git +- Компилятор языка GO версии 1.20 +- make +### Установка необходимых программ +1. Компилятор языка GO можно скачать и установить по ссылке: https://go.dev/dl/ +2. Docker можно скачать и установить по ссылке выше. +3. Git можно скачать и установить по ссылке: https://git-scm.com/ +4. Программа make входит в пакет установленных программ для ОС Linux. +### Порядок действий +1. Склонировать репозиторий с провайдером: +```bash +git clone https://github.com/rudecs/terraform-provider-decort.git +``` +2. Перейти в директорию со скачанным кодом: +```bash +cd terraform-provider-decort +``` +3. Выполнить команду: +> Сборка на ОС windows может привести к ошибкам. + +> Перед сборкой следует проверить переменные окружения go. Параметр `CGO_ENABLED` должен быть равным 0. + +Для сборки под свою ОС +```bash +make build +``` +Для сборки под все поддерживаемые ОС +```bash +make release +``` +В результате выполнения данной последовательности, будет создан исполняемый файл terraform провайдера. diff --git a/4.9.2/05.-Работа-с-terraform.md b/4.9.2/05.-Работа-с-terraform.md new file mode 100644 index 00000000..675f2ea9 --- /dev/null +++ b/4.9.2/05.-Работа-с-terraform.md @@ -0,0 +1,4 @@ +Раздел описывает некоторые практики работы с terraform, которые могут быть полезны пользователю. +Раздел включает в себя следующие статьи: +- Импортирование ресурсов +- Работа с таймаутами diff --git a/4.9.2/05.01-Импортирование-ресурсов.md b/4.9.2/05.01-Импортирование-ресурсов.md new file mode 100644 index 00000000..eec11cac --- /dev/null +++ b/4.9.2/05.01-Импортирование-ресурсов.md @@ -0,0 +1,84 @@ +Импортирование ресурсов в terraform позволяет привести в соответствие состояние terraform (.tfstate) к состоянию ресурса на платформе. +Необходимость такого приведения возникает в нескольких случаях: +- Ресурс был создан через портал платформы, работа продолжается через terraform провайдер, +- Ресурс был создан через terraform провайдер, однако был изменен через портал платформы, +- Ресурс был создан через terraform провайдер, однако был изменен другим пользователем через terraform провайдер, +- И так далее + +Такие расхождения в состоянии ресурсов нередки, путей их решения несколько: +- Использовать импортирование ресурсов, +- Использовать общие файлы состояний ресурсов, к которым будут иметь доступ все участники, занятые в работе с платформой. +В текущем разделе рассматривается первый вариант. + +## Импортирование ресурсов +Импортирование ресурсов позволяет совершить запрос к платформе, чтобы сформировать файл состояния. +Чтобы совершить импортирование ресурсов необходимо ввести сл. команду: +```bash +terraform import . +``` +или использовать блок +```terraform +import { + to = decort_disk.disk + id = "9" +} +``` +А замтем команду +```bash +terraform apply +``` +## Пример +Предположим, что у нас ресурс, описывающий диск: +```terraform +resource "decort_disk" "disk" { + account_id = 121212 + 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 +``` +или +```bash +Error: Missing required argument +``` +Ошибка возникает в том случае, если в описании ресурса отсутствует обязательное поле. +Например: +```terraform +resource "decort_disk" "disk" { + account_id = 121212 + size_max = 100500 +} +``` +В приведенном выше описании отсутствует поле disk_name, поэтому, при попытке импортирования возникнет ошибка. +Для ее устранения, необходимо выполнить запрос на получение списка дисков, найти недостающее поле, после чего добавить его в описание ресурса. +После этого повторить попытку импортирования. + +> При использовании импорта через команду `terraform import` задание всех необходимых параметров может сразу не потребоваться, однако при попытке обновления ресурса обязательные поля все равно должны быть заполнены. + + diff --git a/4.9.2/05.02-Работа-с-таймаутами.md b/4.9.2/05.02-Работа-с-таймаутами.md new file mode 100644 index 00000000..b8e0c80f --- /dev/null +++ b/4.9.2/05.02-Работа-с-таймаутами.md @@ -0,0 +1,100 @@ +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