Spec-Zone.ru › Ansible 2.6

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
    Варианты:
  • present ←
  • absent
Состояние ключа развертывания.
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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API