A configuration organization tool.
Go to file
Felipe Monteiro d80aa0bd8f docs: Update getting started documentation
Currently the getting started documentation is somewhat incorrect:
usage of pip3 install is not necessary as "regular" usage of
pegleg entails using ./tools/pegleg.sh which uses the Pegleg
Docker image.

Also, the CLI guide doesn't include any useful examples so some
have been added.

Change-Id: I851b1c8b4f9c38672fce7b4a017e31882c7006ea
Depends-On: Iaa928ec2f777ed6f899d3b1790f5f9de613da9bb
2018-09-14 11:14:36 -06:00
doc docs: Update getting started documentation 2018-09-14 11:14:36 -06:00
images/pegleg Update Dockerfile to allow override of FROM variable 2018-07-17 14:37:08 -05:00
site_yamls/site Check that Pegleg only considers YAML 2018-04-10 08:25:36 -05:00
src/bin/pegleg Allow "dirty" local repositories to be safely modified 2018-09-14 05:25:21 +00:00
tools Add ~/.ssh mount to pegleg.sh 2018-09-07 10:31:35 -05:00
.dockerignore Update to UCP layout standard 2018-03-05 07:42:00 -06:00
.gitignore Allow linting policies to be selectable 2018-03-13 08:57:00 -05:00
.gitreview Update .gitreview for openstack infra 2018-05-17 19:52:49 +01:00
.zuul.yaml trivial: Rename docs/ => doc/ in .zuul.yaml 2018-08-23 23:26:35 +01:00
LICENSE Initial commit 2018-01-26 15:47:15 -06:00
Makefile Update Dockerfile to allow override of FROM variable 2018-07-17 14:37:08 -05:00
README.rst Update Pegleg README 2018-08-29 21:42:04 +00:00
tox.ini Add venv tox environment 2018-08-24 21:32:52 +02:00

README.rst

Pegleg

Doc Status

Introduction

Pegleg is a document aggregator that provides early linting and validations via Deckhand, a document management micro-service within Airship.

Pegleg supports local and remote Git repositories. Remote repositories can be cloned using a variety of protocols -- HTTP(S) or SSH. Afterward, specific revisions within those repositories can be checked out, their documents aggregated, linted, and passed to the rest of Airship for orchestration, allowing document authors to manage their site definitions using version control.

Find more documentation for Pegleg on Read the Docs.

Core Responsibilities

  • aggregation - Aggregates all documents required for site deployment across multiple Git repositories, each of which can be used to maintain separate document sets in isolation
  • linting - Configurable linting checks documents for common syntactical and semantical mistakes

Getting Started

For more detailed installation and setup information, please refer to the Getting Started guide.

Integration Points

Pegleg has the following integration points:

  • Deckhand which provides document revision management, storage and rendering functionality upon which the rest of the Airship components rely for orchestration of infrastructure provisioning.

Further Reading

Airship.