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 ключ', 'created_at': 'ГГГГ-ММ-ДДЧЧ:ММ:СС', 'read_only': False}] |
| key словарь | успех | Метаданные о только что созданном ключе. Присутствует только при state=present Пример: {'id': 0, 'key': 'Ключ в кодировке BASE64', 'url': 'http://example.com/github ключ', 'created_at': 'ГГГГ-ММ-ДДЧЧ:ММ:СС', 'read_only': False} |
| matching_keys список | При state=present | Массив ключей, соответствующих указанному имени. Присутствует только при state=present Пример: [{'id': 0, 'key': 'Ключ в кодировке BASE64', 'url': 'http://example.com/github ключ', '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.7/modules/github_key_module.html
