InGraph is an Infrastructure Graph DSL for AWS CloudFormation.
InGraph ain't template generator :stuck_out_tongue_winking_eye:
InGraph is a Declarative Infrastructure Graph DSL for AWS CloudFormation.
Declarative: Never again abstract away from CloudFormation. Simply declare your infrastructure components, without the hassle of YAML, and preserve the strict semantic of the AWS CloudFormation language. Veterans, build on top of your knowledge. Beginners, learn CloudFormation effectively.
Composable: Create encapsulated components with their assets and dependencies, then share or compose them to build more complex infrastructures. From simple nodes to your whole graph, everything is a deployable infrastructure unit.
Integrated: Leverage the evergrowing Python ecosystem. Benefit from static type checking, take advantage of autocompletion in your editor, or even consume open infrastructure components via the Python Package Index, among others.
python3.8 -m pip install --user ingraph
Verify your installation by invoking the
ig command. You should see
a welcome screen.
We have several examples on the website. Here is the first one to whet your appetite.
ig cfn -i example.py -r HelloWorld -o example.yaml
This example creates a simple AWS Lambda function that returns a "Hello, World!" message.
You'll notice that CloudFormation parameters, along with their types and default values are simple constructor parameters, or that CloudFormation outputs are class attributes, or even that CloudFormation resource names are derived from variable names. It's only a taste of what is in store for you.
The primary purpose of this project is to continue to evolve the core of InGraph. We are grateful to the community for any contribution. You may, for example, proof-read the documentation, submit bugs and fixes, provide improvements, discuss new axes of evolution, or spread the word around you.
We want to thank and express our gratitude to Ben Kehoe. Without his guidance and support, this project wouldn't have been possible.
Unless otherwise stated, the source code of the project is released under the GNU Affero General Public License Version 3. Please note, however, that all public interfaces subject to be embedded within the source code of your infrastructure are released under the Apache License Version 2. Refer to the header of each file or to the LICENSE file present in the parent directory where appropriate.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.