Lambda Console

☁️🐚 A CLI to run shell commands or interact with your application on Lambda.

⬇️ Installation

npm install -g lambda-console-cli

🐚 Usage

...

🏘️ Implementations

Have you created a language-specific package or implemented the Lambda Console specification in your framework? Open an GitHub issue and share your project with us. We will add it to this list below.

• Ruby: The lambda-console-ruby gem for any Ruby Lambda.
• Rails: Integrated into the Lamby v5 for Rails on Lambda.

📐 Specification

Please see Lambda Console (Ruby) for a full reference implementation of the Lambda Console spec in Ruby.

Event Structure

The event structure for Lambda Console language specific implementation must conform to the following JSON schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "X_LAMBDA_CONSOLE": {
      "type": "object",
      "oneOf": [
        {
          "properties": {
            "run": {
              "type": "string"
            }
          },
          "required": ["run"],
          "additionalProperties": false
        },
        {
          "properties": {
            "interact": {
              "type": "string"
            }
          },
          "required": ["interact"],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": ["X_LAMBDA_CONSOLE"]
}

More succinctly, one of the two examples are acceptable event types.

Run Commands: For running shell commands.

{ "X_LAMBDA_CONSOLE": { "run": "cat /etc/os-release" } }

Interact Commands: Interact in the context of your program. Like IRB for Ruby.

{ "X_LAMBDA_CONSOLE": { "interact": "User.find(1)" } }

Response Formats

These rules apply to any implementation Lambda response for the Lambda Console to work properly.

Run Commands

• statusCode: Either 0 if no error or 1 if an error occurred.
• body: Combined string of standard out and error in the order they happened.

Interact Commands

• statusCode: Either 200 if no error or 422 if an error occurred.
• body: String response of the expression evaluated by your program.

Recommendations

• Run: Should assume the Lambda task/application root as the present working directory.
• Run: Should capture standard out and error in a single stream.
• Interactive: Should be run from a language's main context or binding.

Future Ideas

• Should our interact command capture all stdout or just the return of the evaluated expression?
• Can we leverage some pseudo-tty features for run commands to support features like ANSI colors?

Permission

The user running this CLI will need the following IAM actions associated with their user or role:

• lambda:ListFunctions
• lambda:InvokeFunction

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/rails-lambda/lambda-console. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Lambda Console project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.