diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..e49a135 --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,30 @@ +repos: + - repo: https://github.com/pre-commit/pre-commit-hooks + rev: v5.0.0 + hooks: + - id: end-of-file-fixer + - id: no-commit-to-branch + name: no-commit-to-branch (main, master, dev_*) + args: + - --pattern + - dev_.* + - repo: https://github.com/pycqa/flake8 + rev: 7.2.0 + hooks: + - id: flake8 + exclude: | + (?x)^( + module_utils/decort_utils.py | + library/decort_bservice.py | + library/decort_disk.py | + library/decort_group.py | + library/decort_k8s.py | + library/decort_kvmvm.py | + library/decort_lb.py | + library/decort_osimage.py | + library/decort_pfw.py | + library/decort_rg.py | + library/decort_vins.py + )$ + args: + - --extend-ignore=E402 diff --git a/CHANGELOG.md b/CHANGELOG.md index 5c12f33..aa0852b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,87 +1,122 @@ -# Список изменений в версии 8.0.0 +# Список изменений в версии 9.0.0 ## Добавлено -### Модуль decort_account +### Глобально | Идентификатор
задачи | Описание | | --- | --- | -| BANS-713 | Добавлен параметр `description` и возвращаемое значение `description`. | +| BANS-798 | Обновлены системные требования: версия интерпретатора Python обновлена до 3.12, версия Python-библиотеки ansible обновлена до 11.6.0 | -### Модуль decort_account_info +### Модуль decort_kvmvm | Идентификатор
задачи | Описание | | --- | --- | -| BANS-714 | Добавлено возвращаемое значение `description` для аккаунта и ресурсных групп. | +| BANS-790 | Добавлен параметр `zone_id` и возвращаемое значение `zone_id`. | +| BANS-810 | Добавлен параметр `guest_agent` и возвращаемое значение `guest_agent`. | +| BANS-806 | Добавлен параметр `get_snapshot_merge_status` и возвращаемое значение `snapshot_merge_status`. | +| BANS-823 | Добавлено значение `TRUNK` для параметра `networks.type`. | +| BANS-813 | Добавлено значение `SDN` для параметра `networks.type`. | +| BANS-835 | Добавлена возможность использования параметра `networks.mtu` для внешней сети. | -### Модуль decort_user_info +### Модуль decort_lb | Идентификатор
задачи | Описание | | --- | --- | -| BANS-715 | Добавлено возвращаемое значение `description` для аккаунтов. | -| BANS-718 | Добавлен параметр `audits.sorting`. | -| BANS-725 | Добавлены параметры `audits.filter.time.start.timestamp`, `audits.filter.time.start.datetime`, `audits.filter.time.end.timestamp`, `audits.filter.time.end.datetime`. | +| BANS-793 | Добавлен параметр `zone_id` и возвращаемое значение `zone_id`. | +| BANS-819 | Добавлено возвращаемое значение `account_id`. | +| BANS-800 | Добавлены значения `stopped` и `started` для параметра `state` и возвращаемое значение `tech_status`. | ### Модуль decort_k8s | Идентификатор
задачи | Описание | | --- | --- | -| BANS-717 | Добавлено возвращаемое значение `description`. | +| BANS-794 | Добавлен параметр `zone_id` и возвращаемое значение `zone_id`. | +| BANS-804 | Добавлены значения `stopped` и `started` для параметра `state`. | -### Модуль decort_kvmvm +### Модуль decort_vins | Идентификатор
задачи | Описание | | --- | --- | -| BANS-719 | Добавлены параметры `boot.mode`, `boot.loader_type`, `network_interface_naming`, `hot_resize` и возвращаемые значения `boot_mode`, `boot_loader_type`, `network_interface_naming`, `hot_resize`. | -| BANS-746 | Добавлено возвращаемое значение `pinned_to_stack`. | -| BANS-744 | Добавлены возвращаемые значения `affinity_label`, `affinity_rules` и `anti_affinity_rules`. | -| BANS-724 | Для параметра `state` добавлены значение `started` вместо `poweredon` и значение `stopped` вместо значений `poweredoff` и `halted`. | -| BANS-763 | Добавлен параметр `networks.mac`. | +| BANS-791 | Добавлен параметр `zone_id` и возвращаемое значение `zone_id`. | -### Модуль decort_osimage +### Модуль decort_bservice | Идентификатор
задачи | Описание | | --- | --- | -| BANS-740 | Добавлены параметры `boot.mode`, `boot.loader_type`, `network_interface_naming`, `hot_resize` и возвращаемые значения `boot_mode`, `boot_loader_type`, `network_interface_naming`, `hot_resize`. | +| BANS-792 | Добавлен параметр `zone_id` и возвращаемое значение `zone_id`. | +| BANS-805 | Добавлены значения `stopped` и `started` для параметра `state`. | -### Модуль decort_group +### Модуль decort_user_info | Идентификатор
задачи | Описание | | --- | --- | -| BANS-721 | Добавлен параметр `chipset`. Добавлено возвращаемое значение `Computes.chipset`.| +| BANS-796 | Добавлен параметр `zones` и возвращаемое значение `zones`. | +| BANS-826 | Добавлен параметр `trunks` и возвращаемое значение `trunks`. | -### Модуль decort_disk +### Модуль decort_account | Идентификатор
задачи | Описание | | --- | --- | -| BANS-773 | Добавлены возвращаемые значения `size_available` и `size_used`.| +| BANS-789 | Добавлен параметр `default_zone_id` и возвращаемые значение `zoneIds`, `defaultZoneId`. | -## Удалено -### Общее +### Модуль decort_account_info | Идентификатор
задачи | Описание | | --- | --- | -| BANS-669 | Прекращено использование библиотеки `PyJWT`. | +| BANS-809 | Добавлено значение `MERGE` для параметра `computes.filter.tech_status`. | +| BANS-855 | Добавлены значения `SNAPCREATE`, `CLONING`, `ROLLBACK` для параметра `computes.filter.tech_status`. | -### Модуль decort_k8s +### Модуль decort_rg +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-812 | Добавлен параметр `sdn_access_group_id` и возвращаемое значение `sdn_access_group_id`. | + +### Модуль decort_zone | Идентификатор
задачи | Описание | | --- | --- | -| BANS-711 | Удалена возможность задавать значение больше `1` для параметра `master_count` при `with_lb: false`. | +| BANS-795 | Добавлен модуль `decort_zone` для получения информации о зонах. | + +### Модуль decort_trunk +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-825 | Добавлен модуль `decort_trunk` для получения информации о транковых портах. | + +### Модуль decort_snapshot +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-808 | Добавлено значение `merge_aborted` для параметра `state`. | ### Модуль decort_osimage | Идентификатор
задачи | Описание | | --- | --- | -| BANS-740 | Удалены параметры `hotresize`, `boottype`, `imagetype` в связи с переименованием в `hot_resize`, `boot.mode`, `boot.loader_type`. | +| BANS-849 | Добавлен параметр `account_id`, используемый при создании шаблонных и виртуальных образов. | -### Модуль decort_kvmvm +## Удалено +### Модуль decort_disk | Идентификатор
задачи | Описание | | --- | --- | -| BANS-724 | Для параметра `state` удалены значения `poweredoff` и `halted` в связи с заменой на `stopped` и значение `poweredon` в связи заменой на `started`. | +| BANS-815 | Удалено значение по умолчанию для параметра `description`. | -### Модуль decort_user_info +### Модуль decort_lb | Идентификатор
задачи | Описание | | --- | --- | -| BANS-725 | Удалены параметры `audits.filter.time.start.unix`, `audits.filter.time.start.date_time`, `audits.filter.time.end.unix`, `audits.filter.time.end.date_time` в связи с переименованием. | +| BANS-815 | Удалено значение по умолчанию для параметра `description`. | -## Исправлено ### Модуль decort_k8s | Идентификатор
задачи | Описание | | --- | --- | -| BANS-711 | Модуль завершал свою работу ошибкой запроса к API при недопустимом значении в параметре `master_count`. | +| BANS-804 | Удален параметр `started` в связи с переносом логики в параметр `state` (значение `started`). | -### Модуль decort_kvmvm +### Модуль decort_bservice +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-805 | Удален параметр `started` в связи с переносом логики в параметр `state` (значение `started`). | + +### Модуль decort_osimage +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-849 | Удален параметр `account_Id` в связи с переименованием в `account_id`. | + +## Исправлено +### Модуль decort_lb +| Идентификатор
задачи | Описание | +| --- | --- | +| BANS-803 | Модуль завершал работу ошибкой Python при создании балансировщика с указанием параметра `backends` или `frontends`. | +| BANS-820 | Выполнение модуля с указанием параметра `vins_id` и без указания параметра `ext_net_id` вызывало создание балансировщика с некорректной сетевой конфигурацией, дальнейшее добавление конфигурации backend к которому завершалось ошибкой платформы. | +| BANS-799 | Скорректирована логика параметра целевого состояния `present`. Теперь состояние `present` соответствует тому, что балансировщик нагрузки существует, и не приводит к изменению состояния существующего балансировщика нагрузки. Также для параметра `state` значение по умолчанию `present` теперь только при создании балансировщика нагрузки. | + +### Модуль decort_account | Идентификатор
задачи | Описание | | --- | --- | -| BANS-736 | Модуль завершал свою работу ошибкой запроса к API при попытке отсоединить загрузочный диск у запущенной ВМ. | -| BANS-747 | При создании ВМ со `state: present` модуль запускал ВМ после создания. | -| BANS-733 | Исправлена ошибка при клонировании ВМ в режиме `check_mode: true`. | +| BANS-817 | Модуль некорректно отслеживал завершение удаления и восстановления аккаунта. | diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..d0864a0 --- /dev/null +++ b/Makefile @@ -0,0 +1,3 @@ +dev: + pip install -r requirements-dev.txt + pre-commit install diff --git a/README.md b/README.md index 37e862d..c1edd5b 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,7 @@ | Версия платформы | Версия модулей Ansible | |:----------------:|:--------------------------:| +| 4.4.0 build 963 | 9.0.x | | 4.3.0 | 8.0.x | | 4.2.0 | 7.0.x, 7.1.x, 7.2.x | | 4.1.0 | 6.0.x, 6.1.x | @@ -15,6 +16,6 @@ ## Ссылки -- [Документация](./wiki/Home.md) +- [Документация](https://repository.basistech.ru/BASIS/wiki-decort-ansible/src/branch/main/Home.md) - [Список изменений](./CHANGELOG.md) diff --git a/examples/decort_osimage/create-virtual-osimage.yaml b/examples/decort_osimage/create-virtual-osimage.yaml index 015c21e..5d193e3 100644 --- a/examples/decort_osimage/create-virtual-osimage.yaml +++ b/examples/decort_osimage/create-virtual-osimage.yaml @@ -12,4 +12,3 @@ virt_name: "alpine_last" delegate_to: localhost register: osimage - diff --git a/examples/decort_osimage/rename-osimage.yaml b/examples/decort_osimage/rename-osimage.yaml index eb13642..0a9dcc3 100644 --- a/examples/decort_osimage/rename-osimage.yaml +++ b/examples/decort_osimage/rename-osimage.yaml @@ -12,4 +12,3 @@ image_id: 54321 delegate_to: localhost register: osimage - diff --git a/examples/hashivault/hashivault_example.yaml b/examples/hashivault/hashivault_example.yaml index 7caba86..0130ec1 100644 --- a/examples/hashivault/hashivault_example.yaml +++ b/examples/hashivault/hashivault_example.yaml @@ -32,4 +32,4 @@ state: present rg_id: 99 #Resource group id delegate_to: localhost - register: simple_vm \ No newline at end of file + register: simple_vm diff --git a/examples/hashivault/hashivault_plugin_read_secret.yaml b/examples/hashivault/hashivault_plugin_read_secret.yaml index 05832ab..36991ba 100644 --- a/examples/hashivault/hashivault_plugin_read_secret.yaml +++ b/examples/hashivault/hashivault_plugin_read_secret.yaml @@ -15,4 +15,4 @@ - "Secret: {{ response.secret }}" - "Data: {{ response.data }} (contains secret data & metadata in kv2)" - "Metadata: {{ response.metadata }}" - - "Full response: {{ response.raw }}" \ No newline at end of file + - "Full response: {{ response.raw }}" diff --git a/examples/kubernetes.yaml b/examples/kubernetes.yaml index 065c5f8..84721e0 100644 --- a/examples/kubernetes.yaml +++ b/examples/kubernetes.yaml @@ -36,4 +36,4 @@ num: 2 verify_ssl: false delegate_to: localhost - register: kube \ No newline at end of file + register: kube diff --git a/library/decort_account.py b/library/decort_account.py index b87f43d..bc7f444 100644 --- a/library/decort_account.py +++ b/library/decort_account.py @@ -4,7 +4,7 @@ DOCUMENTATION = r''' --- module: decort_account -description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 ''' from typing import Iterable @@ -114,6 +114,9 @@ class DecortAccount(DecortController): description=dict( type='str', ), + default_zone_id=dict( + type='int', + ), ), required_one_of=[ ('id', 'name') @@ -164,15 +167,24 @@ class DecortAccount(DecortController): if check_error: self.exit(fail=True) + def check_amodule_args_for_change(self): + check_error = False + if self.check_aparam_default_zone_id() is False: + check_error = True + + if check_error: + self.exit(fail=True) + def run(self): self.get_info() + self.check_amodule_args_for_change() self.change() self.exit() def get_info(self): # If this is the first getting info - if not getattr(self, 'id', None): - self.id, self.facts = self.account_find( + if self._acc_info is None: + self.acc_id, self._acc_info = self.account_find( account_name=self.aparams['name'], account_id=self.aparams['id'], ) @@ -181,7 +193,10 @@ class DecortAccount(DecortController): # If check mode is enabled, there is no needed to # request info again if not self.amodule.check_mode: - self.id, self.facts = self.account_find(account_id=self.id) + self.acc_id, self._acc_info = self.account_find( + account_id=self.acc_id, + ) + self.facts = self.acc_info def change(self): self.change_state() @@ -189,12 +204,12 @@ class DecortAccount(DecortController): self.change_acl() if self.account_update_args: - self.account_update(account_id=self.id, + self.account_update(account_id=self.acc_id, **self.account_update_args) self.get_info() def change_state(self): - match self.facts: + match self._acc_info: case None: self.message(self.MESSAGES.obj_not_found(obj=self.OBJ)) match self.aparams: @@ -208,7 +223,7 @@ class DecortAccount(DecortController): self.message( self.MESSAGES.obj_deleted( obj=self.OBJ, - id=self.id, + id=self.acc_id, permanently=True, already=True, ) @@ -216,7 +231,7 @@ class DecortAccount(DecortController): case {'state': 'confirmed' | 'disabled' | 'present'}: self.message( self.MESSAGES.obj_not_restored(obj=self.OBJ, - id=self.id) + id=self.acc_id) ) self.exit(fail=True) case {'status': 'DELETED'}: @@ -225,7 +240,7 @@ class DecortAccount(DecortController): self.message( self.MESSAGES.obj_deleted( obj=self.OBJ, - id=self.id, + id=self.acc_id, permanently=False, already=True, ) @@ -259,26 +274,28 @@ class DecortAccount(DecortController): pass def delete(self, permanently=False): - self.account_delete(account_id=self.id, permanently=permanently) + self.account_delete(account_id=self.acc_id, permanently=permanently) self.get_info() def disable(self): - self.account_disable(account_id=self.id) + self.account_disable(account_id=self.acc_id) self.get_info() def enable(self): - self.account_enable(account_id=self.id) + self.account_enable(account_id=self.acc_id) self.get_info() def restore(self): - self.account_restore(account_id=self.id) + self.account_restore(account_id=self.acc_id) self.get_info() def change_acl(self): if not self.aparams['acl']: return - actual_users = {u['userGroupId']: u['right'] for u in self.facts['acl']} + actual_users = { + u['userGroupId']: u['right'] for u in self.acc_info['acl'] + } actual_users_ids = set(actual_users.keys()) aparams_acl = self.aparams['acl'] @@ -291,9 +308,13 @@ class DecortAccount(DecortController): match aparams_acl: case {'mode': 'revoke'}: - del_users_ids = aparams_users_ids.intersection(actual_users_ids) + del_users_ids = aparams_users_ids.intersection( + actual_users_ids, + ) case {'mode': 'update' | 'match' as mode}: - new_users_ids = aparams_users_ids.difference(actual_users_ids) + new_users_ids = aparams_users_ids.difference( + actual_users_ids, + ) new_users = dict( u for u in aparams_users.items() if u[0] in new_users_ids ) @@ -315,7 +336,7 @@ class DecortAccount(DecortController): actual_users_ids.difference(aparams_users_ids) if del_users_ids or new_users or upd_users: - self.account_change_acl(account_id=self.id, + self.account_change_acl(account_id=self.acc_id, del_users=del_users_ids, add_users=new_users, upd_users=upd_users) @@ -327,12 +348,12 @@ class DecortAccount(DecortController): aparam_access_emails = self.aparams['access_emails'] if (aparam_access_emails is not None - and self.facts['sendAccessEmails'] != aparam_access_emails): + and self.acc_info['sendAccessEmails'] != aparam_access_emails): result_args['access_emails'] = aparam_access_emails aparam_name = self.aparams['name'] if (self.aparams['id'] and aparam_name - and self.facts['name'] != aparam_name): + and self.acc_info['name'] != aparam_name): result_args['name'] = aparam_name aparam_quotas = self.aparams['quotas'] @@ -346,7 +367,7 @@ class DecortAccount(DecortController): ['ram', 'CU_M', 'ram_quota'], ] for aparam, info_key, result_arg in quotas_naming: - current_value = int(self.facts['resourceLimits'][info_key]) + current_value = int(self.acc_info['resourceLimits'][info_key]) if (aparam_quotas[aparam] is not None and current_value != aparam_quotas[aparam]): result_args[result_arg] = aparam_quotas[aparam] @@ -359,18 +380,38 @@ class DecortAccount(DecortController): sep_pools.add( f'{sep["sep_id"]}_{pool_name}' ) - if set(self.facts['uniqPools']) != sep_pools: + if set(self.acc_info['uniqPools']) != sep_pools: result_args['sep_pools'] = sep_pools aparam_desc = self.aparams['description'] if ( aparam_desc is not None - and self.facts['description'] != aparam_desc + and self.acc_info['description'] != aparam_desc ): result_args['description'] = aparam_desc + aparam_default_zone_id = self.aparams['default_zone_id'] + if ( + aparam_default_zone_id is not None + and self.acc_info['defaultZoneId'] != aparam_default_zone_id + ): + result_args['default_zone_id'] = aparam_default_zone_id + return result_args + def check_aparam_default_zone_id(self) -> bool | None: + aparam_default_zone_id = self.aparams['default_zone_id'] + if aparam_default_zone_id is not None: + if aparam_default_zone_id in self.acc_zone_ids: + return True + else: + self.message( + 'Check for parameter "default_zone_id" failed: ' + f'zone ID {aparam_default_zone_id} not available ' + f'for account ID {self.acc_id}.' + ) + return False + def main(): DecortAccount().run() diff --git a/library/decort_account_info.py b/library/decort_account_info.py index 6eb09a3..ce47859 100644 --- a/library/decort_account_info.py +++ b/library/decort_account_info.py @@ -4,7 +4,7 @@ DOCUMENTATION = r''' --- module: decort_account_info -description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 ''' from ansible.module_utils.basic import AnsibleModule @@ -78,8 +78,7 @@ class DecortAccountInfo(DecortController): ), field=dict( type='str', - choices=\ - self.FIELDS_FOR_SORTING_ACCOUNT_COMPUTE_LIST, + choices=self.FIELDS_FOR_SORTING_ACCOUNT_COMPUTE_LIST, # noqa: E501 required=True, ), ), @@ -129,8 +128,7 @@ class DecortAccountInfo(DecortController): ), field=dict( type='str', - choices=\ - self.FIELDS_FOR_SORTING_ACCOUNT_DISK_LIST, + choices=self.FIELDS_FOR_SORTING_ACCOUNT_DISK_LIST, # noqa: E501 required=True, ), ), @@ -221,8 +219,7 @@ class DecortAccountInfo(DecortController): ), field=dict( type='str', - choices=\ - self.FIELDS_FOR_SORTING_ACCOUNT_IMAGE_LIST, + choices=self.FIELDS_FOR_SORTING_ACCOUNT_IMAGE_LIST, # noqa: E501 required=True, ), ), @@ -278,8 +275,7 @@ class DecortAccountInfo(DecortController): ), field=dict( type='str', - choices=\ - self.FIELDS_FOR_SORTING_ACCOUNT_RG_LIST, + choices=self.FIELDS_FOR_SORTING_ACCOUNT_RG_LIST, # noqa: E501 required=True, ), ), @@ -332,8 +328,7 @@ class DecortAccountInfo(DecortController): ), field=dict( type='str', - choices=\ - self.FIELDS_FOR_SORTING_ACCOUNT_VINS_LIST, + choices=self.FIELDS_FOR_SORTING_ACCOUNT_VINS_LIST, # noqa: E501 required=True, ), ), diff --git a/library/decort_bservice.py b/library/decort_bservice.py index aa62b79..8edeca6 100644 --- a/library/decort_bservice.py +++ b/library/decort_bservice.py @@ -20,6 +20,7 @@ class decort_bservice(DecortController): validated_acc_id = 0 validated_rg_id = 0 self.bservice_info = None + self.is_bservice_stopped_or_will_be_stopped: None | bool = None if arg_amodule.params['name'] == "" and arg_amodule.params['id'] == 0: self.result['failed'] = True self.result['changed'] = False @@ -27,7 +28,7 @@ class decort_bservice(DecortController): self.fail_json(**self.result) if not arg_amodule.params['id']: if not arg_amodule.params['rg_id']: # RG ID is not set -> locate RG by name -> need account ID - validated_acc_id, _ = self.account_find(arg_amodule.params['account_name'], + validated_acc_id, self.acc_info = self.account_find(arg_amodule.params['account_name'], arg_amodule.params['account_id']) if not validated_acc_id: self.result['failed'] = True @@ -53,7 +54,7 @@ class decort_bservice(DecortController): arg_amodule.params['rg_id'] = validated_rg_id arg_amodule.params['rg_name'] = validated_rg_facts['name'] validated_acc_id = validated_rg_facts['accountId'] - + self.bservice_id, self.bservice_info = self.bservice_find( validated_acc_id, validated_rg_id, @@ -61,10 +62,14 @@ class decort_bservice(DecortController): arg_amodule.params['id'] ) - if self.bservice_id == 0: - self.bservice_should_exist = False - else: + self.acc_id = validated_acc_id or self.bservice_info['accountId'] + + if self.bservice_id and self.bservice_info['status'] != 'DESTROYED': self.bservice_should_exist = True + self.check_amodule_args_for_change() + else: + self.bservice_should_exist = False + self.check_amodule_args_for_create() def nop(self): """No operation (NOP) handler for B-service. @@ -103,15 +108,23 @@ class decort_bservice(DecortController): self.amodule.params['name'], self.amodule.params['rg_id'], self.amodule.params['sshuser'], - self.amodule.params['sshkey'] + self.amodule.params['sshkey'], + zone_id=self.aparams['zone_id'], ) if self.bservice_id: _, self.bservice_info = self.bservice_get_by_id(self.bservice_id) - self.bservice_state(self.bservice_info,'enabled',self.amodule.params['started']) + self.bservice_state(self.bservice_info,'enabled') return - def action(self,d_state,started=False): - self.bservice_state(self.bservice_info,d_state,started) + def action(self,d_state): + self.bservice_state(self.bservice_info,d_state) + + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None and aparam_zone_id != self.bservice_info['zoneId']: + self.bservice_migrate_to_zone( + bs_id=self.bservice_id, + zone_id=aparam_zone_id, + ) return def restore(self): @@ -147,6 +160,7 @@ class decort_bservice(DecortController): ret_dict['rg_id'] = self.bservice_info['rgId'] ret_dict['account_id'] = self.bservice_info['accountId'] ret_dict['groups'] = self.bservice_info['groups'] + ret_dict['zone_id'] = self.bservice_info['zoneId'] return ret_dict @property @@ -168,13 +182,10 @@ class decort_bservice(DecortController): 'disabled', 'enabled', 'present', - 'check', + 'started', + 'stopped', ], ), - started=dict( - type='bool', - default=True, - ), name=dict( type='str', default='', @@ -197,6 +208,9 @@ class decort_bservice(DecortController): type='str', default='', ), + zone_id=dict( + type='int', + ), ), supports_check_mode=True, required_one_of=[ @@ -204,12 +218,54 @@ class decort_bservice(DecortController): ('rg_id', 'rg_name'), ], ) + + def check_amodule_args_for_change(self): + check_errors = False + + self.is_bservice_stopped_or_will_be_stopped = ( + ( + self.bservice_info['techStatus'] == 'STOPPED' + and ( + self.aparams['state'] is None + or self.aparams['state'] in ('present', 'stopped') + ) + ) + or ( + self.bservice_info['techStatus'] != 'STOPPED' + and self.aparams['state'] == 'stopped' + ) + ) + + if self.check_aparam_zone_id() is False: + check_errors = True + if ( + self.aparams['zone_id'] is not None + and self.aparams['zone_id'] != self.bservice_info['zoneId'] + and not self.is_bservice_stopped_or_will_be_stopped + ): + check_errors = True + self.message( + 'Check for parameter "zone_id" failed: ' + 'Basic Service must be stopped to migrate to a zone.' + ) + + if check_errors: + self.exit(fail=True) + + def check_amodule_args_for_create(self): + check_errors = False + if self.check_aparam_zone_id() is False: + check_errors = True + + if check_errors: + self.exit(fail=True) + def main(): subj = decort_bservice() amodule = subj.amodule - if amodule.params['state'] == 'check': + if subj.amodule.check_mode: subj.result['changed'] = False if subj.bservice_id: subj.result['failed'] = False @@ -235,30 +291,23 @@ def main(): "ENABLING","DISABLING","RESTORING","MODELED"): subj.error() elif subj.bservice_info['status'] == "DELETED": - if amodule.params['state'] in ('disabled', 'enabled', 'present'): + if amodule.params['state'] in ( + 'disabled', 'enabled', 'present', 'started', 'stopped' + ): subj.restore(subj.bservice_id) - subj.action(amodule.params['state'],amodule.params['started']) + subj.action(amodule.params['state']) if amodule.params['state'] == 'absent': subj.nop() - elif subj.bservice_info['techStatus'] in ("STARTED","STOPPED"): - if amodule.params['state'] == 'disabled': - subj.action(amodule.params['state'],amodule.params['started']) - elif amodule.params['state'] == 'absent': - subj.destroy() - else: - subj.action(amodule.params['state'],amodule.params['started']) - elif subj.bservice_info['status'] == "DISABLED": + elif subj.bservice_info['status'] in ('ENABLED', 'DISABLED'): if amodule.params['state'] == 'absent': subj.destroy() - elif amodule.params['state'] in ('present','enabled'): - subj.action(amodule.params['state'],amodule.params['started']) else: - subj.nop() + subj.action(amodule.params['state']) elif subj.bservice_info['status'] == "DESTROED": if amodule.params['state'] in ('present','enabled'): subj.create() - subj.action(amodule.params['state'],amodule.params['started']) - if amodule.params['state'] == 'absent': + subj.action(amodule.params['state']) + if amodule.params['state'] == 'absent': subj.nop() else: if amodule.params['state'] == 'absent': @@ -272,9 +321,10 @@ def main(): amodule.fail_json(**subj.result) else: if subj.bservice_should_exist: + _, subj.bservice_info = subj.bservice_get_by_id(subj.bservice_id) subj.result['facts'] = subj.package_facts(amodule.check_mode) amodule.exit_json(**subj.result) else: amodule.exit_json(**subj.result) if __name__ == "__main__": - main() \ No newline at end of file + main() diff --git a/library/decort_disk.py b/library/decort_disk.py index 44fb3b5..b9eb521 100644 --- a/library/decort_disk.py +++ b/library/decort_disk.py @@ -52,7 +52,7 @@ class decort_disk(DecortController): self.amodule.fail_json(**self.result) self.acc_id = validated_acc_id - self.acc_info = validated_acc_info + self._acc_info = validated_acc_info validated_disk_id, validated_disk_facts = self.disk_find( disk_id=arg_amodule.params['id'], name=arg_amodule.params['name'] if "name" in arg_amodule.params else "", @@ -192,7 +192,6 @@ class decort_disk(DecortController): ), description=dict( type='str', - default='Disk by decort_disk', ), id=dict( type='int', @@ -348,4 +347,4 @@ def main(): if __name__ == "__main__": main() -#SHARE \ No newline at end of file +#SHARE diff --git a/library/decort_group.py b/library/decort_group.py index 07a04f9..5636b18 100644 --- a/library/decort_group.py +++ b/library/decort_group.py @@ -389,4 +389,4 @@ def main(): amodule.exit_json(**subj.result) if __name__ == "__main__": - main() \ No newline at end of file + main() diff --git a/library/decort_jwt.py b/library/decort_jwt.py index 30c3099..80f7903 100644 --- a/library/decort_jwt.py +++ b/library/decort_jwt.py @@ -4,7 +4,7 @@ DOCUMENTATION = r''' --- module: decort_jwt -description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 ''' from ansible.module_utils.basic import AnsibleModule diff --git a/library/decort_k8s.py b/library/decort_k8s.py index 68dffb6..df24506 100644 --- a/library/decort_k8s.py +++ b/library/decort_k8s.py @@ -23,6 +23,7 @@ class decort_k8s(DecortController): validated_rg_facts = None validated_k8ci_id = 0 self.k8s_should_exist = False + self.is_k8s_stopped_or_will_be_stopped: None | bool = None self.wg_default_params = { 'num': 1, @@ -77,62 +78,12 @@ class decort_k8s(DecortController): rg_id=validated_rg_id, check_state=False) - if self.k8s_id: + if self.k8s_id and self.k8s_info['status'] != 'DESTROYED': self.k8s_should_exist = True self.acc_id = self.k8s_info['accountId'] - # check workers and groups for add or remove? - - aparam_sysctl = arg_amodule.params['lb_sysctl'] - if aparam_sysctl is not None: - _, lb_info = self._lb_get_by_id(lb_id=self.k8s_info['lbId']) - sysctl_with_str_values = { - k: str(v) for k, v in aparam_sysctl.items() - } - if sysctl_with_str_values != lb_info['sysctlParams']: - self.message( - 'Check for parameter "lb_sysctl" failed: ' - 'cannot change lb_sysctl for an existing cluster ' - 'load balancer.' - ) - self.exit(fail=True) - - if not self.k8s_id: - validated_k8ci_id = self.k8s_k8ci_find(arg_amodule.params['k8ci_id']) - if not validated_k8ci_id: - self.result['failed'] = True - self.result['changed'] = False - self.result['msg'] = "Cannot find K8CI ID {}.".format(arg_amodule.params['k8ci_id']) - self.amodule.fail_json(**self.result) - - if not arg_amodule.params['workers']: - self.result['failed'] = True - self.result['changed'] = False - self.result['msg'] = "At least one worker group must be present" - self.amodule.fail_json(**self.result) - - if ( - arg_amodule.params['lb_sysctl'] is not None - and not arg_amodule.params['with_lb'] - ): - self.message( - 'Check for parameter "lb_sysctl" failed: ' - '"lb_sysctl" can only be set if the parameter "with_lb" ' - 'is set to True.' - ) - self.exit(fail=True) - - if ( - self.aparams['master_count'] is not None - and self.aparams['master_count'] > 1 - and not self.aparams['with_lb'] - ): - self.message( - 'Check for parameter "master_count" failed: ' - 'master_count can be more than 1 only if the parameter ' - '"with_lb" is set to True.' - ) - self.exit(fail=True) - + self.check_amodule_args_for_change() + else: + self.check_amodule_args_for_create() return def package_facts(self,check_mode=False): @@ -168,6 +119,7 @@ class decort_k8s(DecortController): ret_dict['k8s_Workers'] = self.k8s_info['k8sGroups']['workers'] ret_dict['lb_id'] = self.k8s_info['lbId'] ret_dict['description'] = self.k8s_info['desc'] + ret_dict['zone_id'] = self.k8s_info['zoneId'] return ret_dict @@ -240,6 +192,7 @@ class decort_k8s(DecortController): self.amodule.params['extnet_only'], master_chipset, lb_sysctl=self.amodule.params['lb_sysctl'], + zone_id=self.aparams['zone_id'], ) if not k8s_id: @@ -270,7 +223,7 @@ class decort_k8s(DecortController): self.k8s_should_exist = False return - def action(self, disared_state, started=True, preupdate: bool = False): + def action(self, disared_state, preupdate: bool = False): if self.amodule.params['master_chipset'] is not None: for master_node in self.k8s_info['k8sGroups']['masters'][ 'detailedInfo' @@ -292,14 +245,19 @@ class decort_k8s(DecortController): # K8s info updating self.k8s_info = self.k8s_get_by_id(k8s_id=self.k8s_id) #k8s state - self.k8s_state(self.k8s_info, disared_state, started) + self.k8s_state(self.k8s_info, disared_state) self.k8s_info = self.k8s_get_by_id(k8s_id=self.k8s_id) - if started == True and self.k8s_info['techStatus'] == "STOPPED": - self.k8s_state(self.k8s_info, disared_state,started) - self.k8s_info['techStatus'] == "STARTED" #check groups and modify if needed if self.aparams['workers'] is not None: self.k8s_workers_modify(self.k8s_info, self.amodule.params['workers']) + + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None and aparam_zone_id != self.k8s_info['zoneId']: + self.k8s_migrate_to_zone( + k8s_id=self.k8s_id, + zone_id=aparam_zone_id, + ) + if self.result['changed'] == True: self.k8s_info = self.k8s_get_by_id(k8s_id=self.k8s_id) #TODO check workers metadata and modify if needed @@ -328,17 +286,14 @@ class decort_k8s(DecortController): 'disabled', 'enabled', 'present', - 'check', + 'started', + 'stopped', ], ), permanent=dict( type='bool', default=False, ), - started=dict( - type='bool', - default=True, - ), name=dict( type='str', default='', @@ -490,18 +445,110 @@ class decort_k8s(DecortController): lb_sysctl=dict( type='dict', ), + zone_id=dict( + type='int', + ), ), supports_check_mode=True, required_one_of=[ ('id', 'name'), ], ) + + def check_amodule_args_for_change(self): + check_errors = False + + self.is_k8s_stopped_or_will_be_stopped = ( + ( + self.k8s_info['techStatus'] == 'STOPPED' + and ( + self.aparams['state'] is None + or self.aparams['state'] in ('present', 'stopped') + ) + ) + or ( + self.k8s_info['techStatus'] != 'STOPPED' + and self.aparams['state'] == 'stopped' + ) + ) + + aparam_sysctl = self.aparams['lb_sysctl'] + if aparam_sysctl is not None: + _, lb_info = self._lb_get_by_id(lb_id=self.k8s_info['lbId']) + sysctl_with_str_values = { + k: str(v) for k, v in aparam_sysctl.items() + } + if sysctl_with_str_values != lb_info['sysctlParams']: + self.message( + 'Check for parameter "lb_sysctl" failed: ' + 'cannot change lb_sysctl for an existing cluster ' + 'load balancer.' + ) + check_errors = True + + if self.check_aparam_zone_id() is False: + check_errors = True + if ( + self.aparams['zone_id'] is not None + and self.aparams['zone_id'] != self.k8s_info['zoneId'] + and not self.is_k8s_stopped_or_will_be_stopped + ): + check_errors = True + self.message( + 'Check for parameter "zone_id" failed: ' + 'K8s cluster must be stopped to migrate to a zone.' + ) + + if check_errors: + self.exit(fail=True) + + def check_amodule_args_for_create(self): + check_errors = False + + validated_k8ci_id = self.k8s_k8ci_find(self.aparams['k8ci_id']) + if not validated_k8ci_id: + self.message(f'Cannot find K8CI ID {"k8ci_id"}.') + check_errors = True + + if not self.aparams['workers']: + self.message('At least one worker group must be present.') + check_errors = True + + if ( + self.aparams['lb_sysctl'] is not None + and not self.aparams['with_lb'] + ): + self.message( + 'Check for parameter "lb_sysctl" failed: ' + '"lb_sysctl" can only be set if the parameter "with_lb" ' + 'is set to True.' + ) + check_errors = True + + if ( + self.aparams['master_count'] is not None + and self.aparams['master_count'] > 1 + and not self.aparams['with_lb'] + ): + self.message( + 'Check for parameter "master_count" failed: ' + 'master_count can be more than 1 only if the parameter ' + '"with_lb" is set to True.' + ) + check_errors = True + + if self.check_aparam_zone_id() is False: + check_errors = True + + if check_errors: + self.exit(fail=True) + def main(): subj = decort_k8s() amodule = subj.amodule - if amodule.params['state'] == 'check': + if subj.amodule.check_mode: subj.result['changed'] = False if subj.k8s_id: # cluster is found - package facts and report success to Ansible @@ -521,7 +568,9 @@ def main(): "ENABLING","DISABLING","RESTORING","MODELED"): subj.error() elif subj.k8s_info['status'] == "DELETED": - if amodule.params['state'] in ('disabled', 'enabled', 'present'): + if amodule.params['state'] in ( + 'disabled', 'enabled', 'present', 'started', 'stopped' + ): subj.k8s_restore(subj.k8s_id) subj.action(disared_state=amodule.params['state'], preupdate=True) @@ -530,24 +579,15 @@ def main(): subj.destroy() else: subj.nop() - elif subj.k8s_info['techStatus'] in ("STARTED","STOPPED"): - if amodule.params['state'] == 'disabled': - subj.action(amodule.params['state']) - elif amodule.params['state'] == 'absent': - subj.destroy() - else: - subj.action(amodule.params['state'],amodule.params['started']) - elif subj.k8s_info['status'] == "DISABLED": + elif subj.k8s_info['status'] in ('ENABLED', 'DISABLED'): if amodule.params['state'] == 'absent': subj.destroy() - elif amodule.params['state'] in ('present','enabled'): - subj.action(amodule.params['state'],amodule.params['started']) else: - subj.nop() - elif subj.k8s_info['status'] == "DESTROED": + subj.action(disared_state=amodule.params['state']) + elif subj.k8s_info['status'] == "DESTROYED": if amodule.params['state'] in ('present','enabled'): subj.create() - if amodule.params['state'] == 'absent': + if amodule.params['state'] == 'absent': subj.nop() else: if amodule.params['state'] == 'absent': diff --git a/library/decort_kvmvm.py b/library/decort_kvmvm.py index 8688442..6ae84ce 100644 --- a/library/decort_kvmvm.py +++ b/library/decort_kvmvm.py @@ -18,6 +18,9 @@ DefaultT = TypeVar('DefaultT') class decort_kvmvm(DecortController): + is_vm_stopped_or_will_be_stopped: None | bool = None + guest_agent_exec_result: None | str = None + def __init__(self): # call superclass constructor first super(decort_kvmvm, self).__init__(AnsibleModule(**self.amodule_init_args)) @@ -31,20 +34,22 @@ class decort_kvmvm(DecortController): # This following flag is used to avoid extra (and unnecessary) get of compute details prior to # packaging facts before the module completes. As "" self.skip_final_get = False + self.force_final_get = False self.comp_id = 0 self.comp_info = None - self.acc_id = 0 self.rg_id = 0 self.aparam_image = None - - validated_acc_id =0 + validated_acc_id = 0 validated_rg_id = 0 validated_rg_facts = None self.vm_to_clone_id = 0 self.vm_to_clone_info = None + if self.aparams['get_snapshot_merge_status']: + self.force_final_get = True + if arg_amodule.params['clone_from'] is not None: self.vm_to_clone_id, self.vm_to_clone_info, _ = ( self._compute_get_by_id( @@ -101,7 +106,7 @@ class decort_kvmvm(DecortController): if not comp_id: # manage Compute by name -> need RG identity if not arg_amodule.params['rg_id']: # RG ID is not set -> locate RG by name -> need account ID - validated_acc_id, _ = self.account_find(arg_amodule.params['account_name'], + validated_acc_id, self._acc_info = self.account_find(arg_amodule.params['account_name'], arg_amodule.params['account_id']) if not validated_acc_id: self.result['failed'] = True @@ -142,6 +147,7 @@ class decort_kvmvm(DecortController): if self.comp_id: self.comp_should_exist = True self.acc_id = self.comp_info['accountId'] + self.rg_id = self.comp_info['rgId'] self.check_amodule_args_for_change() else: if self.amodule.params['state'] != 'absent': @@ -186,18 +192,82 @@ class decort_kvmvm(DecortController): 'to a DPDK network.' ) for net in aparam_nets: - # MTU for non-DPDK networks + net_type = net['type'] + if ( - net['type'] != self.VMNetType.DPDK.value - and net['mtu'] is not None + net['type'] not in ( + self.VMNetType.SDN.value, + self.VMNetType.EMPTY.value, + ) + and not isinstance(net['id'], int) ): check_error = True self.message( - 'Check for parameter "networks" failed:' - ' MTU can be specifed only for DPDK network' - ' (remove parameter "mtu" for network' - f' {net["type"]} with ID {net["id"]}).' + 'Check for parameter "networks" failed: ' + 'Type of parameter "id" must be integer for ' + f'{net["type"]} network type' + ) + + # MTU + net_mtu = net['mtu'] + if net_mtu is not None: + mtu_net_types = ( + self.VMNetType.DPDK.value, + self.VMNetType.EXTNET.value, ) + + # Allowed network types for set MTU + if net_type not in mtu_net_types: + check_error = True + self.message( + 'Check for parameter "networks" failed:' + ' MTU can be specifed' + ' only for DPDK or EXTNET network' + ' (remove parameter "mtu" for network' + f' {net["type"]} with ID {net["id"]}).' + ) + + # Maximum MTU + MAX_MTU = 9216 + if net_type in mtu_net_types and net_mtu > MAX_MTU: + check_error = True + self.message( + 'Check for parameter "networks" failed:' + f' MTU must be no more than {MAX_MTU}' + ' (change value for parameter "mtu" for network' + f' {net["type"]} with ID {net["id"]}).' + ) + + # EXTNET minimum MTU + EXTNET_MIN_MTU = 1500 + if ( + net_type == self.VMNetType.EXTNET.value + and net_mtu < EXTNET_MIN_MTU + ): + check_error = True + self.message( + 'Check for parameter "networks" failed:' + f' MTU for {self.VMNetType.EXTNET.value} network' + f' must be at least {EXTNET_MIN_MTU}' + ' (change value for parameter "mtu" for network' + f' {net["type"]} with ID {net["id"]}).' + ) + + # DPDK minimum MTU + DPDK_MIN_MTU = 1 + if ( + net_type == self.VMNetType.DPDK.value + and net_mtu < DPDK_MIN_MTU + ): + check_error = True + self.message( + 'Check for parameter "networks" failed:' + f' MTU for {self.VMNetType.DPDK.value} network' + f' must be at least {DPDK_MIN_MTU}' + ' (change value for parameter "mtu" for network' + f' {net["type"]} with ID {net["id"]}).' + ) + # MAC address if net['mac'] is not None: if net['type'] == self.VMNetType.EMPTY.value: @@ -220,7 +290,20 @@ class decort_kvmvm(DecortController): 'specified in quotes and in the format ' '"XX:XX:XX:XX:XX:XX".' ) - + if self.VMNetType.SDN.value in net_types: + if not net_types.issubset( + { + self.VMNetType.SDN.value, + self.VMNetType.EMPTY.value, + self.VMNetType.VFNIC.value, + } + ): + check_error = True + self.message( + 'Check for parameter "networks" failed: ' + 'a compute can be connected to a SDN network and ' + 'only to VFNIC, EMPTY networks at the same time.' + ) aparam_custom_fields = self.aparams['custom_fields'] if aparam_custom_fields is not None: if ( @@ -458,7 +541,8 @@ class decort_kvmvm(DecortController): boot_mode=boot_mode, boot_loader_type=loader_type, network_interface_naming=network_interface_naming, - hot_resize=hot_resize,) + hot_resize=hot_resize, + zone_id=self.aparams['zone_id'],) self.comp_should_exist = True # Originally we would have had to re-read comp_info after VM was provisioned @@ -636,6 +720,40 @@ class decort_kvmvm(DecortController): custom_fields=aparam_custom_fields['fields'], ) + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None and aparam_zone_id != self.comp_info['zoneId']: + self.compute_migrate_to_zone( + compute_id=self.comp_id, + zone_id=aparam_zone_id, + ) + + aparam_guest_agent = self.aparams['guest_agent'] + if aparam_guest_agent is not None: + if aparam_guest_agent['enabled'] is not None: + if ( + aparam_guest_agent['enabled'] + and not self.comp_info['qemu_guest']['enabled'] + ): + self.compute_guest_agent_enable(vm_id=self.comp_id) + elif ( + aparam_guest_agent['enabled'] is False + and self.comp_info['qemu_guest']['enabled'] + ): + self.compute_guest_agent_disable(vm_id=self.comp_id) + + if aparam_guest_agent['update_available_commands']: + self.compute_guest_agent_feature_update(vm_id=self.comp_id) + + aparam_guest_agent_exec = aparam_guest_agent['exec'] + if aparam_guest_agent_exec is not None: + self.guest_agent_exec_result = ( + self.compute_guest_agent_execute( + vm_id=self.comp_id, + cmd=aparam_guest_agent_exec['cmd'], + args=aparam_guest_agent_exec['args'], + ) + ) + return @property @@ -779,7 +897,7 @@ class decort_kvmvm(DecortController): # If it does - save public IP address of GW VNF in ret_dict['nat_ip'] elif iface['connType'] == "VLAN": # This is direct external network connection ret_dict['public_ips'].append(iface['ipAddress']) - + ret_dict['cpu'] = self.comp_info['cpus'] ret_dict['ram'] = self.comp_info['ram'] @@ -830,6 +948,18 @@ class decort_kvmvm(DecortController): ret_dict['affinity_rules'] = self.comp_info['affinityRules'] ret_dict['anti_affinity_rules'] = self.comp_info['antiAffinityRules'] + ret_dict['zone_id'] = self.comp_info['zoneId'] + + ret_dict['guest_agent'] = self.comp_info['qemu_guest'] + + if self.guest_agent_exec_result: + ret_dict['guest_agent']['exec_result'] = self.guest_agent_exec_result # noqa: E501 + + if self.amodule.params['get_snapshot_merge_status']: + ret_dict['snapshot_merge_status'] = ( + self.comp_info['snapshot_merge_status'] + ) + return ret_dict def check_amodule_args_for_create(self): @@ -918,6 +1048,30 @@ class decort_kvmvm(DecortController): ' to a DPDK network.' ) + if self.check_aparam_zone_id() is False: + check_errors = True + + if self.aparams['guest_agent'] is not None: + check_errors = True + self.message( + 'Check for parameter "guest_agent" failed: ' + 'guest_agent can be specified only for existing VM.' + ) + + if self.aparams['get_snapshot_merge_status']: + check_errors = True + self.message( + 'Check for parameter "get_snapshot_merge_status" failed: ' + 'snapshot merge status can be retrieved only for existing VM.' + ) + + aparam_networks = self.aparams['networks'] + if aparam_networks is not None: + net_types = {net['type'] for net in aparam_networks} + if self.VMNetType.TRUNK.value in net_types: + if self.check_aparam_networks_trunk() is False: + check_errors = True + if check_errors: self.exit(fail=True) @@ -1019,11 +1173,13 @@ class decort_kvmvm(DecortController): 'EXTNET', 'VFNIC', 'DPDK', + 'TRUNK', + 'SDN', 'EMPTY', ], ), id=dict( - type='int', + type='raw', ), ip_addr=dict( type='str', @@ -1040,6 +1196,8 @@ class decort_kvmvm(DecortController): ('type', 'EXTNET', ('id',)), ('type', 'VFNIC', ('id',)), ('type', 'DPDK', ('id',)), + ('type', 'TRUNK', ('id',)), + ('type', 'SDN', ('id', 'mac')), ], ), network_order_changing=dict( @@ -1180,6 +1338,36 @@ class decort_kvmvm(DecortController): hot_resize=dict( type='bool', ), + zone_id=dict( + type='int', + ), + guest_agent=dict( + type='dict', + options=dict( + enabled=dict( + type='bool', + ), + exec=dict( + type='dict', + options=dict( + cmd=dict( + type='str', + required=True, + ), + args=dict( + type='dict', + default={}, + ), + ), + ), + update_available_commands=dict( + type='bool', + ), + ), + ), + get_snapshot_merge_status=dict( + type='bool', + ), ), supports_check_mode=True, required_one_of=[ @@ -1196,6 +1384,24 @@ class decort_kvmvm(DecortController): comp_info = self.vm_to_clone_info or self.comp_info comp_id = comp_info['id'] + self.is_vm_stopped_or_will_be_stopped = ( + ( + comp_info['techStatus'] == 'STOPPED' + and ( + self.amodule.params['state'] is None + or self.amodule.params['state'] in ( + 'halted', 'poweredoff', 'present', 'stopped', + ) + ) + ) + or ( + comp_info['techStatus'] != 'STOPPED' + and self.amodule.params['state'] in ( + 'halted', 'poweredoff', 'stopped', + ) + ) + ) + aparam_boot = self.amodule.params['boot'] if aparam_boot is not None: new_boot_disk_size = aparam_boot['disk_size'] @@ -1285,26 +1491,8 @@ class decort_kvmvm(DecortController): 'state for a blank Compute can not be "started" or "paused".' ) - is_vm_stopped_or_will_be_stopped = ( - ( - comp_info['techStatus'] == 'STOPPED' - and ( - self.amodule.params['state'] is None - or self.amodule.params['state'] in ( - 'halted', 'poweredoff', 'present', 'stopped', - ) - ) - ) - or ( - comp_info['techStatus'] != 'STOPPED' - and self.amodule.params['state'] in ( - 'halted', 'poweredoff', 'stopped', - ) - ) - ) - if self.amodule.params['rollback_to'] is not None: - if not is_vm_stopped_or_will_be_stopped: + if not self.is_vm_stopped_or_will_be_stopped: check_errors = True self.message( 'Check for parameter "rollback_to" failed: ' @@ -1334,7 +1522,7 @@ class decort_kvmvm(DecortController): if ( self.aparams[param_name] is not None and comp_info[comp_field_name] != self.aparams[param_name] - and not is_vm_stopped_or_will_be_stopped + and not self.is_vm_stopped_or_will_be_stopped ): check_errors = True self.message( @@ -1343,7 +1531,7 @@ class decort_kvmvm(DecortController): ) if self.aparams['preferred_cpu_cores'] is not None: - if not is_vm_stopped_or_will_be_stopped: + if not self.is_vm_stopped_or_will_be_stopped: check_errors = True self.message( 'Check for parameter "preferred_cpu_cores" failed: ' @@ -1407,7 +1595,7 @@ class decort_kvmvm(DecortController): if ( comp_boot_disk_id is not None and comp_boot_disk_id in disks_to_detach - and not is_vm_stopped_or_will_be_stopped + and not self.is_vm_stopped_or_will_be_stopped ): check_errors = True self.message( @@ -1438,6 +1626,22 @@ class decort_kvmvm(DecortController): 'Hot resize must be enabled to change CPU or RAM.' ) + if self.check_aparam_zone_id() is False: + check_errors = True + + if self.check_aparam_guest_agent() is False: + check_errors = True + + if self.check_aparam_get_snapshot_merge_status() is False: + check_errors = True + + aparam_networks = self.aparams['networks'] + if aparam_networks is not None: + net_types = {net['type'] for net in aparam_networks} + if self.VMNetType.TRUNK.value in net_types: + if self.check_aparam_networks_trunk() is False: + check_errors = True + if check_errors: self.exit(fail=True) @@ -1530,6 +1734,211 @@ class decort_kvmvm(DecortController): ) return clone_id + def check_aparam_guest_agent(self) -> bool: + check_errors = False + aparam_guest_agent = self.aparams['guest_agent'] + if aparam_guest_agent: + if self.is_vm_stopped_or_will_be_stopped: + if aparam_guest_agent['update_available_commands']: + check_errors = True + self.message( + 'Check for parameter ' + '"guest_agent.update_available_commands" failed: ' + f'VM ID {self.comp_id} must be started to update ' + 'available commands.' + ) + + is_guest_agent_enabled_or_will_be_enabled = ( + ( + self.comp_info['qemu_guest']['enabled'] + and aparam_guest_agent['enabled'] is not False + ) + or ( + self.comp_info['qemu_guest']['enabled'] is False + and aparam_guest_agent['enabled'] + ) + ) + + aparam_guest_agent_exec = aparam_guest_agent['exec'] + if aparam_guest_agent_exec is not None: + if self.is_vm_stopped_or_will_be_stopped: + check_errors = True + self.message( + 'Check for parameter "guest_agent.exec" failed: ' + f'VM ID {self.comp_id} must be started ' + 'to execute commands.' + ) + + if not is_guest_agent_enabled_or_will_be_enabled: + check_errors = True + self.message( + 'Check for parameter "guest_agent.exec" failed: ' + f'Guest agent for VM ID {self.comp_id} must be enabled' + ' to execute commands.' + ) + + aparam_exec_cmd = aparam_guest_agent_exec['cmd'] + available_commands = ( + self.comp_info['qemu_guest']['enabled_agent_features'] + ) + if aparam_exec_cmd not in available_commands: + check_errors = True + self.message( + 'Check for parameter "guest_agent.exec.cmd" failed: ' + f'Command "{aparam_exec_cmd}" is not ' + f'available for VM ID {self.comp_id}.' + ) + + return not check_errors + + def check_aparam_get_snapshot_merge_status(self) -> bool | None: + check_errors = False + if self.aparams['get_snapshot_merge_status']: + vm_has_shared_sep_disk = False + vm_disk_ids = [disk['id'] for disk in self.comp_info['disks']] + for disk_id in vm_disk_ids: + _, disk_info = self._disk_get_by_id(disk_id=disk_id) + if disk_info['sepType'] == 'SHARED': + vm_has_shared_sep_disk = True + break + + if not vm_has_shared_sep_disk: + check_errors = True + self.message( + 'Check for parameter "get_snapshot_merge_status" failed: ' + f'VM ID {self.comp_id} must have at least one disk with ' + 'SEP type SHARED to retrieve snapshot merge status.' + ) + + return not check_errors + + def find_networks_tags_intersections( + self, + trunk_networks: list, + extnet_networks: list, + ) -> bool: + has_intersections = False + + def parse_trunk_tags(trunk_tags_string: str): + trunk_tags = set() + for part in trunk_tags_string.split(','): + if '-' in part: + start, end = part.split('-') + trunk_tags.update(range(int(start), int(end) + 1)) + else: + trunk_tags.add(int(part)) + return trunk_tags + + trunk_tags_dicts = [] + for trunk_network in trunk_networks: + trunk_tags_dicts.append({ + 'id': trunk_network['id'], + 'tags_str': trunk_network['trunkTags'], + 'tags': parse_trunk_tags( + trunk_tags_string=trunk_network['trunkTags'] + ), + 'native_vlan_id': trunk_network['nativeVlanId'], + }) + + # find for trunk tags intersections with other networks + for i in range(len(trunk_tags_dicts)): + for j in range(i + 1, len(trunk_tags_dicts)): + intersection = ( + trunk_tags_dicts[i]['tags'] + & trunk_tags_dicts[j]['tags'] + ) + if intersection: + has_intersections = True + self.message( + 'Check for parameter "networks" failed: ' + f'Trunk tags {trunk_tags_dicts[i]["tags_str"]} ' + f'of trunk ID {trunk_tags_dicts[i]["id"]} ' + f'overlaps with trunk tags ' + f'{trunk_tags_dicts[j]["tags_str"]} of trunk ID ' + f'{trunk_tags_dicts[j]["id"]}' + ) + for extnet in extnet_networks: + if extnet['vlanId'] in trunk_tags_dicts[i]['tags']: + has_intersections = True + self.message( + 'Check for parameter "networks" failed: ' + f'Trunk tags {trunk_tags_dicts[i]["tags_str"]} ' + f'of trunk ID {trunk_tags_dicts[i]["id"]} ' + f'overlaps with tag {extnet["vlanId"]} of extnet ID ' + f'{extnet["id"]}' + ) + if extnet['vlanId'] == trunk_tags_dicts[i]['native_vlan_id']: + has_intersections = True + self.message( + 'Check for parameter "networks" failed: ' + f'Trunk native vlan ID ' + f'{trunk_tags_dicts[i]["native_vlan_id"]} of trunk ID ' + f'{trunk_tags_dicts[i]["id"]} ' + f'overlaps with vlan ID {extnet["vlanId"]} of extnet ' + f'ID {extnet["id"]}' + ) + + return has_intersections + + def check_aparam_networks_trunk(self) -> bool | None: + check_errors = False + + # check if account has vm feature “trunk” + if not self.check_account_vm_features(vm_feature=self.VMFeature.trunk): + check_errors = True + self.message( + 'Check for parameter "networks" failed: ' + f'Account ID {self.acc_id} must have feature "trunk" to use ' + 'trunk type networks ' + ) + # check if rg has vm feature “trunk” + if not self.check_rg_vm_features(vm_feature=self.VMFeature.trunk): + check_errors = True + self.message( + 'Check for parameter "networks" failed: ' + f'RG ID {self.rg_id} must have feature "trunk" to use ' + 'trunk type networks ' + ) + + aparam_trunk_networks = [] + aparam_extnet_networks = [] + for net in self.aparams['networks']: + if net['type'] == self.VMNetType.TRUNK.value: + aparam_trunk_networks.append(net) + elif net['type'] == self.VMNetType.EXTNET.value: + aparam_extnet_networks.append(net) + + trunk_networks_info = [] + # check that account has access to all specified trunks + for trunk_network in aparam_trunk_networks: + trunk_info = self.trunk_get(id=trunk_network['id']) + trunk_networks_info.append(trunk_info) + if ( + trunk_info['accountIds'] is None + or self.acc_id not in trunk_info['accountIds'] + ): + check_errors = True + self.message( + 'Check for parameter "networks" failed: ' + f'Account ID {self.acc_id} does not have access to ' + f'trunk ID {trunk_info['id']}' + ) + + extnet_networks_info = [] + for extnet_network in aparam_extnet_networks: + extnet_networks_info.append( + self.extnet_get(id=extnet_network['id']) + ) + # check that trunk tags do not overlap with each other + # and with extnets vlan id + if self.find_networks_tags_intersections( + trunk_networks=trunk_networks_info, + extnet_networks=extnet_networks_info, + ): + check_errors = True + + return not check_errors + # Workflow digest: # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECSController # 2) check if the VM with the specified id or rg_name:name exists @@ -1617,12 +2026,16 @@ def main(): # prepare Compute facts to be returned as part of decon.result and then call exit_json(...) rg_facts = None if subj.comp_should_exist: - if subj.result['changed'] and not subj.skip_final_get: + if ( + (subj.result['changed'] and not subj.skip_final_get) + or subj.force_final_get + ): # There were changes to the Compute - refresh Compute facts. _, subj.comp_info, _ = subj.compute_find( comp_id=subj.comp_id, need_custom_fields=True, need_console_url=amodule.params['get_console_url'], + need_snapshot_merge_status=amodule.params['get_snapshot_merge_status'], # noqa: E501 ) # # We no longer need to re-read RG facts, as all network info is now available inside diff --git a/library/decort_lb.py b/library/decort_lb.py index f8c9233..c4a4e87 100644 --- a/library/decort_lb.py +++ b/library/decort_lb.py @@ -23,8 +23,6 @@ class decort_lb(DecortController): self.vins_facts = None self.rg_id = 0 self.rg_facts = None - self.acc_id = 0 - self.acc_facts = None self.default_server_check = "enabled" self.default_alg = "roundrobin" self.default_settings = { @@ -37,6 +35,8 @@ class decort_lb(DecortController): "slowstart": 60000, "weight": 100, } + self.is_lb_stopped_or_will_be_stopped: None | bool = None + if arg_amodule.params['lb_id']: self.lb_id, self.lb_facts = self.lb_find(arg_amodule.params['lb_id']) if not self.lb_id: @@ -46,14 +46,14 @@ class decort_lb(DecortController): self.fail_json(**self.result) self.rg_id = self.lb_facts['rgId'] self.vins_id = self.lb_facts['vinsId'] - return - - if arg_amodule.params['rg_id']: + + elif arg_amodule.params['rg_id']: self.rg_id, self.rg_facts = self.rg_find(0,arg_amodule.params['rg_id'], arg_rg_name="") if not self.rg_id: self.result['failed'] = True self.result['msg'] = "Specified RG ID {} not found.".format(arg_amodule.params['vins_id']) self.amodule.fail_json(**self.result) + self.acc_id = self.rg_facts['accountId'] elif arg_amodule.params['account_id'] or arg_amodule.params['account_name'] != "": @@ -61,7 +61,7 @@ class decort_lb(DecortController): self.result['failed'] = True self.result['msg'] = ("RG name must be specified with account present") self.amodule.fail_json(**self.result) - self.acc_id, self.acc_facts = self.account_find(arg_amodule.params['account_name'], + self.acc_id, self._acc_info = self.account_find(arg_amodule.params['account_name'], arg_amodule.params['account_id']) if not self.acc_id: self.result['failed'] = True @@ -96,15 +96,26 @@ class decort_lb(DecortController): if self.rg_id and arg_amodule.params['lb_name']: self.lb_id, self.lb_facts = self.lb_find(0,arg_amodule.params['lb_name'],self.rg_id) + + if self.lb_id and self.lb_facts['status'] != 'DESTROYED': + self.acc_id = self.lb_facts['accountId'] + self.check_amodule_args_for_change() + else: + self.check_amodule_args_for_create() + return - + def create(self): + start_after_create = self.aparams['state'] != 'stopped' self.lb_id = self.lb_provision(self.amodule.params['lb_name'], self.rg_id,self.vins_id, self.amodule.params['ext_net_id'], self.amodule.params['ha_lb'], self.amodule.params['description'], - sysctl=self.amodule.params['sysctl'],) + sysctl=self.amodule.params['sysctl'], + zone_id=self.aparams['zone_id'], + start=start_after_create, + ) if self.lb_id and (self.amodule.params['backends'] or self.amodule.params['frontends']): self.lb_id, self.lb_facts = self.lb_find(0,self.amodule.params['lb_name'],self.rg_id) @@ -141,6 +152,13 @@ class decort_lb(DecortController): self.lb_state(self.lb_facts, 'started') _, self.lb_facts = self._lb_get_by_id(lb_id=self.lb_id) + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None and aparam_zone_id != self.lb_facts['zoneId']: + self.lb_migrate_to_zone( + lb_id=self.lb_id, + zone_id=aparam_zone_id, + ) + return def delete(self): @@ -205,13 +223,15 @@ class decort_lb(DecortController): ret_dict['id'] = self.lb_facts['id'] ret_dict['name'] = self.lb_facts['name'] ret_dict['state'] = self.lb_facts['status'] - #ret_dict['account_id'] = self.lb_facts['accountId'] + ret_dict['account_id'] = self.lb_facts['accountId'] ret_dict['rg_id'] = self.lb_facts['rgId'] ret_dict['gid'] = self.lb_facts['gid'] if self.amodule.params['state']!="absent": ret_dict['backends'] = self.lb_facts['backends'] ret_dict['frontends'] = self.lb_facts['frontends'] ret_dict['sysctl'] = self.lb_facts['sysctlParams'] + ret_dict['zone_id'] = self.lb_facts['zoneId'] + ret_dict['tech_status'] = self.lb_facts['techStatus'] return ret_dict @property @@ -227,11 +247,10 @@ class decort_lb(DecortController): ), description=dict( type='str', - default='Managed by Ansible module decort_lb', ), ext_net_id=dict( type='int', - default=-1, + default=0, ), ext_ip_addr=dict( type='str', @@ -239,13 +258,14 @@ class decort_lb(DecortController): ), state=dict( type='str', - default='present', choices=[ 'absent', 'disabled', 'enabled', 'present', 'restart', + 'started', + 'stopped', ], ), rg_id=dict( @@ -291,6 +311,9 @@ class decort_lb(DecortController): sysctl=dict( type='dict', ), + zone_id=dict( + type=int, + ), ), supports_check_mode=True, required_one_of=[ @@ -300,6 +323,49 @@ class decort_lb(DecortController): ], ) + def check_amodule_args_for_change(self): + check_errors = False + + lb_info: dict = self.lb_facts + self.is_lb_stopped_or_will_be_stopped = ( + ( + lb_info['techStatus'] == 'STOPPED' + and ( + self.aparams['state'] is None + or self.aparams['state'] in ('present', 'stopped') + ) + ) + or ( + lb_info['techStatus'] != 'STOPPED' + and self.aparams['state'] == 'stopped' + ) + ) + + if self.check_aparam_zone_id() is False: + check_errors = True + if ( + self.aparams['zone_id'] is not None + and self.aparams['zone_id'] != lb_info['zoneId'] + and not self.is_lb_stopped_or_will_be_stopped + ): + check_errors = True + self.message( + 'Check for parameter "zone_id" failed: ' + 'Load balancer must be stopped to migrate to a zone.' + ) + + if check_errors: + self.exit(fail=True) + + def check_amodule_args_for_create(self): + check_errors = False + if self.check_aparam_zone_id() is False: + check_errors = True + + if check_errors: + self.exit(fail=True) + + def main(): decon = decort_lb() amodule = decon.amodule @@ -309,24 +375,15 @@ def main(): decon.result['changed'] = False decon.result['msg'] = ("No change can be done for existing LB ID {} because of its current " "status '{}'").format(decon.lb_id, decon.lb_facts['status']) - elif decon.lb_facts['status'] == "DISABLED": - if amodule.params['state'] == 'absent': - decon.delete() - elif amodule.params['state'] == 'disabled': - decon.action() - elif amodule.params['state'] in ('enabled', 'present'): - decon.action('enabled') - elif decon.lb_facts['status'] in ["CREATED", "ENABLED"]: - if amodule.params['state'] == 'absent': - decon.delete() - elif amodule.params['state'] in ('present', 'enabled'): - decon.action(d_state='enabled') - elif amodule.params['state'] == 'disabled': - decon.action('disabled') - elif amodule.params['state'] in ('stopped', 'started','restart'): - decon.action(amodule.params['state']) + elif decon.lb_facts['status'] in ('DISABLED', 'ENABLED', 'CREATED'): + if amodule.params['state'] == 'absent': + decon.delete() + else: + decon.action(d_state=amodule.params['state']) elif decon.lb_facts['status'] == "DELETED": - if amodule.params['state'] in ['present', 'enabled']: + if amodule.params['state'] == 'present': + decon.action(restore=True) + elif amodule.params['state'] == 'enabled': decon.action(d_state='enabled', restore=True) elif (amodule.params['state'] == 'absent' and amodule.params['permanently']): @@ -341,11 +398,14 @@ def main(): elif amodule.params['state'] == 'disabled': decon.error() else: - if amodule.params['state'] == 'absent': + state = amodule.params['state'] + if state is None: + state = 'present' + if state == 'absent': decon.nop() - elif amodule.params['state'] in ('present', 'enabled'): + elif state in ('present', 'enabled', 'stopped', 'started'): decon.create() - elif amodule.params['state'] == 'disabled': + elif state == 'disabled': decon.error() if decon.result['failed']: @@ -357,4 +417,4 @@ def main(): decon.result['facts'] = decon.package_facts(amodule.check_mode) amodule.exit_json(**decon.result) if __name__ == "__main__": - main() \ No newline at end of file + main() diff --git a/library/decort_osimage.py b/library/decort_osimage.py index 12f564a..be7c04e 100644 --- a/library/decort_osimage.py +++ b/library/decort_osimage.py @@ -26,7 +26,7 @@ class decort_osimage(DecortController): if amodule.params['account_name']: self.validated_account_id, _ = self.account_find(amodule.params['account_name']) else: - self.validated_account_id = amodule.params['account_Id'] + self.validated_account_id = amodule.params['account_id'] if self.validated_account_id == 0: # we failed either to find or access the specified account - fail the module @@ -129,7 +129,7 @@ class decort_osimage(DecortController): hot_resize=hot_resize, username=amodule.params['image_username'], password=amodule.params['image_password'], - account_Id=self.validated_account_id, + account_id=self.validated_account_id, usernameDL=amodule.params['usernameDL'], passwordDL=amodule.params['passwordDL'], sepId=amodule.params['sepId'], @@ -156,7 +156,11 @@ class decort_osimage(DecortController): def decort_virt_image_create(self,amodule): # function that creates a virtual image - image_facts = self.virt_image_create(name=amodule.params['virt_name'], targetId=self.target_image_id) + image_facts = self.virt_image_create( + name=amodule.params['virt_name'], + target_id=self.target_image_id, + account_id=self.aparams['account_id'], + ) image_id, image_facts = decort_osimage.decort_virt_image_find(self, amodule) self.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode) return image_id, image_facts @@ -244,7 +248,7 @@ class decort_osimage(DecortController): account_name=dict( type='str', ), - account_Id=dict( + account_id=dict( type='int', ), image_name=dict( diff --git a/library/decort_rg.py b/library/decort_rg.py index aa68016..baf8a80 100644 --- a/library/decort_rg.py +++ b/library/decort_rg.py @@ -42,6 +42,9 @@ class decort_rg(DecortController): else: self.rg_should_exist = False + if self.validated_rg_id and self.rg_facts['status'] != 'DESTROYED': + self.check_amodule_args_for_change() + def get_info(self): # If this is the first getting info if not self.validated_rg_id: @@ -150,18 +153,20 @@ class decort_rg(DecortController): return def create(self): - self.validated_rg_id = self.rg_provision(self.validated_acc_id, - self.amodule.params['rg_name'], - self.amodule.params['owner'], - self.amodule.params['description'], - self.amodule.params['resType'], - self.amodule.params['def_netType'], - self.amodule.params['ipcidr'], - self.amodule.params['extNetId'], - self.amodule.params['extNetIp'], - self.amodule.params['quotas'], - "", # this is location code. TODO: add module argument - ) + self.validated_rg_id = self.rg_provision( + self.validated_acc_id, + self.amodule.params['rg_name'], + self.amodule.params['owner'], + self.amodule.params['description'], + self.amodule.params['resType'], + self.amodule.params['def_netType'], + self.amodule.params['ipcidr'], + self.amodule.params['extNetId'], + self.amodule.params['extNetIp'], + self.amodule.params['quotas'], + "", # this is location code. TODO: add module argument + sdn_access_group_id=self.aparams['sdn_access_group_id'], + ) if self.validated_rg_id: self.validated_rg_id, self.rg_facts = self.rg_find( @@ -237,6 +242,7 @@ class decort_rg(DecortController): ret_dict['computes'] = self.rg_facts['vms'] ret_dict['uniqPools'] = self.rg_facts['uniqPools'] ret_dict['description'] = self.rg_facts['desc'] + ret_dict['sdn_access_group_id'] = self.rg_facts['sdn_access_group_id'] return ret_dict @@ -334,11 +340,34 @@ class decort_rg(DecortController): recursive_deletion=dict( type='bool', default=False, - ) + ), + sdn_access_group_id=dict( + type='str', + ), ), supports_check_mode=True, ) - + + def check_amodule_args_for_change(self): + check_errors = False + + if ( + self.aparams['sdn_access_group_id'] is not None + and ( + self.aparams['sdn_access_group_id'] + != self.rg_facts['sdn_access_group_id'] + ) + ): + self.message( + 'Check for parameter "sdn_access_group_id" failed: ' + 'cannot change sdn_access_group_id for an existing resource ' + f'group ID {self.validated_rg_id}.' + ) + check_errors = True + + if check_errors: + self.exit(fail=True) + # Workflow digest: # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECORTController # 2) check if the RG with the specified id or rg_name:name exists diff --git a/library/decort_snapshot.py b/library/decort_snapshot.py index 01233c8..52a292d 100644 --- a/library/decort_snapshot.py +++ b/library/decort_snapshot.py @@ -4,7 +4,7 @@ DOCUMENTATION = r''' --- module: decort_snapshot -description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 ''' import time @@ -17,33 +17,24 @@ class DecortSnapshot(DecortController): super().__init__(AnsibleModule(**self.amodule_init_args)) self.check_amodule_args() + self.vm_id: int + self.vm_facts: dict self.aparams_label = self.aparams['label'] self.aparams_vm_id = self.aparams['vm_id'] - vm_id, vm_facts, _ = self._compute_get_by_id( + self.vm_id, self.vm_facts, _ = self._compute_get_by_id( comp_id=self.aparams_vm_id, ) - if not vm_id: + if not self.vm_id: self.message(f'VM {self.aparams_vm_id} not found') self.exit(fail=True) - self.vm_name = vm_facts['name'] - self.vm_snapshots = vm_facts['snapSets'] + self.vm_name = self.vm_facts['name'] + self.vm_snapshots = self.vm_facts['snapSets'] self.vm_snapshot_labels = [ snapshot['label'] for snapshot in self.vm_snapshots ] - if ( - self.aparams_label is not None - and self.aparams_label not in self.vm_snapshot_labels - and self.aparams['state'] is None - ): - self.message( - f'Snapshot {self.aparams_label} ' - f'not found for VM {self.aparams_vm_id}' - ) - self.exit(fail=True) - self.new_snapshot_label = None if self.aparams['state'] == 'present': if self.aparams_label is None: @@ -53,6 +44,17 @@ class DecortSnapshot(DecortController): elif self.aparams_label not in self.vm_snapshot_labels: self.new_snapshot_label = self.aparams_label + if ( + self.new_snapshot_label is None + and self.aparams_label is not None + and self.aparams_label not in self.vm_snapshot_labels + ): + self.message( + f'Snapshot {self.aparams_label} ' + f'not found for VM {self.aparams_vm_id}' + ) + self.exit(fail=True) + @property def amodule_init_args(self) -> dict: return self.pack_amodule_init_args( @@ -65,6 +67,7 @@ class DecortSnapshot(DecortController): choices=( 'absent', 'present', + 'merge_aborted', ), ), usage=dict( @@ -101,6 +104,7 @@ class DecortSnapshot(DecortController): def run(self): self.get_info(first_run=True) + self.check_amodule_args_for_change() self.change() self.exit() @@ -126,6 +130,8 @@ class DecortSnapshot(DecortController): case 'absent': if self.aparams_label in self.vm_snapshot_labels: self.delete() + case 'merge_aborted': + self.abort_merge() def create(self): self.snapshot_create( @@ -141,6 +147,13 @@ class DecortSnapshot(DecortController): ) self.facts = {} + def abort_merge(self): + self.snapshot_abort_merge( + vm_id=self.aparams_vm_id, + label=self.aparams_label, + ) + self.get_info() + def get_snapshot_usage(self) -> int: label = self.new_snapshot_label or self.aparams_label common_snapshots_usage_info, _ = self.snapshot_usage( @@ -148,6 +161,24 @@ class DecortSnapshot(DecortController): label=label, ) return common_snapshots_usage_info['stored'] + + def check_amodule_args_for_change(self): + check_errors = False + + if ( + self.aparams['state'] == 'merge_aborted' + and self.vm_facts['techStatus'] != 'MERGE' + ): + check_errors = True + self.message( + f'Check for parameter "state" failed: ' + 'Merge can be aborted only for VM in "MERGE" tech status.' + ) + + if check_errors: + self.exit(fail=True) + + def main(): DecortSnapshot().run() diff --git a/library/decort_trunk.py b/library/decort_trunk.py new file mode 100644 index 0000000..342616c --- /dev/null +++ b/library/decort_trunk.py @@ -0,0 +1,51 @@ +#!/usr/bin/python + +DOCUMENTATION = r''' +--- +module: decort_trunk + +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 +''' + +from ansible.module_utils.basic import AnsibleModule +from ansible.module_utils.decort_utils import DecortController + + +class DecortTrunk(DecortController): + def __init__(self): + super().__init__(AnsibleModule(**self.amodule_init_args)) + self.id: int = self.aparams['id'] + + @property + def amodule_init_args(self) -> dict: + return self.pack_amodule_init_args( + argument_spec=dict( + id=dict( + type='int', + required=True, + ), + ), + supports_check_mode=True, + ) + + def run(self): + self.get_info() + self.exit() + + def get_info(self): + self.facts = self.trunk_get(id=self.id) + self.facts['account_ids'] = self.facts.pop('accountIds') + self.facts['created_timestamp'] = self.facts.pop('created_at') + self.facts['deleted_timestamp'] = self.facts.pop('deleted_at') + self.facts['updated_timestamp'] = self.facts.pop('updated_at') + self.facts['native_vlan_id'] = self.facts.pop('nativeVlanId') + self.facts['ovs_bridge'] = self.facts.pop('ovsBridge') + self.facts['vlan_ids'] = self.facts.pop('trunkTags') + + +def main(): + DecortTrunk().run() + + +if __name__ == '__main__': + main() diff --git a/library/decort_user_info.py b/library/decort_user_info.py index 3e66fff..ce502fd 100644 --- a/library/decort_user_info.py +++ b/library/decort_user_info.py @@ -4,7 +4,7 @@ DOCUMENTATION = r''' --- module: decort_user_info -description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 ''' from ansible.module_utils.basic import AnsibleModule @@ -33,9 +33,8 @@ class DecortUserInfo(DecortController): rights=dict( type='str', choices=[ - e.value - for e in self.AccountUserRights - ], + e.value for e in self.AccountUserRights + ], ), id=dict( type='int', @@ -47,7 +46,7 @@ class DecortUserInfo(DecortController): type='str', choices=[ e.value for e in self.AccountStatus - ], + ], ), ), ), @@ -79,8 +78,8 @@ class DecortUserInfo(DecortController): type='str', choices=[ e.value - for e in self.AccountSortableField - ], + for e in self.AccountSortableField + ], required=True, ), ), @@ -186,6 +185,124 @@ class DecortUserInfo(DecortController): type='bool', default=False, ), + zones=dict( + type='dict', + options=dict( + filter=dict( + type='dict', + options=dict( + deletable=dict( + type='bool', + ), + description=dict( + type='str', + ), + grid_id=dict( + type='int', + ), + id=dict( + type='int', + ), + name=dict( + type='str', + ), + node_id=dict( + type='int', + ), + status=dict( + type='str', + choices=[ + e.value for e in self.ZoneStatus + ], + ), + ), + ), + pagination=dict( + type='dict', + apply_defaults=True, + options=dict( + number=dict( + type='int', + default=1, + ), + size=dict( + type='int', + default=50, + ), + ), + ), + sorting=dict( + type='dict', + options=dict( + asc=dict( + type='bool', + default=True, + ), + field=dict( + type='str', + choices=self.ZoneField._member_names_, + required=True, + ), + ), + ), + ), + ), + trunks=dict( + type='dict', + options=dict( + filter=dict( + type='dict', + options=dict( + ids=dict( + type='list', + ), + account_ids=dict( + type='list', + ), + status=dict( + type='str', + choices=[ + e.value for e in self.TrunkStatus + ], + ), + vlan_ids=dict( + type='list', + ), + ), + ), + pagination=dict( + type='dict', + apply_defaults=True, + options=dict( + number=dict( + type='int', + default=1, + ), + size=dict( + type='int', + default=50, + ), + ), + ), + sorting=dict( + type='dict', + options=dict( + asc=dict( + type='bool', + default=True, + ), + field=dict( + type='str', + choices=[ + e.value + for e in self.TrunksSortableField + ], + required=True, + ), + ), + ), + ), + ), ), supports_check_mode=True, ) @@ -200,22 +317,38 @@ class DecortUserInfo(DecortController): check_error = False match self.aparams['audits']: - case {'filter': {'time': - {'start': {'datetime': str() as dt_str}} - } - }: + case { + 'filter': {'time': {'start': {'datetime': str() as dt_str}}} + }: if self.dt_str_to_sec(dt_str=dt_str) is None: self.message(self.MESSAGES.str_not_parsed(string=dt_str)) check_error = True match self.aparams['audits']: - case {'filter': {'time': - {'end': {'datetime': str() as dt_str}} - } - }: + case { + 'filter': {'time': {'end': {'datetime': str() as dt_str}}} + }: if self.dt_str_to_sec(dt_str=dt_str) is None: self.message(self.MESSAGES.str_not_parsed(string=dt_str)) check_error = True + aparam_trunks = self.aparams['trunks'] + if ( + aparam_trunks is not None + and aparam_trunks['filter'] is not None + and aparam_trunks['filter']['vlan_ids'] is not None + ): + for vlan_id in aparam_trunks['filter']['vlan_ids']: + if not ( + self.TRUNK_VLAN_ID_MIN_VALUE + <= vlan_id + <= self.TRUNK_VLAN_ID_MAX_VALUE + ): + check_error = True + self.message( + 'Check for parameter "trunks.filter.vlan_ids" failed: ' + f'VLAN ID {vlan_id} must be in range 1-4095.' + ) + if check_error: self.exit(fail=True) @@ -331,6 +464,94 @@ class DecortUserInfo(DecortController): return mapped_args + @property + def mapped_zones_args(self): + """ + Map the module argument `zones` to + arguments dictionary for the method + `DecortController.user_zones`. + """ + + input_args = self.aparams['zones'] + if not input_args: + return input_args + + mapped_args = {} + + input_args_filter = input_args['filter'] + if input_args_filter: + mapped_args.update(input_args_filter) + + input_args_filter_status = input_args_filter['status'] + if input_args_filter_status: + mapped_args['status'] = ( + self.ZoneStatus(input_args_filter_status) + ) + + input_args_pagination = input_args['pagination'] + if input_args_pagination: + mapped_args['page_number'] = input_args_pagination['number'] + mapped_args['page_size'] = input_args_pagination['size'] + + input_args_sorting = input_args['sorting'] + if input_args_sorting: + mapped_args['sort_by_asc'] = input_args_sorting['asc'] + + input_args_sorting_field = input_args_sorting['field'] + if input_args_sorting_field: + mapped_args['sort_by_field'] = ( + self.ZoneField._member_map_[input_args_sorting_field] + ) + + return mapped_args + + @property + def mapped_trunks_args(self): + """ + Map the module argument `trunks` to + arguments dictionary for the method + `DecortController.user_trunks`. + """ + + input_args = self.aparams['trunks'] + if not input_args: + return input_args + + mapped_args = {} + + input_args_filter = input_args['filter'] + if input_args_filter: + mapped_args.update(input_args_filter) + + input_args_filter_status = input_args_filter['status'] + if input_args_filter_status: + mapped_args['status'] = ( + self.TrunkStatus(input_args_filter_status) + ) + + input_args_filter_vlan_ids = input_args_filter['vlan_ids'] + if input_args_filter_vlan_ids is not None: + mapped_args['vlan_ids'] = ', '.join( + map(str, input_args_filter_vlan_ids) + ) + + input_args_pagination = input_args['pagination'] + if input_args_pagination: + mapped_args['page_number'] = input_args_pagination['number'] + mapped_args['page_size'] = input_args_pagination['size'] + + input_args_sorting = input_args['sorting'] + if input_args_sorting: + mapped_args['sort_by_asc'] = input_args_sorting['asc'] + + input_args_sorting_field = input_args_sorting['field'] + if input_args_sorting_field: + mapped_args['sort_by_field'] = ( + self.TrunksSortableField(input_args_sorting_field) + ) + + return mapped_args + def run(self): self.get_info() self.exit() @@ -357,13 +578,34 @@ class DecortUserInfo(DecortController): if self.aparams['api_methods']: self.facts['api_methods'] = self.user_api_methods(id=self.id) - search_string = self.aparams['objects_search'] if search_string: self.facts['objects_search'] = self.user_objects_search( search_string=search_string, ) + if self.aparams['zones']: + self.facts['zones'] = self.user_zones(**self.mapped_zones_args) + + if self.aparams['trunks']: + self.facts['trunks'] = self.user_trunks(**self.mapped_trunks_args) + for trunk_facts in self.facts['trunks']: + trunk_facts['account_ids'] = trunk_facts.pop('accountIds') + trunk_facts['created_timestamp'] = trunk_facts.pop( + 'created_at' + ) + trunk_facts['deleted_timestamp'] = trunk_facts.pop( + 'deleted_at' + ) + trunk_facts['updated_timestamp'] = trunk_facts.pop( + 'updated_at' + ) + trunk_facts['native_vlan_id'] = trunk_facts.pop( + 'nativeVlanId' + ) + trunk_facts['ovs_bridge'] = trunk_facts.pop('ovsBridge') + trunk_facts['vlan_ids'] = trunk_facts.pop('trunkTags') + def main(): DecortUserInfo().run() diff --git a/library/decort_vins.py b/library/decort_vins.py index 6a02c47..a06a4e9 100644 --- a/library/decort_vins.py +++ b/library/decort_vins.py @@ -24,7 +24,6 @@ class decort_vins(DecortController): validated_rg_id = 0 rg_facts = None # will hold RG facts validated_acc_id = 0 - acc_facts = None # will hold Account facts if arg_amodule.params['vins_id']: # expect existing ViNS with the specified ID @@ -45,6 +44,7 @@ class decort_vins(DecortController): # This call to rg_find will abort the module if no RG with such ID is present validated_rg_id, rg_facts = self.rg_find(0, # account ID set to 0 as we search for RG by RG ID arg_amodule.params['rg_id'], arg_rg_name="") + validated_acc_id = rg_facts['accountId'] # This call to vins_find may return vins_id=0 if no ViNS found self.vins_id, self.vins_facts = self.vins_find(vins_id=0, vins_name=arg_amodule.params['vins_name'], @@ -56,7 +56,7 @@ class decort_vins(DecortController): pass elif arg_amodule.params['account_id'] or arg_amodule.params['account_name'] != "": # Specified account must be present and accessible by the user, otherwise abort the module - validated_acc_id, acc_facts = self.account_find(arg_amodule.params['account_name'], arg_amodule.params['account_id']) + validated_acc_id, self._acc_info = self.account_find(arg_amodule.params['account_name'], arg_amodule.params['account_id']) if not validated_acc_id: self.result['failed'] = True self.result['msg'] = ("Current user does not have access to the requested account " @@ -102,15 +102,25 @@ class decort_vins(DecortController): self.amodule.fail_json(**self.result) return + self.rg_id = validated_rg_id self.acc_id = validated_acc_id + + if self.vins_id and self.vins_facts['status'] != 'DESTROYED': + self.check_amodule_args_for_change() + else: + self.check_amodule_args_for_create() + return + def create(self): self.vins_id = self.vins_provision(self.amodule.params['vins_name'], self.acc_id, self.rg_id, self.amodule.params['ipcidr'], self.amodule.params['ext_net_id'], self.amodule.params['ext_ip_addr'], - self.amodule.params['description']) + self.amodule.params['description'], + zone_id=self.amodule.params['zone_id'], + ) if self.amodule.params['mgmtaddr'] or self.amodule.params['connect_to']: _, self.vins_facts = self.vins_find(self.vins_id) @@ -150,6 +160,14 @@ class decort_vins(DecortController): if d_state != '': self.vins_state(self.vins_facts, d_state) + + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None and aparam_zone_id != self.vins_facts['zoneId']: + self.vins_migrate_to_zone( + net_id=self.vins_id, + zone_id=aparam_zone_id, + ) + return def delete(self): self.vins_delete(self.vins_id, permanently=True) @@ -235,6 +253,7 @@ class decort_vins(DecortController): else: ret_dict['ext_ip_addr'] = "" ret_dict['ext_net_id'] = -1 + ret_dict['zone_id'] = self.vins_facts['zoneId'] return ret_dict @@ -309,12 +328,31 @@ class decort_vins(DecortController): type='str', default='', ), + zone_id=dict( + type=int, + ), ), supports_check_mode=True, required_one_of=[ ('vins_id', 'vins_name'), ], ) + + def check_amodule_args_for_change(self): + check_errors = False + if self.check_aparam_zone_id() is False: + check_errors = True + + if check_errors: + self.exit(fail=True) + + def check_amodule_args_for_create(self): + check_errors = False + if self.check_aparam_zone_id() is False: + check_errors = True + + if check_errors: + self.exit(fail=True) # Workflow digest: # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECORTController diff --git a/library/decort_zone.py b/library/decort_zone.py new file mode 100644 index 0000000..d8d18fc --- /dev/null +++ b/library/decort_zone.py @@ -0,0 +1,48 @@ +#!/usr/bin/python + +DOCUMENTATION = r''' +--- +module: decort_zone + +description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home). # noqa: E501 +''' + +from ansible.module_utils.basic import AnsibleModule +from ansible.module_utils.decort_utils import DecortController + + +class DecortZone(DecortController): + def __init__(self): + super().__init__(AnsibleModule(**self.amodule_init_args)) + self.id: int = self.aparams['id'] + + @property + def amodule_init_args(self) -> dict: + return self.pack_amodule_init_args( + argument_spec=dict( + id=dict( + type='int', + required=True, + ), + ), + supports_check_mode=True, + ) + + def run(self): + self.get_info() + self.exit() + + def get_info(self): + self.facts = self.zone_get(id=self.id) + self.facts['grid_id'] = self.facts.pop('gid') + self.facts['created_timestamp'] = self.facts.pop('createdTime') + self.facts['updated_timestamp'] = self.facts.pop('updatedTime') + self.facts['node_ids'] = self.facts.pop('nodeIds') + + +def main(): + DecortZone().run() + + +if __name__ == '__main__': + main() diff --git a/module_utils/decort_utils.py b/module_utils/decort_utils.py index 62fef3a..74118a1 100644 --- a/module_utils/decort_utils.py +++ b/module_utils/decort_utils.py @@ -17,6 +17,7 @@ import time import requests from ansible.module_utils.basic import AnsibleModule, env_fallback +import urllib3 P = ParamSpec('P') @@ -28,6 +29,11 @@ class DecortController(object): based on the requested authentication type. """ + acc_id: None | int = None + _acc_info: None | dict = None + rg_id: None | int = None + _rg_info: None | dict = None + FIELDS_FOR_SORTING_ACCOUNT_COMPUTE_LIST = [ 'cpus', 'createdBy', @@ -108,11 +114,15 @@ class DecortController(object): COMPUTE_TECH_STATUSES = [ 'BACKUP_RUNNING', 'BACKUP_STOPPED', + 'CLONING', 'DOWN', + 'MERGE', 'MIGRATING', 'PAUSED', 'PAUSING', + 'ROLLBACK', 'SCHEDULED', + 'SNAPCREATE', 'STARTED', 'STARTING', 'STOPPED', @@ -175,6 +185,8 @@ class DecortController(object): VFNIC = 'VFNIC' EMPTY = 'EMPTY' DPDK = 'DPDK' + TRUNK = 'TRUNK' + SDN = 'SDN' class AuditsSortableField(Enum): @@ -185,6 +197,67 @@ class DecortController(object): Time = 'Time' + class ZoneField(Enum): + created_timestamp = 'createdTime' + deletable = 'deletable' + description = 'description' + grid_id = 'gid' + guid = 'guid' + id = 'id' + name = 'name' + node_ids = 'nodeIds' + status = 'status' + updated_timestamp = 'updatedTime' + + + class ZoneStatus(Enum): + CREATED = 'CREATED' + DESTROYED = 'DESTROYED' + + + class TrunkStatus(Enum): + CREATED = 'CREATED' + DESTROYED = 'DESTROYED' + DESTROYING = 'DESTROYING' + DISABLED = 'DISABLED' + ENABLED = 'ENABLED' + ENABLING = 'ENABLING' + MODELED = 'MODELED' + + + class TrunksSortableField(Enum): + accountIds = 'account_ids' + created_at = 'created_timestamp' + created_by = 'created_by' + deleted_at = 'deleted_timestamp' + deleted_by = 'deleted_by' + description = 'description' + guid = 'guid' + id = 'id' + mac = 'mac' + name = 'name' + nativeVlanId = 'native_vlan_id' + ovsBridge = 'ovs_bridge' + status = 'status' + trunkTags = 'vlan_ids' + updated_at = 'updated_timestamp' + updated_by = 'updated_by' + + + TRUNK_VLAN_ID_MIN_VALUE = 1 + TRUNK_VLAN_ID_MAX_VALUE = 4095 + + + class VMFeature(Enum): + hugepages = 'hugepages' + numa = 'numa' + cpupin = 'cpupin' + vfnic = 'vfnic' + dpdk = 'dpdk' + changemac = 'changemac' + trunk = 'trunk' + + class MESSAGES: @staticmethod def ssl_error(url: None | str = None): @@ -324,7 +397,10 @@ class DecortController(object): """ self.amodule = arg_amodule # AnsibleModule class instance - self.aparams = self.amodule.params + self.aparams: dict[str, Any] = self.amodule.params + + if self.aparams['verify_ssl'] is False: + urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning) # Note that the value for 'changed' key is by default set to 'False'. If you plan to manage value of 'changed' # key outside of DecortController() class, make sure you only update to 'True' when you really change the state @@ -425,6 +501,32 @@ class DecortController(object): # self.run_phase = "Initializing DecortController instance complete." return + @property + def acc_info(self) -> dict: + if self._acc_info is None: + if not isinstance(self.acc_id, int): + raise TypeError + _, acc_info = self.account_find(account_id=self.acc_id) + if not isinstance(acc_info, dict): + raise TypeError + self._acc_info = acc_info + return self._acc_info + + @property + def acc_zone_ids(self) -> list[int]: + return [zone['id'] for zone in self.acc_info['zoneIds']] + + @property + def rg_info(self) -> dict: + if self._rg_info is None: + if not isinstance(self.rg_id, int): + raise TypeError + _, rg_info = self.rg_find(arg_rg_id=self.rg_id) + if not isinstance(rg_info, dict): + raise TypeError + self._rg_info = rg_info + return self._rg_info + @staticmethod def waypoint(orig_f: Callable[P, R]) -> Callable[P, R]: """ @@ -816,6 +918,7 @@ class DecortController(object): arg_params, arg_files=None, not_fail_codes: None | list = None, + accept_json_response: bool = False, ) -> requests.Response: """ Wrapper around DECORT API calls. It uses authorization mode and @@ -851,6 +954,8 @@ class DecortController(object): req_url = self.controller_url + arg_api_name http_headers['Authorization'] = 'bearer {}'.format(self.jwt) + if accept_json_response: + http_headers['Accept'] = 'application/json' while retry_counter > 0: try: @@ -1099,6 +1204,63 @@ class DecortController(object): return api_resp.json() + @waypoint + def user_zones( + self, + page_size: None | int = None, + deletable: None | bool = None, + description: None | str = None, + grid_id: None | int = None, + id: None | int = None, + name: None | str = None, + node_id: None | int = None, + status: None | ZoneStatus = None, + page_number: int = 1, + sort_by_asc: bool = True, + sort_by_field: None | ZoneField = None, + ) -> list[dict]: + """ + Implementation of the functionality of API method + `/cloudapi/zone/list`. + """ + + sort_by = None + if sort_by_field: + sort_by_prefix = '+' if sort_by_asc else '-' + sort_by = f'{sort_by_prefix}{sort_by_field.value}' + + api_params = { + 'by_id': id, + 'gid': grid_id, + 'name': name, + 'description': description, + 'status': status.value if status else None, + 'deletable': deletable, + 'nodeId': node_id, + 'page': page_number if page_size else None, + 'size': page_size, + 'sortBy': sort_by, + } + api_resp = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/zone/list', + arg_params=api_params, + ) + + zones_orig: list[dict] = api_resp.json()['data'] + + zones_result: list[dict] = [] + + for zone_orig in zones_orig: + zone_result = {} + + for field in self.ZoneField: + zone_result[field.name] = zone_orig[field.value] + + zones_result.append(zone_result) + + return zones_result + ################################### # Compute and KVM VM resource manipulation methods ################################### @@ -1262,6 +1424,7 @@ class DecortController(object): comp_id, need_custom_fields: bool = False, need_console_url: bool = False, + need_snapshot_merge_status: bool = False, ): """Helper function that locates compute instance by ID and returns Compute facts. @@ -1301,17 +1464,30 @@ class DecortController(object): ) ret_comp_dict['console_url'] = console_url + if need_snapshot_merge_status: + snapshot_merge_status = ( + self.compute_get_snapshot_merge_status( + vm_id=ret_comp_id, + ) + ) + ret_comp_dict['snapshot_merge_status'] = snapshot_merge_status + else: self.result['warning'] = ("compute_get_by_id(): failed to get Compute by ID {}. HTTP code {}, " "response {}.").format(comp_id, api_resp.status_code, api_resp.reason) return ret_comp_id, ret_comp_dict, ret_rg_id - def compute_find(self, comp_id: int = 0, - comp_name="", rg_id=0, - check_state=True, - need_custom_fields: bool = False, - need_console_url: bool = False): + def compute_find( + self, + comp_id: int = 0, + comp_name="", + rg_id=0, + check_state=True, + need_custom_fields: bool = False, + need_console_url: bool = False, + need_snapshot_merge_status: bool = False, + ): """Tries to find Compute instance according to the specified parameters. On success returns non-zero Compute ID and a dictionary with Compute details, or 0 for ID and None for the dictionary on failure. @@ -1349,6 +1525,7 @@ class DecortController(object): comp_id=comp_id, need_custom_fields=need_custom_fields, need_console_url=need_console_url, + need_snapshot_merge_status=need_snapshot_merge_status, ) ) if not ret_comp_id: @@ -1390,6 +1567,7 @@ class DecortController(object): comp_id=ret_comp_id, need_custom_fields=need_custom_fields, need_console_url=need_console_url, + need_snapshot_merge_status=need_snapshot_merge_status, # noqa: E501 ) break @@ -1489,7 +1667,9 @@ class DecortController(object): boot_mode: Literal['bios', 'uefi'] = 'bios', boot_loader_type: Literal['linux', 'windows', 'unknown'] = 'unknown', network_interface_naming: Literal['eth', 'ens'] = 'ens', - hot_resize: bool = False,): + hot_resize: bool = False, + zone_id: None | int = None, + ): """Manage KVM VM provisioning. To remove existing KVM VM compute instance use compute_remove method, to resize use compute_resize, to manage power state use compute_powerstate method. @@ -1527,6 +1707,7 @@ class DecortController(object): 'chipset': chipset, 'withoutBootDisk': not boot_disk_size, 'preferredCpu': preferred_cpu_cores, + 'zoneId': zone_id, } if description: api_params['desc'] = description @@ -1569,8 +1750,13 @@ class DecortController(object): ifaces_for_delete = [] nets_for_attach = [] + + ifaces_dict = {} + new_nets_dict = {} + nets_for_change_ip = [] nets_for_change_mac_dict = {} + nets_for_change_mtu_dict = {} # Either only attaching or only detaching networks if not ifaces or not new_networks: @@ -1580,18 +1766,19 @@ class DecortController(object): # Creating dictionaries in which the key is a net type + a net id # + (optional) postfix # For empty networks a net id is the number of the empty network - ifaces_dict = {} empty_ifaces_count = 0 for iface in ifaces: net_type = iface['netType'] if net_type == self.VMNetType.EMPTY.value: empty_ifaces_count += 1 net_id = empty_ifaces_count + elif net_type == self.VMNetType.SDN.value: + net_id = iface['sdn_interface_id'] else: net_id = iface['netId'] net_key = f'{net_type}{net_id}' ifaces_dict[net_key] = iface - new_nets_dict = {} + empty_new_nets_count = 0 for net in new_networks: net_type = net['type'] @@ -1659,6 +1846,13 @@ class DecortController(object): if new_mac and current_mac != new_mac: nets_for_change_mac_dict[net_key] = net + # Adding networks for change MTU + if net['type'] == self.VMNetType.EXTNET.value: + current_mtu = ifaces_dict[net_key]['mtu'] + new_mtu = net['mtu'] + if new_mtu and current_mtu != new_mtu: + nets_for_change_mtu_dict[net_key] = net + # Detaching networks for iface in ifaces_for_delete: self.decort_api_call( @@ -1674,17 +1868,21 @@ class DecortController(object): # Attaching networks for net in nets_for_attach: + api_params = { + 'computeId': vm_id, + 'netType': net['type'], + 'netId': net.get('id') or 0, + 'ipAddr': net.get('ip_addr'), + 'mtu': net.get('mtu'), + 'mac_addr': net.get('mac'), + } + if net['type'] == self.VMNetType.SDN.value: + api_params['sdn_interface_id'] = net['id'] + api_params['netId'] = 0 self.decort_api_call( arg_req_function=requests.post, arg_api_name='/restmachine/cloudapi/compute/netAttach', - arg_params={ - 'computeId': vm_id, - 'netType': net['type'], - 'netId': net.get('id') or 0, - 'ipAddr': net.get('ip_addr'), - 'mtu': net.get('mtu'), - 'mac_addr': net.get('mac'), - }, + arg_params=api_params, ) self.set_changed() @@ -1715,6 +1913,19 @@ class DecortController(object): ) self.set_changed() + # Changing MTU + for net_key, net in nets_for_change_mtu_dict.items(): + self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/change_mtu', + arg_params={ + 'compute_id': vm_id, + 'interface': ifaces_dict[net_key]['mac'], + 'mtu': net['mtu'], + }, + ) + self.set_changed() + def compute_resize_vector(self, comp_dict, new_cpu, new_ram): """Check if the Compute new size parameters passed to this function are different from the current Compute configuration. @@ -2217,6 +2428,122 @@ class DecortController(object): ) return api_response.text + @waypoint + @checkmode + def compute_migrate_to_zone(self, compute_id: int, zone_id: int): + api_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/migrateToZone', + arg_params={ + 'computeId': compute_id, + 'zoneId': zone_id, + }, + ) + self.set_changed() + return api_response.json() + + @waypoint + def compute_get_snapshot_merge_status(self, vm_id: int) -> dict: + api_response = self.decort_api_call( + arg_req_function=requests.get, + arg_api_name='/restmachine/cloudapi/compute/shared_snapshot_merge_status', # noqa: E501 + arg_params={ + 'compute_id': vm_id, + }, + ) + return api_response.json() + + @waypoint + @checkmode + def compute_guest_agent_disable(self, vm_id: int): + """ + Implementation of functionality of the API method + `/cloudapi/compute/guest_agent_disable`. + """ + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/guest_agent_disable', + arg_params={ + 'compute_id': vm_id, + } + ) + self.set_changed() + return response.json() + + @waypoint + @checkmode + def compute_guest_agent_enable(self, vm_id: int): + """ + Implementation of functionality of the API method + `/cloudapi/compute/guest_agent_enable`. + """ + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/guest_agent_enable', + arg_params={ + 'compute_id': vm_id, + } + ) + self.set_changed() + return response.json() + + @waypoint + def compute_guest_agent_feature_get(self, vm_id: int) -> list: + """ + Implementation of functionality of the API method + `/cloudapi/compute/guest_agent_feature_get`. + """ + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/guest_agent_feature_get', # noqa: E501 + arg_params={ + 'compute_id': vm_id, + } + ) + return response.json() + + @waypoint + @checkmode + def compute_guest_agent_feature_update(self, vm_id: int): + """ + Implementation of functionality of the API method + `/cloudapi/compute/guest_agent_feature_update`. + """ + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/guest_agent_feature_update', # noqa: E501 + arg_params={ + 'compute_id': vm_id, + } + ) + self.set_changed() + return response.json() + + @waypoint + @checkmode + def compute_guest_agent_execute( + self, + vm_id: int, + cmd: str, + args: dict | None = None, + ): + """ + Implementation of functionality of the API method + `/cloudapi/compute/guest_agent_execute`. + """ + api_params = { + 'compute_id': vm_id, + 'command': cmd, + 'arguments': json.dumps(args or {}), + } + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/guest_agent_execute', + arg_params=api_params, + ) + self.set_changed() + return response.json()['return'] + ################################### # OS image manipulation methods ################################### @@ -2359,11 +2686,20 @@ class DecortController(object): return 0, None - def virt_image_create(self, name, targetId): + def virt_image_create( + self, + name: str, + target_id: int, + account_id: None | int = 0, + ): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "virt_image_create") - api_params = dict(name=name, targetId=targetId,) + api_params = { + 'name': name, + 'targetId': target_id, + 'accountId': account_id, + } api_resp = self.decort_api_call(requests.post, "/restmachine/cloudapi/image/createVirtual", api_params) # On success the above call will return here. On error it will abort execution by calling fail_json. virt_image_dict = json.loads(api_resp.content.decode('utf8')) @@ -2392,7 +2728,7 @@ class DecortController(object): drivers, username, password, - account_Id, + account_id, usernameDL, passwordDL, sepId, @@ -2411,7 +2747,7 @@ class DecortController(object): 'boottype': boot_mode, 'imagetype': boot_loader_type, 'drivers': drivers, - 'accountId': account_Id, + 'accountId': account_id, 'hotresize': hot_resize, 'username': username, 'password': password, @@ -2682,7 +3018,21 @@ class DecortController(object): self.result['changed'] = True return - def rg_provision(self, arg_account_id, arg_rg_name, arg_username, arg_desc, restype, arg_net_type, ipcidr, arg_extNetId, arg_extIp, arg_quota={}, location=""): + def rg_provision( + self, + arg_account_id, + arg_rg_name, + arg_username, + arg_desc, + restype, + arg_net_type, + ipcidr, + arg_extNetId, + arg_extIp, + arg_quota={}, + location="", + sdn_access_group_id: None | str = None, + ): """Provision new RG according to the specified arguments. If critical error occurs the embedded call to API function will abort further execution of the script and relay error to Ansible. @@ -2724,9 +3074,7 @@ class DecortController(object): def_net=arg_net_type, extNetId=arg_extNetId, extIp=arg_extIp, - # maxMemoryCapacity=-1, maxVDiskCapacity=-1, - # maxCPUCapacity=-1, maxNumPublicIP=-1, - # maxNetworkPeerTransfer=-1, + sdn_access_group_id=sdn_access_group_id, ) if arg_quota: if 'ram' in arg_quota: @@ -3527,7 +3875,8 @@ class DecortController(object): 'accountId': account_id, 'permanently': permanently, }, - not_fail_codes=[404] + not_fail_codes=[404], + accept_json_response=True, ) if api_resp.status_code == 404: @@ -3536,14 +3885,60 @@ class DecortController(object): ) self.exit(fail=True) - self.message( - self.MESSAGES.obj_deleted( - obj=OBJ, - id=account_id, - permanently=permanently) - ) self.set_changed() + audit_id = api_resp.json() + task_link = ( + f'{self.controller_url}/portal/#/system/tasks/{audit_id}' + ) + + task_schedule_timeout = 600 + account_delete_timeout = 1200 + sleep_interval = 5 + while True: + task_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/tasks/get', + arg_params={'auditId': audit_id}, + ) + task_resp_data = task_response.json() + match task_resp_data['status']: + case 'SCHEDULED': + if task_schedule_timeout <= 0: + self.message( + f'Time to schedule task to delete account ID ' + f'{account_id} has been exceeded.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + task_schedule_timeout -= sleep_interval + case 'PROCESSING': + if account_delete_timeout <= 0: + self.message( + f'Time to delete account ID {account_id} ' + f'has been exceeded.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + account_delete_timeout -= sleep_interval + case 'ERROR': + self.result['msg'] = ( + f'Deleting account ID {account_id} failed:' + f'{task_resp_data.get("error")}.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + case 'OK': + self.message( + self.MESSAGES.obj_deleted( + obj=OBJ, + id=account_id, + permanently=permanently, + ) + ) + break + time.sleep(sleep_interval) + @waypoint @checkmode def account_restore(self, account_id: int) -> None: @@ -3563,7 +3958,8 @@ class DecortController(object): arg_params={ 'accountId': account_id, }, - not_fail_codes=[404] + not_fail_codes=[404], + accept_json_response=True, ) if api_resp.status_code == 404: @@ -3572,14 +3968,59 @@ class DecortController(object): ) self.exit(fail=True) - self.message( - self.MESSAGES.obj_restored( - obj=OBJ, - id=account_id, - ) - ) self.set_changed() + audit_id = api_resp.json() + task_link = ( + f'{self.controller_url}/portal/#/system/tasks/{audit_id}' + ) + + task_schedule_timeout = 600 + account_restore_timeout = 1200 + sleep_interval = 5 + while True: + task_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/tasks/get', + arg_params={'auditId': audit_id}, + ) + task_resp_data = task_response.json() + match task_resp_data['status']: + case 'SCHEDULED': + if task_schedule_timeout <= 0: + self.message( + f'Time to schedule task to restore account ID ' + f'{account_id} has been exceeded.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + task_schedule_timeout -= sleep_interval + case 'PROCESSING': + if account_restore_timeout <= 0: + self.message( + f'Time to restore account ID {account_id} ' + f'has been exceeded.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + account_restore_timeout -= sleep_interval + case 'ERROR': + self.result['msg'] = ( + f'Restoring account ID {account_id} failed:' + f'{task_resp_data.get("error")}.' + f'\nTask details: {task_link}' + ) + self.exit(fail=True) + case 'OK': + self.message( + self.MESSAGES.obj_restored( + obj=OBJ, + id=account_id, + ) + ) + break + time.sleep(sleep_interval) + @waypoint @checkmode def account_disable(self, account_id: int) -> None: @@ -3778,7 +4219,9 @@ class DecortController(object): public_ip_quota: None | int = None, ram_quota: None | int = None, sep_pools: None | Iterable[str] = None, - description: None | str = None,) -> None: + description: None | str = None, + default_zone_id: None | int = None, + ) -> None: """ Implementation of functionality of the API method `/cloudapi/account/update`. @@ -3804,6 +4247,7 @@ class DecortController(object): 'sendAccessEmails': access_emails, 'uniqPools': sep_pools, 'desc': description, + 'defaultZoneId': default_zone_id, }, not_fail_codes=[404] ) @@ -3847,6 +4291,16 @@ class DecortController(object): new_value=q_value) ) + if default_zone_id is not None: + self.message( + self.MESSAGES.obj_smth_changed( + obj=OBJ, + id=account_id, + smth='default_zone_id', + new_value=default_zone_id, + ) + ) + self.set_changed() ################################### @@ -4082,7 +4536,17 @@ class DecortController(object): return 0, None - def vins_provision(self, vins_name, account_id, rg_id=0, ipcidr="", ext_net_id=-1, ext_ip_addr="", desc=""): + def vins_provision( + self, + vins_name, + account_id, + rg_id=0, + ipcidr="", + ext_net_id=-1, + ext_ip_addr="", + desc="", + zone_id: None | int = None, + ): """Provision ViNS according to the specified arguments. If critical error occurs the embedded call to API function will abort further execution of the script and relay error to Ansible. @@ -4150,6 +4614,8 @@ class DecortController(object): if ipcidr != "": api_params['ipcidr'] = ipcidr api_params['desc'] = desc + + api_params['zoneId'] = zone_id api_resp = self.decort_api_call(requests.post, api_url, api_params) # On success the above call will return here. On error it will abort execution by calling fail_json. @@ -4399,6 +4865,20 @@ class DecortController(object): vins_dict['VNFDev']['accountId'] ) return + + @waypoint + @checkmode + def vins_migrate_to_zone(self, net_id: int, zone_id: int): + api_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/vins/migrateToZone', + arg_params={ + 'net_id': net_id, + 'zone_id': zone_id, + }, + ) + self.set_changed() + return api_response.json() def _vnf_iface_add(self,arg_devid,arg_vxlanid,arg_ipaddr,arg_netmask="24",arg_defgw=""): api_params = dict( @@ -5123,7 +5603,7 @@ class DecortController(object): "DESTROYED", "CREATING", "RESTORING"] VALID_TARGET_STATES = ["ENABLED", "DISABLED"] - + if arg_k8s_dict['status'] in NOP_STATES_FOR_K8S_CHANGE: self.result['failed'] = False self.result['msg'] = ("k8s_state(): no state change possible for k8s ID {} " @@ -5142,24 +5622,32 @@ class DecortController(object): "'{}' was requested.").format(arg_k8s_dict['id'], arg_k8s_dict['name'], arg_desired_state) return - if arg_desired_state == 'present': - arg_desired_state = 'enabled' + k8s_state_api = "" # This string will also be used as a flag to indicate that API call is necessary api_params = dict(k8sId=arg_k8s_dict['id']) expected_state = "" tech_state = "" - if arg_k8s_dict['status'] in ["CREATED", "ENABLED"] and arg_desired_state == 'disabled': - k8s_state_api = "/restmachine/cloudapi/k8s/disable" - expected_state = "DISABLED" - elif arg_k8s_dict['status'] in ["CREATED", "DISABLED"] and arg_desired_state == 'enabled': - k8s_state_api = "/restmachine/cloudapi/k8s/enable" - expected_state = "ENABLED" - elif arg_k8s_dict['status'] == "ENABLED" and arg_desired_state == 'enabled' and arg_started is True and arg_k8s_dict['techStatus'] == "STOPPED": - k8s_state_api = "/restmachine/cloudapi/k8s/start" - tech_state = "STARTED" - elif arg_k8s_dict['status'] == "ENABLED" and arg_desired_state == 'enabled' and arg_started is False and arg_k8s_dict['techStatus'] == "STARTED": - k8s_state_api = "/restmachine/cloudapi/k8s/stop" - tech_state = "STOPPED" + if arg_k8s_dict['status'] in ['CREATED', 'ENABLED']: + if arg_desired_state == 'disabled': + k8s_state_api = '/restmachine/cloudapi/k8s/disable' + expected_state = 'DISABLED' + elif ( + arg_k8s_dict['techStatus'] == 'STARTED' + and arg_desired_state == 'stopped' + ): + k8s_state_api = '/restmachine/cloudapi/k8s/stop' + elif ( + arg_k8s_dict['techStatus'] == 'STOPPED' + and arg_desired_state == 'started' + ): + k8s_state_api = '/restmachine/cloudapi/k8s/start' + elif ( + arg_k8s_dict['status'] == 'DISABLED' + and arg_desired_state == 'enabled' + ): + k8s_state_api = '/restmachine/cloudapi/k8s/enable' + expected_state = 'ENABLED' + if k8s_state_api != "": self.decort_api_call(requests.post, k8s_state_api, api_params) # On success the above call will return here. On error it will abort execution by calling fail_json. @@ -5173,7 +5661,7 @@ class DecortController(object): "state '{}' to desired state '{}'.").format(arg_k8s_dict['id'], arg_k8s_dict['status'], arg_desired_state) - + return def k8s_delete(self, k8s_id, permanently=False): @@ -5288,6 +5776,7 @@ class DecortController(object): extnet_only, master_chipset: Literal['Q35', 'i440fx'] = 'i440fx', lb_sysctl: dict | None = None, + zone_id: None | int = None, ): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "k8s_provision") @@ -5336,6 +5825,7 @@ class DecortController(object): lbSysctlParams=lb_sysctl and json.dumps( {k: str(v) for k, v in lb_sysctl.items()} ), + zoneId=zone_id, ) upload_files = None @@ -5620,6 +6110,20 @@ class DecortController(object): ret_conf = api_resp.content.decode('utf8') return ret_conf + @waypoint + @checkmode + def k8s_migrate_to_zone(self, k8s_id: int, zone_id: int): + api_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/k8s/migrateToZone', + arg_params={ + 'k8sId': k8s_id, + 'zoneId': zone_id, + }, + ) + self.set_changed() + return api_response.json() + ############################## # # Bservice management @@ -5675,7 +6179,7 @@ class DecortController(object): else: return bservice_id,None - def bservice_provision(self,bs_name,rgid,sshuser=None,sshkey=None): + def bservice_provision(self,bs_name,rgid,sshuser=None,sshkey=None, zone_id: None | int = None): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_provision") @@ -5693,6 +6197,7 @@ class DecortController(object): rgId = rgid, sshUser = sshuser, sshKey = sshkey, + zoneId=zone_id, ) api_resp = self.decort_api_call(requests.post, api_url, api_params) self.result['failed'] = False @@ -5700,7 +6205,7 @@ class DecortController(object): ret_bservice_id = int(api_resp.content.decode('utf8')) return ret_bservice_id - def bservice_state(self,bs_dict,desired_state,started=True): + def bservice_state(self,bs_dict,desired_state): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "bservice_state") if desired_state == "present": @@ -5708,7 +6213,7 @@ class DecortController(object): NOP_STATES_FOR_BS_CHANGE = ["MODELED", "DISABLING", "ENABLING", "DELETING", "DELETED", "DESTROYING", "DESTROYED","RESTORYNG","RECONFIGURING"] - VALID_TARGET_STATES = ["enabled", "disabled"] + VALID_TARGET_STATES = ["enabled", "disabled", 'started', 'stopped'] if bs_dict['status'] in NOP_STATES_FOR_BS_CHANGE: self.result['failed'] = False @@ -5734,12 +6239,29 @@ class DecortController(object): api_params = dict(serviceId=bs_dict['id']) expected_state = "" - if bs_dict['status'] in ["CREATED", "ENABLED"] and desired_state == 'disabled': - bsstate_api = "/restmachine/cloudapi/bservice/disable" - expected_state = "DISABLED" - elif bs_dict['status'] in ["CREATED", "DISABLED"] and desired_state == 'enabled': - bsstate_api = "/restmachine/cloudapi/bservice/enable" - expected_state = "ENABLED" + if bs_dict['status'] in ['CREATED', 'ENABLED']: + if desired_state == 'disabled': + bsstate_api = '/restmachine/cloudapi/bservice/disable' + expected_state = 'DISABLED' + elif ( + bs_dict['techStatus'] == 'STARTED' + and desired_state == 'stopped' + ): + bsstate_api = '/restmachine/cloudapi/bservice/stop' + elif ( + ( + bs_dict['techStatus'] == 'STOPPED' + or bs_dict['status'] == 'CREATED' + ) + and desired_state == 'started' + ): + bsstate_api = '/restmachine/cloudapi/bservice/start' + elif ( + bs_dict['status'] == 'DISABLED' + and desired_state == 'enabled' + ): + bsstate_api = '/restmachine/cloudapi/bservice/enable' + expected_state = 'ENABLED' if bsstate_api != "": self.decort_api_call(requests.post, bsstate_api, api_params) @@ -5753,29 +6275,7 @@ class DecortController(object): "state '{}' to desired state '{}'.").format(bs_dict['id'], bs_dict['status'], desired_state) - - start_api = "" - - if bs_dict['status'] in ["ENABLED","enabled"]: - if started == True and bs_dict['techStatus'] == "STOPPED": - start_api = "/restmachine/cloudapi/bservice/start" - t_state_expected = "STARTED" - if started == False and bs_dict['techStatus'] == "STARTED": - start_api = "/restmachine/cloudapi/bservice/stop" - t_state_expected = "STOPPED" - - if start_api != "": - self.decort_api_call(requests.post, start_api, api_params) - # On success the above call will return here. On error it will abort execution by calling fail_json. - self.result['failed'] = False - self.result['changed'] = True - bs_dict['techStatus'] = t_state_expected - else: - self.result['failed'] = False - self.result['msg'] = ("bservice_state(): no start/stop action required for B-service ID {} from current " - "techStatus '{}' to desired started = '{}'.").format(bs_dict['id'], - bs_dict['techStatus'], - started) + return def bservice_delete(self,bs_id,permanently=True): @@ -5795,6 +6295,20 @@ class DecortController(object): self.result['changed'] = True return + + @waypoint + @checkmode + def bservice_migrate_to_zone(self, bs_id: int, zone_id: int): + api_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/bservice/migrateToZone', + arg_params={ + 'serviceId': bs_id, + 'zoneId': zone_id, + }, + ) + self.set_changed() + return api_response.json() # # GROUP MANAGE @@ -6062,7 +6576,18 @@ class DecortController(object): self.amodule.fail_json(**self.result) return 0, None - def lb_provision(self,lb_name,rg_id,vins_id,ext_net_id,ha_status,description,start=True, sysctl: dict | None = None): + def lb_provision( + self, + lb_name, + rg_id, + vins_id, + ext_net_id, + ha_status, + description, + start=True, + sysctl: dict | None = None, + zone_id: None | int = None, + ): """Provision LB according to the specified arguments. If critical error occurs the embedded call to API function will abort further execution of the script and relay error to Ansible. @@ -6095,6 +6620,7 @@ class DecortController(object): sysctlParams=sysctl and json.dumps( {k: str(v) for k, v in sysctl.items()} ), + zoneId=zone_id, ) api_resp = self.decort_api_call(requests.post, api_url, api_params) # On success the above call will return here. On error it will abort execution by calling fail_json. @@ -6133,7 +6659,7 @@ class DecortController(object): NOP_STATES_FOR_LB_CHANGE = ["MODELED", "DISABLING", "ENABLING", "DELETING", "DELETED", "DESTROYING", "DESTROYED"] - VALID_TARGET_STATES = ["enabled", "disabled","restart", 'started'] + VALID_TARGET_STATES = ["enabled", "disabled","restart", 'started', 'stopped'] VALID_TARGET_TSTATES = ["STARTED","STOPPED"] if lb_dict['status'] in NOP_STATES_FOR_LB_CHANGE: @@ -6142,7 +6668,10 @@ class DecortController(object): "in its current state '{}'.").format(lb_dict['id'], lb_dict['status']) return - if desired_state not in VALID_TARGET_STATES: + if ( + desired_state is not None + and desired_state not in VALID_TARGET_STATES + ): self.result['failed'] = False self.result['warning'] = ("lb_state(): unrecognized desired state '{}' requested " "for LB ID {}. No LB state change will be done.").format(desired_state, @@ -6181,7 +6710,7 @@ class DecortController(object): self.result['failed'] = False self.result['changed'] = True lb_dict['status'] = expected_state - else: + elif desired_state is not None: self.result['failed'] = False self.result['msg'] = ("lb_state(): no state change required for LB ID {} from current " "state '{}' to desired state '{}'.").format(lb_dict['id'], @@ -6427,7 +6956,7 @@ class DecortController(object): aparam_backends: list | None, aparam_frontends: list | None, aparam_servers: list | None, - aparam_sysctl: dict | None, + aparam_sysctl: dict | None = None, ): self.result['waypoints'] = "{} -> {}".format(self.result['waypoints'], "lb_update") @@ -6754,6 +7283,20 @@ class DecortController(object): ) self.set_changed() + @waypoint + @checkmode + def lb_migrate_to_zone(self, lb_id: int, zone_id: int): + api_response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/lb/migrateToZone', + arg_params={ + 'lbId': lb_id, + 'zoneId': zone_id, + }, + ) + self.set_changed() + return api_response.json() + @waypoint @checkmode def snapshot_create(self, compute_id: int, label: str): @@ -6886,3 +7429,162 @@ class DecortController(object): common_snapshot_usage_info = snapshot_usage[0] snapshots_usage = snapshot_usage[1:] return common_snapshot_usage_info, snapshots_usage + + @waypoint + @checkmode + def snapshot_abort_merge(self, vm_id: int, label: str) -> str: + response = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/compute/abort_shared_snapshot_merge', # noqa: E501 + arg_params={ + 'compute_id': vm_id, + 'label': label, + }, + ) + self.set_changed() + self.message( + f'Merge aborted for snapshot {label} of VM ID {vm_id}.' + ) + return response.text + + def check_aparam_zone_id(self) -> bool | None: + aparam_zone_id = self.aparams['zone_id'] + if aparam_zone_id is not None: + if aparam_zone_id in self.acc_zone_ids: + return True + else: + self.message( + 'Check for parameter "zone_id" failed: ' + f'zone ID {aparam_zone_id} not available for account ID {self.acc_id}.' + ) + return False + + @waypoint + def zone_get(self, id: int) -> dict: + """ + Implementation of functionality of the API method + `/cloudapi/zone/get`. + """ + + api_resp = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/zone/get', + arg_params={ + 'id': id, + }, + not_fail_codes=[403, 404], + ) + + zone_info = None + if api_resp.status_code == 200: + zone_info = api_resp.json() + + if not zone_info: + self.message( + self.MESSAGES.obj_not_found(obj='zone', id=id) + ) + self.exit(fail=True) + + return zone_info + + @waypoint + def trunk_get(self, id: int) -> dict: + """ + Implementation of functionality of the API method + `/cloudapi/trunk/get`. + """ + + api_resp = self.decort_api_call( + arg_req_function=requests.get, + arg_api_name='/restmachine/cloudapi/trunk/get', + arg_params={ + 'id': id, + }, + not_fail_codes=[404], + ) + + trunk_info = None + if api_resp.status_code == 200: + trunk_info = api_resp.json() + + if not trunk_info: + self.message( + self.MESSAGES.obj_not_found(obj='trunk', id=id) + ) + self.exit(fail=True) + + return trunk_info + + @waypoint + def user_trunks( + self, + account_ids: None | list = None, + ids: None | list = None, + status: None | TrunkStatus = None, + vlan_ids: None | list = None, + page_number: int = 1, + page_size: None | int = None, + sort_by_asc: bool = True, + sort_by_field: None | TrunksSortableField = None, + ) -> list[dict]: + """ + Implementation of the functionality of API method + `/cloudapi/trunk/list`. + """ + sort_by = None + if sort_by_field: + sort_by_prefix = '+' if sort_by_asc else '-' + sort_by = f'{sort_by_prefix}{sort_by_field.name}' + + api_params = { + 'account_ids': account_ids, + 'ids': ids, + 'trunk_tags': vlan_ids, + 'status': status.value if status else None, + 'page': page_number if page_size else None, + 'size': page_size, + 'sort_by': sort_by, + } + api_resp = self.decort_api_call( + arg_req_function=requests.get, + arg_api_name='/restmachine/cloudapi/trunk/list', + arg_params=api_params, + ) + + trunks = api_resp.json()['data'] + + return trunks + + def check_account_vm_features(self, vm_feature: VMFeature) -> bool: + return vm_feature.value in self.acc_info['computeFeatures'] + + def check_rg_vm_features(self, vm_feature: VMFeature) -> bool: + return vm_feature.value in self.rg_info['computeFeatures'] + + @waypoint + def extnet_get(self, id: int) -> dict: + """ + Implementation of functionality of the API method + `/cloudapi/extnet/get`. + """ + + api_resp = self.decort_api_call( + arg_req_function=requests.post, + arg_api_name='/restmachine/cloudapi/extnet/get', + arg_params={ + 'net_id': id, + }, + not_fail_codes=[404], + ) + + extnet_info = None + if api_resp.status_code == 200: + extnet_info = api_resp.json() + + if not extnet_info: + self.message( + self.MESSAGES.obj_not_found(obj='trunk', id=id) + ) + self.exit(fail=True) + + return extnet_info diff --git a/requirements-dev.txt b/requirements-dev.txt new file mode 100644 index 0000000..61f70b3 --- /dev/null +++ b/requirements-dev.txt @@ -0,0 +1,2 @@ +-r requirements.txt +pre-commit==4.1.0 diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..557caaf --- /dev/null +++ b/requirements.txt @@ -0,0 +1,2 @@ +ansible==11.6.0 +requests==2.32.3 diff --git a/wiki/5.2.6/Home.md b/wiki/5.2.6/Home.md deleted file mode 100644 index 0f4cb12..0000000 --- a/wiki/5.2.6/Home.md +++ /dev/null @@ -1,20 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) -2. [Обзор облачной платформы DECORT.](./Обзор-облачной-платформы-DECORT.md) - - [Основные понятия](./Обзор-облачной-платформы-DECORT.md#основные-понятия) - - [Способы авторизации](./Обзор-облачной-платформы-DECORT.md#способы-авторизации) -3. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными серверами KVM. - - [Модуль decort_osimage](./модуль-decort_osimage.md) - получение идентификатора образа ОС. - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисковыми ресурсами. - - [Модуль decort_pfw](./модуль-decort_pfw.md) - настройки правил трансляции сетевых портов для виртуального сервера. - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами. - - [Модуль decort_vins](./модуль-decort_vins.md) - управление виртуальными сетевыми сегментами. - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена. - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление Basic сервисами. - - [Модуль decort_group](./модуль-decort_group.md)- управление группами виртуальных серверов. - - [Модуль decort_k8s](./модуль-decort_k8s.md)- управление кластерами Kubernetes. -4. [Полезные советы](./полезные-советы.md) - - [Как хранить авторизационную информацию отдельно от плейбука.](./полезные-советы.md#41-как-хранить-авторизационную-информацию-отдельно-от-плейбука) diff --git a/wiki/5.2.6/Обзор-облачной-платформы-DECORT.md b/wiki/5.2.6/Обзор-облачной-платформы-DECORT.md deleted file mode 100644 index 9424cb2..0000000 --- a/wiki/5.2.6/Обзор-облачной-платформы-DECORT.md +++ /dev/null @@ -1,30 +0,0 @@ -## Основные понятия - -Ниже перечислены основные понятия с указанием соответствующих им аргументов в Terraform провайдере DECORT. - -1. Контроллер облачной платформы DECORT – управляющее приложение, которое обеспечивает авторизацию пользователей и оркестрацию облачных ресурсов. - - Адрес контроллера задается в обязательном аргументе `controller_url` в Вашем плейбуке. Например, `controller_url= "https://ds1.digitalenergy.online"` -2. Авторизационный провайдер – приложение, работающее по протоколу Oauth2, предназначенное для выпуска и валидации токенов доступа к контроллеру облачной платформы в соответствующих режимах авторизации. Все действия в платформе должны выполняться авторизованными пользователями, и авторизационное приложение позволяет получить токен доступа, действующий некоторое ограниченное время, наличие которого подтверждает успешную авторизацию. - - Адрес авторизационного провайдера задается в аргументе `oauth2_url` в Вашем плейбуке. Например `oauth2_url= "https://sso.digitalenergy.online"`. При этом необходимо указать тип авторизации `authenticator: oauth2` -3. Подписчик (account) – сущность, которая используется для группирования облачных ресурсов по принадлежности к определенному клиенту для целей учета потребления и биллинга. - - Имя подписчика задается аргументом `account_name` в Вашем плейбуке. Альтернативой является задание численного идентификатора подписчика в аргументе `account_id`. -4. Пользователь (user) – пользователь облачной инфраструктуры, представленный учетной записью. Чтобы получить возможность управлять облачными ресурсами (например, создавать виртуальные серверы или дискт) пользователь должен быть ассоциирован с одним или несколькими подписчиками и иметь соответствующие права, определяемые ролевой моделью, принятой в облачной платформе DECORT. Для доступа к платформе пользователь должен авторизоваться одним из способов, описанных ниже в разделе «Способы авторизации». -5. Ресурсная группа (resource group) – способ группирования вычислительных ресурсов (например, виртуальных серверов по функциональному признаку или принадлежности к одному и тому же проекту). Ресурсную группу можно рассматривать как небольшой персональный дата-центр, в котором размещаются один или несколько серверов и виртуальных сетевых сегментов. Ресурсная группа идентифицируется по комбинации параметров `account` и `name`. Обратите внимание, что имя имя ресурсной группы уникально только в рамках одного и того же `account`. -6. Вычислительный ресурс (compute) - универсальная абстракция пользовательского сервера в платформе DECORT. Благодаря использованию такой абстракции можно, например, создать одну виртуальную машину на базе KVM Intel x86, а другую - на базе KVM IBM Power, а потом управлять ими - изменять количество CPU/RAM, подключать/отключать диски и т.п. - одинаковым образом, не задумываясь об их архитектурных различиях. -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. Данный способ является предпочтительным, так как обеспечивает бОльшую гибкость и безопасность. Для авторизации в этом режиме в Вашем плейбуке необходимо указать параметры `oauth2_url` и `controller_url`, а также предоставить одно из нижеперечисленного: - - Комбинация Application ID & Application secret, соответствующих пользователю, от имени которого будет осуществляться управление облачными ресурсами в текущей сессии. В процессе проверки предоставленных Application ID & Application secret модуль получает от авторизационного провайдера токен (JSON Web Token, JWT), который затем используется для доступа к указанному контроллеру DECORT. Для авторизации по данному варианту, в Вашем плейбуке следует установить аргумент `authenticator=oauth2` и задать аргументы `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`). - -После успешной авторизации пользователь (или приложение-клиент) получает доступ к ресурсам, находящимся под управлением соответствующего DECORT контроллера. Доступ предоставляется в рамках подписчиков (`account`), с которыми ассоциирован данный пользователь (`user`), и в соответствии с присвоенными ему ролями. \ No newline at end of file diff --git a/wiki/5.2.6/введение.md b/wiki/5.2.6/введение.md deleted file mode 100644 index a697840..0000000 --- a/wiki/5.2.6/введение.md +++ /dev/null @@ -1,90 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -У каждого модуля есть свой раздел, в котором Вы можете найти подробную информацию о параметрах, которые использует и возращает данный модуль, а также примеры использования данного модуля. - -В состав библиотеки модулей DECORT для Ansible на текущий момент входят: - -- decort_kvmvm - модуль для управления жизненным циклом виртуальных серверов (экземпляров compute). Платформа DECORT поддерживает виртуальные серверы на базе технологии KVM и аппаратных архитектур Intel x86 и IBM PowerPC. -Позволяет: - 1. Создавать новые виртуальные сервера указанной аппаратной архитектуры. Платформа поддерживает виртуальные сервера архитектуры Intel x86 и IBM PowerPC. - 2. Изменять конфигурацию существующего виртуального сервера: - - Изменять количества выделенных CPU и виртуальной ОЗУ. Следует иметь ввиду, что изменение этих параметров в меньшую сторону может потребовать перезагрузки гостевой ОС. - - Увеличивать размера загрузочного диска - - Подключать / отключать дополнительные дисковые ресурсы. - - Создавать / удалять сетевые подключения. - 3. Изменять состояние существующего виртуального сервера: - - Выключать / включать. - - Перезагружать, приостанаваливать / возобновлять работу гостевой ОС. - 4. Удалять существующий виртуальный сервер. - 5. Получать информацию о существующем виртуальном сервере без изменения его конфигурации. -- decort_disk - модуль для управления жизненным циклом дисковых ресурсов, которые можно подключать к экземплярам compute. -Позволяет: - 1) создавать / удалять диск; - 2) изменять размер диска. -- decort_rg - модуль для управления жизненным циклом ресурсных групп (Resource Groups, RG). -Позволяет: - 1) Создавать\удалять ресурсные группы. - 2) Запрашивать информацию об уже существующих ресурсных группах. - 3) Редактировать ресурсные группы. - 4) Настраивать квоты в ресурсных группах. - 5) Восстанавливать ресурсные группы. -- decort_vins - модуль для управления жизненным циклом виртуальных сетевых сегментов (Virtual Network Segment, ViNS). Экземпляры compute (напр., виртуальные серверы) могут быть подключены к нескольким виртуальным сетевым сегментам. -Позволяет: - 1) Создавать, удалять виртуальные сетевые сегменты. - 2) Изменять виртуальные сетевые сегменты. - 3) Запрашивать информацию о виртуальных сетевых сегментах. - 4) Восстанавливать удалённые виртуальные сетевые сегменты. - -- decort_pfw - модуль для настройки правил трансляции сетевых портов виртуальных серверов. -- decort_osimage - модуль для взаимодействия с образами. -Позволяет: - 1) Создавать новый образ операционной системы для виртуальных машин. - 2) Создавать виртуальный образ для образа операционной системы. - 3) Изменять имя образа (в случае изменения имени виртуального образа, имя и id виртуального образа указываются как image_name и image_id). - 4) Привязывать другой образ операционной системы к виртуальному образу. - 5) Удалять существующий образ, привязанный к аккаунту. - 6) Получать информацию об образе. -- decort_jwt - модуль для получения авторизационного токена (JWT - JSON Web Token), который можно использовать при массовом создании экземпляров compute для ускорения работы playbook-а. Подробности см. в соответствующем разделе. -- decort_bservice - модуль для взаимодействия с Basic сервисами (Basic service). -Позволяет: - 1) Создавать Basic Service. - 2) Удалять Basic Service. - 3) Включать/выключать Basic Service. - 4) Запрашивать информацию о Basic Service. -- decort_group - модуль для взаимодействия с группами виртуальных серверов(compute). -Позволяет: - 1) Получить информацию о группе виртуальных серверов. - 2) Запустить/остановить группу виртуальных серверов. - 3) Изменить параметры группы виртуальных серверов (cpu, ram, disk, и т.д). - 4) Изменить количество виртуальных серверов в группе. - 5) Изменить параметры сети (ext_net, VINS). - 6) Создать группу виртуальных серверов и подключить её к Basic сервису. - 7) Удалить группу виртуальных серверов. -- decort_k8s - модуль для взаимодействия с кластерами Kubernetes. -Позволяет: - 1) Создавать/удалять кластера Kubernetes. - 2) Enable/Disable кластера Kubernetes. - 3) Запускать/Останавливать кластера Kubernetes - 4) Модифицировать кластера Kubernetes - 5) Получать информацию об уже существующем кластере Kubernetes. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.7 or higher -- Python 3.7 or higher -- PyJWT 2.0.0 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 3.5.0 or higher - -## Подготовка к работе - -Для начала работы необходимо разместить директории library и module_utils в Вашей рабочей директории, откуда будут запускаться плейбуки, либо указать в ansible.cfg путь до них. - - - - diff --git a/wiki/5.2.6/модуль-decort_bservice.md b/wiki/5.2.6/модуль-decort_bservice.md deleted file mode 100644 index 7289a3e..0000000 --- a/wiki/5.2.6/модуль-decort_bservice.md +++ /dev/null @@ -1,103 +0,0 @@ -# 03.08 Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовый сервис (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_disk предназначен для управления basic сервисами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service. -- Удалять Basic Service. -- Включать/выключать Basic Service. -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя учётной записи (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string) | Текстовое описание диска. Данный аргумент является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения _DECORT_JWT_. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: absent, disabled, enabled, present, check| Состояние Basic сервиса.| -| started | (bool) | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. По умолчанию: False. | -| name | (string) | Имя, с которым будет создан Basic сервис. Также используется для поиска ID Basic сервиса. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах в группе basic сервиса. Используется в паре с sshkey. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера в группе basic сервиса. Используется в паре с sshuser. | -| id | (int) | Уникальный целочисленный идентификатор Basic сервиса, используется для поиска, взаимодействия и удаления Basic сервиса. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, в которой будет работать модуль. | -| rg_name | (string) | Имя ресурсной группы, в которой будет работать модуль. | -| description | (string) | Описание. По умолчанию: `Created by decort ansible module`| -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения.
Данный параметр является опциональным.
Функциональность callbacks в текущей версии модуля не реализована.| -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL.
Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи.
Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`.
Функциональность callbacks в текущей версии модуля не реализована.| - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор данного Basic сервиса.| -|name | string | Имя Basic сервиса.| -| techStatus | string | Технический статус Basic сервиса. | -|state | string | Текущий статус Basic сервиса. Корректные состояния:MODELED, DISABLING, ENABLING, DELETING, DELETED, "DESTROYING, DESTROYED, RESTORYNG, RECONFIGURING| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в котором находится Basic сервис.| -| account_id | int | Уникальный целочисленный идентификатор пользователя, к которому привязан данный Basic сервис.| -| groupsName | string | Имена групп виртуальных серверов, которые находятся в данном Basic сервисе.| -| groupsIds | string | Уникальные целочисленные идентификаторы групп виртуальных серверов, которые находятся в данном Basic сервисе. | - - -## Пример использования модуля decort_bservice - -Данный пример создаёт Basic сервис с названием databases. - -``` - - name: Manage bservice at RG - decort_bservice: - account_id: 98 - verify_ssl: false - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - rg_id: 1629 - state: present - name: databases - started: True - register: db_bservice -``` - -Данный пример удаляет Basic сервис с названием databases. -``` - - name: Manage bservice at RG - decort_bservice: - account_id: 98 - verify_ssl: false - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - rg_id: 1629 - state: absent - name: databases - started: False - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_disk.md b/wiki/5.2.6/модуль-decort_disk.md deleted file mode 100644 index bb47cda..0000000 --- a/wiki/5.2.6/модуль-decort_disk.md +++ /dev/null @@ -1,167 +0,0 @@ -# 03.03 Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисковыми ресурсами в платформе DECORT: - -- создание / удаление диска; -- изменение размера диска. -- переименование диска. -- ограничение ввода / вывода диска. -- восстановление удаленного диска из корзины. - -Обратите внимание: - -- загрузочный диск для виртуального сервера создаётся и подключается автоматически в процессе создания этого сервера. - Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным серверам выполняется с помощью модулей управления compute-ресурсами (например, подробнее см. модуль decort_kvmvm, параметр data_disks). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя учётной записи (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string) | Текстовое описание диска. Данный аргумент является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным.| -| description | (string) | Описание диска. Используется при создании диска, по умолчанию установлено: "Disk created with Ansible Decort_disk module." | -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int) | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
`True`
`False` <- default | Задаёт поведение платформы при попытке удалить диск, подключённый к экземпляру _compute_.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: True`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах.| -| name | (string) | Имя диска. Для идентификации диска требуется либо его имя name и информация об учётной записи (`account_id` или `account_name`), которой принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool) | Параметр, использующийся при удалении диска, при значении True - диск удалится навсегда, а при False - попадёт в корзину. | -|place_with | (int) | Идентификатор образа ОС, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ ОС. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -|pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, значение по умолчанию - пустая строка (в этом случае платформа использует пул, который сконфигурирован на целевой системе хранения как пул по умолчанию). | -| reason | (string) | Причина, по которой было выполнено какое-либо действие, в данном модуле используется только при удалении диска. | -|sep_id | (int) | Идентификатор провайдера системы хранения данных (Storage End-point Provider). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный загрузочный образ, на базе которого создаётся экземпляр compute.| -|size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующих дисков, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | Значения:
`present` <- default
`absent`
| Целевое состояние диска. | -| type | (string) | Тип создаваемого диска. Возможные значения: B-Boot, D-Data, T-Temp. По умолчанию установлено значение D.| -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения.
Данный параметр является опциональным.
Функциональность callbacks в текущей версии модуля не реализована.| -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL.
Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи.
Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`.
Функциональность callbacks в текущей версии модуля не реализована.| - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|account_id | int | Уникальный целочисленный идентификатор учётной записи (account), которой принадлежит диск.| -|attached_to | int | Идентификатор экземпляра Compute (напр., виртуального сервера), к которому в настоящий момент подключён диск. Если диск не подключён, то attached_to=0| -|gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -|id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничение ввода / вывода диска. | -|name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -|pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения (Storage Endpoint Provider), на которой размещаются ресурсы данного диска.| -|size | int | Размер диска в ГБ.| -|state | string | Текущий статус диска. Корректные состояния: CREATED, ASSIGNED, DELETED, DESTROYED, PURGED.| - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (size: 50), с ограничением ввода / вывода в 2000 iops, на ресурсах системы хранения, доступной через Storage Endpoint provider под номером 1 (sep_id: 1) в пуле "data01". - -``` -- name: manage data disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - state: present - register: my_data_disk01 - delegate_to: localhost -``` -В данном примере ограничивается уже существующий диск с именем "DataDisk01", ограничивается как чтение/запись в iops, так и в байтах, также задаётся их максимальное чтение / запись(read/write_*_sec_max). - -``` -- name: manage data disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 100 - read_bytes_sec_max: 100 - read_iops_sec: 100 - read_iops_sec_max: 100 - size_iops_sec: 100 - write_bytes_sec: 100 - write_bytes_sec_max: 100 - write_iops_sec: 100 - write_iops_sec_max: 100 - total_bytes_sec: 0 - total_iops_sec: 0 - total_bytes_sec_max: 0 - total_iops_sec_max: 0 - state: present - register: my_data_disk01 - delegate_to: localhost -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: manage data disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - state: present - register: my_data_disk01 - delegate_to: localhost -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: manage data disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - state: present - register: my_data_disk01 - delegate_to: localhost -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальному серверу, следует воспользоваться показанной ниже конструкцией: - -``` -- name: manage virtual server - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_group.md b/wiki/5.2.6/модуль-decort_group.md deleted file mode 100644 index 2f0a003..0000000 --- a/wiki/5.2.6/модуль-decort_group.md +++ /dev/null @@ -1,103 +0,0 @@ -# 03.09 Модуль decort_group -## Обзор модуля decort_group -Модуль decort_group позволяет взаимодействовать с группами виртуальных серверов, которые находятся в Basic сервисе. `Взаимодействие с Basic сервисами происходит в модуле decort_bservice.` - -Модуль decort_group позволяет: -- Получить информацию о группе виртуальных серверов. -- Запустить/остановить группу виртуальных серверов. -- Изменить параметры группы виртуальных серверов (cpu, ram, disk, role, name). -- Изменить количество виртуальных серверов в группе. -- Изменить параметры сети (ext_net, VINS). -- Создать группу виртуальных серверов и подключить её к Basic сервису. -- Удалить группу виртуальных серверов. - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля decort_group. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя учётной записи (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя учётной записи (account), которой принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным.| -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|id | (int) | Уникальный целочисленный идентификатор группы виртуальных серверов.| -| image_id | (int) | Уникальный целочисленный идентификатор образа операционной системы. Используется для создания виртуальных серверов в группе. | -| image_name | (string) | Имя образа операционной системы. Используется для создания виртуальных серверов в группе.| -| driver | (string) | Тип виртуального сервера. Прим. `KVM_X86` | -| boot_disk | (int) | Обьём виртуального диска на виртуальных серверах. | -| bservice_id | (int) | Уникальный целочисленный идентификатор Basic серфиса, в который необходимо добавить группу виртуальных серверов. | -| count | (int) | Количество виртуальных серверов в группе. | -| timeoutStart | (int) | Задержка в секундах до отображения группы виртуальных серверов. | -| role | (string) | Роль группы виртуальных серверов. | -| cpu | (int) | Количество ядер процессора на каждом виртуальном сервере в группе. | -| ram | (int) | Объём оперативной памяти на каждом виртуальном сервере в группе. | -| networks | (list) | Список сетей, которые необходимо подключить к каждому виртуальному серверу в группе | -| description | (string) | Описание группы виртуальных серверов. | -|verify_ssl | (bool) | True <- default False Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах.| -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована. | -|workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`.| - -## Возвращаемые значения модуля decort_group - -Модуль decort_group возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, к которому привязана данная группа виртуальных серверов. | -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится данная группа виртуальных серверов. | -| id | int | Уникальный целочисленный идентификатор данной группы виртуальных серверов.| -| name | string | Имя данной группы виртуальных серверов.| -| techStatus | string | Технический статус данной группы виртуальных серверов. | -| state | string | Текущее состояние группы виртуальных серверов. Корректные состояния: absent, started, stopped, present, check.| -| Computes | string | Уникальные целочисленные идентификаторы виртуальных серверов, входящих в группу. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу виртуальных серверов с названием test_group. -``` -- hosts: localhost - tasks: - - name: create - decort_group: - authenticator: oauth2 - verify_ssl: False - controller_url: "https://ds1.digitalenergy.online" - state: present - bservice_id: 1823 - count: 2 - name: "test_group" - cpu: 2 - ram: 2 - boot_disk: 10 - image_id: 518 - driver: "KVM_X86" - timeoutStart: 5 - networks: - - type: VINS - id: 1987 - delegate_to: localhost - register: group_test -``` - -Данный пример удаляет группу виртуальных серверов с названием test_group. - -``` -- hosts: localhost - tasks: - - name: create - decort_group: - authenticator: oauth2 - verify_ssl: False - controller_url: "https://ds1.digitalenergy.online" - state: absent - bservice_id: 1823 - name: "test_group" - delegate_to: localhost - register: group_test -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_jwt.md b/wiki/5.2.6/модуль-decort_jwt.md deleted file mode 100644 index 0726013..0000000 --- a/wiki/5.2.6/модуль-decort_jwt.md +++ /dev/null @@ -1,56 +0,0 @@ -# 03.07 Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль decort_jwt предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании виртуальных серверов на базе одного и того же образа, так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает changed: False). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_jwt. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -|app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|validity | (int) | Срок действия JWT в секундах. Данный параметр является опциональным, значение по умолчанию - 3600 сек.| -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -|workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована.| -|workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов workflow_callback данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля не реализована.| -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль decort_jwt возвращает словарь, в котором по ключу jwt находится значение JWT-токена (тип string). - -## Пример использования модуля decort_jwt - -В данном примере сначала получается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуального сервера в режиме авторизации jwt (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: ansible_master - tasks: - - name: obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - delegate_to: localhost - register: my_token -``` -``` - - name: manage KVM VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - state: present - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании нового виртуального сервера (в предположении, что результат выполнения task для модуля decort_jwt был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_k8s.md b/wiki/5.2.6/модуль-decort_k8s.md deleted file mode 100644 index a4fbc15..0000000 --- a/wiki/5.2.6/модуль-decort_k8s.md +++ /dev/null @@ -1,102 +0,0 @@ -# 03.10 Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль decort_k8s предназначен для выполнения следующих действий над кластерами Kubernetes, созданными в облачной платформе DECORT: -- Создание/удаление кластера Kubernetes. -- Enable/Disable кластера Kubernetes. -- Запуск/Остановка кластера Kubernetes -- Модификация кластера Kubernetes -- Получение идентификатора образа Kubernetes по имени образа. - - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля decort_k8s: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения DECORT_APP_ID. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме authenticator: jwt Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| verify_ssl | (bool) | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована. | -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля не реализована. | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, к которому привязан кластер. | -| account_name | (string) | Имя аккаунта, к которому привязан кластер. | -| annotation | (string) | Аннотации для рабочих групп в кластере Kubernetes. | -| quotas | (dict) | Библиотека, содержащая квоты. | -| state | (string) | Состояние кластера. Поддерживаемые состояния: absent, disabled, enabled, present,check. | -| permanent | (bool) | Параметр, отвечающий за полное удаление кластера. При значениие `True` кластер будет полностью удалён, при значении `False` кластер будет перемещён в корзину. | -| started | (bool) | Параметр, отвечающий за запуск кластера после создания. При значении `True`, после создания кластер будет автоматически запущен. | -| name | (string) | Имя кластера Kubernetes. | -| id | (int) | Уникальный целочисленный идентификатор кластера Kubernetes, позволяющий удалять, изменять и получать сведения о кластере Kubernetes. | -| getConfig | (bool) | Параметр, передающий конфигурационный файл кластера Kubernetes, при значении `True`. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, в которой находится кластер Kubernetes. | -| rg_name | (int) | Имя ресурсной группы, в которой находится кластер Kubernetes. | -| k8ci_id | (int) | Уникальный целочисленный идентификатор образа кластера Kubernetes. | -| wg_name | (string) | Имя рабочей группы. В кластере может быть несколько рабочих групп. | -| master_count | (int) | Количество master узлов в рабочей группе. По умолчанию: `1`| -| master_cpu | (int) | Количество ядер процессора на каждом master узле. По умолчанию: `2` | -| master_ram_mb | (int) | Объём оперативной памяти на каждом master узле. По умолчанию: `2048` | -| master_disk_gb | (int) | Объём жесткого диска на каждом master узле. По умолчанию: `10` | -| worker_count | (int) | Количество worker узлов в рабочей группе. По умолчанию: `1`| -| worker_cpu | (int) | Количество ядер процессора на каждом worker узле. По умолчанию: `1` | -| worker_ram_mb | (int) | Объём оперативной памяти на каждом worker узле. По умолчанию: `1024` | -| worker_disk_gb | (int) | Объём жесткого диска на каждом worker узле. По умолчанию: `10` | -| workers | (dict) | Библиотека, в которой необходимо указывать рабочие группы и их параметры. См. пример 13.4 | -| extnet_id | (int) | Уникальный целочисленный идентификатор внешней сети, к которой будет подключен кластер при создании. По умолчанию: `0` | -| description | (string) | Описание кластера. По умолчанию: `Created by decort ansible module` | -| with_lb | (bool) | Отвечает за создание Load Balancer при создании кластера. По умолчанию: `True` | - - - -## Возвращаемые значения модуля decort_k8s - -Модуль decort_k8s возвращает информацию о кластере в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| id | int | Уникальный целочисленный идентификатор данного кластера. | -| name | string | Имя данного кластера. | -| techStatus | string | Технический статус кластера. Возможные технические статусы кластера: STARTED, DELETED, STOPPED, CREATED, , DISABLED, ENABLED, RESTORED, MODELED.| -| state | string | Текущий статус кластера. Поддерживаемые состояния: absent, disabled, enabled, present,check. | -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится данный кластер. | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, к которому привязан данный кластер. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с названием cluster-test. -``` - - name: create a cluster named cluster-test - decort_k8s: - state: present - started: True - getConfig: True - authenticator: jwt - jwt: "{{ token.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - name: "cluster-test" - rg_id: 125 - k8ci_id: 18 - workers: - - name: wg1 - ram: 1024 - cpu: 10 - disk: 10 - num: 1 - - name: wg2 - ram: 1024 - cpu: 10 - disk: 10 - num: 2 - verify_ssl: false - delegate_to: localhost - register: kube - -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_kvmvm.md b/wiki/5.2.6/модуль-decort_kvmvm.md deleted file mode 100644 index 05f93b6..0000000 --- a/wiki/5.2.6/модуль-decort_kvmvm.md +++ /dev/null @@ -1,112 +0,0 @@ -# 03.01 Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль decort_kvmvm предназначен для предназначен для выполнения следующих действий над виртуальными серверами, созданными на базе технологии виртуализации KVM, в облачной платформе DECORT: - -1. Создание нового виртуального сервера указанной аппаратной архитектуры. Платформа поддерживает виртуальные сервера архитектуры Intel x86 и IBM PowerPC. -2. Изменение конфигурации существующего виртуального сервера: - - Изменение количества выделенных CPU и виртуальной ОЗУ. Следует иметь ввиду, что изменение этих параметров в меньшую сторону может потребовать перезагрузки гостевой ОС. - - Увеличение размера загрузочного диска - - Подключение / отключение дополнительных дисковых ресурсов. - - Создание / удаление сетевых подлкючений. -3. Изменение состояния существующего виртуального сервера: - - Выключение / включение. - - Перезагрузка, приостановка / возобновление работы гостевой ОС. -4. Удаление существующего виртуального сервера. -5. Получение информации о существующем виртуальном сервере без изменения его конфигурации. - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_kvmvm. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | int | Уникальный цифровой идентификатор подписчика, владеющего данным виртуальным сервером.Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя подписчика, которому будет принадлежать новый виртуальный сервер (или уже принадлежит существующий). Параметр должен задаваться в точном соответствии с тем, как назван нужный подписчик в облачной инфраструктуре (с соблюдением заглавных и строчных символов, а также пробелов). Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией account_name и rg_name. Если задан `account_id`, то `account_name` игнорируется.| -| annotation | (string) | Опциональное описание виртуального сервера. Этот параметр используется только в момент создания нового виртуального сервера и игнорируется при любых действиях над существующими серверами.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| arch | Значения:
`KVM_X86` <- default
`KVM_PPC`
| Аппаратная архитектура виртуального сервера. Данный параметр является обязательным при создании нового вирутального сервера и игнорируется для уже существующего сервера.
Платформа DECORT поддерживает виртуальные серверы KVM аппаратных архитектур Intel x86 и IBM PowerPC. | -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|boot_disk | (int) | Размер загрузочного диска виртуального сервера в ГБ. Загрузочный диск всегда создаётся на той же системе хранения и в том же пуле, где размещён образ ОС (см. параметры `image_name` или `image_id`), на базе которого создаётся данный виртуальный сервер. Если данный параметр не указан на момент создания виртуального сервера, то размер загрузочного диска будет установлен равным размеру образа ОС.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным.| -| cpu | (int) | Количество виртуальных CPU, выделенных виртуальному серверу. Параметр является обязательным при создании нового сервера, во всех других случаях он опциональный. Если указать его для уже существующего сервера, то будет выполнена попытка изменить количество CPU. Следует иметь ввиду, что уменьшение количества CPU у работающего сервера, как правило, потребует его перезагрузки.| -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данному виртуальному серверу как дополнительные (помимо загрузочного диска, который создаётся автоматически вместе с виртуальным сервером).| -| id | (int) | Уникальный цифровой идентификатор виртуального сервера внутри платформы. Этот параметр используется как один из методов идентификации существующего сервера (альтернатива – по комбинации name, `rg_name` и `account_name`) и игнорируется при создании нового сервера, так как для нового сервера облачная платформа назначает этот идентификатор автоматически. Если при вызове модуля `decort_kvmvm` существующий виртуальный сервер идентифицируется по своему id, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются.| -| image_id | (int) | Уникальный цифровой идентификатор образа ОС, на базе которого следует создать виртуальный сервер. При создании нового виртуального сервера требуется задать этот параметр или параметр image_name. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. Для получения `image_id` по `image_name` можно использовать модуль `decort_osimage`.| -| image_name | (string) | Название образа ОС, на базе которого следует создать виртуальный сервер. При создании нового виртуального сервера требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. Параметр `image_name` должен задаваться в точном соответствии с тем, как назван нужный образ ОС в облачной инфраструктуре (с соблюдением заглавных и строчных символов, а также пробелов).| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Название виртуального сервера. Чтобы модуль `decort_kvmvm` мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или идентификатор `rg_id`. Параметр должен задаваться в точном соответствии с тем, как назван сервер в облачной инфраструктуре (с соблюдением заглавных и строчных символов, а также пробелов). Если для существующего виртуального сервера указаны и name, и id, то параметр name игнорируется и идентификация сервера выполняется по его id.| -| networks | (list of dicts) | Опциональный список словарей, задающих сетевые подключения для данного виртуального сервера. Структура словаря:- (string) type - тип сетевого подключения, одно из VINS или EXTNET; - (int) id - идентификатор сетевого сегмента данного подключения; для type: VINS это VINS ID, для type: EXTNET это ID внешнего сетевого сегмента; - (string) ip_addr - опциональный IP адрес, который надлежит присвоить данному подключению; если данный параметр не указан, то платформа назначит свободный IP адрес из нужного диапазона автоматически. Если этот параметр не задан, то будет создан сервер без сетевых подключений, а если модуль вызван для уже существуюшего сервера, то все его сетевые подключения будут удалены.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| password | (string) | Пароль для подключения к контроллеру облачной инфраструктуры DECORT в режиме `authenticator: legacy`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать в playbook. Если параметр не задан в playbook, то модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_PASSWORD`.| -| ram | (int) | Объем оперативной памяти (RAM) в MB, выделенной данному виртуальному серверу. Параметр является обязательным при создании нового сервера. Если указать его для уже существующего сервера, то будет выполнена попытка изменить объем выделенной серверу памяти. Следует иметь ввиду, что уменьшение объема памяти работающего сервера в большинстве случаев потребует его перезагрузки.| -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы (RG), в которой будет создан новый или находится уже существующий виртуальный сервер. Данный параметр является одним из методов идентификации существующей RG (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы (RG), в которой будет создан новый или находится уже существующий виртуальный сервер. Данный параметр является одним из методов идентификации существующей RG, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`, который можно получить с помощью модуля `decort_rg`). Параметр должен задаваться в точном соответствии с тем, как нужная ресурсная группа названа в облачной инфраструктуре (с соблюдением заглавных и строчных символов, а также пробелов). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| ssh_key | (string) | Открытая часть SSH ключа, который необходимо авторизовать на создаваемом виртуальном сервере для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для Linux серверов, является опциональным, используется только при создании нового сервера и игнорируется при других операциях.| -| ssh_key_user | (string) | Имя пользователя на уровне гостевой ОС (только для Linux серверов) для которого авторизуется SSH ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`, используется только при создании нового сервера и игнорируется при других операциях.| -| state | Значения:
`present` <- default
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check` | Целевое состояние виртуального сервера на выходе из модуля _decort_kvmvm_.
Значение 'halted' - синоним к 'poweredoff'.
Значение 'check' вызывает модуль в _read-only_ режиме и считывает характеристики существующего виртуального сервера. | -| tags | (string) | Строка, содержащая набор текстовых меток, которые надлежит присвоить данному виртуальному серверу. Данные текстовые метки представляют собой произвольный текст, который можно использовать для группировки и индексирования виртуальных серверов во внешних приложениях. Параметр является опциональным.| -| user | (string) | Имя пользователя, непосредственно зарегистрированного на контроллере облачной инфраструктуры DECORT, которое используется для подключения к контроллеру в режиме `authenticator: legacy`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль `decort_kvmvm` будет использовать значение переменной окружения `DECORT_USER`.| -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована.| -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля `decort_kvmvm` не реализована.| - - -## Возвращаемые значения модуля decort_kvmvm - -Модуль decort_kvmvm возвращает информацию о виртуальном сервере в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int |Цифровой идентификатор подписчика, владеющего данным виртуальным сервером.| -| account_name | string | Имя подписчика, владеющего данным виртуальным сервером.| -| arch | string | Аппаратная архитектура данного виртуального сервера. Допустимые значения: KVM_X86 для Intel x86 и KVM_PPC для IBM PowerPC.| -| cpu | int | Количество виртуальных CPU, выделенных данному виртуальному серверу.| -| data_disks | list of ints | Список идентификаторов data-дисков, в настоящий момент подключенных к данному серверу.| -| disk_size | int | Размер загрузочного диска в ГБ.| -| id | int | Уникальный цифровой идентификатор данного виртуального сервера (экземпляра compute) в платформе DECORT.| -| name | string | Имя виртуального сервера. Имя уникально только в рамках одной и той же ресурсной группы.| -| password | string | Пароль системного пользователя по умолчанию.| -| private_ips | list of strings | Список IP адресов на сетевых интерфейсах сервера, которые подключены к виртуальным сетевым сегментам (Virtual Network Segments, ViNS).| -| public_ips | list of strings | Список IP адресов на сетевых интерфейсах сервера, которые подключены непосредственно к внешним сетевым сегментам (external network segments).| -| ram | int | Объём ОЗУ в МБ, выделенный виртуальному серверу.| -| rg_id | int | Уникальный цифровой идентификатор ресурсной группы (RG), к которой принадлежит данный сервер.| -| state | string | Состояние виртуального сервера.| -| username | string |Имя системного пользователя по умолчанию.| - -## Пример использования модуля decort_kvmvm - -В данном примере создается виртуальный сервер KVM VM по имени MyFirstVM с аппаратной архитектурой Intel x86. -``` -- name: create new x86 KVM VM according to the specs - decort_kvmvm: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: MyFirstVM - arch: KVM_X86 - state: present - cpu: 2 - ram: 4096 - boot_disk: 10 - image_id: "{{ my_img.facts.id }}" - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - rg_id: "{{ my_rg.facts.id }}" - annotation: "My 1st VM created and managed with DECORT KVMVM module" - delegate_to: localhost - register: new_vm -``` - -Виртуальный сервер создаётся на базе некоторого системного образа (дискового ресурса, содержащего операционную систему). В данном примере системный образ задаётся по его идентификатору (image_id: "{{ my_img.facts.id }}"). Для получения такого идентификатора можно использовать модуль decort_osimage. - -Виртуальный сервер всегда создаётся в принадлежности к некоторой ресурсной группе. В данном примере соответствующая ресурсная группа задаётся по её идентификатору (rg_id: "{{ my_rg.facts.id }}"). Для управления ресурсными группами предназначен модуль decort_rg. С помощью этого модуля можно также получит идентификатор ресурсной группы, чтобы использовать его при создании виртуального сервера. - -Для управления сетевыми подключениями виртуального сервера в модуле decort_kvmvm используется параметр networks, представляющий собой список с описанием требующихся подключений. В данном примере задано одно подключение в виртуальному сетевому сегменту (type: VINS) с указанным идентификатором (id: "{{ my_vins.facts.id }}"). Для управления виртуальными сетевыми сегментами и получения их идентификаторов служит модуль decort_vins. \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_osimage.md b/wiki/5.2.6/модуль-decort_osimage.md deleted file mode 100644 index 60cdbbb..0000000 --- a/wiki/5.2.6/модуль-decort_osimage.md +++ /dev/null @@ -1,135 +0,0 @@ -# 03.02 Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: - -1. Создание нового образа операционной системы для виртуальных машин. -2. Создание виртуального образа для образа операционной системы. -3. Изменение имени образа (в случае изменения имени виртуального образа, имя и id виртуального образа указываются как image_name и image_id. -4. Привязка другого образа операционной системы к виртуальному образу. -5. Удаление существующего образа, привязанного к аккаунту. -6. Получение информации об образе. - -Также данный модуль может быть полезен при массовом создании экземпляров compute (напр., виртуальных серверов) на базе одного и того же образа, так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения DECORT_APP_ID. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме authenticator: jwt Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| verify_ssl | (bool) | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована. | -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля не реализована. | -| account_Id | (string) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа операционной системы.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последвии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа операционной системы.| -| state | (string) | Состояние образов. При значении present идет создание образов операционной системы, к которым привязан указанный в `account_Id` или `account_name` аккаунт. При значении absent идет их удаление. | -| drivers | (string) | Список типов compute (напр., виртуальных серверов), подходящих для образа операционной системы. Прим. `KVM_X86`. Используется при создании образа операционной системы.| -| architecture | (string) | Бинарная архитектура образа. Прим. `X86_64` или `PPC64_LE`. Используется при создании образа операционной системы.| -| imagetype | (string) | Тип образа. `linux`, `windows` или `other`. По умолчанию установлено `linux`. Используется при создании образа операционной системы.| -| boottype | (string) | Тип загрузки образа. `bios` или `uefi`. По умолчанию установлено `uefi`. Используется при создании образа операционной системы.| -| url | (string) | Унифицированный указатель ресурса (URL), указывающий на образ iso операционной системы. Используется при создании образа операционной системы.| -| sepId | (integer) | Уникальный целочисленный идентификатор конечной точки провайдера хранения. Указывается в паре с `poolName`. Используется при создании образа операционной системы.| -| poolName | (string) | Пул, в котором будет создан образ. Указывается в паре с `sepId`. Используется при создании образа операционной системы.| -| hotresize | (bool) | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа операционной системы. | -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа операционной системы. Используется при создании образа операционной системы.| -| usernameDL | (string) | Имя пользователя для загрузки бинарного носителя. Используется в паре с `passwordDL`. Используется при создании образа операционной системы. | -| passwordDL | (string)| Пароль для загрузки бинарного носителя. Используется в паре с `usernameDL`. Используется при создании образа операционной системы. | -| permanently | (bool) | Навсегда ли удалить образ. Используется при удалении убраза. По умолчанию установлено false.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию о XXX в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| arch | string | Аппаратная архитектура, с которой совместим данный образ. Возможные значения: X86_64 (Intel x86), PPC64_LE (IBM PowerPC). | -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа операционной системы, который привязан к данному виртуальному. | -| name | string | Имя образа. Обратите внимание, что имя образа может содержать пробелы. | -| pool | string | Пул на системе хранения данных, в котором находится данный образ.| -| sep_id |int | Идентификатор системы хранения (Storage Endpoint Provider), на которой хранится данный образ. | -| size |int | Размер образа в ГБ. Загрузочный диск экземпляра compute, создаваемого на базе данного образа, должен иметь как минимум такой же размер. | -| state | string | Текущий статус образа. Возможные значения: CREATED, DISABLED, DESTROYED. Экземпляры compute можно создавать только на базе образов, которые находятся в статусе CREATED.| -| type | string | Тип операционной системы внутри данного образа. Возможные значения: Linux, Windows.| - - - -## Пример использования модуля decort_osimage - - -Пример создания образа операционной системы Alpine Linux. -``` - - name: create_osimage - decort_osimage: - authenticator: oauth2 - verify_ssl: False - controller_url: "https://ds1.digitalenergy.online" - state: present - image_name: "alpine_linux3.14.0" - account_Id: 12345 - url: "https://dl-cdn.alpinelinux.org/alpine/v3.14/releases/x86_64/alpine-virt-3.14.0-x86_64.iso" - boottype: "uefi" - imagetype: "linux" - hotresize: False - image_username: "test" - image_password: "p@ssw0rd" - usernameDL: "testDL" - passwordDL: "p@ssw0rdDL" - architecture: "X86_64" - drivers: "KVM_X86" - delegate_to: localhost - register: osimage -``` - -Пример получения образа операционной системы по имени образа. - -``` - - name: get_osimage - decort_osimage: - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: "alpine_linux_3.14.0" - account_Id: 12345 - delegate_to: localhost - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой образ операционной системы, он привяжет к себе указанный в примере образ операционной системы. - -``` - - name: create_virtual_osimage - decort_osimage: - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: "alpine_linux_3.14.0" - virt_name: "alpine_last" - delegate_to: localhost - register: osimage -``` -Обратите внимание, что в данным примере можно использовать как image_name, так и image_id. Также можно использовать либо virt_name, либо virt_id. - -Пример переименования образа. - -``` - - name: rename_osimage - decort_osimage: - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: "alpine_linux_3.14.0v2.0" - image_id: 54321 - delegate_to: localhost - register: osimage -``` - diff --git a/wiki/5.2.6/модуль-decort_pfw.md b/wiki/5.2.6/модуль-decort_pfw.md deleted file mode 100644 index 18eca68..0000000 --- a/wiki/5.2.6/модуль-decort_pfw.md +++ /dev/null @@ -1,73 +0,0 @@ -# 03.04 Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль decort_pfw предназначен для управления правилами трансляции сетевых портов для указанного экземпляра Compute (например, для виртуального сервера, созданного с помощью decort_kvmvm). - -##Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_pfw. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -|app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|compute_id | (int) | Идентификатор экземпляра Compute (напр., виртуального сервера), для которого требуется настроит правила.| -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным.| -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме authenticator: jwt Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|rules | (list of dicts) | Список словарей, задающих правила трансляции сетевых портов. Правила могут задавать как трансляцию "один к одному", так и "диапазон в диапазон". Структура словаря: (int) public_port_start - номер внешнего порта (на публичном интерфейсе ViNS, заданного параметром vins_id) для начала диапазона. (int) public_port_end - номер внешнего порта для конца диапазона. Если требуется правило "один к одному", то public_port_end можно не указывать или указать равным public_port_start. (int) local_port - номер порта на интерфейсе экземпляра Compute, заданного параметром compute_id. Если задаётся правило "диапазон в диапазон", то local_port становится началом диапазона для трансляции. В случае правила "один к одному" public_port_start просто транслируется в local_port (string) proto - протокол, tcp или udp.| -| state | Значения:
`present` <- default
`absent`
`check`
| Целевое состояние правил.
Если `state=absent`, то будут удалены все правила для указанного `compute_id` независимо от содержания параметра `rules`. В противном случае набор правил на выходе из модуля будет соответствовать тому, который содержится в параметре `rules`.
Если задан `state=check`, то модуль запускается в режиме read-only и возвращает текущие настройки правил трансляции сетевых портов для указанных `compute_id` и `vins_id`. | -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -|vins_id | (int) | Идентификатор виртуального сетевого сегмента (Virtual Network Segment, ViNS), в рамках которого настраиваются правила трансляции сетевых портов. Экземпляр Compute, заданный в параметре `compute_id`, должен быть уже подключён к данному ViNS.| -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована. | -|workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля не реализована.| - -## Возвращаемые значения модуля decort_pfw - -Модуль decort_pfw возвращает информацию о правилах трансляции сетевых портов и сопутсвтующую информацию в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|compute_id | int | Идентификатор compute, для которого настроены перечисленные правила трансляции.| -|public_ip | string |IP адрес на внешнем сетевом интерфейсе ViNS. Перечисленные ниже правила трансляции настраиваются на этом интерфейсе.| -|rules | list of dict | Список словарей, описывающих правила трансляции сетевых портов. Структура словаря: (int) id - идентификатор правила. (int) publicPortStart - номер внешнего порта (на публичном интерфейсе ViNS, см. public_ip) для начала диапазона. (int) publicPortEnd - номер внешнего порта для конца диапазона. Если требуется правило "один к одному", то publicPortEnd можно не указывать или указать равным publicPortStart. (int) localPort - номер порта на интерфейсе экземпляра Compute, заданного параметром compute_id. Если задаётся правило "диапазон в диапазон", то localPort указывает начало диапазона для трансляции. В случае правила "один к одному" publicPortStart просто транслируется в localPort. (string) protocol - протокол, tcp или udp.| -|state | string | Статус правил. Для корректно отработавшего модуля это поле должно иметь значение "PRESENT".| -|vins_id | int | Идентификатор виртуального сетевого сегмента (ViNS), в котором настроены перечисленные выше правила трансляции.| - -## Пример использования модуля decort_pfw - -В данном примере для ранее созданного экземпляра KVM VM compute (идентифицируется по compute_id), подключённого к указанному виртуальному сетевому сегменту (идентифицируется по vins_id) настраиваются два правила трансляции сетевых портов: - -- Правило "один к одному": внешний порт 30022 -> внутренний порт 22, протокол tcp. -- Правило "диапазон в диапазон": внешние порты с 30080 по 30085 включительно -> внутренние порты начиная с 30080, протокол tcp. - -``` -- name: manage port forwarding rules - decort_pfw: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - compute_id: "{{ my_kvmvm.facts.id }}" - vins_id: "{{ my_vins01.facts.id }}" - rules: - - public_port_start: 30022 - local_port: 22 - proto: tcp - - public_port_start: 30080 - public_port_end: 30085 - local_port: 30080 - proto: tcp - state: present - register: my_pfw - delegate_to: localhost -``` - -В данном примере результат выполнения модуля decort_pfw записывается в переменную my_pfw. Для доступа к списку правил используйте следующую конструкцию: - -`"{{ my_pfw.facts.rules }}"` diff --git a/wiki/5.2.6/модуль-decort_rg.md b/wiki/5.2.6/модуль-decort_rg.md deleted file mode 100644 index 427d475..0000000 --- a/wiki/5.2.6/модуль-decort_rg.md +++ /dev/null @@ -1,223 +0,0 @@ -# 03.05 Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- Создавать\\удалять ресурсные группы. -- Запрашивать информацию об уже существующих ресурсных группах. -- Редактировать ресурсные группы. -- Настраивать квоты в ресурсных группах. -- Восстанавливать ресурсные группы. -- Задавать стандартную сеть ресурсной группы. -- Настраивать доступ к ресурсным группам. - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор учётной записи (account), в рамках которой создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя учётной записи (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя учётной записи (account), в рамках которой создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать,забрать, изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный аргумент является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным. | -| def_netType | (string)
Значения:
`PRIVATE` <- default
`PUBLIC`
`NONE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также, чтобы изменить ресурсную группу по умолчанию. Не обязателен. | -| def_netId | (int) | Уникальный целочисленный идентификатор сети (ViNS), используется для изменения сети по умолчанию в ресурсной группе. | -| extNetIp | (string) | IP-адрес внешней сети, к которой ресурсная группа будет подключена при создании. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| ipcidr | (string) | IP-адрес приватной сети. Используется при создании ресурсной группы, чтобы задать ip адрес ViNS, который создастся вместе с ресурсной группой. Задаётся при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения _DECORT_JWT_. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rename | (string) | Новое имя ресурсной группы. Используется при переименовании ресурсной группы. | -| quotas | (dict) | Зарезервировано для будущих расширений, предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| resType | (list) | Типы ресурсов, которые можно создать в ресурсной группе. | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. | -| state | Значения:
`present` <- default
`absent`
`enabled`
`disabled` | Целевое состояние ресурсной группы. | -| permanently | (bool)
`False` <- default
`True` | Параметр, использующийся при удалении ресурсной группы, при значении True - ресурсная группа удалится навсегда, а при False - попадёт в корзину. | -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль будет оперативно передавать информацию о своем статусе и текущей фазе исполнения.
Данный параметр является опциональным.
Функциональность callbacks в текущей версии модуля не реализована. | -| workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL.
Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов `workflow_callback` данные со своим внутренним состоянием и отслеживать инициированные им задачи.
Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`.
Функциональность callbacks в текущей версии модуля не реализована. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о XXX в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор учётной записи (account), которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках учётной записи, которой принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. Корректные состояния: CREATED, DISABLED, DELETED, DESTROYED | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. Корректные типы сети по умолчанию: NONE, PRIVATE, PUBLIC. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в учётной записи MyAccount, также ограничить в ней доступ к ресурсам, задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - resType: - - vins - - compute - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как ограничить типы создаваемых ресурсов в ресурсной группе MyRG в учётной записи MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - resType: - - vins - - compute - - k8s - - openshift - - lb - - flipgroup - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` \ No newline at end of file diff --git a/wiki/5.2.6/модуль-decort_vins.md b/wiki/5.2.6/модуль-decort_vins.md deleted file mode 100644 index c2a2bd2..0000000 --- a/wiki/5.2.6/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# 03.06 Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для создания, изменения, получения текущих характеристик и удаления виртуального сетевого сегмента (Virtual Network Segment, ViNS). -Позволяет: -- Создавать, удалять виртуальные сетевые сегменты. -- Изменять виртуальные сетевые сегменты. -- Запрашивать информацию о виртуальных сетевых сегментах. -- Восстанавливать удалённые виртуальные сетевые сегменты. -- Соединять виртуальные сетевые сегменты. - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -|account_id | (int) | Уникальный целочисленный идентификатор учётной записи (account), которой принадлежит данный ViNS. При идентификации виртуального сетевого сегмента по имени (см. параметр `vins_name`) должно быть задан либо идентификатор, либо имя учётной записи (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя учётной записи (account), которой принадлежит данный ViNS. При идентификации виртуального сетевого сегмента по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание виртуального сетевого сегмента. Данный аргумент является опциональным и учитывается только при создании ViNS, а при всех прочих операциях игнорируется.| -|app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`legacy`
`oauth2`
`jwt` <- default | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный виртуальный сервер. Данный параметр является обязательным. ext_net_id (int) Данный аргумент контролирует подключение виртуального сетевого сегмента во внешнюю сеть: * -1 (default) - ViNS не подключён ко внешней сети; * 0 - ViNS подключён ко внешней сети, которую платформа выбирает по умолчанию; * >0 - ViNS подключён ко внешней сети с заданным идентификатором;| -|ext_ip_addr | (string) | Данный аргумент позволяет выбрать IP адрес для подключения виртуального сетевого сегмента ко внешней сети (когда значение аргумента ext_net_id больше либо равно 0) и учитывается только при новых подключених - в рамках модуля `decort_vins` вы не можете изменить внешний IP адрес не меняя идентификатор внешней сети. Параметр является опциональным: если он не задан, то в случае ViNS, подключённого во внешнюю сеть, платформа назначит IP адрес автоматически.| При ручном задании данного параметра следует иметь ввиду, что если будет задан неверный или уже занятый IP адрес, то модуль вернёт ошибку. -|ipcidr | string | Адрес, которые надлежит присвоить внутренней сети сетевого сегмента. Данный аргумент является опциональным и используется только при создании нового виртуального сетевого сегмента, а при всех прочих операциях игнорируется. Если этот аргумент не задан, то платформа назначит адрес автоматически. Обратите внимание, что виртуальные сетевые сегменты, принадлежащие одной и той же учётной записи, не могут иметь пересекающихся диапазонов внутренних адресов.| -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения _DECORT_OAUTH2_URL_. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должен быть создан или уже существует ViNS. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -|rg_name | (string) | Имя ресурсной группы, в которой должен быть создан или уже существует ViNS. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | Значения:
`present` <- default
`absent`
`enabled`
`disabled`
| Целевое состояние ViNS. | -| verify_ssl | (bool)
`True` <- default
`False` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -|vins_id | (int) | Идентификатор виртуального сетевого сегмента. Соответствующий сетевой сегмент должен существовать (таким образом, с помощью `vins_id` нельзя создать новый сегмент, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -|vins_name| (string) | Имя виртуального сетевого сегмента. Для идентификации виртуального сетевого сегмента требуется либо vins_name и информация об учётной записи/ресурсной группе, которой принадлежит сегмент, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или учетной записи, на уровне которой существует данный сетевой сегмент.| -| ext_net_id | (int) | Уникальный целочисленный идентификатор внешней сети. | -| mgmtaddr | (str) | Адрес менеджмента интерфейса. В данный параметр указывается ip адрес менеджмента интерфейса, который предоставляет доступ по SSH. | -| custom_config | (bool) | Параметр, отвечающий за использование пользовательской конфигурации. По умолчанию: `False` | -| config_save | (bool) | Параметр, отвечающий за сохранение файла конфигурации. По умолчанию: `False` | -| connect_to | (list) | Список, в котором необходимо указывать виртуальные сетевые сегменты, которые Вы хотите соединить. См. примеры. -|workflow_callback | (string) | URL, по которому вышестоящее приложение (например, пользовательский портал или оркестратор верхнего уровня, инициирующий запуск Ansible playbook) ожидает API вызова, в параметрах которого модуль desc_vm будет оперативно передавать информацию о своем статусе и текущей фазе исполнения. Данный параметр является опциональным. Функциональность callbacks в текущей версии модуля не реализована.| -|workflow_context | (string) | Контекстная информация, которая будет содержаться в параметрах API вызова, адресованного к `workflow_callback` URL. Данная информация призвана однозначно идентифицировать задачу, выполняемую модулем в настоящий момент, чтобы оркестратор верхнего уровня мог сопоставить получаемые через вызов workflow_callback данные со своим внутренним состоянием и отслеживать инициированные им задачи. Параметр является опциональным и имеет значение только при условии, что также задан `workflow_callback`. Функциональность callbacks в текущей версии модуля не реализована.| - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о виртуальном сетевом сегменте (Virtual Network Segment, ViNS) в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | int | Уникальный целочисленный идентификатор учётной записи (_account_), которой принадлежит ViNS. | -| ext_ip_addr | (string) | IP адрес интерфейса, которым ViNS подключён во внешнюю сеть. Если ViNS не подключён к внешней сети, то пустая строка. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключён ViNS. -1 означает, что ViNS в данный момент не подключён к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данного ViNS. | -| id | (int) | Уникальный целочисленный идентификатор ViNS. | -| name | (string) | Имя ViNS. Обратите внимание, что это имя уникально только в рамках учётной записи или ресурсной группы, на уровне которых создан ViNS. | -| int_net_addr | (string) | Адрес внутренней сети ViNS. Обратите внимание, что адреса внутренних сетей всех ViNS, принадлежащих одной и той же учётной записи (независимо от того, создан ли ViNS на уровне учётной записи или ресурсной группы), не пересекаются. | -| rg_id | (int) | Уникальный целочисленный идентификатор учётной ресурсной группы, которой принадлежит данный ViNS. Если данный ViNS создан на уровне учётной записи, то `rg_id=0`. | -| state | (string) | Текущее состояние ViNS.
Корректные состояния: `CREATED`, `ENABLED`, `DISABLED`, `DELETED`, `DESTROYED`. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся виртуальный сетевой сегмент с именем "MyVins01" (vins_name: "MyVins01"). - -Сетевой сегмент создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей учётной записи "MyMainAccount" (account_name: "MyMainAccount"). Виртуальный сетевой сегмент будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS at resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - vins_name: "vins_created_by_decort_VINS_module" - state: present - rg_id: 198 - ext_net_id: -1 - ipcidr: "10.20.30.0/24" - mgmtaddr: "10.20.30.1" - custom_config: false - config_save: false - verify_ssl: false - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор ViNS для подключения к нему виртуального сервера. -``` -- name: manage virtual server - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание виртуального сетевого сегмента, а потом его привязка к виртуальным сетевым сегментам с id 864 и 196. -``` - - name: Manage ViNS at resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "vins_connected_by_decort_vins_module" - state: present - rg_id: 98 - connect_to: - - type: VINS - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - type: VINS - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/5.2.6/полезные-советы.md b/wiki/5.2.6/полезные-советы.md deleted file mode 100644 index 62efe8f..0000000 --- a/wiki/5.2.6/полезные-советы.md +++ /dev/null @@ -1,16 +0,0 @@ -## 4.1 Как хранить авторизационную информацию отдельно от плейбука. - -В зависимости от метода авторизации нужная информация может передаваться в аргументах app_id & app_secret (пара аргументов), jwt (единичный аргумент) или user & password (пара аргументов). Однако, помещать данную информацию непосредственно в плейбук или роль может быть небезопасным, так как она позволяет любому, кто получил этот файл, осуществить доступ к контроллеру облачной инфраструктуры от лица данного пользователя. - -Если вышеперечисленные параметры не указаны в плейбуке или роли, то Ansible модуль DECORT попытается использовать значения, заданные в соответствующих переменных окружения: - - -| Аргумент | Переменная окружения| -| ------ | ------ | -| app_id | DECORT_APP_ID | -| app_secret | DECORT_APP_SECRET | -| jwt | DECORT_JWT | -| user | DECORT_USER | -| password | DECORT_PASSWORD | - -Поэтому для использования плейбука, не содержащего секретной информации, рекомендуется вместо внесения значений непосредственно в файл перед запуском провайдера установить нужные переменные окружения. \ No newline at end of file diff --git a/wiki/5.3.0/Home.md b/wiki/5.3.0/Home.md deleted file mode 100644 index c7f062d..0000000 --- a/wiki/5.3.0/Home.md +++ /dev/null @@ -1,16 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки diff --git a/wiki/5.3.0/введение.md b/wiki/5.3.0/введение.md deleted file mode 100644 index bcc3cae..0000000 --- a/wiki/5.3.0/введение.md +++ /dev/null @@ -1,27 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.16.5 or higher -- Python 3.10.12 or higher -- PyJWT 1.7.1 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 4.0.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` diff --git a/wiki/5.3.0/модуль-decort_bservice.md b/wiki/5.3.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/5.3.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_disk.md b/wiki/5.3.0/модуль-decort_disk.md deleted file mode 100644 index 4cf625e..0000000 --- a/wiki/5.3.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| attached_to | int | Идентификатор виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то `attached_to: 0`| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - annotation: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_group.md b/wiki/5.3.0/модуль-decort_group.md deleted file mode 100644 index 46f651f..0000000 --- a/wiki/5.3.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. Обязательный параметр. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы. Обязательный параметр. -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_jwt.md b/wiki/5.3.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/5.3.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_k8s.md b/wiki/5.3.0/модуль-decort_k8s.md deleted file mode 100644 index 0decbad..0000000 --- a/wiki/5.3.0/модуль-decort_k8s.md +++ /dev/null @@ -1,108 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. Обязательный параметр. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Автоматический запуск кластера после его создания. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Обязательный параметр. Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init
• `cpu` (int) (обязательный) - количество виртуальных процессоров на узле
• `disk` (int) (обязательный) - объём загрузочного диска на узле
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (обязательный) - количество узлов
• `pool` (str) (обязательный) - пул СХД, заданной ключом `sep_id`
• `ram` (int) (обязательный) - объём оперативной памяти на узле
• `sep_id` (int) (обязательный) - идентификатор СХД; если задать `null`, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule` | - - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - pool: null - ram: 1024 - sep_id: null - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - pool: null - ram: 1024 - sep_id: null - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_kvmvm.md b/wiki/5.3.0/модуль-decort_kvmvm.md deleted file mode 100644 index a6008f8..0000000 --- a/wiki/5.3.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,106 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| affinity_label | (str) | Метка affinity. -| annotation | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| arch | (str)
Значения:
`X86_64`
`PPC64_LE`
Default: `X86_64` | Архитектура виртуальной машины. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.| -| networks | (list) | Список словарей, описывающих сети для подключения к ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| cpu | int | Количество виртуальных процессоров. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| name | string | Имя ВМ. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - register: my_vm -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_lb.md b/wiki/5.3.0/модуль-decort_lb.md deleted file mode 100644 index 543a8ac..0000000 --- a/wiki/5.3.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- annotation - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. Обязательный параметр. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/5.3.0/модуль-decort_osimage.md b/wiki/5.3.0/модуль-decort_osimage.md deleted file mode 100644 index 139bc69..0000000 --- a/wiki/5.3.0/модуль-decort_osimage.md +++ /dev/null @@ -1,132 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| architecture | (string)
Default: `X86_64` | Архитектура микропроцессора, для которой предназначен образ. Используется при создании образа.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/5.3.0/модуль-decort_pfw.md b/wiki/5.3.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/5.3.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/5.3.0/модуль-decort_rg.md b/wiki/5.3.0/модуль-decort_rg.md deleted file mode 100644 index 24dd2b2..0000000 --- a/wiki/5.3.0/модуль-decort_rg.md +++ /dev/null @@ -1,200 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети. Используется при создании РГ для подключения внешней сети к внутренней сети, которая будет создана и задана как сеть по умолчанию для РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rename | (string) | Новое имя ресурсной группы. Используется при переименовании ресурсной группы. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` \ No newline at end of file diff --git a/wiki/5.3.0/модуль-decort_vins.md b/wiki/5.3.0/модуль-decort_vins.md deleted file mode 100644 index 43b95ce..0000000 --- a/wiki/5.3.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/5.4.0/Home.md b/wiki/5.4.0/Home.md deleted file mode 100644 index 9154892..0000000 --- a/wiki/5.4.0/Home.md +++ /dev/null @@ -1,21 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью app_id и app_secret](./введение.md#пример-авторизации-с-помощью-app_id-и-app_secret) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте \ No newline at end of file diff --git a/wiki/5.4.0/введение.md b/wiki/5.4.0/введение.md deleted file mode 100644 index d7b4129..0000000 --- a/wiki/5.4.0/введение.md +++ /dev/null @@ -1,182 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.16.5 or higher -- Python 3.10.12 or higher -- PyJWT 1.7.1 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 4.0.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью app_id и app_secret - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with app_id and app_secret - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: oauth2 - controller_url: "{{ controller_url }}" - oauth2_url: "{{ oauth2_url }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_account_info.md b/wiki/5.4.0/модуль-decort_account_info.md deleted file mode 100644 index 74f2c98..0000000 --- a/wiki/5.4.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3840 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор аккаунта. Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		- Включение в вывод удалённых объектов. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру id. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (int) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- explicit - - bool - - Видимость аккаунта. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время отключения. -
- deactivationTime_readable - - str - - Дата и время отключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С включение в вывод удаленных -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - deleted: true -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/5.4.0/модуль-decort_bservice.md b/wiki/5.4.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/5.4.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_disk.md b/wiki/5.4.0/модуль-decort_disk.md deleted file mode 100644 index 4cf625e..0000000 --- a/wiki/5.4.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| attached_to | int | Идентификатор виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то `attached_to: 0`| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - annotation: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_group.md b/wiki/5.4.0/модуль-decort_group.md deleted file mode 100644 index 46f651f..0000000 --- a/wiki/5.4.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. Обязательный параметр. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы. Обязательный параметр. -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_jwt.md b/wiki/5.4.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/5.4.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_k8s.md b/wiki/5.4.0/модуль-decort_k8s.md deleted file mode 100644 index 0decbad..0000000 --- a/wiki/5.4.0/модуль-decort_k8s.md +++ /dev/null @@ -1,108 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. Обязательный параметр. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Автоматический запуск кластера после его создания. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Обязательный параметр. Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init
• `cpu` (int) (обязательный) - количество виртуальных процессоров на узле
• `disk` (int) (обязательный) - объём загрузочного диска на узле
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (обязательный) - количество узлов
• `pool` (str) (обязательный) - пул СХД, заданной ключом `sep_id`
• `ram` (int) (обязательный) - объём оперативной памяти на узле
• `sep_id` (int) (обязательный) - идентификатор СХД; если задать `null`, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule` | - - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - pool: null - ram: 1024 - sep_id: null - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - pool: null - ram: 1024 - sep_id: null - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_kvmvm.md b/wiki/5.4.0/модуль-decort_kvmvm.md deleted file mode 100644 index a6008f8..0000000 --- a/wiki/5.4.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,106 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| affinity_label | (str) | Метка affinity. -| annotation | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| arch | (str)
Значения:
`X86_64`
`PPC64_LE`
Default: `X86_64` | Архитектура виртуальной машины. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.| -| networks | (list) | Список словарей, описывающих сети для подключения к ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| cpu | int | Количество виртуальных процессоров. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| name | string | Имя ВМ. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - register: my_vm -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_lb.md b/wiki/5.4.0/модуль-decort_lb.md deleted file mode 100644 index 543a8ac..0000000 --- a/wiki/5.4.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- annotation - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. Обязательный параметр. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/5.4.0/модуль-decort_osimage.md b/wiki/5.4.0/модуль-decort_osimage.md deleted file mode 100644 index 139bc69..0000000 --- a/wiki/5.4.0/модуль-decort_osimage.md +++ /dev/null @@ -1,132 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| architecture | (string)
Default: `X86_64` | Архитектура микропроцессора, для которой предназначен образ. Используется при создании образа.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/5.4.0/модуль-decort_pfw.md b/wiki/5.4.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/5.4.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/5.4.0/модуль-decort_rg.md b/wiki/5.4.0/модуль-decort_rg.md deleted file mode 100644 index 24dd2b2..0000000 --- a/wiki/5.4.0/модуль-decort_rg.md +++ /dev/null @@ -1,200 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети. Используется при создании РГ для подключения внешней сети к внутренней сети, которая будет создана и задана как сеть по умолчанию для РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rename | (string) | Новое имя ресурсной группы. Используется при переименовании ресурсной группы. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` \ No newline at end of file diff --git a/wiki/5.4.0/модуль-decort_vins.md b/wiki/5.4.0/модуль-decort_vins.md deleted file mode 100644 index 43b95ce..0000000 --- a/wiki/5.4.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/5.5.0/Home.md b/wiki/5.5.0/Home.md deleted file mode 100644 index 90df282..0000000 --- a/wiki/5.5.0/Home.md +++ /dev/null @@ -1,22 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью app_id и app_secret](./введение.md#пример-авторизации-с-помощью-app_id-и-app_secret) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами \ No newline at end of file diff --git a/wiki/5.5.0/введение.md b/wiki/5.5.0/введение.md deleted file mode 100644 index d7b4129..0000000 --- a/wiki/5.5.0/введение.md +++ /dev/null @@ -1,182 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.16.5 or higher -- Python 3.10.12 or higher -- PyJWT 1.7.1 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 4.0.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью app_id и app_secret - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with app_id and app_secret - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: oauth2 - controller_url: "{{ controller_url }}" - oauth2_url: "{{ oauth2_url }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_account.md b/wiki/5.5.0/модуль-decort_account.md deleted file mode 100644 index f320029..0000000 --- a/wiki/5.5.0/модуль-decort_account.md +++ /dev/null @@ -1,951 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- explicit - - bool - - Видимость аккаунта. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` diff --git a/wiki/5.5.0/модуль-decort_account_info.md b/wiki/5.5.0/модуль-decort_account_info.md deleted file mode 100644 index 777ef36..0000000 --- a/wiki/5.5.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3843 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		- Включение в вывод удалённых объектов. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (int) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- explicit - - bool - - Видимость аккаунта. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С включение в вывод удаленных -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - deleted: true -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/5.5.0/модуль-decort_bservice.md b/wiki/5.5.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/5.5.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_disk.md b/wiki/5.5.0/модуль-decort_disk.md deleted file mode 100644 index 4cf625e..0000000 --- a/wiki/5.5.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| attached_to | int | Идентификатор виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то `attached_to: 0`| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - annotation: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_group.md b/wiki/5.5.0/модуль-decort_group.md deleted file mode 100644 index 46f651f..0000000 --- a/wiki/5.5.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. Обязательный параметр. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы. Обязательный параметр. -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_jwt.md b/wiki/5.5.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/5.5.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_k8s.md b/wiki/5.5.0/модуль-decort_k8s.md deleted file mode 100644 index 0decbad..0000000 --- a/wiki/5.5.0/модуль-decort_k8s.md +++ /dev/null @@ -1,108 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. Обязательный параметр. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Автоматический запуск кластера после его создания. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Обязательный параметр. Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init
• `cpu` (int) (обязательный) - количество виртуальных процессоров на узле
• `disk` (int) (обязательный) - объём загрузочного диска на узле
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (обязательный) - количество узлов
• `pool` (str) (обязательный) - пул СХД, заданной ключом `sep_id`
• `ram` (int) (обязательный) - объём оперативной памяти на узле
• `sep_id` (int) (обязательный) - идентификатор СХД; если задать `null`, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule` | - - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - pool: null - ram: 1024 - sep_id: null - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - pool: null - ram: 1024 - sep_id: null - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_kvmvm.md b/wiki/5.5.0/модуль-decort_kvmvm.md deleted file mode 100644 index a6008f8..0000000 --- a/wiki/5.5.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,106 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| affinity_label | (str) | Метка affinity. -| annotation | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| arch | (str)
Значения:
`X86_64`
`PPC64_LE`
Default: `X86_64` | Архитектура виртуальной машины. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.| -| networks | (list) | Список словарей, описывающих сети для подключения к ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| cpu | int | Количество виртуальных процессоров. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| name | string | Имя ВМ. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - register: my_vm -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_lb.md b/wiki/5.5.0/модуль-decort_lb.md deleted file mode 100644 index 543a8ac..0000000 --- a/wiki/5.5.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- annotation - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. Обязательный параметр. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/5.5.0/модуль-decort_osimage.md b/wiki/5.5.0/модуль-decort_osimage.md deleted file mode 100644 index 139bc69..0000000 --- a/wiki/5.5.0/модуль-decort_osimage.md +++ /dev/null @@ -1,132 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| architecture | (string)
Default: `X86_64` | Архитектура микропроцессора, для которой предназначен образ. Используется при создании образа.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/5.5.0/модуль-decort_pfw.md b/wiki/5.5.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/5.5.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/5.5.0/модуль-decort_rg.md b/wiki/5.5.0/модуль-decort_rg.md deleted file mode 100644 index 24dd2b2..0000000 --- a/wiki/5.5.0/модуль-decort_rg.md +++ /dev/null @@ -1,200 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети. Используется при создании РГ для подключения внешней сети к внутренней сети, которая будет создана и задана как сеть по умолчанию для РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rename | (string) | Новое имя ресурсной группы. Используется при переименовании ресурсной группы. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` \ No newline at end of file diff --git a/wiki/5.5.0/модуль-decort_vins.md b/wiki/5.5.0/модуль-decort_vins.md deleted file mode 100644 index 43b95ce..0000000 --- a/wiki/5.5.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/5.6.0/Home.md b/wiki/5.6.0/Home.md deleted file mode 100644 index 2835851..0000000 --- a/wiki/5.6.0/Home.md +++ /dev/null @@ -1,23 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью app_id и app_secret](./введение.md#пример-авторизации-с-помощью-app_id-и-app_secret) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе \ No newline at end of file diff --git a/wiki/5.6.0/введение.md b/wiki/5.6.0/введение.md deleted file mode 100644 index d7b4129..0000000 --- a/wiki/5.6.0/введение.md +++ /dev/null @@ -1,182 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.16.5 or higher -- Python 3.10.12 or higher -- PyJWT 1.7.1 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 4.0.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью app_id и app_secret - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with app_id and app_secret - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: oauth2 - controller_url: "{{ controller_url }}" - oauth2_url: "{{ oauth2_url }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_account.md b/wiki/5.6.0/модуль-decort_account.md deleted file mode 100644 index 11a3656..0000000 --- a/wiki/5.6.0/модуль-decort_account.md +++ /dev/null @@ -1,939 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` diff --git a/wiki/5.6.0/модуль-decort_account_info.md b/wiki/5.6.0/модуль-decort_account_info.md deleted file mode 100644 index 80d775b..0000000 --- a/wiki/5.6.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3831 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		- Включение в вывод удалённых объектов. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (int) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С включение в вывод удаленных -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - deleted: true -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/5.6.0/модуль-decort_bservice.md b/wiki/5.6.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/5.6.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_disk.md b/wiki/5.6.0/модуль-decort_disk.md deleted file mode 100644 index 4cf625e..0000000 --- a/wiki/5.6.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| attached_to | int | Идентификатор виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то `attached_to: 0`| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - annotation: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_group.md b/wiki/5.6.0/модуль-decort_group.md deleted file mode 100644 index 46f651f..0000000 --- a/wiki/5.6.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. Обязательный параметр. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы. Обязательный параметр. -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_jwt.md b/wiki/5.6.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/5.6.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_k8s.md b/wiki/5.6.0/модуль-decort_k8s.md deleted file mode 100644 index 0decbad..0000000 --- a/wiki/5.6.0/модуль-decort_k8s.md +++ /dev/null @@ -1,108 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. Обязательный параметр. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Автоматический запуск кластера после его создания. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Обязательный параметр. Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init
• `cpu` (int) (обязательный) - количество виртуальных процессоров на узле
• `disk` (int) (обязательный) - объём загрузочного диска на узле
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (обязательный) - количество узлов
• `pool` (str) (обязательный) - пул СХД, заданной ключом `sep_id`
• `ram` (int) (обязательный) - объём оперативной памяти на узле
• `sep_id` (int) (обязательный) - идентификатор СХД; если задать `null`, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule` | - - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - pool: null - ram: 1024 - sep_id: null - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - pool: null - ram: 1024 - sep_id: null - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_kvmvm.md b/wiki/5.6.0/модуль-decort_kvmvm.md deleted file mode 100644 index a6008f8..0000000 --- a/wiki/5.6.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,106 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`) -| affinity_label | (str) | Метка affinity. -| annotation | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| arch | (str)
Значения:
`X86_64`
`PPC64_LE`
Default: `X86_64` | Архитектура виртуальной машины. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.| -| networks | (list) | Список словарей, описывающих сети для подключения к ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| cpu | int | Количество виртуальных процессоров. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| name | string | Имя ВМ. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - register: my_vm -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_lb.md b/wiki/5.6.0/модуль-decort_lb.md deleted file mode 100644 index 543a8ac..0000000 --- a/wiki/5.6.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- annotation - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. Обязательный параметр. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/5.6.0/модуль-decort_osimage.md b/wiki/5.6.0/модуль-decort_osimage.md deleted file mode 100644 index 139bc69..0000000 --- a/wiki/5.6.0/модуль-decort_osimage.md +++ /dev/null @@ -1,132 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| architecture | (string)
Default: `X86_64` | Архитектура микропроцессора, для которой предназначен образ. Используется при создании образа.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/5.6.0/модуль-decort_pfw.md b/wiki/5.6.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/5.6.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/5.6.0/модуль-decort_rg.md b/wiki/5.6.0/модуль-decort_rg.md deleted file mode 100644 index 24dd2b2..0000000 --- a/wiki/5.6.0/модуль-decort_rg.md +++ /dev/null @@ -1,200 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети. Используется при создании РГ для подключения внешней сети к внутренней сети, которая будет создана и задана как сеть по умолчанию для РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rename | (string) | Новое имя ресурсной группы. Используется при переименовании ресурсной группы. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` \ No newline at end of file diff --git a/wiki/5.6.0/модуль-decort_user_info.md b/wiki/5.6.0/модуль-decort_user_info.md deleted file mode 100644 index c77a968..0000000 --- a/wiki/5.6.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1297 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (int) - - По коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/5.6.0/модуль-decort_vins.md b/wiki/5.6.0/модуль-decort_vins.md deleted file mode 100644 index 43b95ce..0000000 --- a/wiki/5.6.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/6.0.0/Home.md b/wiki/6.0.0/Home.md deleted file mode 100644 index 2835851..0000000 --- a/wiki/6.0.0/Home.md +++ /dev/null @@ -1,23 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью app_id и app_secret](./введение.md#пример-авторизации-с-помощью-app_id-и-app_secret) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе \ No newline at end of file diff --git a/wiki/6.0.0/введение.md b/wiki/6.0.0/введение.md deleted file mode 100644 index 9626538..0000000 --- a/wiki/6.0.0/введение.md +++ /dev/null @@ -1,181 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 10.5.0 -- Python 3.10.12 -- PyJWT 2.9.0 Python module -- requests 2.32.3 Python module -- DynamiX Enterprise 4.1.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью app_id и app_secret - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with app_id and app_secret - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: oauth2 - controller_url: "{{ controller_url }}" - oauth2_url: "{{ oauth2_url }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_account.md b/wiki/6.0.0/модуль-decort_account.md deleted file mode 100644 index 528e5ce..0000000 --- a/wiki/6.0.0/модуль-decort_account.md +++ /dev/null @@ -1,992 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` diff --git a/wiki/6.0.0/модуль-decort_account_info.md b/wiki/6.0.0/модуль-decort_account_info.md deleted file mode 100644 index ff5563d..0000000 --- a/wiki/6.0.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3805 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/6.0.0/модуль-decort_bservice.md b/wiki/6.0.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/6.0.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_disk.md b/wiki/6.0.0/модуль-decort_disk.md deleted file mode 100644 index 2c460ca..0000000 --- a/wiki/6.0.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| annotation | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - annotation: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_group.md b/wiki/6.0.0/модуль-decort_group.md deleted file mode 100644 index d010816..0000000 --- a/wiki/6.0.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации группы по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации группы по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о группе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_jwt.md b/wiki/6.0.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/6.0.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_k8s.md b/wiki/6.0.0/модуль-decort_k8s.md deleted file mode 100644 index c351148..0000000 --- a/wiki/6.0.0/модуль-decort_k8s.md +++ /dev/null @@ -1,108 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; обязателен при создании группы
• `disk` (int) (необязательный) - объём загрузочного диска на узле; обязателен при создании группы
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; обязателен при создании группы
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; обязателен при создании группы
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule` | - - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - pool: null - ram: 1024 - sep_id: null - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - pool: null - ram: 1024 - sep_id: null - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_kvmvm.md b/wiki/6.0.0/модуль-decort_kvmvm.md deleted file mode 100644 index 4360531..0000000 --- a/wiki/6.0.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,109 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| annotation | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ.
Если параметр не задан, размер будет равен размеру образа.
Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска. | -| chipset | (string)
Значения:
`q35`
`i440fx`
Default: `i440fx` | Эмулируемый чипсет. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.
Чтобы отключить все диски, нужно указать пустой список `[]`.| -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются.
Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`.
Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. | -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа.| -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| name | string | Имя ВМ. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - register: my_vm -``` \ No newline at end of file diff --git a/wiki/6.0.0/модуль-decort_lb.md b/wiki/6.0.0/модуль-decort_lb.md deleted file mode 100644 index 3678b85..0000000 --- a/wiki/6.0.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- annotation - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/6.0.0/модуль-decort_osimage.md b/wiki/6.0.0/модуль-decort_osimage.md deleted file mode 100644 index 0574bc9..0000000 --- a/wiki/6.0.0/модуль-decort_osimage.md +++ /dev/null @@ -1,131 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/6.0.0/модуль-decort_pfw.md b/wiki/6.0.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/6.0.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/6.0.0/модуль-decort_rg.md b/wiki/6.0.0/модуль-decort_rg.md deleted file mode 100644 index 0b48956..0000000 --- a/wiki/6.0.0/модуль-decort_rg.md +++ /dev/null @@ -1,229 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| annotation | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/6.0.0/модуль-decort_user_info.md b/wiki/6.0.0/модуль-decort_user_info.md deleted file mode 100644 index c463324..0000000 --- a/wiki/6.0.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1338 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/6.0.0/модуль-decort_vins.md b/wiki/6.0.0/модуль-decort_vins.md deleted file mode 100644 index 43b95ce..0000000 --- a/wiki/6.0.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|annotation | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/6.1.0/Home.md b/wiki/6.1.0/Home.md deleted file mode 100644 index 2835851..0000000 --- a/wiki/6.1.0/Home.md +++ /dev/null @@ -1,23 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью app_id и app_secret](./введение.md#пример-авторизации-с-помощью-app_id-и-app_secret) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе \ No newline at end of file diff --git a/wiki/6.1.0/введение.md b/wiki/6.1.0/введение.md deleted file mode 100644 index 62640fd..0000000 --- a/wiki/6.1.0/введение.md +++ /dev/null @@ -1,182 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 2.16.5 or higher -- Python 3.10.12 or higher -- PyJWT 1.7.1 Python module or higher -- requests Python module -- netaddr Python module -- DECORT cloud platform version 4.1.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью app_id и app_secret - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with app_id and app_secret - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: oauth2 - controller_url: "{{ controller_url }}" - oauth2_url: "{{ oauth2_url }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_account.md b/wiki/6.1.0/модуль-decort_account.md deleted file mode 100644 index 528e5ce..0000000 --- a/wiki/6.1.0/модуль-decort_account.md +++ /dev/null @@ -1,992 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` diff --git a/wiki/6.1.0/модуль-decort_account_info.md b/wiki/6.1.0/модуль-decort_account_info.md deleted file mode 100644 index ff5563d..0000000 --- a/wiki/6.1.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3805 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/6.1.0/модуль-decort_bservice.md b/wiki/6.1.0/модуль-decort_bservice.md deleted file mode 100644 index 2348c45..0000000 --- a/wiki/6.1.0/модуль-decort_bservice.md +++ /dev/null @@ -1,92 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_bservice. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на Вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_bservice` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная базовая служба. Данный параметр является обязательным.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_disk.md b/wiki/6.1.0/модуль-decort_disk.md deleted file mode 100644 index 6e7942c..0000000 --- a/wiki/6.1.0/модуль-decort_disk.md +++ /dev/null @@ -1,177 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_disk. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_disk` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| description | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -|app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -|controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данный диск. Данный параметр является обязательным.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -|jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -|oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | -| verify_ssl | (bool)
Default: `false` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_group.md b/wiki/6.1.0/модуль-decort_group.md deleted file mode 100644 index 354c21d..0000000 --- a/wiki/6.1.0/модуль-decort_group.md +++ /dev/null @@ -1,105 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен полный список параметров для модуля **decort_group**. - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt` Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_jwt.md b/wiki/6.1.0/модуль-decort_jwt.md deleted file mode 100644 index 4cd124b..0000000 --- a/wiki/6.1.0/модуль-decort_jwt.md +++ /dev/null @@ -1,53 +0,0 @@ -# Вспомогательный модуль для получения авторизационного JWT токена decort_jwt -## Обзор модуля decort_jwt - -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов, инициируемых в адрес контроллера облачной платформы. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). -## Параметры модуля decort_jwt - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_jwt**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_jwt` - - -|Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к авторизационному серверу. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к авторизационному серверу. Данный параметр является обязательным. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, у которого запрашивается JWT. Данный параметр является обязательным. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| validity | (int)
Default: `3600` | Срок действия JWT в секундах. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес авторизационного сервера, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_jwt - -При успешном выполнении модуль **decort_jwt** возвращает JWT-токен, который доступен по ключу `jwt` (str). - -## Пример использования модуля decort_jwt - -В данном примере сначала запрашивается JWT со сроком действия 1200 сек., а затем этот JWT используется для создания виртуальной машины в режиме авторизации `jwt` (подробнее о данном режиме см. в разделе «Примеры различных режимов авторизации»). -``` -- hosts: localhost - tasks: - - name: Obtain JWT with validity of 1200 sec from the OAuth2 provider - decort_jwt: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - validity: 1200 - register: my_token -``` -``` - - name: Create VM in JWT authorization mode - decort_kvmvm: - authenticator: jwt - jwt: "{{ my_token.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - name: NewVM01 - cpu: 2 - ram: 4096 - <<<дальнейшие детали опущены>>> -``` -Обратите внимание, как используется JWT при создании новой ВМ (в предположении, что результат выполнения task для модуля **decort_jwt** был сохранен в переменной my_token): -``` - jwt: "{{ my_token.jwt }}" -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_k8s.md b/wiki/6.1.0/модуль-decort_k8s.md deleted file mode 100644 index 9fc51ac..0000000 --- a/wiki/6.1.0/модуль-decort_k8s.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен полный список параметров для модуля **decort_k8s**: - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет master-узлов. Не применим при изменении существующего кластера.
Значение по умолчанию при создании: `i440fx`. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`
• `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`
• `disk` (int) (необязательный) - объём загрузочного диска на узле; если не задан при создании, размер диска будет равен размеру используемого образа
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`; значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; значение по умолчанию при создании: `1`
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; значение по умолчанию при создании: `1024`
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. | - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - ram: 1024 - chipset: i440fx - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - ram: 1024 - chipset: Q35 - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_kvmvm.md b/wiki/6.1.0/модуль-decort_kvmvm.md deleted file mode 100644 index 5da2f6c..0000000 --- a/wiki/6.1.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,136 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- создать - - с образом - - без образа - - с загрузочным диском - - без загрузочного диска -- получить информацию -- остановить/приостановить/запустить -- подключить/отключить диски с данными -- подключить/отключить сети -- изменить - - объём загрузочного диска в большую сторону - - количество CPU - - объём ОЗУ - - тэги - - affinity метку - - affinity правила - - anti-affinity правила - - описание - - чипсет - - правило NUMA Affinity - - использование CPU Pinning - - использование Huge Pages - - имя - - XML виртуальной машины -- удалить (безвозвратно) - -## Параметры модуля decort_kvmvm - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_kvmvm**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_kvmvm` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| description | (string) | Опциональное описание виртуальной машины. Этот параметр используется только при создании.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DCORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ.
Если параметр не задан, размер будет равен размеру образа.
Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет. | -| ci_user_data | (dict) | конфигурация для cloud-init -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) данная виртуальная машина. Данный параметр является обязательным. | -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| cpu_pin | (bool) | Запуск виртуальной машины на выделенных процессорах. Чтобы использовать эту функцию, система должна быть предварительно сконфигурирована путем выделения процессоров на физическом узле.
Значение по умолчанию при создании: `false`. | -| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.
Ключи словаря:
• `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`
• `fields` (dict) - поля для управления XML виртуальной машины. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.
Чтобы отключить все диски, нужно указать пустой список `[]`.| -| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле.
Значение по умолчанию при создании: `false`. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
Если заданы оба параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_JWT`. -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| numa_affinity | (str)
Значения:
`strict`
`loose`
`none` | Правило применения NUMA affinity к виртуальной машине.
`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity.
Значение по умолчанию при создании: `none`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль **decort_kvmvm** будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused`
`check`
Default: `present` | Целевое состояние ВМ.
Значение `halted` - синоним к `poweredoff`. Значения `present` и `poweredon` равнозначны.
Значение `check` вызывает модуль в _read-only_ режиме и считывает характеристики существующей ВМ. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| cpu_pin | bool | Запуск виртуальной машины на выделенных процессорах. | -| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| name | string | Имя ВМ. | -| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | - -## Пример использования модуля decort_kvmvm - -В данном примере создается ВМ с именем MyFirstVM. -``` -- name: Сreate VM - decort_kvmvm: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://cloud.digitalenergy.online" - cpu: 2 - image_id: "{{ my_img.facts.id }}" - name: MyFirstVM - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - oauth2_url: "https://sso.digitalenergy.online" - ram: 4096 - rg_id: "{{ my_rg.facts.id }}" - chipset: Q35 - custom_fields: - fields: - title: TestTitle - cpu: - mode: custom - cache: - mode: disable - register: my_vm -``` \ No newline at end of file diff --git a/wiki/6.1.0/модуль-decort_lb.md b/wiki/6.1.0/модуль-decort_lb.md deleted file mode 100644 index e0951c4..0000000 --- a/wiki/6.1.0/модуль-decort_lb.md +++ /dev/null @@ -1,893 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен полный список параметров для модуля **decort_lb**: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- description - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- app_id - - (str) - - Идентификатор приложения, использующийся для подключения к контроллеру - облачной платформы DECORT в режиме authenticator: oauth2. - Данный параметр является обязательным для указанного режима. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, который используется для подключения к - контроллеру облачной платформы DECORT в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно в - playbook. Если параметр не задан в playbook, то модуль будет - использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
oauth2 -
jwt - 		- Режим аутентификации при подключении к контроллеру облачной платформы - DECORT. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режиме - authenticator: oauth2. Данный параметр является - обязательным для указанного режима. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/6.1.0/модуль-decort_osimage.md b/wiki/6.1.0/модуль-decort_osimage.md deleted file mode 100644 index 0574bc9..0000000 --- a/wiki/6.1.0/модуль-decort_osimage.md +++ /dev/null @@ -1,131 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен полный список параметров для модуля decort_osimage. - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должен быть создан (или уже существует) образ. Данный параметр является обязательным. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты. Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/6.1.0/модуль-decort_pfw.md b/wiki/6.1.0/модуль-decort_pfw.md deleted file mode 100644 index 65ccf02..0000000 --- a/wiki/6.1.0/модуль-decort_pfw.md +++ /dev/null @@ -1,76 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw - -Ниже в алфавитном порядке приведен полный список параметров для модуля **decort_pfw**. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_pfw` - - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`. | -| authenticator | (str)
Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Обязательный параметр. | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT. Данный параметр является обязательным. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/6.1.0/модуль-decort_rg.md b/wiki/6.1.0/модуль-decort_rg.md deleted file mode 100644 index c69e206..0000000 --- a/wiki/6.1.0/модуль-decort_rg.md +++ /dev/null @@ -1,229 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - -## Параметры модуля decort_rg - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_rg. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: `ansible-doc -t module decort_rg` - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| description | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`. | -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения DECORT_APP_SECRET. | -| authenticator | Значения:
`oauth2`
`jwt`| Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным.| -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данная ресурсная группа. Данный параметр является обязательным. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`
Данный параметр является обязательным для указанного режима.
Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в _playbook_.
Если этот параметр не определен в _playbook_, то модуль будет использовать значение переменной окружения `DECORT_JWT`. | -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу Oauth2, который должен использоваться в режиме authenticator: oauth2. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/6.1.0/модуль-decort_user_info.md b/wiki/6.1.0/модуль-decort_user_info.md deleted file mode 100644 index c463324..0000000 --- a/wiki/6.1.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1338 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/6.1.0/модуль-decort_vins.md b/wiki/6.1.0/модуль-decort_vins.md deleted file mode 100644 index 3e28adf..0000000 --- a/wiki/6.1.0/модуль-decort_vins.md +++ /dev/null @@ -1,120 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins - -Ниже в алфавитном порядке приведен полный список параметров для модуля decort_vins. Актуальную информацию по параметрам, которые поддерживает версия модуля, установленного на вашем Ansible-сервере, можно получить командой: -`ansible-doc -t module decort_vins` - - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| app_id | (string) | Идентификатор приложения, использующийся для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Если параметр не задан в playbook, модуль будет использовать значение переменной окружения `DECORT_APP_ID`.| -| app_secret | (string) | Секретный ключ приложения, который используется для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: oauth2`. Данный параметр является обязательным для указанного режима. Так как он содержит секретную информацию, то его не рекомендуется задавать непосредственно в playbook. Если параметр не задан в playbook, то модуль будет использовать значение переменной окружения `DECORT_APP_SECRET`.| -| authenticator | Значения:
`oauth2`
`jwt` | Режим аутентификации при подключении к контроллеру облачной платформы DECORT. Данный параметр является обязательным. | -| controller_url | (string) | URL контроллера, соответствующего экземпляру облачной платформы DECORT, в рамках которого должна быть создана (или уже существует) данный внутренняя сеть. Данный параметр является обязательным. -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -| jwt | (string) | JSON Web Token (JWT), который будет использоваться для подключения к контроллеру облачной платформы DECORT в режиме `authenticator: jwt`. Данный параметр является обязательным для указанного режима. Так как он содержит потенциально секретную информацию, а сам JWT, как правило, имеет ограниченное время жизни, то его не рекомендуется задавать непосредственно в playbook. Если этот параметр не определен в playbook, то модуль будет использовать значение переменной окружения `DECORT_JWT`.| -| oauth2_url | (string) | URL авторизационного сервера, работающего по протоколу _Oauth2_, который должен использоваться в режиме `authenticator: oauth2`.
Данный параметр является обязательным для указанного режима.
Если параметр не задан в _playbook_, модуль будет использовать значение переменной окружения `DECORT_OAUTH2_URL`. | -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| verify_ssl | (bool)
Default: `true` | Позволяет отключить проверку SSL сертификатов при выполнении API вызовов в адрес контроллера облачной инфраструктуры, например, при работе с изолированной облачной инфраструктурой, использующей самоподписанные сертификаты.
Применяйте данный параметр с осторожностью, предпочтительно в защищенных средах. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/7.0.0/Home.md b/wiki/7.0.0/Home.md deleted file mode 100644 index 31004d8..0000000 --- a/wiki/7.0.0/Home.md +++ /dev/null @@ -1,25 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o) - - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -1. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе - - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины diff --git a/wiki/7.0.0/введение.md b/wiki/7.0.0/введение.md deleted file mode 100644 index 261da07..0000000 --- a/wiki/7.0.0/введение.md +++ /dev/null @@ -1,250 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 10.6.0 -- Python 3.10.12 -- PyJWT 2.10.1 Python module -- requests 2.32.3 Python module -- DynamiX Enterprise 4.2.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. - Так как он содержит секретную информацию, то его не рекомендуется - задавать непосредственно в playbook. Если параметр не задан в playbook, - то модуль будет использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
bvs -
decs3o -
oauth2 -
jwt -
Default: decs3o - 		- Режим аутентификации для получения токена. - Значение oauth2 является устаревшим и равнозначным - decs3o. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- domain - - (str) - - Домен BVS, использующийся для получения токена в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_DOMAIN. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режимах - authenticator: bvs - или authenticator: decs3o. Данный параметр является - обязательным для указанных режимов. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- password - - (str) - - Пароль пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно - в playbook. Если параметр не задан в playbook, модуль будет - использовать значение переменной окружения - DECORT_PASSWORD. -
- username - - (str) - - Логин пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_USERNAME. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: DECS3O auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - controller_url: https://dynamix.local - oauth2_url: https://sso-dynamix.local -``` - -### Пример авторизации с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: BVS auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - controller_url: https://dynamix.local - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/7.0.0/модуль-decort_account.md b/wiki/7.0.0/модуль-decort_account.md deleted file mode 100644 index 528e5ce..0000000 --- a/wiki/7.0.0/модуль-decort_account.md +++ /dev/null @@ -1,992 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` diff --git a/wiki/7.0.0/модуль-decort_account_info.md b/wiki/7.0.0/модуль-decort_account_info.md deleted file mode 100644 index ff5563d..0000000 --- a/wiki/7.0.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3805 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/7.0.0/модуль-decort_bservice.md b/wiki/7.0.0/модуль-decort_bservice.md deleted file mode 100644 index 96a66aa..0000000 --- a/wiki/7.0.0/модуль-decort_bservice.md +++ /dev/null @@ -1,82 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice -Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/7.0.0/модуль-decort_disk.md b/wiki/7.0.0/модуль-decort_disk.md deleted file mode 100644 index 551178c..0000000 --- a/wiki/7.0.0/модуль-decort_disk.md +++ /dev/null @@ -1,167 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk -Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| description | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/7.0.0/модуль-decort_group.md b/wiki/7.0.0/модуль-decort_group.md deleted file mode 100644 index cc4a638..0000000 --- a/wiki/7.0.0/модуль-decort_group.md +++ /dev/null @@ -1,97 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/7.0.0/модуль-decort_jwt.md b/wiki/7.0.0/модуль-decort_jwt.md deleted file mode 100644 index a38b9f3..0000000 --- a/wiki/7.0.0/модуль-decort_jwt.md +++ /dev/null @@ -1,48 +0,0 @@ -# Модуль decort_jwt -## Обзор модуля -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). - -## Параметры модуля decort_jwt -Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации). - -Отличия от общих параметров: -- Параметр `controller_url` не используется. -- Параметр `jwt` не используется. -- В параметре `authenticator` не используется значение `jwt`. - -## Возвращаемые значения модуля decort_jwt -| Ключ | Тип данных | Описание | -|---| ------ | ------ | -| jwt | str | JWT токен. | - -## Примеры использования -### Пример получения JWT токена с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from DECS3O - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - oauth2_url: https://sso-dynamix.local -``` - -### Пример получения JWT токена с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from BVS - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` diff --git a/wiki/7.0.0/модуль-decort_k8s.md b/wiki/7.0.0/модуль-decort_k8s.md deleted file mode 100644 index 12fcd3e..0000000 --- a/wiki/7.0.0/модуль-decort_k8s.md +++ /dev/null @@ -1,112 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет master-узлов. Не применим при изменении существующего кластера.
Значение по умолчанию при создании: `i440fx`. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`
• `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`
• `disk` (int) (необязательный) - объём загрузочного диска на узле; если не задан при создании, размер диска будет равен размеру используемого образа
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`; значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; значение по умолчанию при создании: `1`
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; значение по умолчанию при создании: `1024`
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. | - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - ram: 1024 - chipset: i440fx - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - ram: 1024 - chipset: Q35 - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/7.0.0/модуль-decort_kvmvm.md b/wiki/7.0.0/модуль-decort_kvmvm.md deleted file mode 100644 index 1985691..0000000 --- a/wiki/7.0.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,887 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- **создать** (см. [примеры](#создать)) - - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания)) - - **с указанием объёма загрузочного диска** (см. параметр **boot_disk** и [примеры](#с-указанием-объёма-загрузочного-диска)) - - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд)) - - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data)) - - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа)) - - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity)) - - **с указанием запуска на выделенных процессорах** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-процессорах)) - - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages)) - - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields)) - - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки)) - - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил)) - - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил)) - - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов)) - - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом)) - - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа)) - - **с загрузочным диском** (см. параметр **boot_disk** и [примеры](#с-загрузочным-диском)) - - **без загрузочного диска** (см. параметр **boot_disk** и [примеры](#без-загрузочного-диска)) - - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) -- **получить информацию** (см. [возвращаемые значения](#возвращаемые-значения-модуля-decort_kvmvm) и [примеры](#получение-основной-информации-о-виртуальной-машине)) -- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить)) -- **подключить/отключить диски с данными** (см. параметр **data_disks** и [примеры](#подключитьотключить-диски-с-данными)) -- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети)) -- **изменить** (см. [примеры](#изменить)) - - **объём загрузочного диска в большую сторону** (см. параметр **boot_disk** и [примеры](#объём-загрузочного-диска-в-большую-сторону)) - - **количество CPU** (см. параметр **cpu** и [примеры](#количество-cpu)) - - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу)) - - **тэги** (см. параметр **tag** и [примеры](#тэги)) - - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку)) - - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила)) - - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила)) - - **описание** (см. параметр **description** и [примеры](#описание)) - - **чипсет** (см. параметр **chipset** и [примеры](#чипсет)) - - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity)) - - **использование CPU Pinning** (см. параметр **cpu_pin** и [примеры](#использование-cpu-pinning)) - - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages)) - - **имя** (см. параметр **name** и [примеры](#имя)) - - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины)) - - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) -- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно)) - -## Параметры модуля decort_kvmvm -Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.
Если параметр не задан при создании ВМ, то значение будет выбрано платформой. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ.
Если параметр не задан, размер будет равен размеру образа.
Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет. | -| ci_user_data | (dict) | конфигурация для cloud-init -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| cpu_pin | (bool) | Запуск виртуальной машины на выделенных процессорах. Чтобы использовать эту функцию, система должна быть предварительно сконфигурирована путем выделения процессоров на физическом узле.
Значение по умолчанию при создании: `false`. | -| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.
Ключи словаря:
• `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`
• `fields` (dict) - поля для управления XML виртуальной машины. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.
Чтобы отключить все диски, нужно указать пустой список `[]`.| -| description | (string) | Опциональное описание виртуальной машины. | -| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле.
Значение по умолчанию при создании: `false`. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
Если заданы оба параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`
• `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| numa_affinity | (str)
Значения:
`strict`
`loose`
`none` | Правило применения NUMA affinity к виртуальной машине.
`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity.
Значение по умолчанию при создании: `none`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused` | Целевое состояние ВМ.
`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.
`absent` - виртуальная машина безвозвратно удалена.
`poweredon` - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.
`poweredoff` - виртуальная машина остановлена. Если запущена, то будет остановлена.
`halted` - аналогично `poweredoff`.
`paused` - виртуальная машина приостановлена.
Значение по умолчанию при создании: `present`. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| cpu_pin | bool | Запуск виртуальной машины на выделенных процессорах. | -| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| name | string | Имя ВМ. | -| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. | -| password | string | Пароль пользователя ОС по умолчанию. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | -| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. | - -## Примеры использования - -### Создать - -#### С указанием описания -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - description: vm description - state: present -``` - -#### С указанием объёма загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - boot_disk: 10 - state: present -``` - -#### С указанием СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - sep_id: "{{ sep_id }}" - pool: "{{ sep_pool_name }}" - state: present -``` - -#### С указанием Cloud-init user data -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - ci_user_data: - packages: - - apache2 - write_files: - - content: | -
- Hello World! -
- owner: user:user - path: /var/www/html/index.html - hostname: test-apache - ssh_keys: - - rsa_public: ssh-rsa AAAAOasDmLxnD= user@pc - state: present -``` - -#### С указанием SSH-ключа -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA... - ssh_key_user: user - state: present -``` - -#### С указанием NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - numa_affinity: strict - state: present -``` - -#### С указанием запуска на выделенных процессорах -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - cpu_pin: true - state: present -``` - -#### С использованием Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - hp_backed: true - state: present -``` - -#### С указанием custom_fields -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - custom_fields: - fields: - title: Title - cpu: - mode: custom - vendor: Intel - cache: - mode: disable - topology: - sockets: 1 - cores: 14 - threads: 1 - match: minimum - check: partial - state: present -``` - -#### С указанием affinity-метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity-label - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - affinity_label: label - state: present -``` - -#### С указанием affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - aff_rule: - - topology: compute - policy: RECOMMENDED - mode: EQ - key: key - value: value - state: present -``` - -#### С указанием anti-affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - aaff_rule: - - topology: node - policy: REQUIRED - mode: ANY - key: key - value: value - state: present -``` - -#### С указанием тэгов -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with tags - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - tag: - tag1_key: tag1_value - tag2_key: tag2_value - state: present -``` - -#### С образом -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - chipset: Q35 - state: present -``` - -#### Без образа - -##### С загрузочным диском -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - boot_disk: 10 - state: present -``` - -##### Без загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and without boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - state: present -``` - -#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - auto_start: true - state: present -``` - -### Получение основной информации о виртуальной машине - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by ID - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by name - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" -``` - -### Остановить/приостановить/запустить - -#### Остановить -``` -- name: Example - hosts: localhost - tasks: - - name: Stop VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredoff -``` - -#### Запустить -``` -- name: Example - hosts: localhost - tasks: - - name: Start VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredon -``` - -#### Приостановить -``` -- name: Example - hosts: localhost - tasks: - - name: Pause VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: paused -``` - -### Подключить/отключить диски с данными - -#### Подключить -``` -- name: Example - hosts: localhost - tasks: - - name: Connect data disks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - data_disks: - - "{{ datadisk1_id }}" - - "{{ datadisk2_id }}" -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect data disks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - data_disks: [] -``` - -### Подключить/отключить сети - -#### Подключить не-DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - state: poweredoff -``` - -#### Подключить не-DPDK сети с соблюдением очередности -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM without network order changing - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - network_order_changing: true - state: poweredoff -``` - -#### Подключить DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect DPDK networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: DPDK - id: "{{ dpdk1_id }}" - - type: EMPTY - - type: DPDK - id: "{{ dpdk2_id }}" - mtu: 1500 - state: poweredoff -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect networks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: [] - state: poweredoff -``` - -### Изменить - -#### Объём загрузочного диска в большую сторону -``` -- name: Example - hosts: localhost - tasks: - - name: Increase boot disk size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot_disk: 15 - state: poweredoff -``` - -#### Количество CPU -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU amount - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu: 1 - state: poweredoff -``` - -#### Объём ОЗУ -``` -- name: Example - hosts: localhost - tasks: - - name: Change RAM size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - ram: 512 - state: poweredoff -``` - -#### Тэги -``` -- name: Example - hosts: localhost - tasks: - - name: Change tags - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value -``` - -#### Affinity метку -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity label - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - affinity_label: Affinity label 1 -``` - -#### Affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aff_rule: - - topology: compute - policy: REQUIRED - mode: EQ - key: app - value: main - - topology: node - policy: RECOMMENDED - mode: NE - key: state - value: started -``` - -#### Anti-affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aaff_rule: - - topology: compute - policy: REQUIRED - mode: ANY - key: app - value: main -``` - -#### Описание -``` -- name: Example - hosts: localhost - tasks: - - name: Change description - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - description: vm description -``` - -#### Чипсет -``` -- name: Example - hosts: localhost - tasks: - - name: Change chipset - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - chipset: i440fx - state: poweredoff -``` - -#### Правило NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Change NUMA affinity rule - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - numa_affinity: loose - state: poweredoff -``` - -#### Использование CPU Pinning -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU Pinning usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - state: poweredoff -``` - -#### Использование Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Change Huge Pages usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - state: poweredoff -``` - -#### Имя -``` -- name: Example - hosts: localhost - tasks: - - name: Rename VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - name: "{{ new_vm_name }}" -``` - -#### XML виртуальной машины - -##### Изменение -``` -- name: Example - hosts: localhost - tasks: - - name: Change XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - fields: - cpu: - mode: custom - vendor: Intel - cache: - mode: enable - os: - type: - machine: pc-i440fx-artful -``` - -##### Отключение управления ВМ через XML -``` -- name: Example - hosts: localhost - tasks: - - name: Disable XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - disable: true -``` - -#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена - -##### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable auto starting pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: true -``` - -##### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable auto starting of pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: false -``` - -### Удалить - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: absent -``` diff --git a/wiki/7.0.0/модуль-decort_lb.md b/wiki/7.0.0/модуль-decort_lb.md deleted file mode 100644 index 61b5b91..0000000 --- a/wiki/7.0.0/модуль-decort_lb.md +++ /dev/null @@ -1,782 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- description - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/7.0.0/модуль-decort_osimage.md b/wiki/7.0.0/модуль-decort_osimage.md deleted file mode 100644 index 6f6dca4..0000000 --- a/wiki/7.0.0/модуль-decort_osimage.md +++ /dev/null @@ -1,124 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/7.0.0/модуль-decort_pfw.md b/wiki/7.0.0/модуль-decort_pfw.md deleted file mode 100644 index 45dd2ad..0000000 --- a/wiki/7.0.0/модуль-decort_pfw.md +++ /dev/null @@ -1,66 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw -Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/7.0.0/модуль-decort_rg.md b/wiki/7.0.0/модуль-decort_rg.md deleted file mode 100644 index 793e865..0000000 --- a/wiki/7.0.0/модуль-decort_rg.md +++ /dev/null @@ -1,221 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - -## Параметры модуля decort_rg -Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| description | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/7.0.0/модуль-decort_snapshot.md b/wiki/7.0.0/модуль-decort_snapshot.md deleted file mode 100644 index 9021585..0000000 --- a/wiki/7.0.0/модуль-decort_snapshot.md +++ /dev/null @@ -1,248 +0,0 @@ -# Модуль decort_snapshot -## Обзор модуля - -Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин: -- **создать** (см. [параметр state](#state) и [примеры](#создать)) -- **удалить** (см. [параметр state](#state) и [примеры](#удалить)) -- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке)) -- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - label - - - (str) - - Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - vm_name_2024-12-10_16-40-52. -
- - state - - - (str) -
Значения: -
absent -
present - 		- Целевое состояние. -
absent - снимок удален. -
present - снимок существует. -
- - usage - - - (bool) -
Default:false - 		- Получить информацию о реальном размере снимка виртуальной машины. -
- - vm_id - - - (int) - - Идентификатор виртуальной машины. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Диски -
- guid - - str - - Идентификатор снимка -
- label - - str - - Метка снимка -
- timestamp - - int - - Временная метка создания снимка -
- vm_id - - int - - Идентификатор виртуальной машины -
- -### Размер снимка - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- stored - - float - - Размер снимка -
- -## Примеры использования - -### Создать - -#### С указанием метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: present -``` - -#### Без указания метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - state: present -``` - -### Удалить -``` -- name: Example - hosts: localhost - tasks: - - name: Delete snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: absent -``` - -### Получить основную информацию о снимке -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic snapshot info - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" -``` - -### Получить информацию о размере снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Get snapshot usage - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - usage: true -``` diff --git a/wiki/7.0.0/модуль-decort_user_info.md b/wiki/7.0.0/модуль-decort_user_info.md deleted file mode 100644 index c463324..0000000 --- a/wiki/7.0.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1338 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/7.0.0/модуль-decort_vins.md b/wiki/7.0.0/модуль-decort_vins.md deleted file mode 100644 index 4c05f25..0000000 --- a/wiki/7.0.0/модуль-decort_vins.md +++ /dev/null @@ -1,110 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins -Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/7.1.0/Home.md b/wiki/7.1.0/Home.md deleted file mode 100644 index 866c022..0000000 --- a/wiki/7.1.0/Home.md +++ /dev/null @@ -1,25 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o) - - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -2. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе - - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины diff --git a/wiki/7.1.0/введение.md b/wiki/7.1.0/введение.md deleted file mode 100644 index 261da07..0000000 --- a/wiki/7.1.0/введение.md +++ /dev/null @@ -1,250 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 10.6.0 -- Python 3.10.12 -- PyJWT 2.10.1 Python module -- requests 2.32.3 Python module -- DynamiX Enterprise 4.2.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. - Так как он содержит секретную информацию, то его не рекомендуется - задавать непосредственно в playbook. Если параметр не задан в playbook, - то модуль будет использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
bvs -
decs3o -
oauth2 -
jwt -
Default: decs3o - 		- Режим аутентификации для получения токена. - Значение oauth2 является устаревшим и равнозначным - decs3o. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- domain - - (str) - - Домен BVS, использующийся для получения токена в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_DOMAIN. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режимах - authenticator: bvs - или authenticator: decs3o. Данный параметр является - обязательным для указанных режимов. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- password - - (str) - - Пароль пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно - в playbook. Если параметр не задан в playbook, модуль будет - использовать значение переменной окружения - DECORT_PASSWORD. -
- username - - (str) - - Логин пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_USERNAME. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: DECS3O auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - controller_url: https://dynamix.local - oauth2_url: https://sso-dynamix.local -``` - -### Пример авторизации с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: BVS auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - controller_url: https://dynamix.local - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/7.1.0/модуль-decort_account.md b/wiki/7.1.0/модуль-decort_account.md deleted file mode 100644 index 528e5ce..0000000 --- a/wiki/7.1.0/модуль-decort_account.md +++ /dev/null @@ -1,992 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` diff --git a/wiki/7.1.0/модуль-decort_account_info.md b/wiki/7.1.0/модуль-decort_account_info.md deleted file mode 100644 index ff5563d..0000000 --- a/wiki/7.1.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3805 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/7.1.0/модуль-decort_bservice.md b/wiki/7.1.0/модуль-decort_bservice.md deleted file mode 100644 index 96a66aa..0000000 --- a/wiki/7.1.0/модуль-decort_bservice.md +++ /dev/null @@ -1,82 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice -Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/7.1.0/модуль-decort_disk.md b/wiki/7.1.0/модуль-decort_disk.md deleted file mode 100644 index 551178c..0000000 --- a/wiki/7.1.0/модуль-decort_disk.md +++ /dev/null @@ -1,167 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - - -Обратите внимание: - -- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины. -- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками); -- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm). - -## Параметры модуля decort_disk -Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| description | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | -| type | (string)
Значения:
`B`
`D`
Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/7.1.0/модуль-decort_group.md b/wiki/7.1.0/модуль-decort_group.md deleted file mode 100644 index cc4a638..0000000 --- a/wiki/7.1.0/модуль-decort_group.md +++ /dev/null @@ -1,97 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/7.1.0/модуль-decort_jwt.md b/wiki/7.1.0/модуль-decort_jwt.md deleted file mode 100644 index a38b9f3..0000000 --- a/wiki/7.1.0/модуль-decort_jwt.md +++ /dev/null @@ -1,48 +0,0 @@ -# Модуль decort_jwt -## Обзор модуля -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). - -## Параметры модуля decort_jwt -Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации). - -Отличия от общих параметров: -- Параметр `controller_url` не используется. -- Параметр `jwt` не используется. -- В параметре `authenticator` не используется значение `jwt`. - -## Возвращаемые значения модуля decort_jwt -| Ключ | Тип данных | Описание | -|---| ------ | ------ | -| jwt | str | JWT токен. | - -## Примеры использования -### Пример получения JWT токена с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from DECS3O - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - oauth2_url: https://sso-dynamix.local -``` - -### Пример получения JWT токена с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from BVS - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` diff --git a/wiki/7.1.0/модуль-decort_k8s.md b/wiki/7.1.0/модуль-decort_k8s.md deleted file mode 100644 index 12fcd3e..0000000 --- a/wiki/7.1.0/модуль-decort_k8s.md +++ /dev/null @@ -1,112 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет master-узлов. Не применим при изменении существующего кластера.
Значение по умолчанию при создании: `i440fx`. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`
• `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`
• `disk` (int) (необязательный) - объём загрузочного диска на узле; если не задан при создании, размер диска будет равен размеру используемого образа
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`; значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; значение по умолчанию при создании: `1`
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; значение по умолчанию при создании: `1024`
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. | - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - ram: 1024 - chipset: i440fx - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - ram: 1024 - chipset: Q35 - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/7.1.0/модуль-decort_kvmvm.md b/wiki/7.1.0/модуль-decort_kvmvm.md deleted file mode 100644 index 0eb60df..0000000 --- a/wiki/7.1.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,945 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- **создать** (см. [примеры](#создать)) - - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания)) - - **с указанием объёма загрузочного диска** (см. параметр **boot_disk** и [примеры](#с-указанием-объёма-загрузочного-диска)) - - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд)) - - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data)) - - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа)) - - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity)) - - **с указанием запуска на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-ядрах-цп)) - - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages)) - - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields)) - - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки)) - - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил)) - - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил)) - - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов)) - - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом)) - - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа)) - - **с загрузочным диском** (см. параметр **boot_disk** и [примеры](#с-загрузочным-диском)) - - **без загрузочного диска** (см. параметр **boot_disk** и [примеры](#без-загрузочного-диска)) - - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **с указанием чипсета** (см. параметр **chipset** и [примеры](#с-указанием-чипсета)) - - **с указанием предпочтительных ядер** (см. параметр **preferred_cpu_cores** и [примеры](#с-указанием-предпочтительных-ядер)) -- **получить информацию** (см. [возвращаемые значения](#возвращаемые-значения-модуля-decort_kvmvm) и [примеры](#получение-основной-информации-о-виртуальной-машине)) -- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить)) -- **подключить/отключить диски с данными** (см. параметр **data_disks** и [примеры](#подключитьотключить-диски-с-данными)) -- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети)) -- **откатить ВМ к состоянию снимка** (см. параметры **rollback_to** и [примеры](#откатить-вм-к-состоянию-снимка)) -- **изменить** (см. [примеры](#изменить)) - - **объём загрузочного диска в большую сторону** (см. параметр **boot_disk** и [примеры](#объём-загрузочного-диска-в-большую-сторону)) - - **количество ЦП** (см. параметр **cpu** и [примеры](#количество-цп)) - - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу)) - - **тэги** (см. параметр **tag** и [примеры](#тэги)) - - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку)) - - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила)) - - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила)) - - **описание** (см. параметр **description** и [примеры](#описание)) - - **чипсет** (см. параметр **chipset** и [примеры](#чипсет)) - - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity)) - - **запуск на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#запуск-на-выделенных-ядрах-цп)) - - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages)) - - **имя** (см. параметр **name** и [примеры](#имя)) - - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины)) - - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **предпочтительные ядра** (см. параметр **preferred_cpu_cores** и [примеры](#предпочтительные-ядра)) -- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно)) - -## Параметры модуля decort_kvmvm -Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.
Если параметр не задан при создании ВМ, то значение будет выбрано платформой. | -| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ.
Если параметр не задан, размер будет равен размеру образа.
Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет. Значение по умолчанию при создании: `i440fx`.| -| ci_user_data | (dict) | конфигурация для cloud-init -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| cpu_pin | (bool) | Запуск виртуальной машины на выделенных ядрах ЦП.
Значение по умолчанию при создании: `false`. | -| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.
Ключи словаря:
• `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`
• `fields` (dict) - поля для управления XML виртуальной машины. | -| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.
Чтобы отключить все диски, нужно указать пустой список `[]`.| -| description | (string) | Опциональное описание виртуальной машины. | -| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле.
Значение по умолчанию при создании: `false`. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
Если заданы оба параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`
• `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| numa_affinity | (str)
Значения:
`strict`
`loose`
`none` | Правило применения NUMA affinity к виртуальной машине.
`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity.
Значение по умолчанию при создании: `none`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| preferred_cpu_cores | (list) | Список номеров предпочтительных выделенных ядер ЦП (см. параметр `cpu_pin`). Чтобы очистить список номеров предпочтительных выделенных ядер ЦП, нужно указать пустой список `[]`. | -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| rollback_to | (string) | Имя снимка, к состоянию которого необходимо совершить откат ВМ. | -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused` | Целевое состояние ВМ.
`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.
`absent` - виртуальная машина безвозвратно удалена.
`poweredon` - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.
`poweredoff` - виртуальная машина остановлена. Если запущена, то будет остановлена.
`halted` - аналогично `poweredoff`.
`paused` - виртуальная машина приостановлена.
Значение по умолчанию при создании: `present`. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| cpu_pin | bool | Запуск виртуальной машины на выделенных ядрах ЦП. | -| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. | -| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| name | string | Имя ВМ. | -| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. | -| password | string | Пароль пользователя ОС по умолчанию. | -| preferred_cpu_cores | list | Список номеров предпочтительных выделенных ядер ЦП. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| snapshots | list | Список словарей, описывающих снимки ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | -| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. | - -## Примеры использования - -### Создать - -#### С указанием описания -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - description: vm description - state: present -``` - -#### С указанием объёма загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - boot_disk: 10 - state: present -``` - -#### С указанием СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - sep_id: "{{ sep_id }}" - pool: "{{ sep_pool_name }}" - state: present -``` - -#### С указанием Cloud-init user data -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ci_user_data: - packages: - - apache2 - write_files: - - content: | -
- Hello World! -
- owner: user:user - path: /var/www/html/index.html - hostname: test-apache - ssh_keys: - - rsa_public: ssh-rsa AAAAOasDmLxnD= user@pc - state: present -``` - -#### С указанием SSH-ключа -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA... - ssh_key_user: user - state: present -``` - -#### С указанием NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - numa_affinity: strict - state: present -``` - -#### С указанием запуска на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - cpu_pin: true - state: present -``` - -#### С использованием Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - hp_backed: true - state: present -``` - -#### С указанием custom_fields -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - custom_fields: - fields: - title: Title - cpu: - mode: custom - vendor: Intel - cache: - mode: disable - topology: - sockets: 1 - cores: 14 - threads: 1 - match: minimum - check: partial - state: present -``` - -#### С указанием affinity-метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity-label - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - affinity_label: label - state: present -``` - -#### С указанием affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aff_rule: - - topology: compute - policy: RECOMMENDED - mode: EQ - key: key - value: value - state: present -``` - -#### С указанием anti-affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aaff_rule: - - topology: node - policy: REQUIRED - mode: ANY - key: key - value: value - state: present -``` - -#### С указанием тэгов -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with tags - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value - state: present -``` - -#### С образом -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - state: present -``` - -#### Без образа - -##### С загрузочным диском -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - boot_disk: 10 - state: present -``` - -##### Без загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and without boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - state: present -``` - -#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - auto_start: true - state: present -``` - -#### С указанием чипсета -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - state: present -``` - -### С указанием предпочтительных ядер -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - state: present -``` - -### Получение основной информации о виртуальной машине - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by ID - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by name - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" -``` - -### Остановить/приостановить/запустить - -#### Остановить -``` -- name: Example - hosts: localhost - tasks: - - name: Stop VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredoff -``` - -#### Запустить -``` -- name: Example - hosts: localhost - tasks: - - name: Start VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredon -``` - -#### Приостановить -``` -- name: Example - hosts: localhost - tasks: - - name: Pause VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: paused -``` - -### Подключить/отключить диски с данными - -#### Подключить -``` -- name: Example - hosts: localhost - tasks: - - name: Connect data disks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - data_disks: - - "{{ datadisk1_id }}" - - "{{ datadisk2_id }}" -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect data disks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - data_disks: [] -``` - -### Подключить/отключить сети - -#### Подключить не-DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - state: poweredoff -``` - -#### Подключить не-DPDK сети с соблюдением очередности -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM without network order changing - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - network_order_changing: true - state: poweredoff -``` - -#### Подключить DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect DPDK networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - networks: - - type: DPDK - id: "{{ dpdk1_id }}" - - type: EMPTY - - type: DPDK - id: "{{ dpdk2_id }}" - mtu: 1500 - state: poweredoff -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect networks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: [] - state: poweredoff -``` - -### Откатить ВМ к состоянию снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Rollback VM to snapshot - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - rollback_to: snapshot_01 - state: poweredoff -``` - -### Изменить - -#### Объём загрузочного диска в большую сторону -``` -- name: Example - hosts: localhost - tasks: - - name: Increase boot disk size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot_disk: 15 - state: poweredoff -``` - -#### Количество ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU amount - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu: 1 - state: poweredoff -``` - -#### Объём ОЗУ -``` -- name: Example - hosts: localhost - tasks: - - name: Change RAM size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - ram: 512 - state: poweredoff -``` - -#### Тэги -``` -- name: Example - hosts: localhost - tasks: - - name: Change tags - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value -``` - -#### Affinity метку -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity label - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - affinity_label: Affinity label 1 -``` - -#### Affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aff_rule: - - topology: compute - policy: REQUIRED - mode: EQ - key: app - value: main - - topology: node - policy: RECOMMENDED - mode: NE - key: state - value: started -``` - -#### Anti-affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aaff_rule: - - topology: compute - policy: REQUIRED - mode: ANY - key: app - value: main -``` - -#### Описание -``` -- name: Example - hosts: localhost - tasks: - - name: Change description - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - description: vm description -``` - -#### Чипсет -``` -- name: Example - hosts: localhost - tasks: - - name: Change chipset - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - chipset: i440fx - state: poweredoff -``` - -#### Правило NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Change NUMA affinity rule - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - numa_affinity: loose - state: poweredoff -``` - -#### Запуск на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU Pinning usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - state: poweredoff -``` - -#### Использование Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Change Huge Pages usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - state: poweredoff -``` - -#### Имя -``` -- name: Example - hosts: localhost - tasks: - - name: Rename VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - name: "{{ new_vm_name }}" -``` - -#### XML виртуальной машины - -##### Изменение -``` -- name: Example - hosts: localhost - tasks: - - name: Change XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - fields: - cpu: - mode: custom - vendor: Intel - cache: - mode: enable - os: - type: - machine: pc-i440fx-artful -``` - -##### Отключение управления ВМ через XML -``` -- name: Example - hosts: localhost - tasks: - - name: Disable XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - disable: true -``` - -#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена - -##### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable auto starting pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: true -``` - -##### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable auto starting of pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: false -``` - -#### Предпочтительные ядра -``` -- name: Example - hosts: localhost - tasks: - - name: Change preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - - 2 - state: poweredoff -``` - -### Удалить - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: absent -``` diff --git a/wiki/7.1.0/модуль-decort_lb.md b/wiki/7.1.0/модуль-decort_lb.md deleted file mode 100644 index 61b5b91..0000000 --- a/wiki/7.1.0/модуль-decort_lb.md +++ /dev/null @@ -1,782 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить конфигурации backend и frontend -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- description - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
diff --git a/wiki/7.1.0/модуль-decort_osimage.md b/wiki/7.1.0/модуль-decort_osimage.md deleted file mode 100644 index 6f6dca4..0000000 --- a/wiki/7.1.0/модуль-decort_osimage.md +++ /dev/null @@ -1,124 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - -## Параметры модуля decort_osimage -Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - diff --git a/wiki/7.1.0/модуль-decort_pfw.md b/wiki/7.1.0/модуль-decort_pfw.md deleted file mode 100644 index 45dd2ad..0000000 --- a/wiki/7.1.0/модуль-decort_pfw.md +++ /dev/null @@ -1,66 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw -Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/7.1.0/модуль-decort_rg.md b/wiki/7.1.0/модуль-decort_rg.md deleted file mode 100644 index 793e865..0000000 --- a/wiki/7.1.0/модуль-decort_rg.md +++ /dev/null @@ -1,221 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - -## Параметры модуля decort_rg -Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| description | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/7.1.0/модуль-decort_snapshot.md b/wiki/7.1.0/модуль-decort_snapshot.md deleted file mode 100644 index 9021585..0000000 --- a/wiki/7.1.0/модуль-decort_snapshot.md +++ /dev/null @@ -1,248 +0,0 @@ -# Модуль decort_snapshot -## Обзор модуля - -Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин: -- **создать** (см. [параметр state](#state) и [примеры](#создать)) -- **удалить** (см. [параметр state](#state) и [примеры](#удалить)) -- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке)) -- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - label - - - (str) - - Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - vm_name_2024-12-10_16-40-52. -
- - state - - - (str) -
Значения: -
absent -
present - 		- Целевое состояние. -
absent - снимок удален. -
present - снимок существует. -
- - usage - - - (bool) -
Default:false - 		- Получить информацию о реальном размере снимка виртуальной машины. -
- - vm_id - - - (int) - - Идентификатор виртуальной машины. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Диски -
- guid - - str - - Идентификатор снимка -
- label - - str - - Метка снимка -
- timestamp - - int - - Временная метка создания снимка -
- vm_id - - int - - Идентификатор виртуальной машины -
- -### Размер снимка - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- stored - - float - - Размер снимка -
- -## Примеры использования - -### Создать - -#### С указанием метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: present -``` - -#### Без указания метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - state: present -``` - -### Удалить -``` -- name: Example - hosts: localhost - tasks: - - name: Delete snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: absent -``` - -### Получить основную информацию о снимке -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic snapshot info - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" -``` - -### Получить информацию о размере снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Get snapshot usage - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - usage: true -``` diff --git a/wiki/7.1.0/модуль-decort_user_info.md b/wiki/7.1.0/модуль-decort_user_info.md deleted file mode 100644 index c463324..0000000 --- a/wiki/7.1.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1338 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/7.1.0/модуль-decort_vins.md b/wiki/7.1.0/модуль-decort_vins.md deleted file mode 100644 index 4c05f25..0000000 --- a/wiki/7.1.0/модуль-decort_vins.md +++ /dev/null @@ -1,110 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins -Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/7.2.0/Home.md b/wiki/7.2.0/Home.md deleted file mode 100644 index 866c022..0000000 --- a/wiki/7.2.0/Home.md +++ /dev/null @@ -1,25 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o) - - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -2. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе - - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины diff --git a/wiki/7.2.0/введение.md b/wiki/7.2.0/введение.md deleted file mode 100644 index 261da07..0000000 --- a/wiki/7.2.0/введение.md +++ /dev/null @@ -1,250 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 10.6.0 -- Python 3.10.12 -- PyJWT 2.10.1 Python module -- requests 2.32.3 Python module -- DynamiX Enterprise 4.2.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. - Так как он содержит секретную информацию, то его не рекомендуется - задавать непосредственно в playbook. Если параметр не задан в playbook, - то модуль будет использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
bvs -
decs3o -
oauth2 -
jwt -
Default: decs3o - 		- Режим аутентификации для получения токена. - Значение oauth2 является устаревшим и равнозначным - decs3o. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- domain - - (str) - - Домен BVS, использующийся для получения токена в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_DOMAIN. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режимах - authenticator: bvs - или authenticator: decs3o. Данный параметр является - обязательным для указанных режимов. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- password - - (str) - - Пароль пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно - в playbook. Если параметр не задан в playbook, модуль будет - использовать значение переменной окружения - DECORT_PASSWORD. -
- username - - (str) - - Логин пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_USERNAME. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: DECS3O auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - controller_url: https://dynamix.local - oauth2_url: https://sso-dynamix.local -``` - -### Пример авторизации с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: BVS auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - controller_url: https://dynamix.local - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/7.2.0/модуль-decort_account.md b/wiki/7.2.0/модуль-decort_account.md deleted file mode 100644 index 528e5ce..0000000 --- a/wiki/7.2.0/модуль-decort_account.md +++ /dev/null @@ -1,992 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` diff --git a/wiki/7.2.0/модуль-decort_account_info.md b/wiki/7.2.0/модуль-decort_account_info.md deleted file mode 100644 index ff5563d..0000000 --- a/wiki/7.2.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3805 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/7.2.0/модуль-decort_bservice.md b/wiki/7.2.0/модуль-decort_bservice.md deleted file mode 100644 index 96a66aa..0000000 --- a/wiki/7.2.0/модуль-decort_bservice.md +++ /dev/null @@ -1,82 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice -Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/7.2.0/модуль-decort_disk.md b/wiki/7.2.0/модуль-decort_disk.md deleted file mode 100644 index 2653825..0000000 --- a/wiki/7.2.0/модуль-decort_disk.md +++ /dev/null @@ -1,159 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - -## Параметры модуля decort_disk -Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| description | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/7.2.0/модуль-decort_group.md b/wiki/7.2.0/модуль-decort_group.md deleted file mode 100644 index cc4a638..0000000 --- a/wiki/7.2.0/модуль-decort_group.md +++ /dev/null @@ -1,97 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/7.2.0/модуль-decort_jwt.md b/wiki/7.2.0/модуль-decort_jwt.md deleted file mode 100644 index a38b9f3..0000000 --- a/wiki/7.2.0/модуль-decort_jwt.md +++ /dev/null @@ -1,48 +0,0 @@ -# Модуль decort_jwt -## Обзор модуля -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). - -## Параметры модуля decort_jwt -Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации). - -Отличия от общих параметров: -- Параметр `controller_url` не используется. -- Параметр `jwt` не используется. -- В параметре `authenticator` не используется значение `jwt`. - -## Возвращаемые значения модуля decort_jwt -| Ключ | Тип данных | Описание | -|---| ------ | ------ | -| jwt | str | JWT токен. | - -## Примеры использования -### Пример получения JWT токена с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from DECS3O - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - oauth2_url: https://sso-dynamix.local -``` - -### Пример получения JWT токена с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from BVS - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` diff --git a/wiki/7.2.0/модуль-decort_k8s.md b/wiki/7.2.0/модуль-decort_k8s.md deleted file mode 100644 index d0b0d85..0000000 --- a/wiki/7.2.0/модуль-decort_k8s.md +++ /dev/null @@ -1,114 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| description | (string)
Default: `Created by decort ansible module` | Описание кластера. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет master-узлов. Не поддерживается изменение в существующем кластере.
Значение по умолчанию при создании: `i440fx`. | -| master_count | (int)
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| lb_sysctl | (dict) | Словарь, описывающий параметры конфигурации sysctl балансировщика нагрузки. Может быть задан только если кластер имеет балансировщик нагрузки. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети. -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`
• `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`
• `disk` (int) (необязательный) - объём загрузочного диска на узле; если не задан при создании, размер диска будет равен размеру используемого образа
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`; значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; значение по умолчанию при создании: `1`
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; значение по умолчанию при создании: `1024`
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. | - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| lb_id | int | Идентификатор балансировщика нагрузки. | -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - ram: 1024 - chipset: i440fx - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - ram: 1024 - chipset: Q35 - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/7.2.0/модуль-decort_kvmvm.md b/wiki/7.2.0/модуль-decort_kvmvm.md deleted file mode 100644 index f262cc8..0000000 --- a/wiki/7.2.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,1054 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- **создать** (см. [примеры](#создать)) - - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания)) - - **с указанием объёма загрузочного диска** (см. параметр **boot.disk_size** и [примеры](#с-указанием-объёма-загрузочного-диска)) - - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд)) - - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data)) - - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа)) - - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity)) - - **с указанием запуска на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-ядрах-цп)) - - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages)) - - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields)) - - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки)) - - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил)) - - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил)) - - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов)) - - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом)) - - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа)) - - **с загрузочным диском** (см. параметр **boot.disk_size** и [примеры](#с-загрузочным-диском)) - - **без загрузочного диска** (см. [примеры](#без-загрузочного-диска)) - - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **с указанием чипсета** (см. параметр **chipset** и [примеры](#с-указанием-чипсета)) - - **с указанием предпочтительных ядер** (см. параметр **preferred_cpu_cores** и [примеры](#с-указанием-предпочтительных-ядер)) - - **путём клонирования другой ВМ** (см. параметр **clone_from** и [примеры](#путём-клонирования-другой-вм)) -- **получить основную информацию** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-виртуальной-машине)) -- **получить ссылку на консоль** (см. параметр **get_console_url** и [примеры](#получение-ссылки-на-консоль)) -- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить)) -- **подключить/отключить диски** (см. параметр **disks** и [примеры](#подключитьотключить-диски)) -- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети)) -- **откатить ВМ к состоянию снимка** (см. параметры **rollback_to** и [примеры](#откатить-вм-к-состоянию-снимка)) -- **изменить** (см. [примеры](#изменить)) - - **объём загрузочного диска в большую сторону** (см. параметр **boot.disk_size** и [примеры](#объём-загрузочного-диска-в-большую-сторону)) - - **количество ЦП** (см. параметр **cpu** и [примеры](#количество-цп)) - - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу)) - - **тэги** (см. параметр **tag** и [примеры](#тэги)) - - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку)) - - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила)) - - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила)) - - **описание** (см. параметр **description** и [примеры](#описание)) - - **чипсет** (см. параметр **chipset** и [примеры](#чипсет)) - - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity)) - - **запуск на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#запуск-на-выделенных-ядрах-цп)) - - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages)) - - **имя** (см. параметр **name** и [примеры](#имя)) - - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины)) - - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **предпочтительные ядра** (см. параметр **preferred_cpu_cores** и [примеры](#предпочтительные-ядра)) - - **загрузочный диск** (см. параметр **boot.disk_id** и [примеры](#загрузочный-диск)) -- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно)) - -## Параметры модуля decort_kvmvm -Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.
Если параметр не задан при создании ВМ, то значение будет выбрано платформой. | -| boot | (dict) | Параметры загрузки.
Ключи словаря:
• `disk_id` (int) - идентификатор диска, который будет установлен как загрузочный;
• `disk_size` (int) - объём загрузочного диска виртуальной машины в ГБ. Если параметр не задан, размер будет равен размеру образа. Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет. Значение по умолчанию при создании: `i440fx`.| -| ci_user_data | (dict) | конфигурация для cloud-init -| clone_from | (dict) | Словарь параметров для создания ВМ путём клонирования другой ВМ.
Ключи словаря:
• `id` (int) (обязательный) - идентификатор клонируемой ВМ
• `force` (bool) - игнорировать, что ВМ запущена; значение по умолчанию: `false`
• `snapshot` (dict) - словарь параметров клонируемого снимка ВМ. Ключи словаря: `name` (str) - название снимка; `timestamp` (int) - unix-время; `datetime` (str) - дата и время в формате `ггггммддччммсс`, альтернатива параметру `timestamp`, допустимо использовать любой разделитель между группами цифр для повышения читаемости, например, `гггг-мм-дд чч:мм:сс`.
Для создания клона также должен быть указан параметр `name` для указания имени клона.| -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| cpu_pin | (bool) | Запуск виртуальной машины на выделенных ядрах ЦП.
Значение по умолчанию при создании: `false`. | -| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.
Ключи словаря:
• `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`
• `fields` (dict) - поля для управления XML виртуальной машины. | -| description | (string) | Опциональное описание виртуальной машины. | -| disks | (dict) | Словарь, описывающий диски ВМ.
Ключи словаря:
•`mode` (str) - режим работы параметра; значения: `update` (по умолчанию) - указанные диски подключены, `detach` - указанные диски отключены, `delete` - указанные диски отключены и удалены; удаляются только отключаемые диски, `match` - подключены только указанные диски
•`ids` (list) - список идентификаторов дисков; для отключения всех дисков нужно передать пустой список в режиме match. | -| get_console_url | (bool)
Default:
`false` | Получить ссылку на консоль ВМ. | -| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле.
Значение по умолчанию при создании: `false`. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
Если заданы оба параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`
• `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| numa_affinity | (str)
Значения:
`strict`
`loose`
`none` | Правило применения NUMA affinity к виртуальной машине.
`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity.
Значение по умолчанию при создании: `none`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| preferred_cpu_cores | (list) | Список номеров предпочтительных выделенных ядер ЦП (см. параметр `cpu_pin`). Чтобы очистить список номеров предпочтительных выделенных ядер ЦП, нужно указать пустой список `[]`. | -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| rollback_to | (string) | Имя снимка, к состоянию которого необходимо совершить откат ВМ. | -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`poweredon`
`poweredoff`
`halted`
`paused` | Целевое состояние ВМ.
`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.
`absent` - виртуальная машина безвозвратно удалена.
`poweredon` - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.
`poweredoff` - виртуальная машина остановлена. Если запущена, то будет остановлена.
`halted` - аналогично `poweredoff`.
`paused` - виртуальная машина приостановлена.
Значение по умолчанию при создании: `present`. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - -### Основная информация - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| arch | string | Архитектура ВМ. | -| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. | -| clones | list | Список идентификаторов клонов ВМ. | -| clone_reference | int | Идентификатор ВМ, клоном которой является данная ВМ. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| cpu_pin | bool | Запуск виртуальной машины на выделенных ядрах ЦП. | -| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. | -| disks | list | Список идентификаторов дисков, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| name | string | Имя ВМ. | -| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. | -| password | string | Пароль пользователя ОС по умолчанию. | -| preferred_cpu_cores | list | Список номеров предпочтительных выделенных ядер ЦП. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| snapshots | list | Список словарей, описывающих снимки ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | -| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. | - -### Ссылка на консоль -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| console_url | string | Ссылка на консоль ВМ. | - -## Примеры использования - -### Создать - -#### С указанием описания -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - description: vm description - state: present -``` - -#### С указанием объёма загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - boot: - disk_size: 10 - state: present -``` - -#### С указанием СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - sep_id: "{{ sep_id }}" - pool: "{{ sep_pool_name }}" - state: present -``` - -#### С указанием Cloud-init user data -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ci_user_data: - packages: - - apache2 - write_files: - - content: | -
- Hello World! -
- owner: user:user - path: /var/www/html/index.html - hostname: test-apache - ssh_keys: - - rsa_public: ssh-rsa AAAAOasDmLxnD= user@pc - state: present -``` - -#### С указанием SSH-ключа -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA... - ssh_key_user: user - state: present -``` - -#### С указанием NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - numa_affinity: strict - state: present -``` - -#### С указанием запуска на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - cpu_pin: true - state: present -``` - -#### С использованием Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - hp_backed: true - state: present -``` - -#### С указанием custom_fields -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - custom_fields: - fields: - title: Title - cpu: - mode: custom - vendor: Intel - cache: - mode: disable - topology: - sockets: 1 - cores: 14 - threads: 1 - match: minimum - check: partial - state: present -``` - -#### С указанием affinity-метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity-label - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - affinity_label: label - state: present -``` - -#### С указанием affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aff_rule: - - topology: compute - policy: RECOMMENDED - mode: EQ - key: key - value: value - state: present -``` - -#### С указанием anti-affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aaff_rule: - - topology: node - policy: REQUIRED - mode: ANY - key: key - value: value - state: present -``` - -#### С указанием тэгов -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with tags - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value - state: present -``` - -#### С образом -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - state: present -``` - -#### Без образа - -##### С загрузочным диском -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - boot: - disk_size: 10 - state: present -``` - -##### Без загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and without boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - state: present -``` - -#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - auto_start: true - state: present -``` - -#### С указанием чипсета -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - state: present -``` - -### С указанием предпочтительных ядер -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - state: present -``` - -### Путём клонирования другой ВМ - -#### Без указания снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - force: true -``` - -#### С указанием имени снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - name: snapshot_01 - force: true -``` - -#### С указанием временной метки снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - timestamp: 1739792809 - force: true -``` - -#### С указанием даты создания снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - datetime: 2024-02-17 14:50:22 - force: true -``` - -### Получение основной информации о виртуальной машине - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by ID - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by name - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" -``` - -### Получение ссылки на консоль -``` -- name: Example - hosts: localhost - tasks: - - name: Get VM console URL - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - get_console_url: true -``` - -### Остановить/приостановить/запустить - -#### Остановить -``` -- name: Example - hosts: localhost - tasks: - - name: Stop VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredoff -``` - -#### Запустить -``` -- name: Example - hosts: localhost - tasks: - - name: Start VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: poweredon -``` - -#### Приостановить -``` -- name: Example - hosts: localhost - tasks: - - name: Pause VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: paused -``` - -### Подключить/отключить диски - -#### Подключить -``` -- name: Example - hosts: localhost - tasks: - - name: Connect data disks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - disks: - mode: update - ids: - - "{{ datadisk1_id }}" - - "{{ datadisk2_id }}" -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect data disks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - disks: - mode: match - ids: [] -``` - -### Подключить/отключить сети - -#### Подключить не-DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - state: poweredoff -``` - -#### Подключить не-DPDK сети с соблюдением очередности -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM without network order changing - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - network_order_changing: true - state: poweredoff -``` - -#### Подключить DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect DPDK networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - networks: - - type: DPDK - id: "{{ dpdk1_id }}" - - type: EMPTY - - type: DPDK - id: "{{ dpdk2_id }}" - mtu: 1500 - state: poweredoff -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect networks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: [] - state: poweredoff -``` - -### Откатить ВМ к состоянию снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Rollback VM to snapshot - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - rollback_to: snapshot_01 - state: poweredoff -``` - -### Изменить - -#### Объём загрузочного диска в большую сторону -``` -- name: Example - hosts: localhost - tasks: - - name: Increase boot disk size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - disk_size: 15 - state: poweredoff -``` - -#### Количество ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU amount - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu: 1 - state: poweredoff -``` - -#### Объём ОЗУ -``` -- name: Example - hosts: localhost - tasks: - - name: Change RAM size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - ram: 512 - state: poweredoff -``` - -#### Тэги -``` -- name: Example - hosts: localhost - tasks: - - name: Change tags - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value -``` - -#### Affinity метку -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity label - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - affinity_label: Affinity label 1 -``` - -#### Affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aff_rule: - - topology: compute - policy: REQUIRED - mode: EQ - key: app - value: main - - topology: node - policy: RECOMMENDED - mode: NE - key: state - value: started -``` - -#### Anti-affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aaff_rule: - - topology: compute - policy: REQUIRED - mode: ANY - key: app - value: main -``` - -#### Описание -``` -- name: Example - hosts: localhost - tasks: - - name: Change description - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - description: vm description -``` - -#### Чипсет -``` -- name: Example - hosts: localhost - tasks: - - name: Change chipset - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - chipset: i440fx - state: poweredoff -``` - -#### Правило NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Change NUMA affinity rule - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - numa_affinity: loose - state: poweredoff -``` - -#### Запуск на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU Pinning usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - state: poweredoff -``` - -#### Использование Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Change Huge Pages usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - state: poweredoff -``` - -#### Имя -``` -- name: Example - hosts: localhost - tasks: - - name: Rename VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - name: "{{ new_vm_name }}" -``` - -#### XML виртуальной машины - -##### Изменение -``` -- name: Example - hosts: localhost - tasks: - - name: Change XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - fields: - cpu: - mode: custom - vendor: Intel - cache: - mode: enable - os: - type: - machine: pc-i440fx-artful -``` - -##### Отключение управления ВМ через XML -``` -- name: Example - hosts: localhost - tasks: - - name: Disable XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - disable: true -``` - -#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена - -##### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable auto starting pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: true -``` - -##### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable auto starting of pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: false -``` - -#### Предпочтительные ядра -``` -- name: Example - hosts: localhost - tasks: - - name: Change preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - - 2 - state: poweredoff -``` - -#### Загрузочный диск -``` -- name: Example - hosts: localhost - tasks: - - name: Make the disk bootable - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - disk_id: "{{ vm_disk1_id }}" -``` - -### Удалить - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: absent -``` diff --git a/wiki/7.2.0/модуль-decort_lb.md b/wiki/7.2.0/модуль-decort_lb.md deleted file mode 100644 index 4aec498..0000000 --- a/wiki/7.2.0/модуль-decort_lb.md +++ /dev/null @@ -1,806 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить - - конфигурации backend и frontend - - конфигурацию sysctl -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- description - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- sysctl - - (dict) - - Словарь, описывающий параметры конфигурации sysctl. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
- sysctl - - dict - - Параметры конфигурации sysctl. -
diff --git a/wiki/7.2.0/модуль-decort_osimage.md b/wiki/7.2.0/модуль-decort_osimage.md deleted file mode 100644 index aa2290e..0000000 --- a/wiki/7.2.0/модуль-decort_osimage.md +++ /dev/null @@ -1,137 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - - удалить - -## Параметры модуля decort_osimage -Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| boottype | (string)
Default: `uefi` | Тип загрузки образа. Используется при создании образа.| -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hotresize | (bool)
Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| imagetype | (string)
Default: `linux` | Тип образа. Используется при создании образа.| -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - -Пример удаления образа - -``` - - name: Delete image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_id: 54321 - state: absent -``` diff --git a/wiki/7.2.0/модуль-decort_pfw.md b/wiki/7.2.0/модуль-decort_pfw.md deleted file mode 100644 index 45dd2ad..0000000 --- a/wiki/7.2.0/модуль-decort_pfw.md +++ /dev/null @@ -1,66 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw -Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/7.2.0/модуль-decort_rg.md b/wiki/7.2.0/модуль-decort_rg.md deleted file mode 100644 index 5774c12..0000000 --- a/wiki/7.2.0/модуль-decort_rg.md +++ /dev/null @@ -1,224 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - - изменять описание - -## Параметры модуля decort_rg -Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| description | (string) | Текстовое описание ресурсной группы. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| description | string | Текстовое описание ресурсной группы. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/7.2.0/модуль-decort_snapshot.md b/wiki/7.2.0/модуль-decort_snapshot.md deleted file mode 100644 index 9021585..0000000 --- a/wiki/7.2.0/модуль-decort_snapshot.md +++ /dev/null @@ -1,248 +0,0 @@ -# Модуль decort_snapshot -## Обзор модуля - -Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин: -- **создать** (см. [параметр state](#state) и [примеры](#создать)) -- **удалить** (см. [параметр state](#state) и [примеры](#удалить)) -- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке)) -- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - label - - - (str) - - Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - vm_name_2024-12-10_16-40-52. -
- - state - - - (str) -
Значения: -
absent -
present - 		- Целевое состояние. -
absent - снимок удален. -
present - снимок существует. -
- - usage - - - (bool) -
Default:false - 		- Получить информацию о реальном размере снимка виртуальной машины. -
- - vm_id - - - (int) - - Идентификатор виртуальной машины. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Диски -
- guid - - str - - Идентификатор снимка -
- label - - str - - Метка снимка -
- timestamp - - int - - Временная метка создания снимка -
- vm_id - - int - - Идентификатор виртуальной машины -
- -### Размер снимка - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- stored - - float - - Размер снимка -
- -## Примеры использования - -### Создать - -#### С указанием метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: present -``` - -#### Без указания метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - state: present -``` - -### Удалить -``` -- name: Example - hosts: localhost - tasks: - - name: Delete snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: absent -``` - -### Получить основную информацию о снимке -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic snapshot info - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" -``` - -### Получить информацию о размере снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Get snapshot usage - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - usage: true -``` diff --git a/wiki/7.2.0/модуль-decort_user_info.md b/wiki/7.2.0/модуль-decort_user_info.md deleted file mode 100644 index c463324..0000000 --- a/wiki/7.2.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1338 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- unix - - (int) - - Unix-время. -
- date_time - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру unix. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - unix: 1724668267 - end: - date_time: 2024-08-26_13-40 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/7.2.0/модуль-decort_vins.md b/wiki/7.2.0/модуль-decort_vins.md deleted file mode 100644 index 4c05f25..0000000 --- a/wiki/7.2.0/модуль-decort_vins.md +++ /dev/null @@ -1,110 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins -Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/8.0.0/Home.md b/wiki/8.0.0/Home.md deleted file mode 100644 index 866c022..0000000 --- a/wiki/8.0.0/Home.md +++ /dev/null @@ -1,25 +0,0 @@ -1. [Введение](./введение.md) - - [Введение](./введение.md#введение) - - [Системные требования](./введение.md#системные-требования) - - [Подготовка к работе](./введение.md#подготовка-к-работе) - - [Авторизация](./введение.md#авторизация) - - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации) - - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o) - - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs) - - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token) -2. Ansible модули DECORT: - - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами - - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами - - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками - - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов - - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами - - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями - - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена - - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами - - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы - - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes - - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки - - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте - - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами - - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе - - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины diff --git a/wiki/8.0.0/введение.md b/wiki/8.0.0/введение.md deleted file mode 100644 index af18224..0000000 --- a/wiki/8.0.0/введение.md +++ /dev/null @@ -1,249 +0,0 @@ -# Модули Ansible для управления облачными ресурсами в платформе DECORT -## Введение - -Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology). - -По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования. - -## Системные требования -Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT. -Системные требования для работы модуля: -- Ansible 10.7.0 -- Python 3.10.12 -- requests 2.32.3 Python module -- DynamiX Enterprise 4.3.0 - -## Подготовка к работе - -Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо: -- либо разместить директории **library** и **module_utils** в одной директории с плейбуками -- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например: -``` -[defaults] -library=./library -module_utils=./module_utils -``` - -## Авторизация - -### Общие параметры модулей для авторизации - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- app_id - - (str) - - Идентификатор приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. Если - параметр не задан в playbook, модуль будет использовать значение - переменной окружения DECORT_APP_ID. -
- app_secret - - (str) - - Секретный ключ приложения, использующийся для получения токена в режимах - authenticator: bvs или authenticator: decs3o. - Данный параметр является обязательным для указанных режимов. - Так как он содержит секретную информацию, то его не рекомендуется - задавать непосредственно в playbook. Если параметр не задан в playbook, - то модуль будет использовать значение переменной окружения - DECORT_APP_SECRET. -
- authenticator - - (str) -
Значения: -
bvs -
decs3o -
oauth2 -
jwt -
Default: decs3o - 		- Режим аутентификации для получения токена. - Значение oauth2 является устаревшим и равнозначным - decs3o. -
- controller_url - - (str) - - URL контроллера, соответствующего экземпляру облачной платформы - DECORT. Данный параметр является обязательным. -
- domain - - (str) - - Домен BVS, использующийся для получения токена в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_DOMAIN. -
- jwt - - (str) - - JSON Web Token (JWT), который будет использоваться для подключения - к контроллеру облачной платформы DECORT в режиме - authenticator: jwt. Данный параметр является - обязательным для указанного режима. Так как он содержит - потенциально секретную информацию, а сам JWT, как правило, - имеет ограниченное время жизни, то его не рекомендуется задавать - непосредственно в playbook. Если этот параметр не определен в - playbook, то модуль будет использовать значение переменной - окружения DECORT_JWT. -
- oauth2_url - - (str) - - URL авторизационного сервера, работающего по протоколу Oauth2, - который должен использоваться в режимах - authenticator: bvs - или authenticator: decs3o. Данный параметр является - обязательным для указанных режимов. Если параметр не задан в - playbook, модуль будет использовать значение переменной - окружения DECORT_OAUTH2_URL. -
- password - - (str) - - Пароль пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Так как он содержит секретную - информацию, то его не рекомендуется задавать непосредственно - в playbook. Если параметр не задан в playbook, модуль будет - использовать значение переменной окружения - DECORT_PASSWORD. -
- username - - (str) - - Логин пользователя, который должен использоваться в режиме - authenticator: bvs. Данный параметр является - обязательным для указанного режима. Если параметр не задан в playbook, - модуль будет использовать значение переменной окружения - DECORT_USERNAME. -
- verify_ssl - - (bool) -
Default: true - 		- Позволяет отключить проверку SSL сертификатов при выполнении API - вызовов в адрес контроллера облачной инфраструктуры, например, - при работе с изолированной облачной инфраструктурой, использующей - самоподписанные сертификаты. Применяйте данный параметр с - осторожностью, предпочтительно в защищенных средах. -
- -### Пример авторизации с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: DECS3O auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - controller_url: https://dynamix.local - oauth2_url: https://sso-dynamix.local -``` - -### Пример авторизации с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: BVS auth - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - controller_url: https://dynamix.local - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` - -### Пример авторизации с помощью JSON Web Token - -``` -- name: Example - hosts: localhost - tasks: - - name: Auth with JWT - decort_module_name: - # Специфичные для модулей параметры упущены - # Пример демонстрирует только параметры для авторизации - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ jwt }}" -``` \ No newline at end of file diff --git a/wiki/8.0.0/модуль-decort_account.md b/wiki/8.0.0/модуль-decort_account.md deleted file mode 100644 index 0e2cfbf..0000000 --- a/wiki/8.0.0/модуль-decort_account.md +++ /dev/null @@ -1,1029 +0,0 @@ -# Модуль decort_account -## Обзор модуля - -Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом: -- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину)) -- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно)) -- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины)) -- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить)) -- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа)) -- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать)) -- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты)) -- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам)) -- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд)) -- **изменить описание** (см. [параметр description](#description) и [примеры](#изменить-описание)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - access_emails - - - (bool) - - Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам. -
- - acl - - - (dict) - - Целевые права доступа. -
- mode - - (str) -
Значения: -
match -
revoke -
update -
Default: update - 		- Режим изменения прав доступа для указанных пользователей. -
match - привести в соответствие для указанных - пользователей, удалить предоставленные для других. -
revoke - отозвать для указанных пользователей, - если предоставлены. -
update - привести в соответствие для указанных - пользователей, оставить без изменения предоставленные для - других. -
- users - - (list) - - Список словарей, описывающих права доступа пользователей. -
Обязательный параметр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
Default: R - 		- Права доступа. -
При mode: revoke не используется. -
При mode: match и mode: update - права ARCXDU считаются соответствующими - правам CXDRAU. -
- id - - (str) - - Идентификатор пользователя. -
Обязательный параметр. -
- - description - - - (str) - - Целевое описание -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - name - - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
Если задан совместно с параметром id, - то используется для переименования (целевое имя). -
- - quotas - - - (dict) - - Целевые квоты. -
- cpu - - (int) - - Количество виртуальных процессоров. -
-1 - удалить квоту. -
- disks_size - - (int) - - Объём дисков в ГБ. -
-1 - удалить квоту. -
- ext_traffic - - (int) - - Объём трафика внешних сетей. -
-1 - удалить квоту. -
- gpu - - (int) - - Количество графических процессоров. -
-1 - удалить квоту. -
- public_ip - - (int) - - Количество внешних IP-адресов. -
-1 - удалить квоту. -
- ram - - (int) - - Объём оперативной памяти в МБ. -
-1 - удалить квоту. -
- - sep_pools - - - (list) - - Список словарей, описывающих доступные пулы СХД. -
- sep_id - - (int) - - Идентификатор системы хранения данных. -
- pool_names - - (list) - - Список названий пулов системы хранения данных. -
- - state - - - (str) -
Значения: -
absent -
absent_permanently -
confirmed -
disabled -
present -
Default: present - 		- Целевое состояние. -
absent - удалён в корзину, безвозвратно удалён - или не существует. Если существует и не удалён, то будет удалён - в корзину. -
absent_permanently - безвозвратно удалён или - не существует. Если существует и не удалён или удалён в корзину, - то будет безвозвратно удалён. -
При значениях absent и absent_permanently - использование других параметров модуля, вызывающих изменение объекта, - не допускается. -
confirmed - включён. Если выключен, то будет включён. - Если удалён в корзину, то будет восстановлен из корзины. -
disabled - выключен. Если включён, то будет выключен. - Если удалён в корзину, то будет восстановлен из корзины и выключен. -
present - существует и не удалён. Если удалён в - корзину, то будет восстановлен из корзины. -
- -## Возвращаемые значения - -Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- description - - str - - Описание. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -## Примеры использования - -### Удалить - -#### В корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent -``` - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: absent_permanently -``` - -### Восстановить из корзины -``` -- name: Example - hosts: localhost - tasks: - - name: Restore account from recycle bin - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: present -``` - -### Выключить/включить - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: disabled -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - state: confirmed -``` - -### Изменить права доступа - -#### Отозвать -``` -- name: Example - hosts: localhost - tasks: - - name: Revoke user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: revoke - users: - - id: "{{ user1_id }}" - - id: "{{ user2_id }}" -``` - -#### Обновить -``` -- name: Example - hosts: localhost - tasks: - - name: Update user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: update - users: - - id: "{{ user1_id }}" - rights: R - - id: "{{ user2_id }}" - rights: RCX -``` - -#### Привести в соответствие -``` -- name: Example - hosts: localhost - tasks: - - name: Match user access rights - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - acl: - mode: match - users: - - id: "{{ user1_id }}" - rights: ARCXDU - - id: "{{ user2_id }}" - rights: RCX -``` - -### Переименовать -``` -- name: Example - hosts: localhost - tasks: - - name: Rename account - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - name: "{{ account_new_name }}" -``` - -### Изменить квоты - -#### На объём дисков -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of disks size - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - disks_size: 500 -``` - -#### На количество внешних IP-адресов -``` -- name: Example - hosts: localhost - tasks: - - name: Update account quota of public IP amount - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - quotas: - public_ip: 10 -``` - -### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам - -#### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: false -``` - -#### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable sending access emails - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - access_emails: true -``` - -### Изменить доступные пулы СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Change available sep pools - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - sep_pools: - - sep_id: 1 - pool_names: - - pool1 -``` - -### Изменить описание -``` -- name: Example - hosts: localhost - tasks: - - name: Change description - decort_account: - # Параметры для авторизации упущены - id: "{{ account_id }}" - description: New account description -``` diff --git a/wiki/8.0.0/модуль-decort_account_info.md b/wiki/8.0.0/модуль-decort_account_info.md deleted file mode 100644 index c889bb4..0000000 --- a/wiki/8.0.0/модуль-decort_account_info.md +++ /dev/null @@ -1,3828 +0,0 @@ -# Модуль decort_account_info -## Обзор модуля - -Модуль **decort_account_info** предназначен для получения следующей информации об аккаунте: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-об-аккаунте)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервированных-ресурсах-аккаунта)) -- **ресурсные группы** (см. [параметр resource_groups](#resource_groups), [возвращаемые значения](#ресурсные-группы) и [примеры](#получение-информации-о-ресурсных-группах)) -- **виртуальные машины** (см. [параметр computes](#computes), [возвращаемые значения](#виртуальные-машины) и [примеры](#получение-информации-о-виртуальных-машинах)) -- **внутренние сети** (см. [параметр vinses](#vinses), [возвращаемые значения](#внутренние-сети) и [примеры](#получение-информации-о-внутренних-сетях)) -- **диски** (см. [параметр disks](#disks), [возвращаемые значения](#диски) и [примеры](#получение-информации-о-дисках)) -- **доступные образы** (см. [параметр images](#param_images), [возвращаемые значения](#образы) и [примеры](#получение-информации-об-образах)) -- **группы с плавающим IP-адресом** (см. [параметр flip_groups](#flip_groups), [возвращаемые значения](#группы-с-плавающим-ip-адресом) и [примеры](#получение-информации-о-группах-с-плавающим-ip-адресом)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_account_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - audits - - - (bool) -
Default: false - 		- Получить информацию об аудитах. -
- - computes - - - (dict) - - Получить информацию о виртуальных машинах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- ext_net_name - - (str) - - По имени внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- rg_name - - (str) - - По имени ресурсной группы. -
- tech_status - - (str) -
Значения: -
BACKUP_RUNNING -
BACKUP_STOPPED -
DOWN -
MIGRATING -
PAUSED -
PAUSING -
SCHEDULED -
STARTED -
STARTING -
STOPPED -
STOPPING - 		- По техническому статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
cpus -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
name -
ram -
registered -
rgId -
rgName -
status -
techStatus -
totalDisksSize -
updatedBy -
updatedTime -
userManaged -
vinsConnected - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - disks - - - (dict) - - Получить информацию о неподключённых дисках, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- size - - (int) - - По объёму. -
- type - - (str) -
Значения: -
B -
D - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
id -
name -
pool -
sepId -
shareable -
sizeMax -
type - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - flip_groups - - - (dict) - - Получить информацию о группах с плавающим IP-адресом, к которым имеет - доступ пользователь, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_net_id - - (int) - - По идентификатору внешней сети. -
- id - - (int) - - По идентификатору. -
- ip - - (str) - - По IP-адресу. -
- name - - (str) - - По имени. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vins_name - - (str) - - По имени внутренней сети. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- id - - (int) - - Идентификатор целевого аккаунта. -
Обязательный параметр, если не задан параметр - name. -
- - images - - - (dict) - - Получить информацию об образах, которые доступны к использованию - в аккаунте, с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- type - - (str) -
Значения: -
cdrom -
linux -
other -
virtual -
windows - 		- По типу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
UNCPath -
desc -
id -
name -
public -
size -
status -
type -
username - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- name - - (str) - - Имя целевого аккаунта. -
Может быть альтернативой параметру id, - за исключением случая, когда необходимо получить - информацию о безвозвратно удалённом объекте. -
- - resource_groups - - - (dict) - - Получить информацию о ресурсных группах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CREATED -
DELETED -
DELETING -
DESTROYED -
DESTROYING -
DISABLED -
DISABLING -
ENABLED -
ENABLING -
MODELED -
RESTORING - 		- По статусу. -
- vins_id - - (int) - - По идентификатору внутренней сети. -
- vm_id - - (int) - - По идентификатору виртуальной машины. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdBy -
createdTime -
deletedBy -
deletedTime -
id -
milestones -
name -
status -
updatedBy -
updatedTime -
vinses - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- - vinses - - - (dict) - - Получить информацию о внутренних сетях, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без использования параметров вывода, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- ext_ip - - (str) - - По внешнему IP-адресу. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- rg_id - - (int) - - По идентификатору ресурсной группы. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
computes -
createdBy -
createdTime -
deletedBy -
deletedTime -
externalIP -
extnetId -
freeIPs -
id -
name -
network -
priVnfDevId -
rgId -
rgName -
status -
updatedBy -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_account_info** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- canBeDeleted - - bool - - Может ли быть удалён. -
- right - - str - - Права. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- company - - str - - Название компании. -
- companyurl - - str - - URL компании. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- computes_amount - - dict - - Количество ВМ по состоянию. -
- started - - int - - Количество запущенных ВМ. -
- stopped - - int - - Количество остановленных ВМ. -
- cpu_allocation_parameter - - str - - Режим выделения ЦП. -
- cpu_allocation_ratio - - str - - Коэффициент для режима выделения ЦП. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deactivationTime - - int - - Unix-время выключения. -
- deactivationTime_readable - - str - - Дата и время выключения. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- description - - str - - Описание. -
- displayname - - str - - Отображаемое имя. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resourceLimits - - dict - - Квоты на ресурсы. -
- CU_C - - int - - Количество виртуальных процессоров. -
- CU_D - - int - - Объём диска в ГБ. -
- CU_DM - - int - - Объём дисков в ГБ. -
- CU_I - - int - - Количество внешних IP-адресов. -
- CU_M - - float - - Объём оперативной памяти в МБ. -
- CU_NP - - int - - Объём трафика внешних сетей. -
- gpu_units - - int - - Количество графических процессоров. -
- sendAccessEmails - - bool - - Отправка пользователям на эл. почту уведомлений о предоставлении доступа. -
- status - - str - - Статус. -
- uniqPools - - list - - Список доступных пулов СХД. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vins - - list - - Список идентификаторов внутренних сетей на уровне аккаунта. -
- vinses_amount - - int - - Количество внутренних сетей. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Ресурсные группы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- resource_groups - - list - - Список словарей, описывающих ресурсные группы. -
- Computes - - dict - - Количество ВМ по состоянию. -
- Started - - int - - Количество запущенных ВМ. -
- Stopped - - int - - Количество остановленных ВМ. -
- Resources - - dict - - Используемые и зарезервированные ресурсы. -
- Consumed - - dict - - Используемые ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- Limits - - dict - - Квоты на ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- disksizemax - - int - - Объём диска в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - float - - Объём оперативной памяти в МБ. -
- Reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- description - - str - - Описание. -
- id - - int - - Идентификатор. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinses - - int - - Количество внутренних сетей. -
- -### Виртуальные машины - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- computes - - list - - Список словарей, описывающих виртуальные машины. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- cpus - - int - - Количество виртуальных процессоров. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- ram - - int - - Объём оперативной памяти в МБ. -
- registered - - bool - - Зарегистрирована ли ВМ как используемая. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- techStatus - - str - - Технический статус. -
- totalDisksSize - - int - - Общий объём дисков. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- vinsConnected - - int - - Количество подключенных внутренних сетей. -
- -### Внутренние сети - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- vinses - - list - - Список словарей, описывающих внутренние сети. -
- accountId - - int - - Идентификатор аккаунта. -
- accountName - - str - - Имя аккаунта. -
- computes - - int - - Количество виртуальных машин. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- externalIP - - str - - Внешний IP-адрес. -
- extnetId - - int - - Идентификатор внешней сети. -
- freeIPs - - int - - Количество свободных IP-адресов. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- network - - str - - Адрес сети. -
- priVnfDevId - - int - - Идентификатор виртуального маршрутизатора. -
- rgId - - int - - Идентификатор ресурсной группы. -
- rgName - - str - - Имя ресурсной группы. -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Диски - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Список словарей, описывающих диски. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- pool - - str - - Пул СХД. -
- sepId - - int - - Идентификатор СХД. -
- shareable - - bool - - Общий доступ. -
- sizeMax - - int - - Объём. -
- type - - str - - Тип. -
- -### Образы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- images - - list - - Список словарей, описывающих образы. -
- UNCPath - - str - - Путь к файлу. -
- desc - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- public - - bool - - Общий доступ. -
- size - - int - - Размер в ГБ. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- username - - str - - Имя пользователя. -
- -### Группы с плавающим IP-адресом - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- flip_groups - - list - - Список словарей, описывающих группы с плавающим IP-адресом. -
- clientType - - str - - Тип клиентов. -
- connType - - str - - Тип соединения. -
- createdBy - - str - - Идентификатор пользователя, который создал. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedBy - - str - - Идентификатор пользователя, который удалил. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- desc - - str - - Описание. -
- gid - - int - - Идентификатор ЦОД. -
- id - - int - - Идентификатор. -
- ip - - str - - IP-адрес. -
- milestones - - int - - Количество событий. -
- name - - str - - Имя. -
- netId - - int - - Идентификатор сети. -
- netType - - str - - Тип сети. -
- netmask - - int - - Маска подсети (длина префикса). -
- status - - str - - Статус. -
- updatedBy - - str - - Идентификатор пользователя, который обновил. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- call - - str - - Метод API. -
- responsetime - - float - - Время отклика в секундах. -
- statuscode - - int - - Код ответа. -
- timestamp - - float - - Unix-время. -
- timestamp_readable - - str - - Дата и время. -
- user - - str - - Идентификатор пользователя. -
- -## Примеры использования - -### Получение основной информации об аккаунте - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by ID - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic account info by name - decort_account_info: - # Параметры для авторизации упущены - name: "{{ account_name }}" -``` - -### Получение информации об используемых и зарезервированных ресурсах аккаунта -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource consumption - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_consumption: true -``` - -### Получение информации о ресурсных группах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: {} -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - filter: - status: CREATED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with resource groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - resource_groups: - pagination: - size: 2 -``` - -### Получение информации о виртуальных машинах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - filter: - ip: 192.168.1.2 -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with computes - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - computes: - pagination: - size: 2 -``` - -### Получение информации о внутренних сетях - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: {} -``` - -#### С фильтрацией по идентификатору ресурсной группы -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - filter: - rg_id: "{{ rg_id }}" -``` - -#### С сортировкой по времени создания -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - sorting: - field: createdTime -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with vinses - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - vinses: - pagination: - size: 2 -``` - -### Получение информации о дисках - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - filter: - type: D -``` - -#### С сортировкой по объёму -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - sorting: - field: sizeMax -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with disks - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - disks: - pagination: - size: 2 -``` - -### Получение информации об образах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: {} -``` - -#### С фильтрацией по типу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - filter: - type: linux -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - sorting: - field: status -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with images - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - images: - pagination: - size: 2 -``` - -### Получение информации о группах с плавающим IP-адресом - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: {} -``` - -#### С фильтрацией по IP-адресу -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - filter: - ip: 192.168.1.5 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with flip groups - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - flip_groups: - pagination: - size: 2 -``` - -### Получение информации об аудитах -``` -- name: Example - hosts: localhost - tasks: - - name: Get account info with audits - decort_account_info: - # Параметры для авторизации упущены - id: "{{ account_id }}" - audits: true -``` diff --git a/wiki/8.0.0/модуль-decort_bservice.md b/wiki/8.0.0/модуль-decort_bservice.md deleted file mode 100644 index 96a66aa..0000000 --- a/wiki/8.0.0/модуль-decort_bservice.md +++ /dev/null @@ -1,82 +0,0 @@ -# Модуль decort_bservice - -## Обзор модуля decort_bservice - -Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое. - -Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными. - -Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents"). - -На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. - -`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.` - -Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов. -Данный модуль позволяет: -- Создавать Basic Service -- Удалять Basic Service (безвозвратно). -- Включать/выключать Basic Service -- Запускать Basic Service -- Запрашивать информацию о Basic Service. - - -## Параметры модуля decort_bservice -Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`.
Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.| -| started | (bool)
Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. | -| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. | -| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. | -| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. | -| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. | -| rg_name | (string) | Имя ресурсной группы базовой службы. | - -## Возвращаемые значения модуля decort_bservice - -Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -|id | int | Уникальный целочисленный идентификатор базовой службы.| -|name | string | Имя базовой службы.| -| techStatus | string | Технический статус базовой службы. | -|state | string | Статус базовой службы.| -| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.| -| groups | list | Список словарей с информацией о группах базовой службы.| - - -## Пример использования модуля decort_bservice - -Данный пример создаёт базовую службу с именем databases. - -``` - - name: Create Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` - -Данный пример удаляет базовую службу с названием databases. -``` - - name: Delete Basic Service - decort_bservice: - authenticator: jwt - controller_url: "{{ controller_url }}" - jwt: "{{ auth_token }}" - state: absent - name: databases - rg_id: "{{ rg_id }}" - register: db_bservice -``` \ No newline at end of file diff --git a/wiki/8.0.0/модуль-decort_disk.md b/wiki/8.0.0/модуль-decort_disk.md deleted file mode 100644 index cc72812..0000000 --- a/wiki/8.0.0/модуль-decort_disk.md +++ /dev/null @@ -1,161 +0,0 @@ -# Модуль decort_disk -## Обзор модуля decort_disk - -Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия: -- создавать -- удалять (в корзину или безвозвратно) -- восстановливать из корзины -- изменять: - - имя - - размер - - лимиты ввода/вывода - - включать/отключать общий доступ - -## Параметры модуля decort_disk -Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| description | (string)
Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.| -|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.| -| iops | (int)
Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. | -| force_detach | (bool)
Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.
По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. | -| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду. Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. | -| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.| -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. | -| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.| -| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. | -| reason | (string)
Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. | -| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.| -| shareable | (bool)
Default: `false` | Включение/отключение общего доступа к диску. -| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.| -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние диска. | - -## Возвращаемые значения модуля decort_disk - -Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.| -| computes | dict | Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.| -| gid | int | Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.| -| id | int | Уникальный целочисленный идентификатор данного диска.| -| iotune | dict | Текущие ограничения ввода/вывода диска. | -| name | string | Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.| -| pool | string | Имя пула на системе хранения данных, в котором размещаются ресурсы диска.| -|sep_id | int | Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.| -| size | int | Размер диска в ГБ.| -| size_available | float | Размер незанятого пространства в ГБ.| -| size_used | float | Размер используемого пространства в ГБ.| -| state | string | Текущий статус диска. | - - -## Пример использования модуля decort_disk - -В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - size: 50 - account_name: "MyAccount" - sep_id: 1 - iops: 2000 - description: "Disk example" - pool: data01 - register: my_data_disk01 -``` -В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - read_bytes_sec: 10000 - write_bytes_sec: 5000 - read_iops_sec и write_iops_sec - read_iops_sec: 2500 - write_iops_sec: 1000 - read_bytes_sec_max: 11000 - write_bytes_sec_max: 6000 - read_iops_sec_max: 3000 - write_iops_sec_max: 1500 - size_iops_sec: 1000 - register: my_data_disk01 - -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - name: "DataDisk01" - account_name: "MyAccount" - limitIO: - total_bytes_sec: 15000 - total_iops_sec: 3500 - total_bytes_sec_max: 17000 - total_iops_sec_max: 4500 - size_iops_sec: 1000 - register: my_data_disk01 -``` - -В данном примере выполняется восстановление удаленного диска с id 111 из корзины. - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - size: 10 - register: my_data_disk01 -``` - -В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk". - -``` -- name: Manage disk - decort_disk: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - id: 111 - name: "NewExampleDisk" - size: 10 - register: my_data_disk01 -``` - -Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией: - -``` -- name: Manage compute - decort_kvmvm: - << для краткости фрагмент опущен >> - data_disks: - - "{{ my_data_disk01.facts.id }}" - << для краткости фрагмент опущен >> -``` \ No newline at end of file diff --git a/wiki/8.0.0/модуль-decort_group.md b/wiki/8.0.0/модуль-decort_group.md deleted file mode 100644 index 57bcb84..0000000 --- a/wiki/8.0.0/модуль-decort_group.md +++ /dev/null @@ -1,100 +0,0 @@ -# Модуль decort_group -## Обзор модуля decort_group -Модуль **decort_group** позволяет производить следующие действия над группами базовой службы: -- создать -- получить информацию -- запустить/остановить -- подключить/отключить сети (для существующей группы только внутренние сети) -- изменить - - имя - - объём загрузочного диска - - количество ВМ - - роль - - количество виртуальных процессоров - - объём ОЗУ - - чипсет -- удалить (безвозвратно) - -## Параметры модуля decort_group -Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| boot_disk | (int) | Обьём загрузочного диска. | -| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет.
Значение по умолчанию при создании: `i440fx`. | -| count | (int) | Количество виртуальных машин. | -| cpu | (int) | Количество виртуальных процессоров. | -| driver | (string)
Значения:
`KVM_X86`
`SVA_KVM_X86`
Default: `KVM_X86` | Драйвер. | -| id | (int) | Идентификатор группы. | -| image_id | (int) | Идентификатор образа. | -| name | (str) | Имя группы.
Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. | -| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)
• `id` (int) (обязательный) - идентификатор сети | -| ram | (int) | Объём оперативной памяти. | -| role | (string) | Тег роли. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`check`
Default: `present` | -| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. | - -## Возвращаемые значения модуля decort_group - -Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.
Ключи словаря:
• `chipset` (str) - эмулируемый чипсет
• `id` (int) - идентификатор ВМ
• `ipAddresses` (list) - список IP-адресов ВМ
• `name` (str) - имя ВМ
• `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) | -| id | int | Идентификатор группы.| -| name | string | Имя группы.| -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Состояние группы. | -| techStatus | string | Технический статус группы. | - -## Пример использования модуля decort_group - -Данный пример создаёт группу с именем `test_group`. -``` -- hosts: localhost - tasks: - - name: Create BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - boot_disk: 10 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - count: 2 - cpu: 2 - image_id: 518 - name: test_group - networks: - - type: VINS - id: 1987 - oauth2_url: "https://sso.digitalenergy.online" - ram: 2 - verify_ssl: false - chipset: Q35 - register: group_test -``` - -Данный пример удаляет группу с именем `test_group`. - -``` -- hosts: localhost - tasks: - - name: Delete BS group - decort_group: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - bservice_id: 1823 - controller_url: "https://ds1.digitalenergy.online" - name: test_group - oauth2_url: "https://sso.digitalenergy.online" - state: absent - verify_ssl: False - register: group_test -``` \ No newline at end of file diff --git a/wiki/8.0.0/модуль-decort_jwt.md b/wiki/8.0.0/модуль-decort_jwt.md deleted file mode 100644 index a38b9f3..0000000 --- a/wiki/8.0.0/модуль-decort_jwt.md +++ /dev/null @@ -1,48 +0,0 @@ -# Модуль decort_jwt -## Обзор модуля -Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена. - -По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`). - -## Параметры модуля decort_jwt -Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации). - -Отличия от общих параметров: -- Параметр `controller_url` не используется. -- Параметр `jwt` не используется. -- В параметре `authenticator` не используется значение `jwt`. - -## Возвращаемые значения модуля decort_jwt -| Ключ | Тип данных | Описание | -|---| ------ | ------ | -| jwt | str | JWT токен. | - -## Примеры использования -### Пример получения JWT токена с помощью DECS3O -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from DECS3O - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: decs3o - oauth2_url: https://sso-dynamix.local -``` - -### Пример получения JWT токена с помощью BVS -``` -- name: Example - hosts: localhost - tasks: - - name: Obtain JWT from BVS - decort_jwt: - app_id: "{{ app_id }}" - app_secret: "{{ app_secret }}" - authenticator: bvs - oauth2_url: https://bvs.local - domain: dynamix - username: "{{ username }}" - password: "{{ password }}" -``` diff --git a/wiki/8.0.0/модуль-decort_k8s.md b/wiki/8.0.0/модуль-decort_k8s.md deleted file mode 100644 index b7db22f..0000000 --- a/wiki/8.0.0/модуль-decort_k8s.md +++ /dev/null @@ -1,115 +0,0 @@ -# Модуль decort_k8s -## Обзор модуля decort_k8s - -Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes: -- создать -- получить информацию -- отключить/включить/запустить -- изменить группы Worker-узлов -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_k8s -Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Идентификатор аккаунта. | -| account_name | (string) | Имя аккаунта. | -| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена. -| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. | -| description | (string) | Целевое описание. | -| extnet_id | (int)
Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). | -| extnet_only | (bool)
Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. | -| getConfig | (bool)
Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. | -| ha_lb | (bool)
Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). | -| id | (int) | Идентификатор кластера Kubernetes. | -| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации. -| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. | -| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. | -| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. | -| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. | -| master_chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет master-узлов. Не поддерживается изменение в существующем кластере.
Значение по умолчанию при создании: `i440fx`. | -| master_count | (int)
Значения:
`1`
`3`
`5`
`7`
Default: `1` | Количество Master-узлов. | -| master_cpu | (int)
Default: `2` | Количество виртуальных процессоров на Master-узле. | -| master_disk | (int)
Default: `10` | Объём загрузочного диска на Master-узле. | -| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. | -| master_ram | (int)
Default: `2048` | Объём оперативной памяти на Master-узле. | -| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. | -| name | (string) | Имя кластера Kubernetes. | -| network_plugin | (str)
Значения:
`flannel`
`calico`
`weavenet`
Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) | -| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера. -| permanent | (bool)
Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). | -| rg_id | (int) | Идентификатор ресурсной группы. | -| rg_name | (str) | Имя ресурсной группы. | -| started | (bool)
Default: `true` | Запустить кластер.
Используется только для существующего кластера. | -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
`check`
Default: `present` | Целевое состояние кластера. | -| lb_sysctl | (dict) | Словарь, описывающий параметры конфигурации sysctl балансировщика нагрузки. Может быть задан только если кластер имеет балансировщик нагрузки. | -| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется. -| with_lb | (bool)
Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. | -| workers | (list) | Список словарей, описывающих группы Worker-узлов.
Ключи словаря:
• `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`
• `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`
• `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`
• `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`
• `disk` (int) (необязательный) - объём загрузочного диска на узле; если не задан при создании, размер диска будет равен размеру используемого образа
• `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`; значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими
• `name` (string) (обязательный) - имя группы Worker-узлов
• `num` (int) (необязательный) - количество узлов; значение по умолчанию при создании: `1`
• `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой
• `ram` (int) (необязательный) - объём оперативной памяти на узле; значение по умолчанию при создании: `1024`
• `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла
• `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. | - -## Возвращаемые значения модуля decort_k8s - -Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| config | str | Kuber config кластера. -| description | str | Описание. | -| id | int | Идентификатор кластера. | -| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти -| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.
Ключи словаря:
• `cpu` (int) - количество виртуальных процессоров
• `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ
• `disk` (int) - объём загрузочного диска
• `id` (int) - идентификатор группы
• `labels` (list) - список строк с labels
• `name` (str) - имя группы
• `num` (int) - количество узлов
• `ram` (int) - объём оперативной памяти
• `taints` (list) - список строк с taints -| lb_id | int | Идентификатор балансировщика нагрузки. | -| name | string | Имя кластера. | -| rg_id | int | Идентификатор ресурсной группы. | -| state | string | Статус кластера. | -| techStatus | string | Технический статус кластера. | -| vins_id | int | Идентификатор внутренней сети кластера. | - - -## Пример использования модуля decort_k8s - - -Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config. -``` - - name: Create a k8s cluster named cluster-test - decort_k8s: - authenticator: jwt - controller_url: "https://ds1.digitalenergy.online" - getConfig: true - jwt: "{{ token.jwt }}" - k8ci_id: 18 - name: cluster-test - rg_id: 125 - workers: - - cpu: 10 - disk: 10 - name: wg1 - num: 1 - ram: 1024 - chipset: i440fx - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - - cpu: 10 - disk: 10 - name: wg2 - num: 2 - ram: 1024 - chipset: Q35 - ci_user_data: {} - taints: - - key=value:NoSchedule - annotations: - - key=value - labels: - - label=value - register: k8s_cluster -``` \ No newline at end of file diff --git a/wiki/8.0.0/модуль-decort_kvmvm.md b/wiki/8.0.0/модуль-decort_kvmvm.md deleted file mode 100644 index 726fa26..0000000 --- a/wiki/8.0.0/модуль-decort_kvmvm.md +++ /dev/null @@ -1,1202 +0,0 @@ -# Модуль decort_kvmvm -## Обзор модуля decort_kvmvm - -Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами: -- **создать** (см. [примеры](#создать)) - - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания)) - - **с указанием объёма загрузочного диска** (см. параметр **boot.disk_size** и [примеры](#с-указанием-объёма-загрузочного-диска)) - - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд)) - - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data)) - - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа)) - - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity)) - - **с указанием запуска на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-ядрах-цп)) - - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages)) - - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields)) - - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки)) - - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил)) - - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил)) - - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов)) - - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом)) - - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа)) - - **с загрузочным диском** (см. параметр **boot.disk_size** и [примеры](#с-загрузочным-диском)) - - **без загрузочного диска** (см. [примеры](#без-загрузочного-диска)) - - **с указанием режима загрузки** (см. параметр **boot.mode** и [примеры](#с-указанием-режима-загрузки)) - - **с указанием типа загрузчика ОС** (см. параметр **boot.loader_type** и [примеры](#с-указанием-типа-загрузчика-ос)) - - **с указанием именования сетевых интерфейсов** (см. параметр **network_interface_naming** и [примеры](#с-указанием-именования-сетевых-интерфейсов)) - - **с поддержкой изменения объема ОЗУ и количества ЦП у запущенной ВМ** (см. параметр **hot_resize** и [примеры](#с-поддержкой-изменения-объема-озу-и-количества-цп-у-запущенной-вм)) - - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **с указанием чипсета** (см. параметр **chipset** и [примеры](#с-указанием-чипсета)) - - **с указанием предпочтительных ядер** (см. параметр **preferred_cpu_cores** и [примеры](#с-указанием-предпочтительных-ядер)) - - **путём клонирования другой ВМ** (см. параметр **clone_from** и [примеры](#путём-клонирования-другой-вм)) -- **получить основную информацию** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-виртуальной-машине)) -- **получить ссылку на консоль** (см. параметр **get_console_url** и [примеры](#получение-ссылки-на-консоль)) -- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить)) -- **подключить/отключить диски** (см. параметр **disks** и [примеры](#подключитьотключить-диски)) -- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети)) -- **откатить ВМ к состоянию снимка** (см. параметры **rollback_to** и [примеры](#откатить-вм-к-состоянию-снимка)) -- **изменить** (см. [примеры](#изменить)) - - **объём загрузочного диска в большую сторону** (см. параметр **boot.disk_size** и [примеры](#объём-загрузочного-диска-в-большую-сторону)) - - **количество ЦП** (см. параметр **cpu** и [примеры](#количество-цп)) - - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу)) - - **тэги** (см. параметр **tag** и [примеры](#тэги)) - - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку)) - - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила)) - - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила)) - - **описание** (см. параметр **description** и [примеры](#описание)) - - **чипсет** (см. параметр **chipset** и [примеры](#чипсет)) - - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity)) - - **запуск на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#запуск-на-выделенных-ядрах-цп)) - - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages)) - - **имя** (см. параметр **name** и [примеры](#имя)) - - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины)) - - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена)) - - **предпочтительные ядра** (см. параметр **preferred_cpu_cores** и [примеры](#предпочтительные-ядра)) - - **загрузочный диск** (см. параметр **boot.disk_id** и [примеры](#загрузочный-диск)) - - **режим загрузки** (см. параметр **boot.mode** и [примеры](#режим-загрузки)) - - **тип загрузчика ОС** (см. параметр **boot.loader_type** и [примеры](#тип-загрузчика-ос)) - - **именование сетевых интерфейсов** (см. параметр **network_interface_naming** и [примеры](#именование-сетевых-интерфейсов)) - - **поддержку изменения объема ОЗУ и количества ЦП у запущенной ВМ** (см. параметр **hot_resize** и [примеры](#поддержку-изменения-объема-озу-и-количества-цп-у-запущенной-вм)) - - **MAC-адрес сетевого интерфейса** (см. параметр **networks.mac** и [примеры](#mac-адрес-сетевого-интерфейса)) -- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно)) - -## Параметры модуля decort_kvmvm -Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. | -| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. | -| aff_rule | (list) | Список словарей, описывающих affinity правила.
Ключи словаря:
• `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)
• `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`
• `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)
• `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила
• `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).
Чтобы очистить affinity правила, нужно указать пустой список `[]`. | -| affinity_label | (str) | Метка affinity.
Чтобы очистить метку affinity, нужно указать пустую строку `""`. | -| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.
Если параметр не задан при создании ВМ, то значение будет выбрано платформой. | -| boot | (dict) | Параметры загрузки.
Ключи словаря:
• `disk_id` (int) - идентификатор диска, который будет установлен как загрузочный;
• `disk_size` (int) - объём загрузочного диска виртуальной машины в ГБ. Если параметр не задан, размер будет равен размеру образа. Если не заданы этот параметр и параметры `image_id` и `image_name`, то виртуальная машина будет создана без загрузочного диска;
• `mode` (str) - режим загрузки, значения: `bios`, `uefi`, значение по умолчанию при создании: `bios`;
• `loader_type` (str) - тип загрузчика операционной системы, значения: `linux`, `windows`, `unknown`, значение по умолчанию при создании: `unknown`. | -| chipset | (string)
Значения:
`Q35`
`i440fx` | Эмулируемый чипсет. Значение по умолчанию при создании: `i440fx`.| -| ci_user_data | (dict) | конфигурация для cloud-init -| clone_from | (dict) | Словарь параметров для создания ВМ путём клонирования другой ВМ.
Ключи словаря:
• `id` (int) (обязательный) - идентификатор клонируемой ВМ
• `force` (bool) - игнорировать, что ВМ запущена; значение по умолчанию: `false`
• `snapshot` (dict) - словарь параметров клонируемого снимка ВМ. Ключи словаря: `name` (str) - название снимка; `timestamp` (int) - unix-время; `datetime` (str) - дата и время в формате `ггггммддччммсс`, альтернатива параметру `timestamp`, допустимо использовать любой разделитель между группами цифр для повышения читаемости, например, `гггг-мм-дд чч:мм:сс`.
Для создания клона также должен быть указан параметр `name` для указания имени клона.| -| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. | -| cpu_pin | (bool) | Запуск виртуальной машины на выделенных ядрах ЦП.
Значение по умолчанию при создании: `false`. | -| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.
Ключи словаря:
• `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`
• `fields` (dict) - поля для управления XML виртуальной машины. | -| description | (string) | Опциональное описание виртуальной машины. | -| disks | (dict) | Словарь, описывающий диски ВМ.
Ключи словаря:
•`mode` (str) - режим работы параметра; значения: `update` (по умолчанию) - указанные диски подключены, `detach` - указанные диски отключены, `delete` - указанные диски отключены и удалены; удаляются только отключаемые диски, `match` - подключены только указанные диски
•`ids` (list) - список идентификаторов дисков; для отключения всех дисков нужно передать пустой список в режиме match. | -| get_console_url | (bool)
Default:
`false` | Получить ссылку на консоль ВМ. | -| hot_resize | (bool) | Поддержка изменения объёма ОЗУ и количества процессоров у запущенной ВМ.
Значение по умолчанию при создании: `false`. | -| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле.
Значение по умолчанию при создании: `false`. | -| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. | -| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину.
Если заданы оба параметра (`image_id` и `image_name`), то `image_name` игнорируется.
Если этот параметр и параметр `image_name` не заданы, то виртуальная машина будет создана без образа. | -| image_name | (string) | Название образа, на базе которого следует создать ВМ.
Если этот параметр и параметр `image_id` не заданы, то виртуальная машина будет создана без образа. | -| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` используется для переименования. | -| network_interface_naming | (string)
Значения:
`ens`
`eth`| Шаблон именования сетевых интерфейсов в ОС Linux.
Значение по умолчанию при создании: `ens`. | -| network_order_changing | (bool)
Default:
`false` | Соблюдение очерёдности сетей при их изменении.
Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится с учётом очерёдности сетей и, при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ, а затем подключение сетей в соответствии с параметром `networks`.
Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. | -| networks | (list) | Список словарей, описывающих сети ВМ.
Ключи словаря:
• `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)
• `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций
• `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`
• `mac` (str) (необязательный) - MAC-адрес сетевого интерфейса; не применим для сети типа `EMPTY`
• `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.
ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.
Чтобы отключить все сети, нужно указать пустой список `[]`. | -| numa_affinity | (str)
Значения:
`strict`
`loose`
`none` | Правило применения NUMA affinity к виртуальной машине.
`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity.
Значение по умолчанию при создании: `none`. | -| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой. -| preferred_cpu_cores | (list) | Список номеров предпочтительных выделенных ядер ЦП (см. параметр `cpu_pin`). Чтобы очистить список номеров предпочтительных выделенных ядер ЦП, нужно указать пустой список `[]`. | -| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. | -| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).| -| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.| -| rollback_to | (string) | Имя снимка, к состоянию которого необходимо совершить откат ВМ. | -| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа. -| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. | -| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. | -| state | (str)
Значения:
`present`
`absent`
`started`
`stopped`
`paused` | Целевое состояние ВМ.
`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.
`absent` - виртуальная машина безвозвратно удалена.
`started` - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.
`stopped` - виртуальная машина остановлена. Если запущена, то будет остановлена.
`paused` - виртуальная машина приостановлена.
Значение по умолчанию при создании: `present`. | -| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.
Чтобы очистить теги, нужно указать пустой словарь `{}`.| - -## Возвращаемые значения модуля decort_kvmvm - -Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами: - -### Основная информация - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| account_id | int | Идентификатор аккаунта. | -| affinity_label | string | Метка affinity. | -| affinity_rules | list | Список словарей, описывающих affinity правила. | -| anti_affinity_rules | list | Список словарей, описывающих anti-affinity правила. | -| arch | string | Архитектура ВМ. | -| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. | -| boot_mode | string | Режим загрузки. | -| clones | list | Список идентификаторов клонов ВМ. | -| clone_reference | int | Идентификатор ВМ, клоном которой является данная ВМ. | -| chipset | string | Эмулируемый чипсет. | -| cpu | int | Количество виртуальных процессоров. | -| cpu_pin | bool | Запуск виртуальной машины на выделенных ядрах ЦП. | -| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. | -| disks | list | Список идентификаторов дисков, подключенных к ВМ. | -| disk_size | int | Размер загрузочного диска в ГБ. | -| hot_resize | bool | Поддержка изменения объёма ОЗУ и количества процессоров у запущенной ВМ. | -| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. | -| id | int | Идентификатор ВМ. | -| image_id | id | Идентификатор образа. -| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ, отсортированный по номеру слота PCI. | -| boot_loader_type | string | Тип загрузчика операционной системы. | -| name | string | Имя ВМ. | -| network_interface_naming | string | Шаблон именования сетевых интерфейсов в ОС Linux. | -| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. | -| password | string | Пароль пользователя ОС по умолчанию. | -| pinned_to_stack | bool | ВМ привязана к вычислительному узлу. | -| preferred_cpu_cores | list | Список номеров предпочтительных выделенных ядер ЦП. | -| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. | -| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. | -| ram | int | Объём ОЗУ ВМ в МБ. | -| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. | -| snapshots | list | Список словарей, описывающих снимки ВМ. | -| state | string | Состояние ВМ.| -| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ. -| tech_status | str | Технический статус ВМ. -| username | string | Имя пользователя ОС по умолчанию. | -| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. | - -### Ссылка на консоль -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| console_url | string | Ссылка на консоль ВМ. | - -## Примеры использования - -### Создать - -#### С указанием описания -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - description: vm description - state: present -``` - -#### С указанием объёма загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - boot: - disk_size: 10 - state: present -``` - -#### С указанием СХД -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - sep_id: "{{ sep_id }}" - pool: "{{ sep_pool_name }}" - state: present -``` - -#### С указанием Cloud-init user data -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ci_user_data: - packages: - - apache2 - write_files: - - content: | -
- Hello World! -
- owner: user:user - path: /var/www/html/index.html - hostname: test-apache - ssh_keys: - - rsa_public: ssh-rsa AAAAOasDmLxnD= user@pc - state: present -``` - -#### С указанием SSH-ключа -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA... - ssh_key_user: user - state: present -``` - -#### С указанием NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - numa_affinity: strict - state: present -``` - -#### С указанием запуска на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - cpu_pin: true - state: present -``` - -#### С использованием Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - hp_backed: true - state: present -``` - -#### С указанием custom_fields -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - custom_fields: - fields: - title: Title - cpu: - mode: custom - vendor: Intel - cache: - mode: disable - topology: - sockets: 1 - cores: 14 - threads: 1 - match: minimum - check: partial - state: present -``` - -#### С указанием affinity-метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity-label - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - affinity_label: label - state: present -``` - -#### С указанием affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aff_rule: - - topology: compute - policy: RECOMMENDED - mode: EQ - key: key - value: value - state: present -``` - -#### С указанием anti-affinity правил -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - aaff_rule: - - topology: node - policy: REQUIRED - mode: ANY - key: key - value: value - state: present -``` - -#### С указанием тэгов -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with tags - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value - state: present -``` - -#### С образом -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with image - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - image_id: "{{ image_id }}" - state: present -``` - -#### Без образа - -##### С загрузочным диском -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - boot: - disk_size: 10 - state: present -``` - -##### Без загрузочного диска -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and without boot disk - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - state: present -``` - -##### С указанием режима загрузки -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with boot mode - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - boot: - mode: bios -``` - -##### С указанием типа загрузчика ОС -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with loader type - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - boot: - loader_type: linux -``` - -##### С указанием именования сетевых интерфейсов -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with network interface naming - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - network_interface_naming: ens -``` - -##### С поддержкой изменения объема ОЗУ и количества ЦП у запущенной ВМ -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM without image and with hot resize - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - hot_resize: true -``` - -#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - auto_start: true - state: present -``` - -#### С указанием чипсета -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - chipset: Q35 - state: present -``` - -### С указанием предпочтительных ядер -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM with preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" - cpu: 1 - ram: 512 - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - state: present -``` - -### Путём клонирования другой ВМ - -#### Без указания снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - force: true -``` - -#### С указанием имени снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - name: snapshot_01 - force: true -``` - -#### С указанием временной метки снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - timestamp: 1739792809 - force: true -``` - -#### С указанием даты создания снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Create VM clone - decort_kvmvm: - # Параметры для авторизации упущены - name: vm_clone - clone_from: - id: "{{ vm_id }}" - snapshot: - datetime: 2024-02-17 14:50:22 - force: true -``` - -### Получение основной информации о виртуальной машине - -#### По идентификатору -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by ID - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" -``` - -#### По имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic VM info by name - decort_kvmvm: - # Параметры для авторизации упущены - rg_id: "{{ rg_id }}" - name: "{{ vm_name }}" -``` - -### Получение ссылки на консоль -``` -- name: Example - hosts: localhost - tasks: - - name: Get VM console URL - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - get_console_url: true -``` - -### Остановить/приостановить/запустить - -#### Остановить -``` -- name: Example - hosts: localhost - tasks: - - name: Stop VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: stopped -``` - -#### Запустить -``` -- name: Example - hosts: localhost - tasks: - - name: Start VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: started -``` - -#### Приостановить -``` -- name: Example - hosts: localhost - tasks: - - name: Pause VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: paused -``` - -### Подключить/отключить диски - -#### Подключить -``` -- name: Example - hosts: localhost - tasks: - - name: Connect data disks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - disks: - mode: update - ids: - - "{{ datadisk1_id }}" - - "{{ datadisk2_id }}" -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect data disks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - disks: - mode: match - ids: [] -``` - -### Подключить/отключить сети - -#### Подключить не-DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - mac: "00:11:22:33:44:55" - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - state: stopped -``` - -#### Подключить не-DPDK сети с соблюдением очередности -``` -- name: Example - hosts: localhost - tasks: - - name: Connect networks to VM without network order changing - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - ip_addr: 192.168.4.0 - mac: "00:11:22:33:44:55" - - type: EMPTY - - type: EXTNET - id: "{{ extnet_id }}" - ip_addr: 35.21.230.0 - - type: VFNIC - id: "{{ vfpool_id }}" - network_order_changing: true - state: stopped -``` - -#### Подключить DPDK сети -``` -- name: Example - hosts: localhost - tasks: - - name: Connect DPDK networks to VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - networks: - - type: DPDK - id: "{{ dpdk1_id }}" - - type: EMPTY - - type: DPDK - id: "{{ dpdk2_id }}" - mtu: 1500 - state: stopped -``` - -#### Отключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disconnect networks from VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: [] - state: stopped -``` - -### Откатить ВМ к состоянию снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Rollback VM to snapshot - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - rollback_to: snapshot_01 - state: stopped -``` - -### Изменить - -#### Объём загрузочного диска в большую сторону -``` -- name: Example - hosts: localhost - tasks: - - name: Increase boot disk size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - disk_size: 15 - state: stopped -``` - -#### Количество ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU amount - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu: 1 - state: stopped -``` - -#### Объём ОЗУ -``` -- name: Example - hosts: localhost - tasks: - - name: Change RAM size - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - ram: 512 - state: stopped -``` - -#### Тэги -``` -- name: Example - hosts: localhost - tasks: - - name: Change tags - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - tag: - tag1_key: tag1_value - tag2_key: tag2_value -``` - -#### Affinity метку -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity label - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - affinity_label: Affinity label 1 -``` - -#### Affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aff_rule: - - topology: compute - policy: REQUIRED - mode: EQ - key: app - value: main - - topology: node - policy: RECOMMENDED - mode: NE - key: state - value: started -``` - -#### Anti-affinity правила -``` -- name: Example - hosts: localhost - tasks: - - name: Change anti-affinity rules - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - aaff_rule: - - topology: compute - policy: REQUIRED - mode: ANY - key: app - value: main -``` - -#### Описание -``` -- name: Example - hosts: localhost - tasks: - - name: Change description - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - description: vm description -``` - -#### Чипсет -``` -- name: Example - hosts: localhost - tasks: - - name: Change chipset - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - chipset: i440fx - state: stopped -``` - -#### Правило NUMA Affinity -``` -- name: Example - hosts: localhost - tasks: - - name: Change NUMA affinity rule - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - numa_affinity: loose - state: stopped -``` - -#### Запуск на выделенных ядрах ЦП -``` -- name: Example - hosts: localhost - tasks: - - name: Change CPU Pinning usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - state: stopped -``` - -#### Использование Huge Pages -``` -- name: Example - hosts: localhost - tasks: - - name: Change Huge Pages usage - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hp_backed: true - state: stopped -``` - -#### Имя -``` -- name: Example - hosts: localhost - tasks: - - name: Rename VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - name: "{{ new_vm_name }}" -``` - -#### XML виртуальной машины - -##### Изменение -``` -- name: Example - hosts: localhost - tasks: - - name: Change XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - fields: - cpu: - mode: custom - vendor: Intel - cache: - mode: enable - os: - type: - machine: pc-i440fx-artful -``` - -##### Отключение управления ВМ через XML -``` -- name: Example - hosts: localhost - tasks: - - name: Disable XML management - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - custom_fields: - disable: true -``` - -#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена - -##### Включить -``` -- name: Example - hosts: localhost - tasks: - - name: Enable auto starting pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: true -``` - -##### Выключить -``` -- name: Example - hosts: localhost - tasks: - - name: Disable auto starting of pinned VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - auto_start: false -``` - -#### Предпочтительные ядра -``` -- name: Example - hosts: localhost - tasks: - - name: Change preferred CPU cores - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - cpu_pin: true - preferred_cpu_cores: - - 0 - - 1 - - 2 - state: stopped -``` - -#### Загрузочный диск -``` -- name: Example - hosts: localhost - tasks: - - name: Make the disk bootable - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - disk_id: "{{ vm_disk1_id }}" -``` - -#### Режим загрузки -``` -- name: Example - hosts: localhost - tasks: - - name: Change boot mode - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - mode: uefi -``` - -#### Тип загрузчика ОС -``` -- name: Example - hosts: localhost - tasks: - - name: Change loader type - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - boot: - loader_type: windows -``` - -#### Именование сетевых интерфейсов -``` -- name: Example - hosts: localhost - tasks: - - name: Change network interface naming - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - network_interface_naming: eth -``` - -#### Поддержку изменения объема ОЗУ и количества ЦП у запущенной ВМ -``` -- name: Example - hosts: localhost - tasks: - - name: Change hot resize support - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - hot_resize: true -``` - -#### MAC-адрес сетевого интерфейса -``` -- name: Example - hosts: localhost - tasks: - - name: Change network interface MAC address - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - networks: - - type: VINS - id: "{{ vins_id }}" - mac: "11:22:33:44:55:66" -``` - -### Удалить - -#### Безвозвратно -``` -- name: Example - hosts: localhost - tasks: - - name: Delete VM - decort_kvmvm: - # Параметры для авторизации упущены - id: "{{ vm_id }}" - state: absent -``` diff --git a/wiki/8.0.0/модуль-decort_lb.md b/wiki/8.0.0/модуль-decort_lb.md deleted file mode 100644 index 4aec498..0000000 --- a/wiki/8.0.0/модуль-decort_lb.md +++ /dev/null @@ -1,806 +0,0 @@ -# Модуль decort_lb -## Обзор модуля decort_lb - -Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки: -- создать -- получить информацию -- отключить/включить/запустить/перезапустить -- изменить - - конфигурации backend и frontend - - конфигурацию sysctl -- удалить (в корзину или безвозвратно) -- восстановить из корзины - -## Параметры модуля decort_lb -Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- account_id - - (int) - - Идентификатор аккаунта. -
- account_name - - (str) - - Имя аккаунта. -
Может быть альтернативой параметру account_id. -
- description - - (str) -
Default: Managed by Ansible module decort_lb - 		- Описание балансировщика. -
- backends - - (list) - - Список словарей, описывающих конфигурации backend. -
- algorithm - - (str) -
Значения: -
leastconn -
roundrobin -
static-rr -
Default: roundrobin - 		- Используемый алгоритм. -
- - default_settings - - - (dict) - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
- downinter - - (int) -
Default: 1000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается недоступным. -
- fall - - (int) -
Default: 2 - 		- Количество последовательных неудачных проверок доступности, после - которых сервер, ранее считавшийся доступным, начинает считаться - недоступным и временно исключается из схемы балансировки. -
- inter - - (int) -
Default: 5000 - 		- Интервал в миллисекундах между двумя последовательными проверками - доступности сервера, который считается доступным. -
- maxconn - - (int) -
Default: 250 - 		- Лимит одновременных подключений к серверу. При достижении этого лимита - сервер временно исключается из схемы балансировки. -
- maxqueue - - (int) -
Default: 256 - 		- Лимит соединений, ожидающих в очереди. Когда этот предел будет - достигнут, все последующие подключения будут перенаправлены - на другие серверы. -
- rise - - (int) -
Default: 2 - 		- Количество проверок, которые должен пройти сервер, считавшийся - недоступным, чтобы начать считаться доступным и снова быть - включенным в схему балансировки. -
- slowstart - - (int) -
Default: 60000 - 		- Интервал в миллисекундах с момента когда сервер начинает считаться - доступным, по истечении которого количество фактически разрешенных - подключений к этому серверу будет возвращено до 100% от - установленного лимита. -
- weight - - (int) -
Default: 100 - 		- Вес сервера для использования в алгоритмах балансировки. -
- name - - (str) - - Название backend. Обязательный параметр. -
- ext_net_id - - (int) - - Идентификатор внешней сети. -
Может быть не задан, если задан vins_id - - в таком случае балансировщик будет подключён только к - внутренней сети. -
- - frontends - - - (list) - - Список словарей, описывающих конфигурации frontend. -
- backend - - (str) - - Название используемого backend. Обязательный параметр. -
- bindings - - (list) - - Список словарей, описывающих конфигурации binding. -
- address - - (str) - - IP-адрес. -
Если не задан, то будет использоваться основной IP-адрес - балансировщика во внешней сети или, если подключена только - внутренняя сеть, основной IP-адрес балансировщика во внутренней сети. -
- name - - (str) - - Название. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- ha_lb - - bool -
Default: false - 		- Использовать схему высокой доступности для создаваемого балансировщика. -
- lb_id - - (int) - - Идентификатор балансировщика нагрузки. -
- lb_name - - (str) - - Имя балансировщика. -
- permanently - - (bool) -
Default: false - 		- Если выполняется удаление, то выполнить безвозвратное удаление - (минуя корзину). -
- rg_id - - (int) - - Идентификатор ресурсной группы. -
- rg_name - - (str) - - Имя ресурсной группы. -
В комбинации с заданным аккаунтов может быть альтернативой - параметру rg_id -
- servers - - (list) - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - (str) - - IP-адрес. Обязательный параметр. -
- backends - - (list) - - Список словарей, описывающих параметры backend-сервера для разных - конфигураций backend. -
Обязательный параметр. -
- check - - (str) -
Значения: -
enabled -
disabled -
Default: enabled - 		- Проверка доступности сервера. -
- name - - (str) - - Название конфигурации backend. Обязательный параметр. -
- port - - (int) -
Значения: -
1-65535 - 		- Порт. Обязательный параметр. -
- server_settings - - (dict) - - Словарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- name - - (str) - - Название. Обязательный параметр. -
- state - - (str) -
Значения: -
present -
absent -
enabled -
disabled -
restart -
Default: present - 		- Целевое состояние балансировщика нагрузки. -
Выполнение с state=restart позволяет выполнить - перезапуск балансировщика, соответственно, всегда возвращает - changed: true. -
Значения present и enabled равнозначны - и соответствуют включённому и запущенному балансировщику. -
- sysctl - - (dict) - - Словарь, описывающий параметры конфигурации sysctl. -
- vins_id - - (int) - - Идентификатор внутренней сети. -
Может быть не задан, если задан ext_net_id - - в таком случае балансировщик будет подключён только к - внешней сети. -
- vins_name - - (str) - - Имя внутренней сети. -
В комбинации с заданной РГ может быть альтернативой для - параметра vins_id. -
- -## Возвращаемые значения модуля decort_lb - -Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- backends - - list - - Список словарей, описывающих конфигурации backend. -
- algorithm - - str - - Используемый алгоритм. -
- name - - str - - Название конфигурации backend. -
- serverDefaultSettings - - dict - - Cловарь, описывающий параметры по умолчанию для backend-серверов. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- servers - - list - - Список словарей, описывающих конфигурации backend-серверов. -
- address - - str - - IP-адрес. -
- check - - str - - Проверка доступности сервера. -
- name - - str - - Название. -
- port - - int - - Порт. -
- serverSettings - - dict - - Cловарь, описывающий параметры backend-сервера. -
Ключи данного словаря аналогичны ключам словаря - - default_settings - . -
- frontends - - list - - Список словарей, описывающих конфигурации frontend. -
Ключи данного словаря аналогичны ключам словарей списка - - frontends - . -
- gid - - int - - Идентификатор физического кластера (Grid ID). -
- id - - int - - Идентификатор балансировщика. -
- name - - str - - Имя балансировщика. -
- rg_id - - int - - Идентификатор ресурсной группы. -
- state - - str - - Статус балансировщика. -
- sysctl - - dict - - Параметры конфигурации sysctl. -
diff --git a/wiki/8.0.0/модуль-decort_osimage.md b/wiki/8.0.0/модуль-decort_osimage.md deleted file mode 100644 index 7a64bb9..0000000 --- a/wiki/8.0.0/модуль-decort_osimage.md +++ /dev/null @@ -1,146 +0,0 @@ -# Модуль decort_osimage -## Обзор модуля decort_osimage - -Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT: -- шаблонные образы: - - создать - - получить информацию - - изменить имя - - удалить -- виртуальные образы - - создать - - получить информацию - - изменить - - имя - - целевой образ - - удалить - -## Параметры модуля decort_osimage -Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. | -| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. | -| boot | (dict) | Параметры загрузки.
Ключи словаря:
• `mode` (str) - режим загрузки, значения: `bios`, `uefi`, значение по умолчанию при создании: `bios`;
• `loader_type` (str) - тип загрузчика операционной системы, значения: `linux`, `windows`, `unknown`, значение по умолчанию при создании: `unknown`. | -| drivers | (string)
Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.| -| hot_resize | (bool) | Поддержка изменения объёма ОЗУ и количества процессоров у запущенных ВМ, созданных на основе образа.
Значение по умолчанию при создании: `false`. | -| image_id | (int) | Идентификатор шаблонного образа. -| image_name | (str) | Имя шаблонного образа. -| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.| -| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. | -| network_interface_naming | (string)
Значения:
`ens`
`eth`| Шаблон именования сетевых интерфейсов в ОС Linux.
Значение по умолчанию при создании: `ens`. | -| passwordDL | (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. | -| pool | (str) | Имя пула СХД. Используется для поиска существующего образа. -| poolName | (string) | Имя пула СХД. Используется при создании образа. | -| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. | -| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа. -| state | (string)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. | -| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.| -| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. | -| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| -| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.| - - -## Возвращаемые значения модуля decort_osimage - -Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами: - - -| Ключ | Тип данных | Описание | -| ------ | ------ | ------ | -| accountId | int | Идентификатор аккаунта. | -| boot_mode | string | Режим загрузки. | -| boot_loader_type | string | Тип загрузчика операционной системы. | -| hot_resize | bool | Поддержка изменения объёма ОЗУ и количества процессоров у запущенной ВМ. | -| id | int | Уникальный целочисленный идентификатор данного образа. | -| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. | -| name | string | Имя образа. | -| network_interface_naming | string | Шаблон именования сетевых интерфейсов в ОС Linux. | -| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.| -| sep_id | int | Идентификатор системы хранения данных, на которой хранится данный образ. | -| size | int | Размер образа в ГБ. | -| state | string | Текущий статус образа. | -| type | string | Тип образа. | - - - -## Пример использования модуля decort_osimage - - -Пример создания шаблонного образа с операционной системой Alpine Linux. -``` - - name: Create template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2 - verify_ssl: false - boot: - mode: uefi - loader_type: linux - network_interface_naming: eth - hot_resize: true - register: osimage -``` - -Пример получения информации о существующем шаблонном образе по его имени. - -``` - - name: Get template image - decort_osimage: - account_Id: 12345 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - verify_ssl: false - register: osimage -``` - -Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ. - -``` - - name: Create virtual image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1 - virt_name: alpine_last - register: osimage -``` -Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`. - -Пример переименования образа. - -``` - - name: Rename template image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_name: alpine_linux_3.19.1_new_name - image_id: 54321 - register: osimage -``` - -Пример удаления образа - -``` - - name: Delete image - decort_osimage: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - controller_url: "https://ds1.digitalenergy.online" - image_id: 54321 - state: absent -``` diff --git a/wiki/8.0.0/модуль-decort_pfw.md b/wiki/8.0.0/модуль-decort_pfw.md deleted file mode 100644 index 45dd2ad..0000000 --- a/wiki/8.0.0/модуль-decort_pfw.md +++ /dev/null @@ -1,66 +0,0 @@ -# Модуль decort_pfw -## Обзор модуля decort_pfw - -Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины. -Модуль поддерживает выполнение следующих действий над правилами: -- добавить -- получить информацию -- удалить - -## Параметры модуля decort_pfw -Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание| -| ------ | ------ | ------ | -| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. | -| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).
Ключи словаря:
• `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`
• `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`
• `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;
• `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` | -| state | (str)
Значения:
`present`
`absent`
Default: `present` | Целевое состояние правил.
Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). | -| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. | - - -## Возвращаемые значения модуля decort_pfw - -Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами: - - -|Ключ | Тип данных | Описание| -| ------ | ------ | ------ | -| compute_id | int | Идентификатор ВМ. | -| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. | -| rules | list | Список словарей, описывающих правила переадресации портов.
Ключи словаря:
• `id` (int) - идентификатор правила
• `localIp` (str) - IP-адрес ВМ
• `localPort` (int) - внутренний порт
• `protocol` (str) - протокол
• `publicPortEnd` (int) - верхняя граница диапазона внешних портов
• `publicPortStart` (int) - нижняя граница диапазона внешних портов
• `vmId` (int) - идентификатор ВМ
• `vmName` (str) - имя ВМ | -| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. | -| vins_id | int | Идентификатор внутренней сети. | - -## Пример использования модуля decort_pfw - -В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов: - -- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`. -- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`. - -``` -- name: Add port forwarding rules - decort_pfw: - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - authenticator: oauth2 - compute_id: "{{ my_vm.facts.id }}" - controller_url: "https://cloud.digitalenergy.online" - oauth2_url: "https://sso.digitalenergy.online" - rules: - - local_port: 22 - proto: tcp - public_port_start: 30022 - - local_port: 30080 - proto: udp - public_port_end: 30085 - public_port_start: 30080 - vins_id: "{{ my_vins.facts.id }}" - register: my_pfw_rules -``` - -В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию: - -``` -"{{ my_pfw_rules.facts.rules }}" -``` diff --git a/wiki/8.0.0/модуль-decort_rg.md b/wiki/8.0.0/модуль-decort_rg.md deleted file mode 100644 index 5774c12..0000000 --- a/wiki/8.0.0/модуль-decort_rg.md +++ /dev/null @@ -1,224 +0,0 @@ -# Модуль decort_rg - -## Обзор модуля decort_rg - -Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет: - -- создавать ресурсные группы -- удалять ресурсные группы (в корзину или безвозвратно, с удалением содержимого или без) -- восстанавливать ресурсные группы из корзины -- включать/отключать ресурсные группы -- запрашивать информацию об уже существующих ресурсных группах -- изменять ресурсные группы: - - переименовывать - - настраивать квоты - - задавать стандартную сеть - - настраивать права доступа для пользователей - - изменять доступные пулы СХД - - изменять описание - -## Параметры модуля decort_rg -Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -|----------|--------------------------|----------| -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. | -| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. | -| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. | -| description | (string) | Текстовое описание ресурсной группы. | -| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. | -| def_netType | (string)
Значения:
`PRIVATE`
`PUBLIC`
`NONE`
Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. | -| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.
Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.
Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. | -| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. | -| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. | -| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. | -| permanently | (bool)
Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. | -| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. | -| recursive_deletion | (bool)
Default: `false` | Рекурсивное удаление.
Если `true`, то при удалении РГ будет удалено всё её содержимое.
Если `false`, то при удалении непустой РГ работа модуля завершится ошибкой. | -| rename | (string) | Новое имя ресурсной группы.
Возможно переименование только включенной ресурсной группы. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` | -| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. | -| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.
Ключи словаря:
• `sep_id` (int) - идентификатор системы хранения данных.
• `pool_names` (list) - список названий пулов системы хранения данных.
Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.| -| state | Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние ресурсной группы. | - -## Возвращаемые значения модуля decort_rg - -Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -|------|------------|----------| -| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. | -| description | string | Текстовое описание ресурсной группы. | -| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. | -| id | int | Уникальный целочисленный идентификатор ресурсной группы. | -| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. | -| state | string | Текущее состояние ресурсной группы. | -| quota | dict | Текущие квоты ресурсной группы. | -| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. | -| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. | -| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. | -| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. | -| computes | list | Список идентификаторов виртуальных машин ресурсной группы. | -| uniqPools | list | Список доступных пулов СХД. | - -## Пример использования модуля decort_rg - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "R" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - access: - action: "grant" - user: "MyUser" - right: "RCX" - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - quotas: - cpu: 16 - ram: 16384 - disk: 100 - ext_ips: 20 - net_transfer: 1000 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - def_netType: "PRIVATE" - def_netId: 99 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount. - -``` -- name: manage resource group - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - rename: "NewRg" - rg_id: 27 - state: present - register: my_rg - delegate_to: localhost -``` - -В данном примере результат работы модуля decort_rg записывается в переменную my_rg. - -Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом: - -``` - <прочие детали опущены> - rg_id: "{{ my_rg.facts.id }}" -``` - -В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount. - -``` -- name: change available sep pools - decort_rg: - authenticator: oauth2 - app_id: "{{ my_app_id }}" - app_secret: "{{ my_app_secret }}" - oauth2_url: "https://sso.digitalenergy.online" - controller_url: "https://cloud.digitalenergy.online" - account_name: "MyAccount" - rg_name: "MyRG" - sep_pools: - - sep_id: 1 - pool_names: - - sep1_pool1 - - sep1_pool2 - - sep_id: 2 - pool_names: - - sep2_pool1 - state: present - register: my_rg - delegate_to: localhost -``` diff --git a/wiki/8.0.0/модуль-decort_snapshot.md b/wiki/8.0.0/модуль-decort_snapshot.md deleted file mode 100644 index 9021585..0000000 --- a/wiki/8.0.0/модуль-decort_snapshot.md +++ /dev/null @@ -1,248 +0,0 @@ -# Модуль decort_snapshot -## Обзор модуля - -Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин: -- **создать** (см. [параметр state](#state) и [примеры](#создать)) -- **удалить** (см. [параметр state](#state) и [примеры](#удалить)) -- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке)) -- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - label - - - (str) - - Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - vm_name_2024-12-10_16-40-52. -
- - state - - - (str) -
Значения: -
absent -
present - 		- Целевое состояние. -
absent - снимок удален. -
present - снимок существует. -
- - usage - - - (bool) -
Default:false - 		- Получить информацию о реальном размере снимка виртуальной машины. -
- - vm_id - - - (int) - - Идентификатор виртуальной машины. -
Обязательный параметр. -
- -## Возвращаемые значения - -Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- disks - - list - - Диски -
- guid - - str - - Идентификатор снимка -
- label - - str - - Метка снимка -
- timestamp - - int - - Временная метка создания снимка -
- vm_id - - int - - Идентификатор виртуальной машины -
- -### Размер снимка - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- stored - - float - - Размер снимка -
- -## Примеры использования - -### Создать - -#### С указанием метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: present -``` - -#### Без указания метки -``` -- name: Example - hosts: localhost - tasks: - - name: Create snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - state: present -``` - -### Удалить -``` -- name: Example - hosts: localhost - tasks: - - name: Delete snapshot - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - state: absent -``` - -### Получить основную информацию о снимке -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic snapshot info - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" -``` - -### Получить информацию о размере снимка -``` -- name: Example - hosts: localhost - tasks: - - name: Get snapshot usage - decort_snapshot: - # Параметры для авторизации упущены - vm_id: "{{ vm_id }}" - label: "{{ snapshot_label }}" - usage: true -``` diff --git a/wiki/8.0.0/модуль-decort_user_info.md b/wiki/8.0.0/модуль-decort_user_info.md deleted file mode 100644 index 483d9b7..0000000 --- a/wiki/8.0.0/модуль-decort_user_info.md +++ /dev/null @@ -1,1411 +0,0 @@ -# Модуль decort_user_info -## Обзор модуля - -Модуль **decort_user_info** предназначен для получения следующей информации о пользователе: -- **основная информация** (см. [возвращаемые значения](#основная-информация) и [примеры](#получение-основной-информации-о-пользователе)) -- **используемые и зарезервированные ресурсы** (см. [параметр resource_consumption](#resource_consumption), [возвращаемые значения](#используемые-и-зарезервированные-ресурсы) и [примеры](#получение-информации-об-используемых-и-зарезервируемых-ресурсах)) -- **доступные аккаунты** (см. [параметр accounts](#accounts), [возвращаемые значения](#доступные-аккаунты) и [примеры](#получение-информации-о-доступных-аккаунтах)) -- **аудиты** (см. [параметр audits](#audits), [возвращаемые значения](#аудиты) и [примеры](#получение-информации-об-аудитах)) -- **доступные методы API** (см. [параметр api_methods](#api_methods), [возвращаемые значения](#доступные-методы-api) и [примеры](#получение-доступных-методов-api)) -- **поиск доступных объектов по строке** (см. [параметр objects_search](#objects_search), [возвращаемые значения](#найденные-объекты) и [примеры](#поиск-доступных-объектов)) - -## Параметры модуля -Ниже приведен список параметров для модуля **decort_user_info** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ПараметрТипОписание
- - accounts - - - (dict) - - Получить информацию об аккаунтах, к которым имеет доступ пользователь, - с учётом заданных параметров вывода. -
Чтобы получить информацию без указания параметров вывода, - необходимо задать пустой словарь {}. -
- deleted - - (bool) -
Default: false - 		-
false - вывод только неудалённых объектов. -
true - вывод только удалённых в корзину объектов. -
- filter - - (dict) - - Фильтр. -
- rights - - (str) -
Значения: -
R -
RCX -
ARCXDU -
CXDRAU - 		- По предоставленным правам доступа. -
- id - - (int) - - По идентификатору. -
- name - - (str) - - По имени. -
- status - - (str) -
Значения: -
CONFIRMED -
DELETED -
DESTROYED -
DESTROYING -
DISABLED - 		- По статусу. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) - - Размер страниц. -
Обязательный параметр. -
- resource_consumption - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
createdTime -
deletedTime -
id -
name -
status -
updatedTime - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - api_methods - - - (bool) -
Default: false - 		- Получить методы API, к которым имеет доступ пользователь. -
- - audits - - - (dict) - - Получить информацию об аудитах пользователя, с учётом - заданных параметров вывода. -
Чтобы получить информацию с параметрами вывода по умолчанию, - необходимо задать пустой словарь {}. -
- filter - - (dict) - - Фильтр. -
- api_method - - (str) - - По методу API. -
- status_code - - (dict) - - По коду ответа HTTP. -
- min - - (int) - - По минимальному коду ответа HTTP. -
- max - - (int) - - По максимальному коду ответа HTTP. -
- time - - (dict) - - По временному периоду. -
- start - - (dict) - - Начало периода. -
- timestamp - - (int) - - Unix-время. -
- datetime - - (str) - - Дата и время в формате ггггммддччммсс. - Альтернатива параметру timestamp. -
Допустимо использовать любой разделитель между - группами цифр для повышения читаемости. Например, - гггг-мм-дд чч:мм:сс. -
- end - - (dict) - - Конец периода. -
Структура словаря аналогична параметру - start. -
- pagination - - (dict) - - Постраничный вывод. -
- number - - (int) -
Default: 1 - 		- Номер страницы. -
- size - - (int) -
Default: 50 - 		- Размер страниц. -
- sorting - - (dict) - - Сортировка. -
- asc - - (bool) -
Default: true - 		- Сортировать по возрастанию. -
true - по возрастанию. -
false - по убыванию. -
- field - - (str) -
Значения: -
Call -
Guid -
Response Time -
Status Code -
Time - 		- Название поля, по которому сортировать. -
Обязательный параметр. -
- - objects_search - - - (str) - - Получить информацию о доступных пользователю объектах, - найденных по строчному значению данного параметра. -
- - resource_consumption - - - (bool) -
Default: false - 		- Получить информацию об используемых и зарезервированных ресурсах, - к которым имеет доступ пользователь. -
- -## Возвращаемые значения - -Модуль **decort_user_info** возвращает информацию о пользователе в виде словаря `facts` со следующими ключами: - -### Основная информация - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- admin - - bool - - Наличие административных прав. -
- data - - dict - - Дополнительные данные. -
- emailaddresses - - list - - Адреса эл. почты. -
- name - - str - - Имя/идентификатор. -
- roles - - list - - Группы доступа. -
- -### Используемые и зарезервированные ресурсы - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- - resource_consumed - - - dict - - Используемые ресурсы. -
- cpu - - int - - Количество виртуальных процессоров. -
- disksize - - int - - Объём дисков в ГБ. -
- extips - - int - - Количество внешних IP-адресов. -
- exttraffic - - int - - Объём трафика внешних сетей. -
- gpu - - int - - Количество графических процессоров. -
- ram - - int - - Объём оперативной памяти в МБ. -
- seps - - dict - - Объём дисков по пулам СХД. -
- (идентификатор СХД) - - dict - - Пулы СХД. -
- (название пула) - - dict - - Словарь пула СХД. -
- disksize - - int - - Объём дисков в ГБ. -
- resource_reserved - - dict - - Зарезервированные ресурсы. -
Структура словаря аналогична словарю - - resource_consumed - . -
- -### Доступные аккаунты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- accounts - - list - - Список словарей, описывающих аккаунты. -
- acl - - list - - Список словарей, описывающих доступы пользователей. -
- right - - str - - Права доступа. -
- status - - str - - Статус. -
- type - - str - - Тип. -
- userGroupId - - str - - Идентификатор пользователя или группы пользователей. -
- computeFeatures - - list - - Список дополнительных возможностей гипервизора, доступных ВМ. -
- createdTime - - int - - Unix-время создания. -
- createdTime_readable - - str - - Дата и время создания. -
- deletedTime - - int - - Unix-время удаления. -
- deletedTime_readable - - str - - Дата и время удаления. -
- description - - str - - Описание. -
- id - - int - - Идентификатор. -
- name - - str - - Имя. -
- resource_consumed - - list - - Используемые ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- resource_reserved - - list - - Зарезервированные ресурсы. -
Только если - accounts.resource_consumption: true - и только для неудалённых объектов. -
Структура словаря аналогична словарю - - resource_consumed - . -
- status - - str - - Статус. -
- updatedTime - - int - - Unix-время обновления. -
- updatedTime_readable - - str - - Дата и время обновления. -
- -### Аудиты - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- audits - - list - - Список словарей, описывающих аудиты. -
- Call - - str - - Метод API. -
- Guid - - str - - Уникальный идентификатор аудита. -
- Response Time - - float - - Время отклика в секундах. -
- Status Code - - int - - Код ответа HTTP. -
- Time - - float - - Unix-время. -
- Time_readable - - str - - Дата и время. -
- -### Доступные методы API - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- api_methods - - list - - Список словарей, описывающих доступные методы API. -
- (название группы методов API) - - dict - - Доступные методы группы. -
- (название подгруппы методов API) - - list - - Методы подгруппы. -
- ALL - - bool - - Доступ ко всем методам группы. -
- -### Найденные объекты - - - - - - - - - - - - -
- Ключ - - Тип -
данных - 		- Описание -
- objects_search - - list - - Список словарей, описывающих найденные объекты. -
- -## Примеры использования - -### Получение основной информации о пользователе -``` -- name: Example - hosts: localhost - tasks: - - name: Get basic user info - decort_user_info: - # Параметры для авторизации упущены -``` - -### Получение информации об используемых и зарезервируемых ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with resource consumption - decort_user_info: - # Параметры для авторизации упущены - resource_consumption: true -``` - -### Получение информации о доступных аккаунтах - -#### Только неудалённые -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with not deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: {} -``` - -#### Только удалённые в корзину -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with deleted accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - deleted: true -``` - -#### С информацией об используемых и зарезервированных ресурсах -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - resource_consumption: true -``` - -#### С фильтрацией по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - filter: - status: CONFIRMED -``` - -#### С сортировкой по имени -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - sorting: - field: name -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with accounts - decort_user_info: - # Параметры для авторизации упущены - accounts: - pagination: - size: 2 -``` - -### Получение информации об аудитах - -#### Без использования параметров вывода -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: {} -``` - -#### С фильтрацией по методу API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - call: cloudapi/account -``` - -#### С фильтрацией по временному периоду -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - filter: - time: - start: - timestamp: 1724668267 - end: - datetime: 2024-08-26_13-40-00 -``` - -#### С постраничным выводом -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits - decort_user_info: - # Параметры для авторизации упущены - audits: - pagination: - size: 2 -``` - -#### С сортировкой по статусу -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with audits sorted by status code - decort_user_info: - # Параметры для авторизации упущены - audits: - sorting: - field: Status Code -``` - -### Получение доступных методов API -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with API methods - decort_user_info: - # Параметры для авторизации упущены - api_methods: true -``` - -### Поиск доступных объектов -``` -- name: Example - hosts: localhost - tasks: - - name: Get user info with found objects - decort_user_info: - # Параметры для авторизации упущены - objects_search: test -``` diff --git a/wiki/8.0.0/модуль-decort_vins.md b/wiki/8.0.0/модуль-decort_vins.md deleted file mode 100644 index 4c05f25..0000000 --- a/wiki/8.0.0/модуль-decort_vins.md +++ /dev/null @@ -1,110 +0,0 @@ -# Модуль decort_vins -## Обзор модуля decort_vins - -Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия: -- создавать - - на уровне ресурсной группы (если РГ задана) - - на уровне аккаунта (если РГ не задана) -- удалять (безвозвратно) -- восстанавливать из корзины -- запрашивать информацию -- включать/отключать -- соединять (необходимы права администратора) -- изменять: - - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора) - - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора) - - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора) - -## Параметры модуля decort_vins -Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)): - -| Параметр | Тип, допустимые значения | Описание | -| ------ | ------ | ------ | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -| account_name | (string) | Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.| -|description | (string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.| -| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. | -| ext_ip_addr | (string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически. -| ipcidr | (string) | Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.| -|rg_id | (int) | Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.| -| rg_name | (string) | Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.| -| state | (string)
Значения:
`present`
`absent`
`enabled`
`disabled`
Default: `present` | Целевое состояние внутренней сети. | -| vins_id | (int) | Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.| -| vins_name| (string) | Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.| -| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору. -| custom_config | (bool)
Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. | -| config_save | (bool)
Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. | -| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры. - -## Возвращаемые значения модуля decort_vins - -Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами: - -| Ключ | Тип данных | Описание | -| --- | --- | --- | -| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. | -| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора -| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. | -| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. | -| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. | -| id | (int) | Уникальный целочисленный идентификатор внутренней сети. | -| name | (string) | Имя внутренней сети. | -| int_net_addr | (string) | Адрес внутренней сети. | -| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. | -| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему. -| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору. -| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору. -| state | (string) | Состояние внутренней сети. | - - - -## Пример использования модуля decort_vins - -В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01"). - -Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0). -``` - - name: Manage ViNS on resource group level - decort_vins: - account_name: "MyMainAccount" - rg_name: "MyRg01" - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://ds1.digitalenergy.online" - ext_net_id: 0 - vins_name: "MyVins01" - register: my_vins - ``` - -Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера. -``` -- name: Manage virtual machine - decort_kvmvm: - << для краткости фрагмент опущен >> - networks: - - type: VINS - id: "{{ my_vins.facts.id }}" - << для краткости фрагмент опущен >> -``` - -В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196. -``` - - name: Manage ViNS on resource group level - decort_vins: - authenticator: jwt - jwt: "{{ my_jwt.jwt }}" - controller_url: "https://cloud.digitalenergy.online" - vins_name: "ViNS_connected_by_decort_vins_module" - rg_id: 98 - connect_to: - - id: 864 - ipaddr: 192.168.5.66 - netmask: 24 - - id: 196 - ipaddr: 192.168.9.133 - netmask: 24 - register: managed_vins - -``` - - diff --git a/wiki/Home.md b/wiki/Home.md deleted file mode 100644 index 41c5ef1..0000000 --- a/wiki/Home.md +++ /dev/null @@ -1,13 +0,0 @@ -## Документация: - -- [Модули Ansible версии 8.0.0](./8.0.0/Home.md) -- [Модули Ansible версии 7.2.0](./7.2.0/Home.md) -- [Модули Ansible версии 7.1.0](./7.1.0/Home.md) -- [Модули Ansible версии 7.0.0](./7.0.0/Home.md) -- [Модули Ansible версии 6.1.0](./6.1.0/Home.md) -- [Модули Ansible версии 6.0.0](./6.0.0/Home.md) -- [Модули Ansible версии 5.6.0](./5.6.0/Home.md) -- [Модули Ansible версии 5.5.0](./5.5.0/Home.md) -- [Модули Ansible версии 5.4.0](./5.4.0/Home.md) -- [Модули Ansible версии 5.3.0](./5.3.0/Home.md) -- [Модули Ansible версии 5.2.6](./5.2.6/Home.md) \ No newline at end of file