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 целое число		Идентификатор сервера Hetzner Cloud, который необходимо управлять. Требуется только если не указано имя сервера name.
image строка		Изображение, с которого должен быть создан сервер. Требуется, если сервер не существует.
labels словарь		Пользовательские метки (пар ключ-значение).
location строка		Расположение сервера. Требуется, если не указан параметр datacenter и сервер не существует.
name строка		Имя сервера Hetzner Cloud, который необходимо управлять. Требуется только если не указан параметр id или сервер не существует.
rescue_mode строка добавлено в 2.9		Укажите тип системы восстановления Hetzner, в который должен загрузиться сервер.
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
    upgrade_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 will be booted in rescue mode and therefore restarted
  hcloud_server:
    name: my-server
    rescue_mode: linux64
    state: restarted

- name: Ensure the server is rebuild
  hcloud_server:
    name: my-server
    image: ubuntu-18.04
    state: rebuild

Возвращаемые значения

Общие возвращаемые значения описаны здесь, а следующие поля уникальны для данного модуля:

Ключ		Возвращается	Описание
hcloud_server сложный		Всегда	Экземпляр сервера
	backup_window логическое	всегда	Временной интервал (UTC) для резервного копирования, или null, если резервное копирование отключено Пример: 22-02
	datacenter строка	всегда	Название ЦОД сервера Пример: fsn1-dc14
	id целое число	всегда	Числовой идентификатор сервера Пример: 1937415
	ipv4_address строка	всегда	Общедоступный IPv4-адрес сервера Пример: 116.203.104.109
	ipv6 строка	всегда	IPv6 сеть сервера Пример: 2a01:4f8:1c1c:c140::/64
	labels словарь	всегда	Пользовательские метки (пар ключ-значение)
	location строка	всегда	Название расположения сервера Пример: fsn1
	name строка	всегда	Имя сервера Пример: my-server
	rescue_enabled логическое	всегда	True, если режим восстановления включён, сервер затем загрузится в систему восстановления при следующей перезагрузке
	server_type строка	всегда	Название типа сервера Пример: cx11
	status строка	всегда	Статус сервера Пример: запущен

Статус

Интерфейс данного модуля не гарантирует обратную совместимость. [превью]
Данный модуль поддерживается сообществом Ansible. [community]

Авторы

Лукас Каеммерлинг (@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.9/modules/hcloud_server_module.html