Модуль ngine_io.cloudstack.cs_sshkeypair – Управление ключами SSH в облаках на основе Apache CloudStack.

Примечание

Этот модуль является частью коллекции ngine_io.cloudstack (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Чтобы использовать его в playbook, укажите: ngine_io.cloudstack.cs_sshkeypair.

Новое в ngine_io.cloudstack 0.1.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Создание, регистрация и удаление ключей SSH.
Если ключ не найден и открытый ключ не предоставлен, будет создана новая пара закрытых/открытых ключей SSH, и закрытый ключ будет возвращен.

Требования

Ниже указаны требования, необходимые на хосте, который выполняет этот модуль.

python >= 2.6
cs >= 0.9.0

Параметры

Параметр	Комментарии
account строка	Учетная запись, с которой связан открытый ключ.
api_http_method строка	HTTP-метод, используемый для запроса конечной точки API. Если не указано, учитывается переменная среды `CLOUDSTACK_METHOD`. Варианты: `"get"` ← (по умолчанию) `"post"`
api_key строка / обязательно	API-ключ API CloudStack. Если не указано, учитывается переменная среды `CLOUDSTACK_KEY`.
api_secret строка / обязательно	Секретный ключ API CloudStack. Если не указано, учитывается переменная среды `CLOUDSTACK_SECRET`.
api_timeout целое число	Таймаут HTTP в секундах. Если не указано, учитывается переменная среды `CLOUDSTACK_TIMEOUT`. По умолчанию: `10`
api_url строка / обязательно	URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, учитывается переменная среды `CLOUDSTACK_ENDPOINT`.
api_verify_ssl_cert строка	Проверить файл сертификата центра сертификации. Если не указано, учитывается переменная среды `CLOUDSTACK_VERIFY`.
domain строка	Домен, с которым связан открытый ключ.
name строка / обязательно	Имя открытого ключа.
project строка	Имя проекта, в котором будет зарегистрирован открытый ключ.
public_key строка	Строка открытого ключа.
state строка	Состояние открытого ключа. Варианты: `"present"` ← (по умолчанию) `"absent"`
validate_certs булево добавлено в ngine_io.cloudstack 2.4.0	Если `false`, SSL-сертификаты проверяться не будут. Если не указано, учитывается переменная среды `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`. Это следует использовать только на лично контролируемых сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Подробное руководство по модулям cloudstack можно найти в Руководстве по облаку CloudStack.
Этот модуль поддерживает режим проверки.

Примеры

- name: create a new private / public key pair
  ngine_io.cloudstack.cs_sshkeypair:
    name: linus@example.com
  register: key

- debug:
    msg: 'Private key is {{ key.private_key }}'

- name: remove a public key by its name
  ngine_io.cloudstack.cs_sshkeypair:
    name: linus@example.com
    state: absent

- name: register your existing local public key
  ngine_io.cloudstack.cs_sshkeypair:
    name: linus@example.com
    public_key: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"

Значения возврата

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

Ключ	Описание
fingerprint строка	Отпечаток SSH-открытого ключа. Возвращается: success Пример: `"86:5e:a3:e8:bd:95:7b:07:7c:c2:5c:f7:ad:8b:09:28"`
id строка	UUID SSH-открытого ключа. Возвращается: success Пример: `"a6f7a5fc-43f8-11e5-a151-feff819cdc9f"`
name строка	Имя SSH-открытого ключа. Возвращается: success Пример: `"linus@example.com"`
private_key строка	Закрытый ключ сгенерированной пары SSH-ключей. Возвращается: changed Пример: `"-----BEGIN RSA PRIVATE KEY----- MII...8tO -----END RSA PRIVATE KEY----- "`

Авторы

René Moser (@resmo)

Ссылки на коллекцию

© 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/ngine_io/cloudstack/cs_sshkeypair_module.html