github_key – Управление ключами доступа GitHub
Новая версия 2.2.
Описание
- Создает, удаляет или обновляет ключи доступа GitHub.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| force boolean |
| Значение по умолчанию — yes, которое заменит существующий удалённый ключ, если он отличается от pubkey. Если no, ключ будет установлен только в том случае, если ключ с заданным name не существует. |
| name - / обязательно | Имя SSH-ключа | |
| pubkey - | Значение открытого SSH-ключа. Требуется, когда state=present. | |
| state - |
| Удалить ключ, убедиться, что он существует, или обновить его значение. |
| token - / обязательно | Токен доступа к GitHub с разрешением на просмотр и создание открытых ключей. |
Примеры
- name: Read SSH public key to authorize
shell: cat /home/foo/.ssh/id_rsa.pub
register: ssh_pub_key
- name: Authorize key with GitHub
local_action:
module: github_key
name: Access Key for Some Machine
token: '{{ github_access_token }}'
pubkey: '{{ ssh_pub_key.stdout }}'
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращается | Описание |
|---|---|---|
| deleted_keys список | Когда state=absent | Массив объектов ключей, которые были удалены. Присутствует только при state=absent Пример: [{'id': 0, 'key': 'Ключ в кодировке BASE64', 'url': 'http://example.com/github key', 'created_at': 'ГГГГ-ММ-ДДЧЧ:ММ:СС', 'read_only': False}] |
| key словарь | успех | Метаданные о только что созданном ключе. Присутствует только при state=present Пример: {'id': 0, 'key': 'Ключ в кодировке BASE64', 'url': 'http://example.com/github key', 'created_at': 'ГГГГ-ММ-ДДЧЧ:ММ:СС', 'read_only': False} |
| matching_keys список | Когда state=present | Массив ключей, соответствующих указанному имени. Присутствует только при state=present Пример: [{'id': 0, 'key': 'Ключ в кодировке BASE64', 'url': 'http://example.com/github key', 'created_at': 'ГГГГ-ММ-ДДЧЧ:ММ:СС', 'read_only': False}] |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Robert Estelle (@erydo)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/github_key_module.html
