hcloud_server – Создание и управление облачными серверами на Hetzner Cloud
Новая версия 2.8.
Обзор
- Создание, обновление и управление облачными серверами на Hetzner Cloud.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- hcloud-python >= 1.0.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_token строка / обязательно | Ключ API для Hetzner Cloud. | |
| backups логическое значение |
| Включить или отключить резервное копирование для заданного сервера. |
| datacenter строка | ЦОД сервера. Обязательно, если не задан параметр location и сервер не существует. | |
| endpoint строка | Значение по умолчанию: "https://api.hetzner.cloud/v1" | API-адрес Hetzner Cloud. |
| force_upgrade логическое значение |
| Вынудить обновление сервера. Отключить сервер, если он работает при обновлении. |
| id целое число | ID сервера Hetzner Cloud для управления. Требуется только если не задано имя сервера name. | |
| image строка | Образ, с которого должен быть создан сервер. Обязательно, если сервер не существует. | |
| labels словарь | Пользовательские метки (пары ключ-значение). | |
| location строка | Расположение сервера. Обязательно, если не задан параметр datacenter и сервер не существует. | |
| name строка | Имя сервера Hetzner Cloud для управления. Требуется только если не задан параметр id или сервер не существует. | |
| server_type строка | Тип сервера Hetzner Cloud для управления. Обязательно, если сервер не существует. | |
| ssh_keys список | Список имен SSH-ключей Имена ключей соответствуют SSH-ключам, настроенным для доступа к вашей учетной записи Hetzner Cloud. | |
| state строка |
| Состояние сервера. |
| upgrade_disk логическое значение |
| Изменить размер диска при изменении размера сервера. Если вы хотите в дальнейшем уменьшить размер сервера, это значение должно быть False. |
| user_data строка | Данные пользователя, передаваемые серверу при создании. Используется только если сервер не существует. | |
| volumes список | Список идентификаторов томов, которые должны быть подключены к серверу при создании. |
См. также
См. также
- Документация API Hetzner Cloud
- Полное руководство по API Hetzner Cloud.
Примеры
- name: Create a basic server
hcloud_server:
name: my-server
server_type: cx11
image: ubuntu-18.04
state: present
- name: Create a basic server with ssh key
hcloud_server:
name: my-server
server_type: cx11
image: ubuntu-18.04
location: fsn1
ssh_keys:
- me@myorganisation
state: present
- name: Resize an existing server
hcloud_server:
name: my-server
server_type: cx21
keep_disk: yes
state: present
- name: Ensure the server is absent (remove if needed)
hcloud_server:
name: my-server
state: absent
- name: Ensure the server is started
hcloud_server:
name: my-server
state: started
- name: Ensure the server is stopped
hcloud_server:
name: my-server
state: stopped
- name: Ensure the server is restarted
hcloud_server:
name: my-server
state: restarted
- name: Ensure the server is rebuild
hcloud_server:
name: my-server
image: ubuntu-18.04
state: rebuild
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| hcloud_server словарь | Всегда | Экземпляр сервера Пример: {'backup_window': None, 'datacenter': 'nbg1-dc3', 'id': 1937415, 'image': 'ubuntu-18.04', 'ipv4_address': '116.203.104.109', 'ipv6': '2a01:4f8:1c1c:c140::/64', 'labels': {}, 'location': 'nbg1', 'name': 'mein-server-2', 'rescue_enabled': False, 'server_type': 'cx11', 'status': 'running'} |
Статус
- Гарантируется, что этот модуль будет иметь обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Lukas Kaemmerling (@lkaemmerling)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/hcloud_server_module.html
