Аутентификация

Чтобы аутентифицировать вызов API в Hetzner Cloud API при использовании коллекции hetzner.hcloud, вы можете передать токен API разными способами:

Токен API можно передать с помощью переменной окружения (рекомендуется):

export HCLOUD_TOKEN='LRK9DAWQ1ZAEFSrCNEEzLCUwhYX1U3g7wMg4dTlkkDC96fyDuyJ39nVbVjCKSDfj'

# Verify that your token is working
ansible -m hetzner.hcloud.location_info localhost

В качестве альтернативы можно указать токен API непосредственно в аргументе модуля:

- name: Create server
  hetzner.hcloud.server:
    api_token: LRK9DAWQ1ZAEFSrCNEEzLCUwhYX1U3g7wMg4dTlkkDC96fyDuyJ39nVbVjCKSDfj
    name: my-server
    server_type: cpx22
    image: debian-12
    state: present

Чтобы сократить дублирование описанного выше решения, можно настроить модули hetzner.hcloud.* с помощью группы действий hetzner.hcloud.all, например, если вы хотите хранить токен API в хранилище секретов:

- name: Demonstrate the usage of the 'hetzner.hcloud.all' module_defaults group
  hosts: localhost
  connection: local

  module_defaults:
    group/hetzner.hcloud.all:
      api_token: "{{ _vault_hcloud_api_token }}"

  tasks:
    - name: Create server
      hetzner.hcloud.server:
        name: my-server
        server_type: cpx22
        image: debian-12
        state: present

Экспериментальные функции

Экспериментальные функции выпускаются в рамках наших регулярных релизов (например, в виде публичной бета-версии продукта). На экспериментальном этапе в этих функциях могут появляться несовместимые изменения в минорных релизах.

Стабильность экспериментальных функций не связана со стабильностью соответствующего вышестоящего API.

Экспериментальные функции имеют разные уровни зрелости (например, экспериментальный, альфа, бета) в зависимости от зрелости вышестоящего API.

Информация об экспериментальных функциях публикуется в примечаниях к релизу. Также в документации можно узнать, является ли модуль или фильтр экспериментальным:

Experimental: $PRODUCT is $MATURITY, breaking changes may occur within minor releases. See https://docs.hetzner.cloud/changelog#$SLUG for more details.