instacdk

Deploy any TypeScript/JavaScript AWS CDK construct as a standalone applications.

• instacdk
• Motivation
• Usage
• Commands

Motivation

AWS CDK Constructs are a powerful and convenient way to describe AWS infrastructure in a shareable way. When you're developing your own cloud applications, taking a construct library and adding it into your application is easy.

But what if you're NOT developing something and you just want to deploy a construct directly, with some light configuration?

InstaCDK makes it possible to take any construct (written in TypeScript or JavaScript) add some light scaffolding around it, and deploy it to your account.

Features:

• Works on both NPM libraries as well as GitHub source repositories
• Allows user configuration, via properties explicitly declared in instacdk.json or automatically derived from JSII manifest.

Usage

$ npm install -g instacdk
$ instacdk COMMAND
running command...
$ instacdk (-v|--version|version)
instacdk/0.1.1 darwin-x64 node-v12.12.0
$ instacdk --help [COMMAND]
USAGE
  $ instacdk COMMAND
...

Commands

• instacdk deploy LIBRARY [CONSTRUCT]
• instacdk destroy LIBRARY [CONSTRUCT]
• instacdk ls
• instacdk manage

instacdk deploy LIBRARY [CONSTRUCT]

Deploy an AWS CDK construct from an NPM package or GitHub repository

USAGE
  $ instacdk deploy LIBRARY [CONSTRUCT]

ARGUMENTS
  LIBRARY    Construct library NPM package, GitHub repo, or directory name
  CONSTRUCT  Construct to instantiate

OPTIONS
  -h, --help                         show CLI help
  -i, --identifier=identifier        distinguish between multiple installs of the same library/construct
  -o, --propsOverride=propsOverride
  -r, --region=region                override default region to deploy to (only for new deploys)
  -v, --version                      show CLI version

See code: src/commands/deploy.ts

instacdk destroy LIBRARY [CONSTRUCT]

Destroy a previously installed construct

USAGE
  $ instacdk destroy LIBRARY [CONSTRUCT]

ARGUMENTS
  LIBRARY    Construct library NPM package, GitHub repo, or directory name
  CONSTRUCT  Construct name

OPTIONS
  -h, --help                   show CLI help
  -i, --identifier=identifier  distinguish between multiple installs of the same library/construct
  -v, --version                show CLI version

See code: src/commands/destroy.ts

instacdk ls

List installed constructs

USAGE
  $ instacdk ls

OPTIONS
  -h, --help     show CLI help
  -v, --version  show CLI version

See code: src/commands/ls.ts

instacdk manage

List, update and destroy installed constructs

USAGE
  $ instacdk manage

OPTIONS
  -h, --help     show CLI help
  -v, --version  show CLI version

See code: src/commands/manage.ts