amazon.aws.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)}}'

Авторы

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