Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/iopipe/lambda-shell

interactive shell for machines running on AWS Lambda
https://github.com/iopipe/lambda-shell

Last synced: about 2 months ago
JSON representation

interactive shell for machines running on AWS Lambda

Host: GitHub
URL: https://github.com/iopipe/lambda-shell
Owner: iopipe
License: apache-2.0
Created: 2016-07-29T17:00:58.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2017-01-16T01:22:25.000Z (over 7 years ago)
Last Synced: 2024-06-04T19:59:46.091Z (4 months ago)
Language: JavaScript
Homepage: https://www.iopipe.com
Size: 25.4 KB
Stars: 154
Watchers: 9
Forks: 11
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

Lambda shell - a lambda-backed Linux shell
------------------------------------------

Execute commands hosted and executed by AWS Lambda
via an interactive shell / terminal.

![VideoGif](https://raw.githubusercontent.com/iopipe/lambda-shell/master/contrib/demo.gif)

Requirements:
- Apex (http://apex.run)
- Amazon AWS account

# Installation

1. Modify project.json to include your own IAM role.
2. Install npm modules: `cd functions/exec; npm install`
3. Deploy to AWS with `apex deploy exec`.

# Usage

Execute `lambda-shell`:

```
$ ./lambda-shell
```

This will create a REPL (shell) where commands will be
sent to Lambda and returned to your console.

## Example

```
$ ./lambda-shell
$ uname -a
Linux ip-10-11-194-19 4.1.19-24.31.amzn1.x86_64 #1 SMP Tue Mar 15 23:41:50 UTC 2016 x86_64 x86_64 x86_64 GNU/Linux
```

# Exiting the shell

Exit the shell using Ctrl-C.

# Limitations

* No TTY is allocated. You cannot use `vim`, `emacs`, or even `ex`. Try `ed` or `sed` instead.
* The working path ($PWD) is never modified. (`cd` is not very effective...)A
* No guarantee that commands will land onto the same machine/container. (FEATURE!)
* Writes are ephemeral except to /tmp. (FEATURE!)

# License

Apache-2.0