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 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('couldn't 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
  debug: msg='key contains {{item.Name}} with value {{item.Value}} '
  loop: '{{ query("aws_ssm", "/TEST/test-list", region="ap-southeast-2", bypath=true) }}'

Статус

Авторы

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