cddf30092b
Added steps to setting up, creating, and running spyglass in Docker image Change-Id: Ib168c12306608d19df66fc7961d1ceb28d46f5f1
31 lines
1.3 KiB
ReStructuredText
31 lines
1.3 KiB
ReStructuredText
What is Spyglass?
|
|
-----------------
|
|
|
|
Spyglass is the data extractor tool which can interface with
|
|
different input data sources to generate site manifest YAML files.
|
|
The data sources will provide all the configuration data needed
|
|
for a site deployment. These site manifest YAML files generated
|
|
by Spyglass will be saved in a Git repository, from where Pegleg
|
|
can access and aggregate them. This aggregated file can then be
|
|
fed to Shipyard for site deployment/updates.
|
|
|
|
Spyglass follows a plugin model to support multiple input data sources.
|
|
The currently supported plugin is the Spyglass Excel plugin
|
|
(`spyglass-plugin-xls`_).
|
|
|
|
The Spyglass Excel plugin accepts an engineering spec in the form of a
|
|
spreadsheet and an index file to read the spreadsheet as inputs and
|
|
generates site level manifests. As an optional step, it can generate an
|
|
intermediary YAML which contains all the information that will be rendered to
|
|
generate Airship site manifests. This optional step will help the deployment
|
|
engineer modify any data if required.
|
|
|
|
Getting Started
|
|
---------------
|
|
For more detailed information, please refer to the `Index`_ to easily navigate
|
|
the Getting Started, Developer Quickstart, and Command Line Interface guides.
|
|
|
|
|
|
.. _spyglass-plugin-xls: https://opendev.org/airship/spyglass-plugin-xls
|
|
.. _`Index`: ./doc/source/index.rst
|