Wondering what’s next for npm?Check out our public roadmap! »

@joblocal/aws-cfn-deployment

1.0.1 • Public • Published

AWS CloudFormation Deployment

Downloads

The Project provides a CLI tool for create and/or update an AWS CloudFormation. aws-cfn-deployment simplifies keeping your AWS infrastructure in sync with your CloudFormation templates by integrating into your existing build & deployment pipelines.

Requirements

  • AWS environment configuration
  • Yarn or npm
  • Node

Installation

Using yarn for global usage:

$ yarn global add @joblocal/aws-cfn-deployment

Using npm for global usage:

$ npm install -g @joblocal/aws-cfn-deployment

Installing as a local dependency using yarn:

$ yarn add @joblocal/aws-cfn-deployment

Installing as a local dependency using npm:

$ npm install @joblocal/aws-cfn-deployment

Usage

Before you can use this package you need to configure your AWS environment variables. The easiest way is to use AWS CLI.

After installing aws-cfn-deployment you can use it as follows.

$ aws-cfn-deployment
  --region {region}
  --stackName {stack name}
  --templatePath {path to your CloudFormation File}
  --{cfn parameter name} {cfn parameter value}
  --{cfn parameter name} {cfn parameter value}
  ...

Parameters

The parameters region, stackName and templatePath are required. All required parameters for your CloudFormation file are attached (see example).

Example

AWS CloudFormation file (bucket.yaml):

---
AWSTemplateFormatVersion: '2010-09-09'
Description: Creates a S3 bucket.
Parameters:
  BucketName:
    Description: Name of your S3 bucket.
    Type: String
Resources:
  DeploymentBucket:
    Type: AWS::S3::Bucket
    Properties:
      BucketName: !Sub ${AWS::AccountId}-{BucketName}

Command:

$ aws-cfn-deployment
  --region $AWS_DEFAULT_REGION
  --stackName MyBucket
  --templatePath bucket.yaml
  --BucketName AwesomeBucket

Built with

  • Yarn - Dependency Management
  • Jest - Test Runner

Contributing

Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and feature requests.

Authors

  • Joblocal GmbH - Initial work - Joblocal

See also the list of contributors who participated in this project.

Install

npm i @joblocal/aws-cfn-deployment

DownloadsWeekly Downloads

74

Version

1.0.1

License

MIT

Unpacked Size

193 kB

Total Files

11

Last publish

Collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar