Semantic, declarative cloud infrastructure configuration file format and object model
An object model for semantic cloud infrastructure.
paco.models parses a directory of YAML files that compose an Paco project and loads them
into a complete object model.
The model defines common logical cloud infrastructure concepts, such as networks, accounts,
applications and environments.
The model uses network and applications as hierarchical trees of configuration that can
have their values over rode when they are placed into environments. Environments live in a
network and contain applications, and typically represent the stages of the software development
lifecycle (SDLC), such as ‘development’, ‘staging’ and ‘production’.
The model has a declarative schema that explicitly defines the fields for each object type in the model.
This schema declares not only type (e.g. string, integer) but can also declare defaults, min and max values,
constrain to specific values, and define invariants that ensure that if one field has a specific value, another
fields value is compatabile with that. The model will validates these fields when it loads a Paco project.
Install this package with your Python tool of choice. Typically set-up a virtualenv
and pip install the dependencies in there:
python -m venv env./env/bin/pip install -e .
There are unit tests using PyTest. If you are using VS Code you can turn on the
“Py Test Enabled” setting and run “Discover Unit Tests” command.
The module paco.models.gen_vocabulary is dynamically generated by the script paco_update_gen_vocabulary.
To run this script first install the paco.models (pip install -e .) project. Then create an IAM User in
an active AWS account with read-only access and save them in your .aws/credentials file. If you aren’t
using the default profile name, you can set the AWS_PROFILE environment variable.
The paco.models buildout will create a handy profile.sh to set this up for you:
buildoutsource profile.sh