This repository hosts registry extensions
that are published under the AwsCommunity:: namespace in AWS CloudFormation.
The CloudFormation Registry allows customers to create public and private
resources
types,
modules,
and
hooks.
Modules are authored as templates in either JSON or YAML. Resource types and
hooks can be authored in Java, Go, Python, or Typescript, using the
CloudFormation Command Line Interface (CFN
CLI)
for project setup and testing.
Join us on Discord! Connect & interact with CloudFormation developers & experts, find channels to discuss the CloudFormation registry, StackSets, cfn-lint, Guard and more:
(Note that we are not yet actually publishing the extensions, pending approval of our release process)
Log in to your AWS account and go to the CloudFormation console. Under Registry
in the menu, select Public extensions. Search under Third Party publishers for
the AwsCommunity:: namespace. These extensions can be used from any template
you author in a region where they are available and activated. Unlike public
extensions under the AWS:: namespace, each of these community extensions must
first be activated using the instructions
here.
| Name | Type | Version | Description |
|---|---|---|---|
| AwsCommunity::S3::BucketNotification | Resource | Alpha | Configure bucket notifications |
| AwsCommunity::S3::DeleteBucketContents | Resource | Alpha | Delete all objects in a bucket |
| AwsCommunity::S3::BucketVersioningEnabled | Hook | Alpha | Validate that an AWS::S3::Bucket has versioning enabled |
| AwsCommunity::CloudFront::LoggingEnabled | Hook | Alpha | Validate that a CloudFront distribution has logging enabled |
See the contributer guide: ./CONTRIBUTING.md
Also check out how our release process works here: ./RELEASE.md
The CloudFormation CLI (cfn), not to be confused with the aws cloudformation commands, is used to initialize, build, test, and publish
registry extensions.
https://github.com/aws-cloudformation/cloudformation-cli
https://github.com/aws-cloudformation/cloudformation-cli-python-plugin
https://github.com/aws-cloudformation/cloudformation-cli-typescript-plugin
https://github.com/aws-cloudformation/cloudformation-cli-go-plugin
https://github.com/aws-cloudformation/cloudformation-cli-java-plugin
The CloudFormation linter is an indespensible tool for developing templates. It does static analysis on your template to make sure it's valid before submitting it, which saves a lot of wasted time waiting for the service to tell you the same thing.
https://github.com/aws-cloudformation/cfn-lint
Rain is what happens when you have cloud formations... Rain is a CLI helper for
CloudFormation that makes it a lot easier to author and deploy stacks. Instead
of needing to string together aws cloudformation commands to check the status
of a stack before either creating or updating, rain does all of this with a
simple deploy command.
https://github.com/aws-cloudformation/rain
We are working on a set of third party resources that will piggy-back on our release process and be published from our publisher account.
https://github.com/aws-ia/cloudformation-okta-resource-providers
https://github.com/aws-ia/cloudformation-github-resource-providers
https://github.com/aws-ia/cloudformation-rollbar-resource-providers
https://github.com/aws-ia/cloudformation-fastly-resource-providers
https://github.com/aws-ia/cloudformation-cloudflare-resource-providers
https://github.com/aws-ia/cloudformation-snowflake-resource-providers
https://github.com/aws-ia/cloudformation-pagerduty-resource-providers
https://github.com/aws-ia/cloudformation-gitlab-resource-providers
https://github.com/aws-ia/cloudformation-dynatrace-resource-providers
https://github.com/aws-ia/cloudformation-bigid-resource-providers
(Note that we decided to move these out to a separate repo, so they won't be here much longer)
We publish our python packages in packages/ to pypi. When we publish a release a workflow is triggered to do the publishing. See the CD.yml workflows here
For cfn-guard-rs we tag the release with cfn-guard-rs-vX.X.X
For cfn-guard-rs-hook we tag the release with cfn-guard-rs-hook-vX.X.X
