![Bryan Strassner](/assets/img/avatar_default.png)
This patchset moves most of the documentation for shipyard from markdown to reStructuredText. README.md remains as it is nice for Github consumption and serves as a gateway to the rest of the generated documentation. Change-Id: I8cec38fe0e30e9a545cb6e79ae6de1934f7dfc4e
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
## Shipyard
|
|
|
|
Shipyard adopts the Falcon web framework and uses Apache Airflow as the backend
|
|
engine to programmatically author, schedule and monitor workflows.
|
|
|
|
The current workflow is as follows:
|
|
|
|
1. Inital region/site data will be passed to Shipyard from either a human
|
|
operator or Jenkins
|
|
2. The data (in YAML format) will be sent to
|
|
[DeckHand](https://github.com/att-comdev/deckhand) for validation and
|
|
storage
|
|
3. Shipyard will make use of the post-processed data from DeckHand to interact
|
|
with [DryDock](https://github.com/att-comdev/drydock)
|
|
4. DryDock will interact with
|
|
[Promenade](https://github.com/att-comdev/promenade) to provision and deploy
|
|
bare metal nodes using Ubuntu MAAS and a resilient Kubernetes cluster will
|
|
be created at the end of the process
|
|
5. Once the Kubernetes clusters are up and validated to be working properly,
|
|
Shipyard will interact with [Armada](https://github.com/att-comdev/armada)
|
|
to deploy OpenStack using
|
|
[OpenStack Helm](https://github.com/openstack/openstack-helm)
|
|
6. Once the OpenStack cluster is deployed, Shipyard will trigger a workflow to
|
|
perform basic sanity health checks on the cluster
|
|
|
|
Note: This project, along with the tools used within are community-based and
|
|
open sourced.
|
|
|
|
### Mission
|
|
|
|
The goal for Shipyard is to provide a customizable *framework* for operators
|
|
and developers alike. This framework will enable end-users to orchestrate and
|
|
deploy a fully functional container-based Cloud.
|
|
|
|
|
|
### Roadmap
|
|
|
|
The detailed Roadmap can be viewed on the
|
|
[LCOO JIRA](https://openstack-lcoo.atlassian.net/projects/SHIPYARD/issues/)
|
|
|
|
- Integrate with DeckHand, DryDock/Promenade, Armada
|
|
- Expand funcitionality to provide visibility into and options for operation of
|
|
a UCP installation
|
|
|
|
### Getting Started
|
|
|
|
This project is under development at the moment. We encourage anyone who is
|
|
interested in Shipyard to review our
|
|
[documentation](http://shipyard.readthedocs.io/en/latest/)
|
|
|
|
|
|
### Bugs
|
|
|
|
If you find a bug, please feel free to create a
|
|
[GitHub issue](https://github.com/att-comdev/shipyard/issues)
|