thence-common
v0.0.1
Published
Library functions I end up using in every node project
Downloads
5
Readme
CDK Constants
This repository contains constants that make it easier to work with the aws-cdk (CDK).
Why?
The CDK is awesome but it currently lacks types when initializing constructs such as IAM service principals and managed policies. Finding the right construct names requires diving into AWS documentation. Because there is no verification of these construct initializers, errors are only surfaced after deployment and via a rollback.
This library aims to be an up to date constants library for all things AWS so the above never happens again!
Quickstart
Install or update from npm
# install
npm i cdk-constants
# upgrade
npm i -g cdk-constants@latest
Usage
import {SERVICE_PRINCIPALS, MANAGED_POLICIES} from 'cdk-constants'
const lambdaRole = new Role(this, "lambdaDomainChecker", {
assumedBy: new ServicePrincipal(SERVICE_PRINCIPALS.LAMBDA),
managedPolicies: [
ManagedPolicy.fromAwsManagedPolicyName(MANAGED_POLICIES.AWS_LAMBDA_BASIC_EXECUTION_ROLE)
],
})
Properties
SERVICE_PRINCIPALS
- enum of all AWS services principals
MANAGED_POLICIES
- enum of all managed AWS policies
Credits
cdk-constants
wouldn't be possible without modules from the following authors
- Jared Short: initial gist of all service principals
- Gene Wood: gist to pull all aws managed policies
Contributions
All contributors are welcome. As you are reading this, AWS has probably released a new service. Please see CONTRIBUTING for information on how to setup a development environment and submit code.
Some upcoming items on the roadmap:
- list of aws regions and azs, including gov and china
- list of all iam permissions
- jsii compilation into different languages that CDK supports
License
cdk-constants is distributed under the Apache License, Version 2.0.
See LICENSE for more information.