aws_ssm – Получение значения параметра SSM или всех параметров в пути

• Описание
• Требования
• Параметры
• Примеры
• Статус

Описание

• Получение значения параметра Amazon Simple Systems Manager или иерархии параметров. Первый аргумент, передаваемый в поиск, может быть именем параметра или иерархией параметров. Иерархии начинаются с прямой косой черты и заканчиваются именем параметра. Может быть указано до 5 уровней.
• Если ищется явно указанный параметр по имени, который не существует, поиск вернёт значение None, которое Jinja2 интерпретирует как пустую строку. Вы можете использовать фильтр `default` для задания значения по умолчанию в этом случае, но должны установить второй параметр в значение true (см. примеры ниже).
• При поиске пути для параметров под ним будет возвращён словарь для каждого пути. Если под этим путём нет параметра, то возвращение будет успешным, но словарь будет пустым.
• Если поиск завершится ошибкой из-за отсутствия разрешений или из-за ошибки AWS-клиента, aws_ssm сгенерирует ошибку, обычно завершив текущую задачу Ansible. Это обычно правильно, так как игнорирование значения, к которому IAM не предоставляет доступ, может привести к более серьёзным проблемам, неправильному поведению или потере данных. Если вы хотите продолжить в этом случае, вам необходимо настроить две задачи Ansible: одну, которая задаёт переменную и игнорирует ошибки, и другую, которая использует значение этой переменной со значением по умолчанию. См. примеры ниже.

Требования

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

• boto3
• botocore

Параметры

Примеры

# lookup sample:
- name: lookup ssm parameter store in the current region
  debug: msg="{{ lookup('aws_ssm', 'Hello' ) }}"

- name: lookup ssm parameter store in nominated region
  debug: msg="{{ lookup('aws_ssm', 'Hello', region='us-east-2' ) }}"

- name: lookup ssm parameter store without decrypted
  debug: msg="{{ lookup('aws_ssm', 'Hello', decrypt=False ) }}"

- name: lookup ssm parameter store in nominated aws profile
  debug: msg="{{ lookup('aws_ssm', 'Hello', aws_profile='myprofile' ) }}"

- name: lookup ssm parameter store using explicit aws credentials
  debug: msg="{{ lookup('aws_ssm', 'Hello', aws_access_key=my_aws_access_key, aws_secret_key=my_aws_secret_key, aws_security_token=my_security_token ) }}"

- name: lookup ssm parameter store with all options.
  debug: msg="{{ lookup('aws_ssm', 'Hello', decrypt=false, region='us-east-2', aws_profile='myprofile') }}"

- name: lookup a key which doesn't exist, returns ""
  debug: msg="{{ lookup('aws_ssm', 'NoKey') }}"

- name: lookup a key which doesn't exist, returning a default ('root')
  debug: msg="{{ lookup('aws_ssm', 'AdminID') | default('root', true) }}"

- name: lookup a key which doesn't exist failing to store it in a fact
  set_fact:
    temp_secret: "{{ lookup('aws_ssm', '/NoAccess/hiddensecret') }}"
  ignore_errors: true

- name: show fact default to "access failed" if we don't have access
  debug: msg="{{ 'the secret was:' ~ temp_secret | default('could not access secret') }}"

- name: return a dictionary of ssm parameters from a hierarchy path
  debug: msg="{{ lookup('aws_ssm', '/PATH/to/params', region='ap-southeast-2', bypath=true, recursive=true ) }}"

- name: return a dictionary of ssm parameters from a hierarchy path with shortened names (param instead of /PATH/to/param)
  debug: msg="{{ lookup('aws_ssm', '/PATH/to/params', region='ap-southeast-2', shortnames=true, bypath=true, recursive=true ) }}"

- name: Iterate over a parameter hierarchy (one iteration per parameter)
  debug: msg='Key contains {{ item.key }} , with value {{ item.value }}'
  loop: '{{ lookup("aws_ssm", "/demo/", region="ap-southeast-2", bypath=True) | dict2items }}'

- name: Iterate over multiple paths as dictionaries (one iteration per path)
  debug: msg='Path contains {{ item }}'
  loop: '{{ lookup("aws_ssm", "/demo/", "/demo1/", bypath=True)}}'

Статус

• Этот поиск не гарантирует обратной совместимости интерфейса. [превью]
• Этот поиск поддерживается сообществом Ansible. [сообщество]

Авторы

• Bill Wang <ozbillwang(at)gmail.com>
• Marat Bakeev <hawara(at)gmail.com>
• Michael De La Rue <siblemitcom.mddlr@spamgourmet.com>