community.aws.elasticache – Управление кластерами кэша в Amazon ElastiCache

Примечание

Этот плагин входит в коллекцию community.aws (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install community.aws

Чтобы использовать его в плейбуке, укажите: community.aws.elasticache

Новое в версии 1.0.0: of community.aws

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

Обзор

Управление кластерами кэша в Amazon ElastiCache.
Возвращает информацию о заданном кластере кэша.

Требования

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

boto
boto3
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key строка		Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Если задан параметр profile, этот параметр игнорируется. Передача параметров aws_access_key и profile одновременно устарела и параметры будут сделаны взаимоисключающими после 2022-06-01. псевдонимы: ec2_access_key, access_key
aws_ca_bundle путь		Расположение файла сертификата корневого центра для проверки SSL-сертификатов. Используется только для модулей, основанных на boto3. Примечание: Файл сертификата корневого центра читается со стороны модуля и может потребоваться явное копирование с контроллера, если он не запускается локально.
aws_config словарь		Словарь для изменения конфигурации botocore. Параметры можно найти по адресу https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config. Для модулей boto используется только ключ 'user_agent'. См. http://boto.cloudhackers.com/en/latest/boto_config_tut.html#boto для дополнительной конфигурации boto.
aws_secret_key строка		Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Если задан параметр profile, этот параметр игнорируется. Передача параметров aws_secret_key и profile одновременно устарела и параметры будут сделаны взаимоисключающими после 2022-06-01. псевдонимы: ec2_secret_key, secret_key
cache_engine_version строка		Номер версии движка кэша.
cache_parameter_group строка		Имя группы параметров кэша для связывания с этим кластером кэша. Если этот аргумент опущен, будет использоваться группа параметров кэша по умолчанию для указанного движка. псевдонимы: parameter_group
cache_port целое число		Номер порта, на котором каждый из узлов кэша будет принимать подключения.
cache_security_groups список / элементы=строка		Список имен групп безопасности кэша для связывания с этим кластером кэша. Должен быть пустым списком, если внутри VPC.
cache_subnet_group строка		Имя подсети группы для связывания. Используется только если внутри VPC. Требуется, если внутри VPC.
debug_botocore_endpoint_logs логическое значение	Варианты: нет ← да	Использование регистратора botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», выполненных во время задачи, выводящих набор в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода в общий список, выполненный во время плейбука. Также может быть использована переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS.
ec2_url строка		URL для подключения к EC2 или облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется для модулей, где регион требуется. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая есть. псевдонимы: aws_endpoint_url, endpoint_url
engine строка	По умолчанию: "memcached"	Имя движка кэша для использования. Поддерживаемые значения `redis` и `memcached`.
hard_modify логическое значение	Варианты: нет да	Определяет, необходимо ли уничтожить и воссоздать существующий кластер кэша, если это необходимо, чтобы изменить его состояние. По умолчанию `false`.
name строка / обязательно		Идентификатор кластера кэша.
node_type строка	По умолчанию: "cache.t2.small"	Вычислительные и запоминающие возможности узлов в кластере кэша.
num_nodes целое число	По умолчанию: 1	Начальное количество узлов кэша, которые будет иметь кластер кэша. Требуется, когда state=present.
profile строка		Использует профиль boto. Работает только с boto >= 2.24.0. Использование profile переопределяет aws_access_key, aws_secret_key и security_token. Поддержка одновременной передачи их вместе с profile устарела. aws_access_key, aws_secret_key и security_token будут взаимоисключающими с profile после 2022-06-01. псевдонимы: aws_profile
region строка		Регион AWS для использования. Если не указан, используется значение переменной среды AWS_REGION или EC2_REGION, если таковая имеется. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
security_group_ids список / элементы=строка		Список идентификаторов групп безопасности VPC для связывания с этим кластером кэша. Используется только если внутри VPC.
security_token строка		Токен безопасности AWS STS. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Если задан параметр profile, этот параметр игнорируется. Передача параметров security_token и profile одновременно устарела и параметры будут сделаны взаимоисключающими после 2022-06-01. псевдонимы: aws_security_token, access_token
state строка / обязательно	Варианты: present absent rebooted	`absent` или `present` — идемпотентные действия, которые создадут или уничтожат кластер кэша по мере необходимости. `rebooted` перезапустит кластер, что приведет к кратковременному перерыву в работе.
validate_certs логическое значение	Варианты: нет да ←	Если значение «нет», SSL-сертификаты не будут проверены для версий boto >= 2.6.0.
wait логическое значение	Варианты: нет да ←	Ожидание результата кластера кэша перед возвратом.
zone строка		EC2-зона доступности, в которой будет создан кластер кэша.

Примечания

Примечание

Если параметры не заданы в модуле, могут быть использованы следующие переменные среды в порядке убывания приоритета AWS_URL или EC2_URL, AWS_PROFILE или AWS_DEFAULT_PROFILE, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION, AWS_CA_BUNDLE
Ansible использует файл конфигурации boto (обычно ~/.boto), если учетные данные не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION могут использоваться для указания региона AWS, когда это необходимо, но это также можно настроить в файле конфигурации boto

Примеры

# Note: None of these examples set aws_access_key, aws_secret_key, or region.
# It is assumed that their matching environment variables are set.

- name: Basic example
  community.aws.elasticache:
    name: "test-please-delete"
    state: present
    engine: memcached
    cache_engine_version: 1.4.14
    node_type: cache.m1.small
    num_nodes: 1
    cache_port: 11211
    cache_security_groups:
      - default
    zone: us-east-1d


- name: Ensure cache cluster is gone
  community.aws.elasticache:
    name: "test-please-delete"
    state: absent

- name: Reboot cache cluster
  community.aws.elasticache:
    name: "test-please-delete"
    state: rebooted

Авторы

Jim Dalton (@jsdalton)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/aws/elasticache_module.html