Giter VIP home page Giter VIP logo

go-serverless-bro's Introduction

Serverless Framework

Let's create and deploy a new service function on AWS Lambda using the Serverless Framework.

Pocket guide

Proudly brought to you by:

Get an AWS account

 mkdir -p ~/Sites/go-serverless-bro

cd ~/Sites/go-serverless-bro
nvm install 6.10
nvm use 6.10

Install the Serverless Framework

npm install -g serverless

verify its installation:

serverless
Commands
* You can run commands with "serverless" or the shortcut "sls"
* Pass "--verbose" to this command to get in-depth plugin info
* Pass "--no-color" to disable CLI colors
* Pass "--help" after any <command> for contextual help

Framework
* Documentation: https://serverless.com/framework/docs/

config ........................ Configure Serverless
config credentials ............ Configures a new provider profile for the Serverless Framework
create ........................ Create new Serverless service
deploy ........................ Deploy a Serverless service
deploy function ............... Deploy a single function from the service
deploy list ................... List deployed version of your Serverless Service
deploy list functions ......... List all the deployed functions and their versions
info .......................... Display information about the service
install ....................... Install a Serverless service from GitHub or a plugin from the Serverless registry
invoke ........................ Invoke a deployed function
invoke local .................. Invoke function locally
logs .......................... Output the logs of a deployed function
metrics ....................... Show metrics for a specific function
package ....................... Packages a Serverless service
plugin ........................ Plugin management for Serverless
plugin install ................ Install and add a plugin to your service
plugin uninstall .............. Uninstall and remove a plugin from your service
plugin list ................... Lists all available plugins
plugin search ................. Search for plugins
print ......................... Print your compiled and resolved config file
remove ........................ Remove Serverless service and all resources
rollback ...................... Rollback the Serverless service to a specific deployment
rollback function ............. Rollback the function to the previous version
slstats ....................... Enable or disable stats

Platform (Beta)
* The Serverless Platform is currently in experimental beta. Follow the docs below to get started.
* Documentation: https://serverless.com/platform/docs/

emit .......................... Emits an event to a running Event Gateway
login ......................... Login or sign up for the Serverless Platform
logout ........................ Logout from the Serverless Platform
run ........................... Runs the Event Gateway and the Emulator

Plugins
AwsConfigCredentials, Config, Create, Deploy, Emit, Info, Install, Invoke, Login, Logout, Logs, Metrics, Package, Plugin, PluginInstall, PluginList, PluginSearch, PluginUninstall, Print, Remove, Rollback, Run, SlStats

Display its current version:

serverless --version
1.26.1

AWS Console

Create a new user

AWS account

Provide a username and a password. During creation please check only their Administrator Access.

User Details

then set the Administrator Access permission:

User Details

Please download the credentials.csv file and copy the AWS Management Console URL.

User Details

Set up the Serverless Framework with your Amazon Web Services account

For a more permanent solution we are going to set up credentials through AWS profiles.

Setup with serverless config credentials command

Serverless provides a convenient way to configure AWS profiles with the help of the serverless config credentials command.

serverless config credentials --provider aws --key HACKERMANKEY --secret HACKERMANSECRET --overwrite

Serverless: Setting up AWS...
Serverless: Saving your AWS profile in "~/.aws/credentials"...
Serverless: Success! Your AWS access keys were stored under the "default" profile.

Inspect ~/.aws/credentials file

code ~/.aws/credentials

[default]
aws_access_key_id = HACKERMANKEY
aws_secret_access_key = HACKERMANSECRET

Let's create our brand new service

serverless create -t aws-nodejs --name go-serverless-bro
Serverless: Generating boilerplate...
 _______                             __
|   _   .-----.----.--.--.-----.----|  .-----.-----.-----.
|   |___|  -__|   _|  |  |  -__|   _|  |  -__|__ --|__ --|
|____   |_____|__|  \___/|_____|__| |__|_____|_____|_____|
|   |   |             The Serverless Application Framework
|       |                           serverless.com, v1.26.1
 -------'

Serverless: Successfully generated boilerplate for template: "aws-nodejs"
ll
.gitignore
README.md
handler.js
serverless.yml

code handler.js

'use strict';

module.exports.happyHackingBro = (event, context, callback) => {
  const response = {
    statusCode: 200,
    body: JSON.stringify({
      message: 'Happy Hacking Bro!',
      input: event,
    }),
  };

  callback(null, response);
};

code serverless.yml

service: happy-hacking-bro

provider:
  name: aws
  runtime: nodejs6.10

functions:
  happyHackingBro:
    handler: handler.happyHackingBro
    events:
      - http:
          path: bro
          method: get

AWS - deploy

Deploys your entire service via CloudFormation.

