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>