d80aa0bd8f
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
56 lines
2.0 KiB
ReStructuredText
56 lines
2.0 KiB
ReStructuredText
..
|
|
Copyright 2018 AT&T Intellectual Property.
|
|
All Rights Reserved.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
===============
|
|
Getting Started
|
|
===============
|
|
|
|
What is Pegleg?
|
|
---------------
|
|
|
|
Pegleg is a document aggregator that will aggregate all the documents in a
|
|
repository and pack them into a single YAML file. This allows for operators to
|
|
structure their site definitions in a maintainable directory layout, while
|
|
providing them with the automation and tooling needed to aggregate, lint, and
|
|
render those documents for deployment.
|
|
|
|
For more information on the documents that Pegleg works on see `Document Fundamentals`_.
|
|
|
|
Basic Usage
|
|
-----------
|
|
|
|
Before using Pegleg, you must:
|
|
|
|
1. Clone the Pegleg repository:
|
|
|
|
.. code-block:: console
|
|
|
|
git clone https://git.airshipit.org/airship-pegleg
|
|
|
|
2. Install `Docker CE`_, as Pegleg relies on it for CLI execution.
|
|
|
|
3. Clone the repos containing your `site definition libraries`_ into the
|
|
local filesystem where Pegleg is running, as Pegleg can only work with files
|
|
available in the local directory.
|
|
|
|
You will then be able to use all of Pegleg's features through the CLI. See CLI_ for more
|
|
information.
|
|
|
|
.. _Document Fundamentals: https://airship-pegleg.readthedocs.io/en/latest/authoring_strategy.html
|
|
.. _Docker CE: https://docs.docker.com/install/
|
|
.. _site definition libraries: https://airship-pegleg.readthedocs.io/en/latest/artifacts.html#definition-library-layout
|
|
.. _CLI: https://airship-pegleg.readthedocs.io/en/latest/cli.html
|