serverless – Управляет проектом Serverless Framework
Новая версия 2.3.
Описание
- Предоставляет поддержку управления развертыванием и стеками проектов Serverless Framework (https://serverless.com/).
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- serverless
- yaml
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| deploy - | По умолчанию: "да" | Развертывать ли артефакты после их сборки. Если этот параметр равен `false`, все функции будут собраны, но обновление стека для их отправки не будет выполняться. Это полезно в основном для генерации артефактов, которые будут храниться/развертываться в другом месте. |
| force - добавлен в 2.7 | По умолчанию: "нет" | Принудительно выполнить полное развертывание, эквивалентно параметру `--force` в serverless. |
| functions - | По умолчанию: [] | Список конкретных функций для развертывания. Если этот параметр не указан, будут развернуты все функции в сервисе. |
| region - | По умолчанию: "us-east-1" | Регион AWS для развертывания службы |
| serverless_bin_path - добавлен в 2.4 | Путь к бинарному файлу Serverless Framework относительно 'service_path', например, node_module/.bin/serverless | |
| service_path - / обязательно | Путь к корню службы Serverless, над которой нужно выполнить операции. | |
| stage - | Имя стадии проекта Serverless Framework, в которую нужно развернуть. Используется значение по умолчанию серверного фреймворка "dev". | |
| state - |
| Целевое состояние данной стадии/проекта |
| verbose - добавлен в 2.7 | По умолчанию: "нет" | Отображает все события стека во время развертывания и выводит любые выходные данные стека. |
Примечания
Примечание
- В настоящее время команда
serverlessдолжна быть в пути узла, выполняющего задачу. В будущем это может быть флаг.
Примеры
# Basic deploy of a service
- serverless:
service_path: '{{ project_dir }}'
state: present
# Deploy specific functions
- serverless:
service_path: '{{ project_dir }}'
functions:
- my_func_one
- my_func_two
# 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_facts module can get a full list of the stack resources, as
# well as stack events and outputs
- cloudformation_facts:
region: us-east-1
stack_name: '{{ sls.service_name }}'
stack_resources: true
# Deploy a project but use a locally installed serverless binary instead of the global 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 строка | всегда | Наличие/отсутствие стека для проекта serverless. |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.7/modules/serverless_module.html