serverless - Управляет проектом Serverless Framework
Новая версия с 2.3.
Обзор
- Предоставляет поддержку управления развертыванием и стеками проекта Serverless Framework (https://serverless.com/).
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- serverless
- yaml
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| deploy | Значение по умолчанию: да | Определяет, нужно ли развертывать артефакты после их построения. Когда этот параметр равен `false`, все функции будут построены, но обновление стека для отправки не будет выполнено. Это полезно в основном для создания артефактов, которые нужно хранить/развернуть в другом месте. |
| 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" Serverless Framework. | |
| state |
| Целевое состояние заданной стадии/проекта |
Примечания
Примечание
- В настоящее время команда
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. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Автор
- 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.5/modules/serverless_module.html