douglasnaphas / aws-sam-cli Goto Github PK

View Code? Open in Web Editor NEW

This project forked from aws/aws-sam-cli

0.0 2.0 0.0 23.33 MB

CLI tool to build, test, debug, and deploy Serverless applications using AWS SAM

Home Page: https://aws.amazon.com/serverless/sam/

License: Apache License 2.0

Go 0.14% JavaScript 0.09% Python 98.98% Makefile 0.07% C# 0.19% Java 0.30% Shell 0.01% Ruby 0.22%

aws-sam-cli's Introduction

AWS SAM (Beta)

The AWS Serverless Application Model (SAM) is an open-source framework for building serverless applications. It provides shorthand syntax to express functions, APIs, databases, and event source mappings. With just a few lines of configuration, you can define the application you want and model it.

Get Started

To get started with building SAM-based applications, use the SAM CLI. SAM CLI provides a Lambda-like execution environment that lets you locally build, test, debug, and deploy applications defined by SAM templates.

Install SAM CLI
Build & Deploy a "Hello World" Web App
Install AWS Toolkit to use SAM with your favorite IDEs.

Next Steps: Learn to build a more complex serverless application.

Extract text from images and store in a database using Amazon S3 and Amazon Rekognition services.
Detect when records are added to a database using Amazon DynamoDB database and asynchronous stream processing.

Detailed References: Explains SAM commands and usage in depth.

Why SAM

Single-deployment configuration. SAM makes it easy to organize related components and resources, and operate on a single stack. You can use SAM to share configuration (such as memory and timeouts) between resources, and deploy all related resources together as a single, versioned entity.
Local debugging and testing. Use SAM CLI to locally build, test, and debug SAM applications on a Lambda-like execution environment. It tightens the development loop by helping you find & troubleshoot issues locally that you might otherwise identify only after deploying to the cloud.
Deep integration with development tools. You can use SAM with a suite of tools you love and use.
- IDEs: PyCharm, IntelliJ, Visual Studio Code, Visual Studio, AWS Cloud9
- Build: CodeBuild
- Deploy: CodeDeploy, Jenkins
- Continuous Delivery Pipelines: CodePipeline
- Discover Serverless Apps & Patterns: AWS Serverless Application Repository
Built-in best practices. You can use SAM to define and deploy your infrastructure as configuration. This makes it possible for you to use and enforce best practices through code reviews. Also, with a few lines of configuration, you can enable safe deployments through CodeDeploy, and can enable tracing using AWS X-Ray.
Extension of AWS CloudFormation. Because SAM is an extension of AWS CloudFormation, you get the reliable deployment capabilities of AWS CloudFormation. You can define resources by using CloudFormation in your SAM template. Also, you can use the full suite of resources, intrinsic functions, and other template features that are available in CloudFormation.

What is this Github repository? 💻

This Github Repository contains source code for SAM CLI. Here is the development team talking about this code:

SAM CLI code is written in Python. Source code is well documented, very modular, with 95% unit test coverage. It uses this awesome Python library called Click to manage the command line interaction and uses Docker to run Lambda functions locally. We think you'll like the code base. Clone it and run make pr!

Contribute to SAM

We love our contributors ❤️ We have over 100 contributors who have built various parts of the product. Read this testimonial from @ndobryanskyy to learn more about what it was like contributing to SAM.

Depending on your interest and skill, you can help build the different parts of the SAM project;

Enhance the SAM Specification

Make pull requests, report bugs, and share ideas to improve the full SAM template specification. Source code is located on Github at awslabs/serverless-application-model. Read the SAM Specification Contributing Guide to get started.

Strengthen SAM CLI

Add new commands or enhance existing ones, report bugs, or request new features for the SAM CLI. Source code is located on Github at awslabs/aws-sam-cli. Read the SAM CLI Contributing Guide to get started.

Update SAM Developer Guide

SAM Developer Guide provides comprehensive getting started guide and reference documentation. Source code is located on Github at awsdocs/aws-sam-developer-guide. Read the SAM Documentation Contribution Guide to get started.

Join the SAM Community on Slack

