All Projects → apex → Apex Shell

apex / Apex Shell

Licence: mit
Interactive shell for executing commands in AWS Lambda containers.

Programming Languages

go
31211 projects - #10 most used programming language

Apex Shell

The apex-shell(1) command allows you to execute commands in an AWS Lambda function via an interactive shell.

Installation

Grab a binary release, or install via go-get:

$ go get github.com/apex/apex-shell

About

Why on earth would you want to do this? Running arbitrary commands in AWS Lambda allows you to do things such as verify that AWS roles have adequate permissions to interact with other resources, inspecting what environment variables are presented by AWS, or simply taking a peek at the file structure of a Lambda container.

Usage

First thing to note is that apex-shell(1) requires that you run it in an Apex project directory, aka one with a ./project.json. This is because apex-shell(1) currently utilizes many Apex features and configuration information to do its thing.

You should have your AWS profile set via export AWS_PROFILE=name, unless the "default" profile is to be used. Then execute:

$ apex-shell

You should see the following prompt, after which all commands are executing in an AWS Lambda container.

AWS Lambda shell

Use ^C or ^D to shut down the shell and remove the function.

Badges


tjholowaychuk.com  ·  GitHub @tj  ·  Twitter @tjholowaychuk

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].