community.general.serverless – Управляет проектом Serverless Framework
Примечание
Этот плагин входит в состав коллекции community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general
Для использования в книге задач, укажите: community.general.serverless
Обзор
- Обеспечивает поддержку развертывания и создания стеков проектов Serverless Framework (https://serverless.com/).
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- serverless
- yaml
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| deploy boolean |
| Развертывать ли артефакты после их сборки. Когда этот параметр false, все функции будут собраны, но обновление стека для их отправки не будет выполнено.Это в основном полезно для генерации артефактов, которые будут храниться/развертываться в другом месте. |
| force boolean |
| Принудительно выполнить полное развертывание, эквивалентно параметру serverless --force. |
| functions list / elements=string | Значение по умолчанию: [] | Список конкретных функций для развертывания. Если это не указано, будут развернуты все функции в сервисе. |
| region string | Регион AWS для развертывания службы. Этот параметр по умолчанию us-east-1. | |
| serverless_bin_path path | Путь к бинарному файлу серверлесс фреймворка относительно 'service_path', например node_module/.bin/serverless | |
| service_path path / required | Путь к корню сервиса Serverless, с которым нужно работать. | |
| stage string | Имя стадии проекта серверлесс фреймворка для развертывания. Используется значение по умолчанию серверлесс фреймворка "dev". | |
| state string |
| Цель состояния заданной стадии/проекта. |
| verbose boolean |
| Показывает все события стека во время развертывания и отображает любые выходные данные стека. |
Примечания
Примечание
- В настоящее время команда
serverlessдолжна быть в пути узла, выполняющего задачу. В будущем это может быть флаг.
Примеры
- name: Basic deploy of a service
community.general.serverless:
service_path: '{{ project_dir }}'
state: present
- name: Deploy specific functions
community.general.serverless:
service_path: '{{ project_dir }}'
functions:
- my_func_one
- my_func_two
- name: Deploy a project, then pull its resource list back into Ansible
community.general.serverless:
stage: dev
region: us-east-1
service_path: '{{ project_dir }}'
register: sls
# The cloudformation stack is always named the same as the full service, so the
# cloudformation_info module can get a full list of the stack resources, as
# well as stack events and outputs
- cloudformation_info:
region: us-east-1
stack_name: '{{ sls.service_name }}'
stack_resources: true
- name: Deploy a project using a locally installed serverless binary
community.general.serverless:
stage: dev
region: us-east-1
service_path: '{{ project_dir }}'
serverless_bin_path: node_modules/.bin/serverless
Возвращаемые значения
Общие возвращаемые значения описаны в здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| command string | всегда | Полная команда `serverless`, запущенная этим модулем, в случае, если вы хотите повторно запустить команду вне модуля. Пример: serverless deploy --stage production |
| service_name string | всегда | Имя службы, указанное в serverless.yml, которое только что было развернуто. Пример: my-fancy-service-dev |
| state string | всегда | Наличие/отсутствие стека для проекта serverless. |
Авторы
- Ryan Scott Brown (@ryansb)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/serverless_module.html