serverless – Управляет проектом Serverless Framework
Обзор
- Обеспечивает поддержку управления развертыванием и стеками проектов Serverless Framework (https://serverless.com/).
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- serverless
- yaml
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| deploy boolean |
| Определяет, нужно ли развертывать артефакты после их сборки. Когда этот параметр false, все функции будут собраны, но обновление стека для их отправки не будет выполнено.Это полезно в основном для генерации артефактов, которые будут храниться/развертываться в другом месте. |
| force boolean добавлено в 2.7 |
| Определяет, нужно ли принудительно выполнить полное развертывание, эквивалентно параметру serverless --force. |
| functions список | Значение по умолчанию: [] | Список конкретных функций для развертывания. Если параметр не указан, будут развернуты все функции в службе. |
| region строка | Регион AWS для развертывания службы. Этот параметр по умолчанию us-east-1. | |
| serverless_bin_path путь добавлено в 2.4 | Путь к бинарному файлу серверлесс фреймворка относительно 'service_path', например, node_module/.bin/serverless | |
| service_path путь / обязательно | Путь к корню службы Serverless, над которой выполняется операция. | |
| stage строка | Имя стадии проекта серверлесс фреймворк для развертывания. Используется значение по умолчанию "dev" серверлесс фреймворка. | |
| state строка |
| Целевое состояние заданной стадии/проекта. |
| verbose boolean добавлено в 2.7 |
| Показывает все события стека во время развертывания и отображает все выходные данные стека. |
Примечания
Примечание
- В настоящее время команда
serverlessдолжна быть в пути к узлу, выполняющему задачу. В будущем это может быть флагом.
Примеры
- name: Basic deploy of a service
serverless:
service_path: '{{ project_dir }}'
state: present
- name: Deploy specific functions
serverless:
service_path: '{{ project_dir }}'
functions:
- my_func_one
- my_func_two
- name: Deploy a project, then pull its resource list back into Ansible
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
serverless:
stage: dev
region: us-east-1
service_path: '{{ project_dir }}'
serverless_bin_path: node_modules/.bin/serverless
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| command строка | всегда | Полная команда `serverless`, запущенная этим модулем, в случае если вы хотите повторно запустить команду вне модуля. Пример: serverless deploy --stage production |
| service_name строка | всегда | Имя службы, указанное в serverless.yml, которое только что было развернуто. Пример: my-fancy-service-dev |
| state строка | всегда | Является ли стек проекта серверлесс присутствующим/отсутствующим. |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Ryan Scott Brown (@ryansb)
Подсказка
Если вы заметите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/serverless_module.html