github_deploy_key - Управляет ключами развертывания для репозиториев GitHub.
Новая версия с 2.4.
Обзор
- Добавляет или удаляет ключи развертывания для репозиториев GitHub. Поддерживает аутентификацию с использованием имени пользователя и пароля, имени пользователя и пароля с кодом двухфакторной аутентификации (OTP), маркером OAuth2 или персональным токеном доступа.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- python-requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| force bool |
| Если true, принудительно добавляет ключ развертывания, удалив все существующие ключи развертывания с тем же открытым ключом или названием. |
| key обязательно | Открытый SSH-ключ для добавления в репозиторий в качестве ключа развертывания. | |
| name обязательно | Имя ключа развертывания. псевдонимы: title, label | |
| otp | Шестизначный одноразовый пароль для двухфакторной аутентификации. Требуется вместе с именем пользователя и паролем. псевдонимы: 2fa_token | |
| owner обязательно | Имя индивидуальной учетной записи или организации, владеющей репозиторием GitHub. псевдонимы: учетная запись, организация | |
| password | Пароль для аутентификации. Здесь можно использовать персональный токен доступа вместо пароля. | |
| read_only bool |
| Если true, ключ развертывания сможет только читать содержимое репозитория. В противном случае ключ развертывания сможет читать и записывать. |
| repo обязательно | Имя репозитория GitHub. псевдонимы: репозиторий | |
| state |
| Состояние ключа развертывания. |
| token | Маркер OAuth2 или персональный токен доступа для аутентификации. Взаимоисключающее с паролем. | |
| username | Имя пользователя для аутентификации. |
Примечания
Примечание
- Обратитесь к документации API GitHub по адресу: https://developer.github.com/v3/repos/keys/.
Примеры
# add a new read-only deploy key to a GitHub repository using basic authentication
- github_deploy_key:
owner: "johndoe"
repo: "example"
name: "new-deploy-key"
key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAwXxn7kIMNWzcDfou..."
read_only: yes
username: "johndoe"
password: "supersecretpassword"
# remove an existing deploy key from a GitHub repository
- github_deploy_key:
owner: "johndoe"
repository: "example"
name: "new-deploy-key"
key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAwXxn7kIMNWzcDfou..."
force: yes
username: "johndoe"
password: "supersecretpassword"
state: absent
# add a new deploy key to a GitHub repository, replace an existing key, use an OAuth2 token to authenticate
- github_deploy_key:
owner: "johndoe"
repository: "example"
name: "new-deploy-key"
key: "{{ lookup('file', '~/.ssh/github.pub') }}"
force: yes
token: "ABAQDAwXxn7kIMNWzcDfo..."
# re-add a deploy key to a GitHub repository but with a different name
- github_deploy_key:
owner: "johndoe"
repository: "example"
name: "replace-deploy-key"
key: "{{ lookup('file', '~/.ssh/github.pub') }}"
username: "johndoe"
password: "supersecretpassword"
# add a new deploy key to a GitHub repository using 2FA
- github_deploy_key:
owner: "johndoe"
repo: "example"
name: "new-deploy-key-2"
key: "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDAwXxn7kIMNWzcDfou..."
username: "johndoe"
password: "supersecretpassword"
otp: 123456
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращенное значение | Описание |
|---|---|---|
| error строка | неудача | сообщение об ошибке, возвращенное API GitHub Пример: ключ уже используется |
| http_status_code целое число | неудача | код HTTP-статуса, возвращенный API GitHub Пример: 400 |
| id целое число | изменено | идентификатор ключа, назначенный GitHub для ключа развертывания Пример: 24381901 |
| msg строка | всегда | сообщение о статусе, описывающее произошедшее Пример: Ключ развертывания успешно добавлен |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Ali (@bincyber)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/github_deploy_key_module.html