Run this command when you have made infrastructure changes (i.e., you edited serverless.yml).

Use serverless deploy function -f myFunction when you have made code changes and you want to quickly upload your updated code to AWS Lambda or just change function configuration.

serverless deploy
Serverless: Packaging service...
Serverless: Excluding development dependencies...
Serverless: Creating Stack...
Serverless: Checking Stack create progress...
.....
Serverless: Stack create finished...
Serverless: Uploading CloudFormation file to S3...
Serverless: Uploading artifacts...
Serverless: Uploading service .zip file to S3 (5.19 KB)...
Serverless: Validating template...
Serverless: Updating Stack...
Serverless: Checking Stack update progress...
...............................
Serverless: Stack update finished...
Service Information
service: happy-hacking-bro
stage: dev
region: us-east-1
stack: happy-hacking-bro-dev
api keys:
  None
endpoints:
  GET - https://hackerman.execute-api.us-east-1.amazonaws.com/dev/bro
functions:
  happyHackingBro: happy-hacking-bro-dev-happyHackingBro

Test the new endpoint with a Get Request using httpie:

http https://hackerman.execute-api.us-east-1.amazonaws.com/dev/bro

Response:

HTTP/1.1 200 OK
Connection: keep-alive
Content-Length: 1458
Content-Type: application/json
Date: Wed, 21 Mar 2018 21:50:32 GMT
Via: 1.1 cf48a08b49dfcb45abb5308eb3e6e941.cloudfront.net (CloudFront)
X-Amz-Cf-Id: RDukXeUDmyKyQhiWa8CjrMN3IZTtoLfxP4lg6x7j9bFLatjIYcy7_Q==
X-Amzn-Trace-Id: sampled=0;root=1-5ab2d3a8-e20322f9d4032a634f329f12
X-Cache: Miss from cloudfront
x-amzn-RequestId: e11bdacc-2d51-11e8-b9ba-93aa1475ffcf

{
    "input": {
        "body": null,
        "headers": {
            "Accept": "*/*",
            "Accept-Encoding": "gzip, deflate",
            "CloudFront-Forwarded-Proto": "https",
            "CloudFront-Is-Desktop-Viewer": "true",
            "CloudFront-Is-Mobile-Viewer": "false",
            "CloudFront-Is-SmartTV-Viewer": "false",
            "CloudFront-Is-Tablet-Viewer": "false",
            "CloudFront-Viewer-Country": "CR",
            "Host": "hackerman.execute-api.us-east-1.amazonaws.com",
            "User-Agent": "HTTPie/0.9.9",
            "Via": "1.1 hackermancode.cloudfront.net (CloudFront)",
            "X-Amz-Cf-Id": "hackermancode",
            "X-Amzn-Trace-Id": "Root=hackermancode",
            "X-Forwarded-For": "hackermanip, anotherhackermanip",
            "X-Forwarded-Port": "443",
            "X-Forwarded-Proto": "https"
        },
        "httpMethod": "GET",
        "isBase64Encoded": false,
        "path": "/bro",
        "pathParameters": null,
        "queryStringParameters": null,
        "requestContext": {
            "accountId": "...",
            "apiId": "hackermanid",
            "httpMethod": "GET",
            "identity": {
                "accessKey": null,
                "accountId": null,
                "caller": null,
                "cognitoAuthenticationProvider": null,
                "cognitoAuthenticationType": null,
                "cognitoIdentityId": null,
                "cognitoIdentityPoolId": null,
                "sourceIp": "hackermanip",
                "user": null,
                "userAgent": "HTTPie/0.9.9",
                "userArn": null
            },
            "path": "/dev/bro",
            "protocol": "HTTP/1.1",
            "requestId": "",
            "requestTime": "21/Mar/2018:21:50:32 +0000",
            "requestTimeEpoch": 1521669032710,
            "resourceId": "hackermanresourceid",
            "resourcePath": "/bro",
            "stage": "dev"
        },
        "resource": "/bro",
        "stageVariables": null
    },
    "message": "Happy Hacking Bro!"
}

Via Browser

chrome https://hackerman.execute-api.us-east-1.amazonaws.com/dev/bro

User Details

AWS - Invoke Local

serverless invoke local --function happyHackingBro
{
    "statusCode": 200,
    "body": "{\"message\":\"Happy Hacking Bro!\",\"input\":\"\"}"
}

Remove current Serverless service and all resources

serverless remove
Serverless: Getting all objects in S3 bucket...
Serverless: Removing objects in S3 bucket...
Serverless: Removing Stack...
Serverless: Checking Stack removal progress...
....................
Serverless: Stack removal finished...

go-serverless-bro's People

Contributors

josoroma avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.