Json schema for AWS Cloudformation
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
tests
.gitignore
.travis.yml
.vimrc
LICENSE
README.md
basic_types.json
create_resource_schema.py
requirements.txt
resource-stage1.json
resource.json
resource_properties.py
schema.json
serve_diff.py
tools.py
tweak_resource_schema.py
update_parameter_types.py
val.py
validate_template.py

README.md

An attempt to write a json schema (http://json-schema.org) for AWS Cloudformation.

You might be interested in http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-resource-specification.html, which is the official source of machine-readable CloudFormation specification. That is not a JSON Schema in the sense of http://json-schema.org/ but it is comprehensive.

For now, I'm scraping AWS documentation with PyQuery.

This is not your glossy software.

current state

Many things are validated. Some resource properties are not parsed properly, so their values are not validated.

Preliminary hosted version of the schema can be found at http://fungusakafungus.github.io/cloudformation-jsonschema/v0.4/schema.json

The scraping code is in a miserable state.

Build Status

how to use

Use ./validate_template.py tests/examples-aws/Rails_Single_Instance.template to validate cloudformation templates on the command line.

Use schema.json programmatically to validate complete Cloudformation templates.

Use resource.json to validate a single resource.

The schema consists of multiple files, schema.json, resource.json and basic_types.json. To resolve JSON pointers ({"$ref": "basic_types.json#/definitions/string"}) to files on local filesystem, you'll have to use a special resolver. See val.py for the example.

Use released hosted version with python-jsonschema:

import jsonschema, requests

schema = requests.get('http://fungusakafungus.github.io/cloudformation-jsonschema/v0.4/schema.json').json()
jsonschema.validate(
  {'Resources':{}, 'Outputs':{'o':{'Value':'test'}}},
  schema
)

how to contribute

Submit false positive/negative issues with valid and invalid templates.

hack the schema:

Create a virtualenv (virtualenv venv; pip install -r requirements.txt)

You can then scrape AWS documentation for cloudformation resource types and save it as jsonschema:

./create_resource_schema.py resource.json

TODO