aws/sam: add username SAM and example

Readme.md

@@ -4,9 +4,10 @@
 
 [GitHub Actions](https://github.com/features/actions) for automating builds, deployments, and so on.
 
-- [Up](./up) — Deploy serverless applications and APIs to AWS Lambda
+- [Up](./up) — Deploy serverless applications and APIs to [AWS Lambda](https://aws.amazon.com/lambda/)
 - [Go](./go) — Build Go applications
 - [Slack](./slack) — Send Slack messages
+- [AWS SAM](./aws/sam) — Deploy serverless infrastructure with [AWS SAM](https://aws.amazon.com/serverless/sam/)
 
 ## Resources
 

aws/sam/Readme.md

@@ -13,3 +13,45 @@ See the [AWS Security Credentials](https://docs.aws.amazon.com/general/latest/gr
 
 - `AWS_DEFAULT_REGION`- **Optional** The AWS region name, defaults to `us-east-1` ([more info](https://docs.aws.amazon.com/general/latest/gr/rande.html))
 - `AWS_DEFAULT_OUTPUT`- **Optional** The CLI's output output format, defaults to `json` ([more info](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html))
+
+## Example
+
+Package and deploy AWS SAM application with Slack notifications:
+
+```hcl
+workflow "Deployment" {
+  on = "push"
+  resolves = ["Deploy Notification"]
+}
+
+action "Build" {
+  uses = "apex/actions/aws/sam@master"
+  secrets = ["AWS_SECRET_ACCESS_KEY", "AWS_ACCESS_KEY_ID"]
+  args = "package --template-file template.yml --output-template-file out.yml --s3-bucket my-bucket-name"
+}
+
+action "Build Notification" {
+  needs = "Build"
+  uses = "apex/actions/[email protected]"
+  secrets = ["SLACK_WEBHOOK_URL"]
+}
+
+action "Deploy" {
+  needs = "Build Notification"
+  uses = "apex/actions/aws/sam@master"
+  secrets = ["AWS_SECRET_ACCESS_KEY", "AWS_ACCESS_KEY_ID"]
+  args = "deploy --stack-name myapp --capabilities CAPABILITY_IAM --template-file out.yml"
+  env = {
+    AWS_DEFAULT_REGION = "us-west-2"
+  }
+}
+
+action "Deploy Notification" {
+  needs = "Deploy"
+  uses = "apex/actions/[email protected]"
+}
+```
+
+## Notes
+
+This action generates a Slack message upon deployment.

aws/sam/entrypoint.sh

@@ -27,6 +27,7 @@ footer="Completed in ${duration}s"
 
 cat <<EOF > slack.json
 {
+  "username": "SAM",
   "icon_url": "$icon",
   "attachments": [
     {

go/Readme.md

@@ -6,7 +6,7 @@ GitHub Action for using the `go` binary. `GO111MODULE` is enabled and encouraged
 
 Deploy an application to `production` after building the Go binary. By default `./server` is built from `*.go` files, so if you Go source is in root this should work great!
 
-```
+```hcl
 workflow "Deployment" {
   on = "push"
   resolves = ["Deploy"]
@@ -26,7 +26,7 @@ action "Deploy" {
 
 Alternatively you can specify the build command:
 
-```
+```hcl
 workflow "Deployment" {
   on = "push"
   resolves = ["Deploy"]

slack/Readme.md

@@ -17,7 +17,7 @@ GitHub Action for sending Slack messages which were defined by previous action(s
 This example sends a Slack notification after a deployment is complete. The `apex/actions/up`
 action generates a slack.json to provide a message.
 
-```
+```hcl
 workflow "Deployment" {
   on = "push"
   resolves = ["Deploy Notification"]

up/Readme.md

@@ -45,7 +45,7 @@ Deploy an application to `production` after installing NPM dependencies
 in a separate action, note that Up's build hooks are disabled here with `--no-build` since
 we have already built the application.
 
-```
+```hcl
 workflow "Deploy Application" {
   on = "push"
   resolves = ["Deploy"]