In true newline-fashion, we'll get *rolling* with a practical application right away. We're creating a fully functional, dice-rolling chat bot for Slack!

Create a Serverless Slack Bot with AWS Lambda and Python

Introduction

There's no `AWS Lambda` without `AWS`. That means we'll need a few AWS resources created and configured on the AWS side of things to develop and effectively.

How to Setup a Free AWS Developer Environment

Here, we'll configure an `AWS Workspace` or `AWS EC2 Instance` as the development environment to use for developing for AWS Lambda.

How to Configure EC2 and AWS Workspaces Local Credentials

Configuring Your AWS Environment

We can comfortably develop for AWS Lambda with python on any modern Operating System

Setup a Local Python AWS Lambda Development Environment

We will be using the AWS Lambda runtime for the latest stable version of Python 3 - `python3.7`.

Installing Python 3 and Pyenv on MacOS, Windows, and Linux

The easiest way to configure our local development with our credentials is to run the command `aws configure`

How to Login to AWS CLI and Configure Default Region

Configuring Your Local Machine

How Our Slack Bot "Dicebot" Will Work

How to Create an AWS S3 Bucket for Lambda Artifacts

How to Code a Lambda Hello World Function with AWS SAM

How to Test AWS Lambda Functions Locally With Docker

The Beginner Guide to AWS Lambda Deployment

Creating Hello-world Lambda

How to Create a Slack Bot

How to Code a Python Dice Rolling Simulator Program

How to Turn Serverless Python Lambda Code Into a Slack Bot

Testing Our Serverless Slack Dicebot with Docker Locally

Cleaning Up Our Serverless Dicebot Deployment

Creating Dicebot Lambda

*Serverless Computing* may sound like a scary topic, but with the rise of AWS Lambda and mature tools supporting it - it's more approachable than ever. In this newline course, we're going to learn what serverless technology is and isn't, and why it belongs in your developer toolbox. We'll see that for certain common projects - like custom chat bot creation - AWS Lambda really shines for it's simplicity, affordability, and ability to integrate with the wider AWS ecosystem. 

Some developers love using serverless tech because it helps them save money, scale quickly, and deliver on reliability goals. While all of those things are possible with Lambda (especially cost savings which are common - but certainly not guaranteed), it's the development agility and reduction of operations overhead that drives my love for the service. It's a relief to be able to get right into the code, without worrying about configuring operating systems, deploying containers, or scaling clusters. Serverless on Lambda gives developers the resources needed to write, deploy, and _maintain_ production-ready software - all without significant operational overhead.

In true newline-fashion, we'll get *rolling* with a practical application right away. RPG players rejoice - we're creating a fully functional, dice-rolling chat bot for Slack! While the example bot will be for Slack, the same idea can be easily adapted to create a bot for Telegram, Discord, or nearly any other chat service with a bot API. 

We will be using Python 3 for this project, but it's worth noting that [AWS Lambda works with other common languages and runtimes](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html), including NodeJS, Java, ruby, go, and .NET. The basic mechanisms of creating, testing, and deploying your Lambda do not vary significantly based on your runtime choice.

By the end of this course you'll:

* Deploy a Slack Bot that runs on AWS Lambda
* Understand how to keep your AWS account secure
* Be able to deploy custom Lambda functions
* Understand serverless architecture and how it works

In this course we'll build and deploy a Serverless Slack Bot using AWS Lambda and Python. Along the way you'll learn about proper security, how lambda works, and how to deploy your service.

Create a Serverless Slackbot with AWS Lambda and Python

How to deploy a serverless bot into production

Remember to execute this command from the 

$ sam build -u && sam local invoke --event events/valid_roll_2d20.json
...
START RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c Version: $LATEST
{'body': 'text=2d20'}
{'dice_roll': '2d20', 'results': [5, 7]}
END RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c
REPORT RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c  Duration: 3.49 ms       Bill
ed Duration: 100 ms     Memory Size: 128 MB     Max Memory Used: 31 MB
{"statusCode":200,"body":"{\"response_type\": \"in_channel\", \"text\": \"[5, 7] = 1
2\", \"attachments\": [{\"text\": \"rolled 2d20\"}]}"}

$ sam build -u && sam local invoke --event events/invalid_roll_a.json
...START RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84 Version: $LATEST
{'body': 'text=a'}
END RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84
REPORT RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84  Duration: 2.91 ms       Bill
ed Duration: 100 ms     Memory Size: 128 MB     Max Memory Used: 31 MB
{"statusCode":400,"body":"{\"text\": \"invalid literal for int() with base 10: 'a'\"
}"}

 was returned when valid input was given, and 

 when invalid input was given. If the function was to fail for a reason besides invalid input or output, we would expect to see a status code of 

 returned. If that happens, it means we messed up somewhere in our function code and need to check the log output!

Since we already did the initial deployment for (#hello-world-deploy], this section will actually be an update to that deployment, but the commands are exactly the same.

 directory, re-package this update first.

sam package \
    --template-file template.yaml \
    --output-template-file packaged.yaml \
    --s3-bucket <your-bucket-name>

---
title: Testing Our Serverless Slack Dicebot with Docker Locally
isPublicLesson: false
code: https://gitlab.com/fullstackio/books/newline-course-apps/stephanie-prime-create-a-serverless-slack-bot-with-aws-lambda-and-python-app/-/tree/main/code/dicebot
---

# Testing Our Serverless Slack Dicebot with Docker Locally

As we did in the [Test hello_world](#test-hello-world) step above, let's test our new events!

Remember to execute this command from the `dicebot` directory, and not the `first_function` or `events` directory!

    $ sam build -u && sam local invoke --event events/valid_roll_2d20.json
    ...
    START RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c Version: $LATEST
    {'body': 'text=2d20'}
    {'dice_roll': '2d20', 'results': [5, 7]}
    END RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c
    REPORT RequestId: 210c2c8c-290e-1d47-64ff-bfc7b693234c  Duration: 3.49 ms       Bill
    ed Duration: 100 ms     Memory Size: 128 MB     Max Memory Used: 31 MB
    {"statusCode":200,"body":"{\"response_type\": \"in_channel\", \"text\": \"[5, 7] = 1
    2\", \"attachments\": [{\"text\": \"rolled 2d20\"}]}"}

    $ sam build -u && sam local invoke --event events/invalid_roll_a.json
    ...START RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84 Version: $LATEST
    {'body': 'text=a'}
    END RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84
    REPORT RequestId: 5edfc030-edde-1961-4131-50d50ccb8d84  Duration: 2.91 ms       Bill
    ed Duration: 100 ms     Memory Size: 128 MB     Max Memory Used: 31 MB
    {"statusCode":400,"body":"{\"text\": \"invalid literal for int() with base 10: 'a'\"
    }"}

Great, so the output shows a `statusCode` of `200` was returned when valid input was given, and `statusCode` of `400` when invalid input was given. If the function was to fail for a reason besides invalid input or output, we would expect to see a status code of `500` returned. If that happens, it means we messed up somewhere in our function code and need to check the log output!