community.aws.aws_acm – Загрузка и удаление сертификатов в службе AWS Certificate Manager

• Обзор
• Требования
• Параметры
• Примечания
• Примеры
• Возвращаемые значения

Обзор

• Импортировать и удалять сертификаты в службе Certificate Manager (AWS ACM) Amazon Web Services.
• В настоящее время этот модуль не взаимодействует с сертификатами, предоставляемыми AWS. В данный момент он управляет только сертификатами, предоставленными пользователями AWS.
• API ACM позволяет пользователям загружать несколько сертификатов для одного имени домена, а также несколько идентичных сертификатов. Данный модуль пытается ограничить такие возможности, чтобы быть идемпотентным, в соответствии с философией Ansible. Для этого он применяет теги AWS ресурса «Имя» к сертификатам ACM.
• Когда state=present, если в ACM есть один сертификат с тегом Name равным параметру name_tag, и идентичным телом и цепочкой, эта задача завершится без каких-либо изменений.
• Когда state=present, если в ACM есть один сертификат с тегом Name, равным параметру name_tag, и отличным телом, эта задача перезапишет этот сертификат.
• Когда state=present, если в ACM есть несколько сертификатов с тегом Name, равным параметру name_tag, эта задача завершится ошибкой.
• Когда state=absent и certificate_arn определено, этот модуль удалит ресурс ACM с указанным ARN, если он существует в этой области, и завершится без изменений, если он не существует.
• Когда state=absent и domain_name определено, этот модуль удалит все ресурсы ACM в этой области AWS с соответствующим именем домена. Если таковых нет, задача завершится без изменений.
• Когда state=absent и certificate_arn не определено, и domain_name не определено, этот модуль удалит все ресурсы ACM в этой области AWS с соответствующим тегом Name. Если таковых нет, задача завершится без изменений.
• Обратите внимание, что это может не работать должным образом с ключами размером 4096 бит из-за ограничения API ACM.

Требования

Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.

• boto
• boto3
• python >= 2.6

Параметры

Примечания

Примеры

- name: upload a self-signed certificate
  community.aws.aws_acm:
    certificate: "{{ lookup('file', 'cert.pem' ) }}"
    privateKey: "{{ lookup('file', 'key.pem' ) }}"
    name_tag: my_cert # to be applied through an AWS tag as  "Name":"my_cert"
    region: ap-southeast-2 # AWS region

- name: create/update a certificate with a chain
  community.aws.aws_acm:
    certificate: "{{ lookup('file', 'cert.pem' ) }}"
    privateKey: "{{ lookup('file', 'key.pem' ) }}"
    name_tag: my_cert
    certificate_chain: "{{ lookup('file', 'chain.pem' ) }}"
    state: present
    region: ap-southeast-2
  register: cert_create

- name: print ARN of cert we just created
  ansible.builtin.debug:
    var: cert_create.certificate.arn

- name: delete the cert we just created
  community.aws.aws_acm:
    name_tag: my_cert
    state: absent
    region: ap-southeast-2

- name: delete a certificate with a particular ARN
  community.aws.aws_acm:
    certificate_arn: "arn:aws:acm:ap-southeast-2:123456789012:certificate/01234567-abcd-abcd-abcd-012345678901"
    state: absent
    region: ap-southeast-2

- name: delete all certificates with a particular domain name
  community.aws.aws_acm:
    domain_name: acm.ansible.com
    state: absent
    region: ap-southeast-2

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:

Авторы

• Matthew Davis (@matt-telstra) от имени Telstra Corporation Limited