Spec-Zone.ru › Ansible 2.9

cloudscale_server – Управляет серверами на облачном сервисе cloudscale.ch IaaS

  • Описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

  • Создание, обновление, запуск, остановка и удаление серверов на облачном сервисе cloudscale.ch IaaS.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
anti_affinity_with
строка
UUID другого сервера для создания группы анти-аффинити.
Взаимоисключающий с server_groups.
Устарело, удалено в версии 2.11.
api_timeout
-
добавлен в 2.5
По умолчанию:
30
Тайм-аут в секундах для вызовов API cloudscale.ch.
api_token
-
Токен API cloudscale.ch.
Также может быть передан в переменной окружения CLOUDSCALE_API_TOKEN.
bulk_volume_size_gb
целое число
Размер тома накопителя в ГБ.
Тома накопителя нет, если не задано.
flavor
строка
Конфигурация сервера.
force
логический
добавлен в 2.8
    Варианты:
  • нет ←
  • да
Разрешить остановку работающего сервера для обновления при необходимости.
image
-
Изображение, используемое для создания сервера.
name
строка
Имя сервера.
Требуется либо name, либо uuid.
password
строка
добавлен в 2.8
Пароль для сервера.
server_groups
список
добавлен в 2.8
Список UUID или имён групп серверов.
Взаимоисключающий с anti_affinity_with.
ssh_keys
список
Список публичных ключей SSH.
Используйте полное содержимое вашего файла .pub.
state
строка
    Варианты:
  • работающий ←
  • остановленный
  • отсутствующий
Состояние сервера.
tags
словарь
добавлен в 2.9
Теги, связанные с серверами. Установите это в значение {} чтобы очистить все теги.
use_ipv6
логический
    Варианты:
  • нет
  • да ←
Включить IPv6 в публичном сетевом интерфейсе.
use_private_network
логический
    Варианты:
  • нет ←
  • да
Подключить частный сетевой интерфейс к серверу.
use_public_network
логический
    Варианты:
  • нет
  • да ←
Подключить публичный сетевой интерфейс к серверу.
user_data
строка
Данные конфигурации cloud-init (cloud-config) для использования на сервере.
uuid
строка
UUID сервера.
Требуется либо name, либо uuid.
volume_size_gb
целое число
По умолчанию:
10
Размер корневого тома в ГБ.

Примечания

Примечание

  • С версии 2.8, uuid и name больше не являются взаимоисключающими.
  • Если опция uuid предоставлена, она имеет приоритет над name для выбора сервера. Это позволяет обновить имя сервера.
  • Если опция uuid не предоставлена, name используется для выбора сервера. Если существует более одного сервера с этим именем, выполнение прерывается.
  • Только name и flavor оцениваются для обновления.
  • Опция force=true должна быть указана для перезапуска существующих работающих серверов для применения изменений.
  • Вместо параметра api_token можно использовать переменную среды CLOUDSCALE_API_TOKEN.
  • Все операции выполняются с использованием публичного API cloudscale.ch v1.
  • Для получения подробной информации см. полную документацию API: https://www.cloudscale.ch/ru/api/v1.
  • Для всех операций требуется действительный токен API. Вы можете создать любое количество токенов, используя панель управления cloudscale.ch по адресу https://control.cloudscale.ch.

Примеры

# Create and start a server with an existing server group (shiny-group)
- name: Start cloudscale.ch server
  cloudscale_server:
    name: my-shiny-cloudscale-server
    image: debian-8
    flavor: flex-4
    ssh_keys: ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale
    server_groups: shiny-group
    use_private_network: True
    bulk_volume_size_gb: 100
    api_token: xxxxxx

# Start another server in anti-affinity (server group shiny-group)
- name: Start second cloudscale.ch server
  cloudscale_server:
    name: my-other-shiny-server
    image: ubuntu-16.04
    flavor: flex-8
    ssh_keys: ssh-rsa XXXXXXXXXXX ansible@cloudscale
    server_groups: shiny-group
    api_token: xxxxxx


# Force to update the flavor of a running server
- name: Start cloudscale.ch server
  cloudscale_server:
    name: my-shiny-cloudscale-server
    image: debian-8
    flavor: flex-8
    force: yes
    ssh_keys: ssh-rsa XXXXXXXXXX...XXXX ansible@cloudscale
    use_private_network: True
    bulk_volume_size_gb: 100
    api_token: xxxxxx
  register: server1

# Stop the first server
- name: Stop my first server
  cloudscale_server:
    uuid: '{{ server1.uuid }}'
    state: stopped
    api_token: xxxxxx

# Delete my second server
- name: Delete my second server
  cloudscale_server:
    name: my-other-shiny-server
    state: absent
    api_token: xxxxxx

# Start a server and wait for the SSH host keys to be generated
- name: Start server and wait for SSH host keys
  cloudscale_server:
    name: my-cloudscale-server-with-ssh-key
    image: debian-8
    flavor: flex-4
    ssh_keys: ssh-rsa XXXXXXXXXXX ansible@cloudscale
    api_token: xxxxxx
  register: server
  until: server.ssh_fingerprints is defined and server.ssh_fingerprints
  retries: 60
  delay: 2

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

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

Ключ Возвращаемое значение Описание
anti_affinity_with
список
успех, если состояние не равно absent
Список серверов в одной группе антисродства
Устарело, удалено в версии 2.11.

flavor
строка
успех, если состояние не равно absent
Используемый для этого сервера flavour

Пример:
flex-8
href
строка
успех, если состояние не равно absent
API-URL для получения подробностей о данном сервере

Пример:
https://api.cloudscale.ch/v1/servers/cfde831a-4e87-4a75-960f-89b0148aa2cc
image
строка
успех, если состояние не равно absent
Изображение, используемое для загрузки данного сервера

Пример:
debian-8
interfaces
список
успех, если состояние не равно absent
Список сетевых портов, подключенных к серверу

Пример:
[{'type': 'public', 'addresses': ['...']}]
name
строка
успех
Имя отображения сервера

Пример:
its-a-me-mario.cloudscale.ch
server_groups
список
добавлено в 2.8
успех, если состояние не равно absent
Список групп серверов

Пример:
[{'href': 'https://api.cloudscale.ch/v1/server-groups/...', 'uuid': '...', 'name': 'db-group'}]
ssh_fingerprints
список
успех, если состояние не равно absent
Список отпечатков ключей SSH хоста. Будет null, пока ключи хоста не будут получены с сервера.

Пример:
['ecdsa-sha2-nistp256 SHA256:XXXX', '...']
ssh_host_keys
список
успех, если состояние не равно absent
Список ключей SSH хоста. Будет null, пока ключи хоста не будут получены с сервера.

Пример:
['ecdsa-sha2-nistp256 XXXXX', '...']
state
строка
успех
Текущее состояние сервера

Пример:
running
tags
словарь
добавлено в 2.9
успех
Теги, связанные с томом.

Пример:
{'project': 'my project'}
uuid
строка
успех
Уникальный идентификатор сервера

Пример:
cfde831a-4e87-4a75-960f-89b0148aa2cc
volumes
список
успех, если состояние не равно absent
Список томов, подключенных к серверу

Пример:
[{'type': 'ssd', 'device': '/dev/vda', 'size_gb': '50'}]


Статус

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

Авторы

  • Gaudenz Steinlin (@gaudenz)
  • René Moser (@resmo)

Подсказка

Если вы заметили какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.

© 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/cloudscale_server_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API