mirror of
https://github.com/serverless/serverless.git
synced 2025-12-08 19:46:03 +00:00
87 lines
2.5 KiB
Markdown
87 lines
2.5 KiB
Markdown
<!--
|
|
title: Serverless Framework Commands - AWS Lambda - Create
|
|
menuText: create
|
|
menuOrder: 2
|
|
description: Creates a new Service in your current working directory
|
|
layout: Doc
|
|
-->
|
|
|
|
<!-- DOCS-SITE-LINK:START automatically generated -->
|
|
### [Read this on the main serverless docs site](https://www.serverless.com/framework/docs/providers/aws/cli-reference/create)
|
|
<!-- DOCS-SITE-LINK:END -->
|
|
|
|
# AWS - Create
|
|
|
|
Creates a new service in the current working directory based on the provided template.
|
|
|
|
**Create service in current working directory:**
|
|
|
|
```bash
|
|
serverless create --template aws-nodejs
|
|
```
|
|
|
|
**Create service in new folder:**
|
|
|
|
```bash
|
|
serverless create --template aws-nodejs --path myService
|
|
```
|
|
|
|
## Options
|
|
- `--template` or `-t` The name of one of the available templates. **Required**.
|
|
- `--path` or `-p` The path where the service should be created.
|
|
- `--name` or `-n` the name of the service in `serverless.yml`.
|
|
|
|
## Provided lifecycle events
|
|
- `create:create`
|
|
|
|
## Available Templates
|
|
|
|
To see a list of available templates run `serverless create --help`
|
|
|
|
Most commonly used templates:
|
|
|
|
- aws-nodejs
|
|
- aws-python
|
|
- aws-python3
|
|
- aws-groovy-gradle
|
|
- aws-java-maven
|
|
- aws-java-gradle
|
|
- aws-scala-sbt
|
|
- aws-csharp
|
|
- plugin
|
|
|
|
## Examples
|
|
|
|
### Creating a new service
|
|
|
|
```bash
|
|
serverless create --template aws-nodejs --name my-special-service
|
|
```
|
|
|
|
This example will generate scaffolding for a service with `AWS` as a provider and `nodejs` as runtime. The scaffolding
|
|
will be generated in the current working directory.
|
|
|
|
Your new service will have a default stage called `dev` and a default region inside that stage called `us-east-1`.
|
|
The provider which is used for deployment later on is AWS (Amazon web services).
|
|
|
|
### Creating a named service in a (new) directory
|
|
|
|
```bash
|
|
serverless create --template aws-nodejs --path my-new-service
|
|
```
|
|
|
|
This example will generate scaffolding for a service with `AWS` as a provider and `nodejs` as runtime. The scaffolding
|
|
will be generated in the `my-new-service` directory. This directory will be created if not present. Otherwise Serverless
|
|
will use the already present directory.
|
|
|
|
Additionally Serverless will rename the service according to the path you provide. In this example the service will be
|
|
renamed to `my-new-service`.
|
|
|
|
### Creating a new plugin
|
|
|
|
```
|
|
serverless create --template plugin
|
|
```
|
|
|
|
This example will generate scaffolding for a hello world plugin that demonstrates how to create a new command and how to listen to the various events available.
|