AssemblyLift provides a Command Line Interface (CLI) called
asml. The CLI is primarily responsible for building & deploying your application.
You can install
$ cargo install assemblylift-cli
asml help will print the CLI version, as well as a list of commands:
$ asml helpasml 0.3.0USAGE:asml [SUBCOMMAND]FLAGS:-h, --help Prints help information-V, --version Prints version informationSUBCOMMANDS:bind Bind the application to the cloud backendburn Destroy all infrastructure created by 'bind'cast Build the AssemblyLift applicationhelp Prints this message or the help of the given subcommand(s)init Initialize a basic AssemblyLift applicationmake Make a new service or functionpack Pack artifacts for publishingpush Push artifacts to a registryuser User authentication & information
The default infrastructure provider for AssemblyLift is AWS Lambda + API Gateway, which require an Amazon AWS account.
You can create a new project with the
init command. This will scaffold a basic project structure with a single service, containing a single function.
$ asml init --name myapp$ tree myappmyapp├── assemblylift.toml└── services└── my-service├── my-function│ ├── Cargo.toml│ └── src│ └── lib.rs└── service.toml
If you like, you can verify everything is working by building the project with
cast and then deploying it with
AssemblyLift projects and services are defined in TOML documents called manifests. Each project must have a manifest at the project root called assemblylift.toml, and each service must have a manifest at the service root called service.toml.
Each function is stored in a sub-directory under the service directory. Function directories are structured according to the given programming language.