community.digitalocean.digital_ocean_database модуль — Создание и удаление базы данных DigitalOcean
Примечание
Этот модуль входит в коллекцию community.digitalocean (версия 1.27.0).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install community.digitalocean.
Чтобы использовать её в плейбуке, укажите: community.digitalocean.digital_ocean_database.
Новое в community.digitalocean 1.3.0
Описание
- Создает и удаляет базу данных в DigitalOcean и, по желанию, ожидает её подключения.
- Управляемая служба баз данных DigitalOcean упрощает создание и управление высокодоступными кластерами баз данных.
- В настоящее время поддерживает PostgreSQL, Redis, MySQL и MongoDB.
Параметры
Параметр | Комментарии |
|---|---|
baseurl string | Базовый URL API DigitalOcean. По умолчанию: |
engine string / required | Символьное обозначение используемого для кластера механизма базы данных. Возможные значения: Варианты:
|
id aliases: database_id integer | Уникальный ID, который можно использовать для идентификации и ссылки на кластер базы данных. |
name string / required | Уникальное, понятное имя для кластера базы данных. |
num_nodes integer | Количество узлов в кластере базы данных. Допустимые значения: 1, 2 или 3. Варианты:
|
oauth_token aliases: api_token string | Токен OAuth DigitalOcean. Существует несколько других переменных среды, которые можно использовать для предоставления этого значения. Например, - |
private_network_uuid string | Строка, указывающая UUID VPC, которому назначен кластер базы данных. |
project_name aliases: project string | Проект, которому нужно назначить ресурс (имя проекта, а не UUID). По умолчанию используется проект по умолчанию учетной записи (пустая строка). В настоящее время поддерживается только при создании баз данных. По умолчанию: |
region aliases: region_id string / required | Символьный идентификатор региона, где расположен кластер базы данных. |
size aliases: size_id string / required | Символьный идентификатор, представляющий размер узлов в кластере базы данных. См. https://docs.digitalocean.com/reference/api/api-reference/#operation/create_database_cluster для поддерживаемых размеров. |
state string | Указывает желаемое состояние цели. Варианты:
|
tags list / elements=string | Массив тегов, которые были применены к кластеру базы данных. |
timeout integer | Время ожидания в секундах, используемое для опроса API DigitalOcean. По умолчанию: |
validate_certs boolean | Если установлено значение Это значение должно устанавливаться в Варианты:
|
version string | Строка, представляющая версию используемого для кластера механизма базы данных. Для Для Для Для |
wait boolean | Ожидать, пока база данных не станет доступна, прежде чем возвращать результат. Варианты:
|
wait_timeout integer | Сколько времени ожидать, прежде чем ожидание завершится (в секундах), при создании базы данных. По умолчанию: |
Примеры
- name: Create a Redis database
community.digitalocean.digital_ocean_database:
oauth_token: "{{ lookup('ansible.builtin.env', 'DO_API_KEY') }}"
state: present
name: testdatabase1
engine: redis
size: db-s-1vcpu-1gb
region: nyc1
num_nodes: 1
register: my_database
- name: Create a Redis database (and assign to Project "test")
community.digitalocean.digital_ocean_database:
oauth_token: "{{ lookup('ansible.builtin.env', 'DO_API_KEY') }}"
state: present
name: testdatabase1
engine: redis
size: db-s-1vcpu-1gb
region: nyc1
num_nodes: 1
project_name: test
register: my_database
Значения возврата
Общие значения возврата документированы здесь, следующие — поля, уникальные для данного модуля:
Ключ | Описание |
|---|---|
assign_status строка | Статус назначения (ok, not_found, assigned, already_assigned, service_down) Возвращено: changed Пример: |
data словарь | База данных DigitalOcean Возвращено: success Пример: |
msg строка | Сообщение об ошибке или информационное сообщение, возникшее во время выполнения Возвращено: changed Пример: |
resources словарь | Ресурсы, участвующие в назначении проекта Возвращено: changed Пример: |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/digitalocean/digital_ocean_database_module.html