aws_codecommit – Управление репозиториями в AWS CodeCommit
Новая версия 2.8.
Описание
- Поддерживает создание и удаление репозиториев CodeCommit.
- Дополнительную информацию о CodeCommit см. на странице https://aws.amazon.com/codecommit/.
Требования
Ниже перечислены требования, которые необходимы на хосте, выполняющем этот модуль.
- boto
- boto3
- botocore
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key строка | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key | |
| aws_secret_key строка | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key | |
| comment - | Описание или комментарий к репозиторию. | |
| debug_botocore_endpoint_logs логический тип добавлен в 2.8 |
| Использование регистратора botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполняемых во время задачи, выводящих набор в ключ task results. Используйте обратный вызов aws_resource_action для вывода в общий список, сделанный во время выполнения playbook. Также может использоваться переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS. |
| ec2_url строка | URL для подключения к облаку EC2 или Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL (если она задана). | |
| name - / обязательно | Имя репозитория. | |
| profile строка | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region строка | Регион AWS для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION (если она задана). См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_token строка | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| state - / обязательно |
| Определяет состояние репозитория. |
| validate_certs логический тип |
| При установке в «нет», сертификаты SSL для boto версий >= 2.6.0 не будут проверятся. |
Примечания
Примечание
- Если параметры не установлены в модуле, следующие переменные окружения могут быть использованы в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONобычно используются для указания региона AWS, когда это требуется, но это также можно настроить в конфигурационном файле boto
Примеры
# Create a new repository
- aws_codecommit:
name: repo
state: present
# Delete a repository
- aws_codecommit:
name: repo
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| repository_metadata сложный тип | всегда | Информация о репозитории. | |
| account_id строка | при наличии состояния | Идентификатор учетной записи AWS, связанной с репозиторием. Пример: 268342293637 | |
| arn строка | при наличии состояния | Amazon Resource Name (ARN) репозитория. Пример: arn:aws:codecommit:ap-northeast-1:268342293637:username | |
| clone_url_http строка | при наличии состояния | URL для клонирования репозитория по протоколу HTTPS. Пример: https://git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/reponame | |
| clone_url_ssh строка | при наличии состояния | URL для клонирования репозитория по протоколу SSH. Пример: ssh://git-codecommit.ap-northeast-1.amazonaws.com/v1/repos/reponame | |
| creation_date строка | при наличии состояния | Дата и время создания репозитория в формате временной метки. Пример: 2018-10-16T13:21:41.261000+09:00 | |
| last_modified_date строка | при наличии состояния | Дата и время последнего изменения репозитория в формате временной метки. Пример: 2018-10-16T13:21:41.261000+09:00 | |
| repository_description строка | при наличии состояния | Комментарий или описание репозитория. Пример: test from ptux | |
| repository_id строка | всегда | Идентификатор репозитория, который был создан или удален. Пример: e62a5c54-i879-497b-b62f-9f99e4ebfk8e | |
| repository_name строка | при наличии состояния | Имя репозитория. Пример: reponame | |
| response_metadata сложный тип | всегда | Информация о ответе. | |
| http_headers словарь | всегда | HTTP-заголовки ответа. | |
| http_status_code строка | всегда | HTTP-код состояния ответа. Пример: 200 | |
| request_id строка | всегда | Идентификатор HTTP-запроса. Пример: fb49cfca-d0fa-11e8-85cb-b3cc4b5045ef | |
| retry_attempts строка | всегда | Количество попыток повтора. Пример: 0 | |
Статус
- Данный модуль не гарантирует обратной совместимости. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Shuang Wang (@ptux)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/aws_codecommit_module.html