Git Product home page Git Product logo

node-red-contrib-aws's Introduction

node-red-contrib-aws

A collection of Node-RED nodes for AWS.

Nodes (All AWS API functions are available)

  • Lamba
  • EC2
  • Kinesis
  • S3
  • SNS
  • DynamoDB
  • SQS (alpha release)
  • IoT
  • IotData
  • RDS
  • Firehose
  • KMS
  • Redshift
  • AWS config

Payload returned from the AWS SDK is sometimes (particularly S3.Get) encoded in a BUFFER. To parse this to a string pass the output into a function with msg.payload=Buffer.from(msg.payload.Body).toString("utf-8") or similar to decode strings.

All nodes (as of v0.5) have two output points, the top outputs data from successful calls, the botton outputs errors, so you dont need a branching node to sepererate successful or failure calls.

Make sure that the AWS IAM User you are using has sufficient permissions for the function you are using. If you dont you will get an error message.

Feature requests are welcome, submit an issue at https://github.com/daniel-t/node-red-contrib-aws

Usage

Almost all nodes are direct wrappers for the AWS Javascript API, so for information about available parameters consult the API docs https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS.html

Parameters need to be specified as per the AWS API (typically LeadingUpperCase).

WARNING

Only cursory testing of nodes has occured at this stage, please test and report issues.

Acknowledgements

The node-red-contrib-aws uses the following open source software:

License

See [license] (https://github.com/daniel-t/node-red-contrib-aws/blob/master/LICENSE) (Apache License Version 2.0).

Contributions

If you want to add a new node to this library, here's some pointers.

  • I only accept nodes which are built from the run_build.js script without modification. This is to ensure that I can keep things up to date as the AWS API changes. If for some reason you cant do that (such as with the IOT node), please also supply a contextual Diff against the automatically built node and an explanation of why it has to be this way. It's OK to propose changes to the gen scripts, but they need to be as generic as possible.
    • The exception to this are utility nodes, such as DynamoDBConvert
  • Please only submit changes to one node per pull request. If there's a problem with one node, it will delay getting them all in.
  • If you update the build scripts, please submit those in a seperate request to any new/modified nodes
  • Dont submit a complete set of nodes which have only been updated due to a new version of the AWS API. if you need to features, submit individual nodes or create an issue and I will raise the AWS API level across the board.

How to build nodes:

  • Make sure you have a working install, and can create flows with some of the existing nodes
  • Switch into the gen_scripts directory
  • Make a directory called 'build'
  • Run 'nodejs run_build.js' - this will automatically generate the entire node set for all AWS services, many which haven't been validated so aren't part of the library
  • Copy the files for the service of interest from 'build' to the parent directory
  • update package.json to reference the new js file
  • Restart node red
  • If it works please submit a pull request and let me know how extensively its been tested.

Donations

If you like this library and would like to financially support its ongoing developement, you can make donations by Paypal https://www.paypal.me/DanielT253 Bitcoin 124fjAWzBYxhW4CtEj8g9uZqc15z97Fu9A

node-red-contrib-aws's People

Contributors

daniel-t avatar lbaiao2019 avatar mblackstock avatar moriuchi avatar thiagobustamante 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.