Join the SAM developers channel (#samdev) on Slack to collaborate with fellow community members and the AWS SAM team.

aws-sam-cli's People

Contributors

Watchers

aws-sam-cli's Issues

Problem with Bash following aws-sam-cli install

| ~ @ Dougs-MacBook-Pro (dougnaphas) [13:20:06]                                                                                                                                                                                       [42/255]
| 6003 => brew install aws-sam-cli
==> Installing aws-sam-cli from aws/tap
==> Installing dependencies for aws/tap/aws-sam-cli: python
==> Installing aws/tap/aws-sam-cli dependency: python
==> Downloading https://homebrew.bintray.com/bottles/python-3.7.6_1.catalina.bottle.tar.gz
==> Downloading from https://akamai.bintray.com/38/3871ef8b53270576c46489ae397f245b84772c405085238790cf5faa1853b33a?__gda__=exp=1580581939~hmac=1b658f31fcbbf3dc5915c95516f6962836de28b5867a1ae057fd7c76be6513ae&response-content-disposition=
######################################################################## 100.0%
==> Pouring python-3.7.6_1.catalina.bottle.tar.gz
Error: The `brew link` step did not complete successfully
The formula built, but is not symlinked into /usr/local
Could not symlink Frameworks/Python.framework/Headers
Target /usr/local/Frameworks/Python.framework/Headers
is a symlink belonging to python@2. You can unlink it:
  brew unlink python@2

To force the link and overwrite all conflicting files:
  brew link --overwrite python

To list all files that would be deleted:
  brew link --overwrite --dry-run python

Possible conflicting files are:
/usr/local/Frameworks/Python.framework/Headers -> /usr/local/Cellar/python@2/2.7.17/Frameworks/Python.framework/Headers
/usr/local/Frameworks/Python.framework/Python -> /usr/local/Cellar/python@2/2.7.17/Frameworks/Python.framework/Python
/usr/local/Frameworks/Python.framework/Resources -> /usr/local/Cellar/python@2/2.7.17/Frameworks/Python.framework/Resources
/usr/local/Frameworks/Python.framework/Versions/Current -> /usr/local/Cellar/python@2/2.7.17/Frameworks/Python.framework/Versions/Current
==> /usr/local/Cellar/python/3.7.6_1/bin/python3 -s setup.py --no-user-cfg install --force --verbose --install-scripts=/usr/local/Cellar/python/3.7.6_1/bin --install-lib=/usr/local/lib/python3.7/site-packages --single-version-externally-m
==> /usr/local/Cellar/python/3.7.6_1/bin/python3 -s setup.py --no-user-cfg install --force --verbose --install-scripts=/usr/local/Cellar/python/3.7.6_1/bin --install-lib=/usr/local/lib/python3.7/site-packages --single-version-externally-m
==> /usr/local/Cellar/python/3.7.6_1/bin/python3 -s setup.py --no-user-cfg install --force --verbose --install-scripts=/usr/local/Cellar/python/3.7.6_1/bin --install-lib=/usr/local/lib/python3.7/site-packages --single-version-externally-m
==> Caveats
Python has been installed as
  /usr/local/bin/python3

Unversioned symlinks `python`, `python-config`, `pip` etc. pointing to
`python3`, `python3-config`, `pip3` etc., respectively, have been installed into
  /usr/local/opt/python/libexec/bin

If you need Homebrew's Python 2.7 run
  brew install python@2

You can install Python packages with
  pip3 install <package>
They will install into the site-package directory
  /usr/local/lib/python3.7/site-packages

See: https://docs.brew.sh/Homebrew-and-Python
==> Summary
🍺  /usr/local/Cellar/python/3.7.6_1: 3,977 files, 61MB
==> Installing aws/tap/aws-sam-cli
==> Downloading https://github.com/awslabs/aws-sam-cli/releases/download/v0.40.0//aws-sam-cli-0.40.0.sierra.bottle.tar.gz
==> Downloading from https://github-production-release-asset-2e65be.s3.amazonaws.com/92205085/17aa9e80-3233-11ea-923a-c426b99b155d?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIWNJYAX4CSVEH53A%2F20200201%2Fus-east-1%2Fs3%2Faws4_r
######################################################################## 100.0%
==> Pouring aws-sam-cli-0.40.0.sierra.bottle.tar.gz
🍺  /usr/local/Cellar/aws-sam-cli/0.40.0: 3,979 files, 63MB
==> Caveats
==> python
Python has been installed as
  /usr/local/bin/python3

Unversioned symlinks `python`, `python-config`, `pip` etc. pointing to
`python3`, `python3-config`, `pip3` etc., respectively, have been installed into
  /usr/local/opt/python/libexec/bin

If you need Homebrew's Python 2.7 run
  brew install python@2

You can install Python packages with
  pip3 install <package>
They will install into the site-package directory
  /usr/local/lib/python3.7/site-packages

See: https://docs.brew.sh/Homebrew-and-Python

Now new terminal windows print

python3: error: unable to find utility "python3", not a developer tool or in PATH

Fix OPTIONS handling

Upstream issue 1434, PRs 1464 and 1649.

TODO

Set up CloudFormation templates like start-api/swagger-template.yaml and start-api/template.yaml. Check the output template and a response to a curl (see Testing CORS) for OPTIONS handling.

Investigate CDK workshop example code dynamo request happening twice

The CDK workshop example, when run with SAM CLI, runs its Dynamo interactions twice. This can be observed from this commit on a project bootstrapped from the CDK workshop code.

Confirm the issue, do some investigation, and bring attention to it in the SAM CLI repo, the serverless channel of the AWS community Slack, and/or the CDK workshop repo.

douglasnaphas / aws-sam-cli Goto Github PK

aws-sam-cli's Introduction

AWS SAM (Beta)

Get Started

Why SAM

What is this Github repository? 💻

Contribute to SAM

Join the SAM Community on Slack

aws-sam-cli's People

Contributors

Watchers

aws-sam-cli's Issues

Problem with Bash following aws-sam-cli install

Fix OPTIONS handling

TODO

Investigate CDK workshop example code dynamo request happening twice

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent