Skip to content

Latest commit

 

History

History
44 lines (29 loc) · 2.08 KB

README.rst

File metadata and controls

44 lines (29 loc) · 2.08 KB

Foremast - foremast-templates Example

This is a repository that is used for providing example Foremast templates.

By default, Foremast comes bundled with default templates but they can all be overridden with external templates! This is great for individual companies to extend foremast functionality and also override the defaults to company specific values/naming conventions. This repository acts as examples for how the external templates can be structured.

Getting Started

Take a look at quick start guide for a quick introduction on how to use Foremast.

We also have a blog post to help you get started: Automate Spinnaker Pipeline Creation

Documentation

All the documentation can be viewed on Read the Docs. You can find all configuration options, code information, and better examples there.

Development

See the contribution guide for information on code style, contributing, and testing.

Getting Help

For questions, support, or friendly conversation you can find us on Gitter.

External Foremast Templates

In the foremast configuration file (config.py), add a templates_path key. You can see an example of this in the example [config.py](configs/config.py) This can be an absolute value or a path relative to where you are running Foremast. The value of this config key should be the path to the directory which holds the external Foremast templates.

The structure of your templates directory should match the defaults provided with Foremast. The names of the files also need to be the same with the exception of pipeline stages.