From e795466247adc860a1cde23e05bf8f0ce3d21b65 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Dulko?= Date: Thu, 27 Apr 2017 11:01:26 +0200 Subject: [PATCH] Beggining of docs conversion to OpenStack format This commit introduces initial infrastructure for building documentation using the OpenStack's sphinx extension and tox. To demonstrate that README.md is rewritten into README.rst and should appear in documentation built by `tox -e docs`. Partial-Implements: blueprint docs-to-rst Change-Id: I08ebad1c572e248a8f474e785d3bf7a19dbc4340 --- .gitignore | 66 +++++++++++++++- README.md | 23 ------ README.rst | 62 +++++++++++++++ .../source}/appendix/resources-helm.md | 0 .../source}/appendix/resources-kubernetes.md | 0 doc/source/conf.py | 75 +++++++++++++++++++ doc/source/contributing.rst | 4 + .../guides-developer/dev-helm/helm-toolkit.md | 0 .../guides-developer/dev-helm/readme.md | 0 .../dev-helm/registration-domain.md | 0 .../dev-helm/registration-endpoint.md | 0 .../dev-helm/registration-host.md | 0 .../dev-helm/registration-service.md | 0 .../dev-helm/registration-user.md | 0 .../dev-helm/tips-development.md | 0 .../dev-kubernetes/considerations.md | 0 .../guides-developer/dev-kubernetes/readme.md | 0 .../getting-started/gs-conditionals.md | 0 .../getting-started/gs-endpoints.md | 0 .../getting-started/gs-images.md | 0 .../getting-started/gs-labels.md | 0 .../getting-started/gs-overrides.md | 0 .../getting-started/gs-replicas.md | 0 .../getting-started/gs-resources.md | 0 .../getting-started/gs-upgrades.md | 0 .../getting-started/gs-values.md | 0 .../getting-started/readme.md | 0 .../source}/guides-developer/readme.md | 0 .../developer/install-minikube.md | 0 .../developer/install-vagrant.md | 0 .../guides-install/developer/readme.md | 0 .../source}/guides-install/install-aio.md | 0 .../guides-install/install-development.md | 0 .../guides-install/install-multinode.md | 0 {docs => doc/source}/guides-install/readme.md | 0 .../third-party-tools/armada.md | 0 .../third-party-tools/readme.md | 0 .../guides-operator/getting-started/readme.md | 0 .../guides-operator/ops-helm/osh-addons.md | 0 .../ops-helm/osh-operations.md | 0 .../guides-operator/ops-helm/readme.md | 0 .../ops-kubernetes/kb-init-containers.md | 0 .../guides-operator/ops-kubernetes/kb-jobs.md | 0 .../guides-operator/ops-kubernetes/readme.md | 0 .../ops-network/net-ingress.md | 0 .../ops-network/net-nodeport.md | 0 .../guides-operator/ops-network/readme.md | 0 .../ops-openstack/os-config/os-config-gen.md | 0 .../guides-operator/ops-openstack/readme.md | 0 .../guides-operator/ops-security/readme.md | 0 .../ops-security/sec-appsec.md | 0 .../ops-security/sec-namespaces.md | 0 .../guides-operator/ops-security/sec-rbac.md | 0 .../source}/guides-operator/readme.md | 0 .../guides-operator/troubleshooting/readme.md | 0 .../troubleshooting/ts-database.md | 0 .../troubleshooting/ts-development.md | 0 .../troubleshooting/ts-networking.md | 0 .../troubleshooting/ts-persistent-storage.md | 0 {docs => doc/source}/guides-welcome/readme.md | 0 .../guides-welcome/welcome-overview.md | 0 .../guides-welcome/welcome-resiliency.md | 0 .../source}/guides-welcome/welcome-scaling.md | 0 doc/source/index.rst | 23 ++++++ {docs => doc/source}/readme.md | 0 doc/source/readme.rst | 1 + docs/old_readme.md | 57 -------------- setup.cfg | 23 ++++++ setup.py | 20 +++++ test-requirements.txt | 3 + tox.ini | 16 ++++ 71 files changed, 291 insertions(+), 82 deletions(-) delete mode 100644 README.md create mode 100644 README.rst rename {docs => doc/source}/appendix/resources-helm.md (100%) rename {docs => doc/source}/appendix/resources-kubernetes.md (100%) create mode 100755 doc/source/conf.py create mode 100644 doc/source/contributing.rst rename {docs => doc/source}/guides-developer/dev-helm/helm-toolkit.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/readme.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/registration-domain.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/registration-endpoint.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/registration-host.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/registration-service.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/registration-user.md (100%) rename {docs => doc/source}/guides-developer/dev-helm/tips-development.md (100%) rename {docs => doc/source}/guides-developer/dev-kubernetes/considerations.md (100%) rename {docs => doc/source}/guides-developer/dev-kubernetes/readme.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-conditionals.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-endpoints.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-images.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-labels.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-overrides.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-replicas.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-resources.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-upgrades.md (100%) rename {docs => doc/source}/guides-developer/getting-started/gs-values.md (100%) rename {docs => doc/source}/guides-developer/getting-started/readme.md (100%) rename {docs => doc/source}/guides-developer/readme.md (100%) rename {docs => doc/source}/guides-install/developer/install-minikube.md (100%) rename {docs => doc/source}/guides-install/developer/install-vagrant.md (100%) rename {docs => doc/source}/guides-install/developer/readme.md (100%) rename {docs => doc/source}/guides-install/install-aio.md (100%) rename {docs => doc/source}/guides-install/install-development.md (100%) rename {docs => doc/source}/guides-install/install-multinode.md (100%) rename {docs => doc/source}/guides-install/readme.md (100%) rename {docs => doc/source}/guides-install/third-party-tools/armada.md (100%) rename {docs => doc/source}/guides-install/third-party-tools/readme.md (100%) rename {docs => doc/source}/guides-operator/getting-started/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-helm/osh-addons.md (100%) rename {docs => doc/source}/guides-operator/ops-helm/osh-operations.md (100%) rename {docs => doc/source}/guides-operator/ops-helm/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-kubernetes/kb-init-containers.md (100%) rename {docs => doc/source}/guides-operator/ops-kubernetes/kb-jobs.md (100%) rename {docs => doc/source}/guides-operator/ops-kubernetes/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-network/net-ingress.md (100%) rename {docs => doc/source}/guides-operator/ops-network/net-nodeport.md (100%) rename {docs => doc/source}/guides-operator/ops-network/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-openstack/os-config/os-config-gen.md (100%) rename {docs => doc/source}/guides-operator/ops-openstack/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-security/readme.md (100%) rename {docs => doc/source}/guides-operator/ops-security/sec-appsec.md (100%) rename {docs => doc/source}/guides-operator/ops-security/sec-namespaces.md (100%) rename {docs => doc/source}/guides-operator/ops-security/sec-rbac.md (100%) rename {docs => doc/source}/guides-operator/readme.md (100%) rename {docs => doc/source}/guides-operator/troubleshooting/readme.md (100%) rename {docs => doc/source}/guides-operator/troubleshooting/ts-database.md (100%) rename {docs => doc/source}/guides-operator/troubleshooting/ts-development.md (100%) rename {docs => doc/source}/guides-operator/troubleshooting/ts-networking.md (100%) rename {docs => doc/source}/guides-operator/troubleshooting/ts-persistent-storage.md (100%) rename {docs => doc/source}/guides-welcome/readme.md (100%) rename {docs => doc/source}/guides-welcome/welcome-overview.md (100%) rename {docs => doc/source}/guides-welcome/welcome-resiliency.md (100%) rename {docs => doc/source}/guides-welcome/welcome-scaling.md (100%) create mode 100644 doc/source/index.rst rename {docs => doc/source}/readme.md (100%) create mode 100644 doc/source/readme.rst delete mode 100644 docs/old_readme.md create mode 100644 setup.cfg create mode 100755 setup.py create mode 100644 test-requirements.txt create mode 100644 tox.ini diff --git a/.gitignore b/.gitignore index 5a9f2a3e8b..285d32855a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,71 @@ +*.py[cod] + +# C extensions +*.so + +# Packages +*.egg* +*.egg-info +dist +build +eggs +parts +bin +var +sdist +develop-eggs +.installed.cfg +lib +lib64 + +# Installer logs +pip-log.txt + +# Unit test / coverage reports +cover/ +.coverage* +!.coveragerc +.tox +nosetests.xml +.testrepository +.venv + +# Translations +*.mo + +# Mr Developer +.mr.developer.cfg +.project +.pydevproject + +# Complexity +output/*.html +output/*/index.html + +# Sphinx +doc/build + +# pbr generates these +AUTHORS +ChangeLog + +# Editors +*~ +.*.swp +.*sw? + +# Files created by releasenotes build +releasenotes/build + +# Dev tools +.idea/ +dev/.vagrant + +# Helm internals *.lock */*.lock *.tgz **/*.tgz -.idea/ **/_partials.tpl **/_globals.tpl -dev/.vagrant dev/*.log diff --git a/README.md b/README.md deleted file mode 100644 index 5cab3798ab..0000000000 --- a/README.md +++ /dev/null @@ -1,23 +0,0 @@ -# Openstack-Helm - -**Join us on [Slack](http://slack.k8s.io/):** `#openstack-helm`
-**Join us on [Freenode](https://freenode.net/):** `#openstack-helm`
-**Community Meetings:** Every other Tuesday @ 3PM UTC in the `#openstack-helm` channel
-**Community Agenda Items:** [Google Docs](https://docs.google.com/document/d/1Vm2OnMzjSru3cuvxh4Oa7R_z7staU-7ivGy8foOzDCs/edit#heading=h.bfc0dkav9gk2)
-**Community Roadmap Items:** [Roadmap Docs](https://docs.google.com/spreadsheets/d/1N5AdAdLbvpZ9Tzi1TuqeJbHyczfZRysBIYE_ndnZx6c/edit?usp=sharing) - -Openstack-Helm is a fully self-contained Helm-based OpenStack deployment on Kubernetes. It will provide baremetal provisioning, persistent storage, full-stack resiliency, full-stack scalability, performance monitoring and tracing, and an optional development pipeline (using Jenkins). This project, along with the tools used within are community-based and open sourced. - -# Mission - -The goal for Openstack-Helm is to provide an incredibly customizable *framework* for operators and developers alike. This framework will enable end-users to deploy, maintain, and upgrade a fully functioning Openstack environment for both simple and complex environments. Administrators or developers can either deploy all or individual Openstack components along with their required dependancies. It heavily borrows concepts from [Stackanetes](https://github.com/stackanetes/stackanetes) and [other complex Helm application deployments](https://github.com/sapcc/openstack-helm). This project is meant to be a collaborative project that brings Openstack applications into a [Cloud-Native](https://www.cncf.io/about/charter) model. - -# Open Releases - -Until a 1.0.0 release, this collection is a work in progress and components will continue to be added or modified over time. Please review our [Milestones](https://launchpad.net/openstack-helm), and [Releases](https://github.com/openstack/openstack-helm/releases) for more information. - -# Installation and Development - -This project is under heavy development. We encourage anyone who is interested in Openstack-Helm to review our [Installation](https://github.com/openstack/openstack-helm/blob/master/docs/guides-install/readme.md) documentation, complete with verification procedures. Feel free to ask questions or check out our current [Issues and Bugs](https://bugs.launchpad.net/openstack-helm). - -Openstack-Helm is intended to be packaged and served from your own Helm [repository](https://github.com/kubernetes/helm/blob/master/docs/chart_repository.md). However, for quick installation, evaluation, and convenience, you can use our online Helm repository. After you've configured your environment for [Minikube](https://github.com/openstack/openstack-helm/blob/master/docs/guides-install/developer/install-minikube.md#openstack-helm-minikube-deployment) (for hostPath) or [Bare Metal](https://github.com/openstack/openstack-helm/blob/master/docs/guides-install/install-multinode.md#overview). diff --git a/README.rst b/README.rst new file mode 100644 index 0000000000..b86ffbc662 --- /dev/null +++ b/README.rst @@ -0,0 +1,62 @@ +============== +Openstack-Helm +============== + +Openstack-Helm is a fully self-contained Helm-based OpenStack deployment on +Kubernetes. It will provide baremetal provisioning, persistent storage, +full-stack resiliency, full-stack scalability, performance monitoring and +tracing, and an optional development pipeline (using Jenkins). This project, +along with the tools used within are community-based and open sourced. + +Mission +------- + +The goal for Openstack-Helm is to provide an incredibly customizable +*framework* for operators and developers alike. This framework will enable +end-users to deploy, maintain, and upgrade a fully functioning Openstack +environment for both simple and complex environments. Administrators or +developers can either deploy all or individual Openstack components along with +their required dependancies. It heavily borrows concepts from +`Stackanetes `_ and `other complex +Helm application deployments `_. This +project is meant to be a collaborative project that brings Openstack +applications into a `Cloud-Native `_ model. + +Communication +------------- + +* Join us on `Slack `_ - #openstack-helm +* Join us on `IRC `_: + #openstack-helm on freenode +* Community IRC Meetings: [Every Tuesday @ 3PM UTC], + #openstack-meeting-5 on freenode +* Meeting Agenda Items: `Agenda + `_ +* Community Roadmap Items: `Roadmap Docs + `_ + +Open Releases +------------- + +Until a 1.0.0 release, this collection is a work in progress and components +will continue to be added or modified over time. Please review our +`Milestones `_, and `Releases +`_ for more information. + +Installation and Development +---------------------------- + +This project is under heavy development. We encourage anyone who is interested +in Openstack-Helm to review our `Installation +`_ +documentation, complete with verification procedures. Feel free to ask +questions or check out our current `Issues and Bugs +`_. + +Openstack-Helm is intended to be packaged and served from your own Helm +`repository `_. +However, for quick installation, evaluation, and convenience, you can use our +online Helm repository. After you've configured your environment for `Minikube +`_ +(for hostPath) or `Bare Metal +`_. diff --git a/docs/appendix/resources-helm.md b/doc/source/appendix/resources-helm.md similarity index 100% rename from docs/appendix/resources-helm.md rename to doc/source/appendix/resources-helm.md diff --git a/docs/appendix/resources-kubernetes.md b/doc/source/appendix/resources-kubernetes.md similarity index 100% rename from docs/appendix/resources-kubernetes.md rename to doc/source/appendix/resources-kubernetes.md diff --git a/doc/source/conf.py b/doc/source/conf.py new file mode 100755 index 0000000000..dc45aa96ca --- /dev/null +++ b/doc/source/conf.py @@ -0,0 +1,75 @@ +# -*- coding: utf-8 -*- +# 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. + +import os +import sys + +sys.path.insert(0, os.path.abspath('../..')) +# -- General configuration ---------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom ones. +extensions = [ + 'sphinx.ext.autodoc', + #'sphinx.ext.intersphinx', + 'oslosphinx' +] + +# autodoc generation is a bit aggressive and a nuisance when doing heavy +# text edit cycles. +# execute "export SPHINX_DEBUG=1" in your terminal to disable + +# The suffix of source filenames. +source_suffix = '.rst' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = u'openstack-helm' +copyright = u'2016, OpenStack Foundation' + +# If true, '()' will be appended to :func: etc. cross-reference text. +add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +add_module_names = True + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'sphinx' + +# -- Options for HTML output -------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. Major themes that come with +# Sphinx are currently 'default' and 'sphinxdoc'. +# html_theme_path = ["."] +# html_theme = '_theme' +# html_static_path = ['static'] + +# Output file base name for HTML help builder. +htmlhelp_basename = '%sdoc' % project + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, author, documentclass +# [howto/manual]). +latex_documents = [ + ('index', + '%s.tex' % project, + u'%s Documentation' % project, + u'OpenStack Foundation', 'manual'), +] + +# Example configuration for intersphinx: refer to the Python standard library. +#intersphinx_mapping = {'http://docs.python.org/': None} diff --git a/doc/source/contributing.rst b/doc/source/contributing.rst new file mode 100644 index 0000000000..1728a61ca2 --- /dev/null +++ b/doc/source/contributing.rst @@ -0,0 +1,4 @@ +============ +Contributing +============ +.. include:: ../../CONTRIBUTING.rst diff --git a/docs/guides-developer/dev-helm/helm-toolkit.md b/doc/source/guides-developer/dev-helm/helm-toolkit.md similarity index 100% rename from docs/guides-developer/dev-helm/helm-toolkit.md rename to doc/source/guides-developer/dev-helm/helm-toolkit.md diff --git a/docs/guides-developer/dev-helm/readme.md b/doc/source/guides-developer/dev-helm/readme.md similarity index 100% rename from docs/guides-developer/dev-helm/readme.md rename to doc/source/guides-developer/dev-helm/readme.md diff --git a/docs/guides-developer/dev-helm/registration-domain.md b/doc/source/guides-developer/dev-helm/registration-domain.md similarity index 100% rename from docs/guides-developer/dev-helm/registration-domain.md rename to doc/source/guides-developer/dev-helm/registration-domain.md diff --git a/docs/guides-developer/dev-helm/registration-endpoint.md b/doc/source/guides-developer/dev-helm/registration-endpoint.md similarity index 100% rename from docs/guides-developer/dev-helm/registration-endpoint.md rename to doc/source/guides-developer/dev-helm/registration-endpoint.md diff --git a/docs/guides-developer/dev-helm/registration-host.md b/doc/source/guides-developer/dev-helm/registration-host.md similarity index 100% rename from docs/guides-developer/dev-helm/registration-host.md rename to doc/source/guides-developer/dev-helm/registration-host.md diff --git a/docs/guides-developer/dev-helm/registration-service.md b/doc/source/guides-developer/dev-helm/registration-service.md similarity index 100% rename from docs/guides-developer/dev-helm/registration-service.md rename to doc/source/guides-developer/dev-helm/registration-service.md diff --git a/docs/guides-developer/dev-helm/registration-user.md b/doc/source/guides-developer/dev-helm/registration-user.md similarity index 100% rename from docs/guides-developer/dev-helm/registration-user.md rename to doc/source/guides-developer/dev-helm/registration-user.md diff --git a/docs/guides-developer/dev-helm/tips-development.md b/doc/source/guides-developer/dev-helm/tips-development.md similarity index 100% rename from docs/guides-developer/dev-helm/tips-development.md rename to doc/source/guides-developer/dev-helm/tips-development.md diff --git a/docs/guides-developer/dev-kubernetes/considerations.md b/doc/source/guides-developer/dev-kubernetes/considerations.md similarity index 100% rename from docs/guides-developer/dev-kubernetes/considerations.md rename to doc/source/guides-developer/dev-kubernetes/considerations.md diff --git a/docs/guides-developer/dev-kubernetes/readme.md b/doc/source/guides-developer/dev-kubernetes/readme.md similarity index 100% rename from docs/guides-developer/dev-kubernetes/readme.md rename to doc/source/guides-developer/dev-kubernetes/readme.md diff --git a/docs/guides-developer/getting-started/gs-conditionals.md b/doc/source/guides-developer/getting-started/gs-conditionals.md similarity index 100% rename from docs/guides-developer/getting-started/gs-conditionals.md rename to doc/source/guides-developer/getting-started/gs-conditionals.md diff --git a/docs/guides-developer/getting-started/gs-endpoints.md b/doc/source/guides-developer/getting-started/gs-endpoints.md similarity index 100% rename from docs/guides-developer/getting-started/gs-endpoints.md rename to doc/source/guides-developer/getting-started/gs-endpoints.md diff --git a/docs/guides-developer/getting-started/gs-images.md b/doc/source/guides-developer/getting-started/gs-images.md similarity index 100% rename from docs/guides-developer/getting-started/gs-images.md rename to doc/source/guides-developer/getting-started/gs-images.md diff --git a/docs/guides-developer/getting-started/gs-labels.md b/doc/source/guides-developer/getting-started/gs-labels.md similarity index 100% rename from docs/guides-developer/getting-started/gs-labels.md rename to doc/source/guides-developer/getting-started/gs-labels.md diff --git a/docs/guides-developer/getting-started/gs-overrides.md b/doc/source/guides-developer/getting-started/gs-overrides.md similarity index 100% rename from docs/guides-developer/getting-started/gs-overrides.md rename to doc/source/guides-developer/getting-started/gs-overrides.md diff --git a/docs/guides-developer/getting-started/gs-replicas.md b/doc/source/guides-developer/getting-started/gs-replicas.md similarity index 100% rename from docs/guides-developer/getting-started/gs-replicas.md rename to doc/source/guides-developer/getting-started/gs-replicas.md diff --git a/docs/guides-developer/getting-started/gs-resources.md b/doc/source/guides-developer/getting-started/gs-resources.md similarity index 100% rename from docs/guides-developer/getting-started/gs-resources.md rename to doc/source/guides-developer/getting-started/gs-resources.md diff --git a/docs/guides-developer/getting-started/gs-upgrades.md b/doc/source/guides-developer/getting-started/gs-upgrades.md similarity index 100% rename from docs/guides-developer/getting-started/gs-upgrades.md rename to doc/source/guides-developer/getting-started/gs-upgrades.md diff --git a/docs/guides-developer/getting-started/gs-values.md b/doc/source/guides-developer/getting-started/gs-values.md similarity index 100% rename from docs/guides-developer/getting-started/gs-values.md rename to doc/source/guides-developer/getting-started/gs-values.md diff --git a/docs/guides-developer/getting-started/readme.md b/doc/source/guides-developer/getting-started/readme.md similarity index 100% rename from docs/guides-developer/getting-started/readme.md rename to doc/source/guides-developer/getting-started/readme.md diff --git a/docs/guides-developer/readme.md b/doc/source/guides-developer/readme.md similarity index 100% rename from docs/guides-developer/readme.md rename to doc/source/guides-developer/readme.md diff --git a/docs/guides-install/developer/install-minikube.md b/doc/source/guides-install/developer/install-minikube.md similarity index 100% rename from docs/guides-install/developer/install-minikube.md rename to doc/source/guides-install/developer/install-minikube.md diff --git a/docs/guides-install/developer/install-vagrant.md b/doc/source/guides-install/developer/install-vagrant.md similarity index 100% rename from docs/guides-install/developer/install-vagrant.md rename to doc/source/guides-install/developer/install-vagrant.md diff --git a/docs/guides-install/developer/readme.md b/doc/source/guides-install/developer/readme.md similarity index 100% rename from docs/guides-install/developer/readme.md rename to doc/source/guides-install/developer/readme.md diff --git a/docs/guides-install/install-aio.md b/doc/source/guides-install/install-aio.md similarity index 100% rename from docs/guides-install/install-aio.md rename to doc/source/guides-install/install-aio.md diff --git a/docs/guides-install/install-development.md b/doc/source/guides-install/install-development.md similarity index 100% rename from docs/guides-install/install-development.md rename to doc/source/guides-install/install-development.md diff --git a/docs/guides-install/install-multinode.md b/doc/source/guides-install/install-multinode.md similarity index 100% rename from docs/guides-install/install-multinode.md rename to doc/source/guides-install/install-multinode.md diff --git a/docs/guides-install/readme.md b/doc/source/guides-install/readme.md similarity index 100% rename from docs/guides-install/readme.md rename to doc/source/guides-install/readme.md diff --git a/docs/guides-install/third-party-tools/armada.md b/doc/source/guides-install/third-party-tools/armada.md similarity index 100% rename from docs/guides-install/third-party-tools/armada.md rename to doc/source/guides-install/third-party-tools/armada.md diff --git a/docs/guides-install/third-party-tools/readme.md b/doc/source/guides-install/third-party-tools/readme.md similarity index 100% rename from docs/guides-install/third-party-tools/readme.md rename to doc/source/guides-install/third-party-tools/readme.md diff --git a/docs/guides-operator/getting-started/readme.md b/doc/source/guides-operator/getting-started/readme.md similarity index 100% rename from docs/guides-operator/getting-started/readme.md rename to doc/source/guides-operator/getting-started/readme.md diff --git a/docs/guides-operator/ops-helm/osh-addons.md b/doc/source/guides-operator/ops-helm/osh-addons.md similarity index 100% rename from docs/guides-operator/ops-helm/osh-addons.md rename to doc/source/guides-operator/ops-helm/osh-addons.md diff --git a/docs/guides-operator/ops-helm/osh-operations.md b/doc/source/guides-operator/ops-helm/osh-operations.md similarity index 100% rename from docs/guides-operator/ops-helm/osh-operations.md rename to doc/source/guides-operator/ops-helm/osh-operations.md diff --git a/docs/guides-operator/ops-helm/readme.md b/doc/source/guides-operator/ops-helm/readme.md similarity index 100% rename from docs/guides-operator/ops-helm/readme.md rename to doc/source/guides-operator/ops-helm/readme.md diff --git a/docs/guides-operator/ops-kubernetes/kb-init-containers.md b/doc/source/guides-operator/ops-kubernetes/kb-init-containers.md similarity index 100% rename from docs/guides-operator/ops-kubernetes/kb-init-containers.md rename to doc/source/guides-operator/ops-kubernetes/kb-init-containers.md diff --git a/docs/guides-operator/ops-kubernetes/kb-jobs.md b/doc/source/guides-operator/ops-kubernetes/kb-jobs.md similarity index 100% rename from docs/guides-operator/ops-kubernetes/kb-jobs.md rename to doc/source/guides-operator/ops-kubernetes/kb-jobs.md diff --git a/docs/guides-operator/ops-kubernetes/readme.md b/doc/source/guides-operator/ops-kubernetes/readme.md similarity index 100% rename from docs/guides-operator/ops-kubernetes/readme.md rename to doc/source/guides-operator/ops-kubernetes/readme.md diff --git a/docs/guides-operator/ops-network/net-ingress.md b/doc/source/guides-operator/ops-network/net-ingress.md similarity index 100% rename from docs/guides-operator/ops-network/net-ingress.md rename to doc/source/guides-operator/ops-network/net-ingress.md diff --git a/docs/guides-operator/ops-network/net-nodeport.md b/doc/source/guides-operator/ops-network/net-nodeport.md similarity index 100% rename from docs/guides-operator/ops-network/net-nodeport.md rename to doc/source/guides-operator/ops-network/net-nodeport.md diff --git a/docs/guides-operator/ops-network/readme.md b/doc/source/guides-operator/ops-network/readme.md similarity index 100% rename from docs/guides-operator/ops-network/readme.md rename to doc/source/guides-operator/ops-network/readme.md diff --git a/docs/guides-operator/ops-openstack/os-config/os-config-gen.md b/doc/source/guides-operator/ops-openstack/os-config/os-config-gen.md similarity index 100% rename from docs/guides-operator/ops-openstack/os-config/os-config-gen.md rename to doc/source/guides-operator/ops-openstack/os-config/os-config-gen.md diff --git a/docs/guides-operator/ops-openstack/readme.md b/doc/source/guides-operator/ops-openstack/readme.md similarity index 100% rename from docs/guides-operator/ops-openstack/readme.md rename to doc/source/guides-operator/ops-openstack/readme.md diff --git a/docs/guides-operator/ops-security/readme.md b/doc/source/guides-operator/ops-security/readme.md similarity index 100% rename from docs/guides-operator/ops-security/readme.md rename to doc/source/guides-operator/ops-security/readme.md diff --git a/docs/guides-operator/ops-security/sec-appsec.md b/doc/source/guides-operator/ops-security/sec-appsec.md similarity index 100% rename from docs/guides-operator/ops-security/sec-appsec.md rename to doc/source/guides-operator/ops-security/sec-appsec.md diff --git a/docs/guides-operator/ops-security/sec-namespaces.md b/doc/source/guides-operator/ops-security/sec-namespaces.md similarity index 100% rename from docs/guides-operator/ops-security/sec-namespaces.md rename to doc/source/guides-operator/ops-security/sec-namespaces.md diff --git a/docs/guides-operator/ops-security/sec-rbac.md b/doc/source/guides-operator/ops-security/sec-rbac.md similarity index 100% rename from docs/guides-operator/ops-security/sec-rbac.md rename to doc/source/guides-operator/ops-security/sec-rbac.md diff --git a/docs/guides-operator/readme.md b/doc/source/guides-operator/readme.md similarity index 100% rename from docs/guides-operator/readme.md rename to doc/source/guides-operator/readme.md diff --git a/docs/guides-operator/troubleshooting/readme.md b/doc/source/guides-operator/troubleshooting/readme.md similarity index 100% rename from docs/guides-operator/troubleshooting/readme.md rename to doc/source/guides-operator/troubleshooting/readme.md diff --git a/docs/guides-operator/troubleshooting/ts-database.md b/doc/source/guides-operator/troubleshooting/ts-database.md similarity index 100% rename from docs/guides-operator/troubleshooting/ts-database.md rename to doc/source/guides-operator/troubleshooting/ts-database.md diff --git a/docs/guides-operator/troubleshooting/ts-development.md b/doc/source/guides-operator/troubleshooting/ts-development.md similarity index 100% rename from docs/guides-operator/troubleshooting/ts-development.md rename to doc/source/guides-operator/troubleshooting/ts-development.md diff --git a/docs/guides-operator/troubleshooting/ts-networking.md b/doc/source/guides-operator/troubleshooting/ts-networking.md similarity index 100% rename from docs/guides-operator/troubleshooting/ts-networking.md rename to doc/source/guides-operator/troubleshooting/ts-networking.md diff --git a/docs/guides-operator/troubleshooting/ts-persistent-storage.md b/doc/source/guides-operator/troubleshooting/ts-persistent-storage.md similarity index 100% rename from docs/guides-operator/troubleshooting/ts-persistent-storage.md rename to doc/source/guides-operator/troubleshooting/ts-persistent-storage.md diff --git a/docs/guides-welcome/readme.md b/doc/source/guides-welcome/readme.md similarity index 100% rename from docs/guides-welcome/readme.md rename to doc/source/guides-welcome/readme.md diff --git a/docs/guides-welcome/welcome-overview.md b/doc/source/guides-welcome/welcome-overview.md similarity index 100% rename from docs/guides-welcome/welcome-overview.md rename to doc/source/guides-welcome/welcome-overview.md diff --git a/docs/guides-welcome/welcome-resiliency.md b/doc/source/guides-welcome/welcome-resiliency.md similarity index 100% rename from docs/guides-welcome/welcome-resiliency.md rename to doc/source/guides-welcome/welcome-resiliency.md diff --git a/docs/guides-welcome/welcome-scaling.md b/doc/source/guides-welcome/welcome-scaling.md similarity index 100% rename from docs/guides-welcome/welcome-scaling.md rename to doc/source/guides-welcome/welcome-scaling.md diff --git a/doc/source/index.rst b/doc/source/index.rst new file mode 100644 index 0000000000..7c24284df5 --- /dev/null +++ b/doc/source/index.rst @@ -0,0 +1,23 @@ +.. openstack-helm documentation master file, created by + sphinx-quickstart on Tue Jul 9 22:26:36 2013. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to openstack-helm's documentation! +======================================================== + +Contents: + +.. toctree:: + :maxdepth: 3 + + readme + contributing + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + diff --git a/docs/readme.md b/doc/source/readme.md similarity index 100% rename from docs/readme.md rename to doc/source/readme.md diff --git a/doc/source/readme.rst b/doc/source/readme.rst new file mode 100644 index 0000000000..a6210d3d8a --- /dev/null +++ b/doc/source/readme.rst @@ -0,0 +1 @@ +.. include:: ../../README.rst diff --git a/docs/old_readme.md b/docs/old_readme.md deleted file mode 100644 index e2ef11b78c..0000000000 --- a/docs/old_readme.md +++ /dev/null @@ -1,57 +0,0 @@ -# Openstack-Helm Documentation - - -## Table of Contents - -##  1. Openstack-Helm Design Principles -###    1.1 [Mission](mission.md) -#####      1.1.1 [Resiliency](mission.md#resiliency) -#####      1.1.2 [Scaling](mission.md#scaling) -###    1.2 Helm Overrides -#####      1.2.1 [Values Philosophy](helm_overrides.md#values) -#####      1.2.1 [Replicas](helm_overrides.md#replicas) -#####      1.2.1 [Labels](helm_overrides.md#labels) -#####      1.2.1 [Images](helm_overrides.md#images) -#####      1.2.1 [Upgrades](helm_overrides.md#upgrades) -#####      1.2.1 [Resource Limits](helm_overrides.md#resource limits) -#####      1.2.2 [Endpoints](#helm_overrides.md#endpoints) -#####      1.2.2 [Common Conditionals](helm_overrides.md#common conditionals) -###    1.3 Init-Containers -#####      1.3.1 Dependency Checking -###    1.4 Kubernetes Jobs -#####      1.4.1 Service Registration -#####      1.4.2 User Registration -#####      1.4.3 Database Creation -#####      1.4.4 Database Migration -###    1.5 Complimentary Efforts -####      1.5.1 Image-Based Project Considerations -###    1.6 Kubernetes State -####      1.6.1 Third Party Resources -####      1.6.2 Add-Ons -##  2. Repository Structure -###    2.1 Infrastructure Components -###    2.2 Openstack-Helm Core Services -###    2.3 Openstack-Helm Add-Ons -##  3. Operator Resources -###     3.1 [Installation](https://github.com/att-comdev/openstack-helm/blob/master/docs/installation/getting-started.md) -###     3.2 Openstack-Helm Chart Definition Overrides -###     3.2 Openstacak-Helm Upgrades -##  4. Openstack-Helm Networking -###    4.1 Kubernetes Control Plane -####     4.1.1 CNI SDN Considerations -####     4.1.2 Calico Networking -###    4.2 Ingress Philosophy -###    4.3 Openstack Networking -####     4.3.1 Flat Networking -####     4.3.1 L2 Networking -##  5. Security Guidelines -###    5.1 Network Policies -###    5.2 Advanced Network Policies -###    5.3 Role-Based Access Controls -###    5.4 Security Contexts -###    5.5 Security Add-Ons -##  6. Developer Resources -###    6.1 Contributions and Guidelines -###    6.2 Development Tools -####     6.2.1 [Minikube Development](https://github.com/att-comdev/openstack-helm/blob/master/docs/developer/minikube.md) -###    6.3 Tips and Considerations diff --git a/setup.cfg b/setup.cfg new file mode 100644 index 0000000000..1a9e6eec6c --- /dev/null +++ b/setup.cfg @@ -0,0 +1,23 @@ +[metadata] +name = openstack-helm +summary = Helm charts for OpenStack services +description-file = + README.rst +author = OpenStack +author-email = openstack-dev@lists.openstack.org +home-page = http://www.openstack.org/ +classifier = + Intended Audience :: Developers + License :: OSI Approved :: Apache Software License + Operating System :: POSIX :: Linux + +[build_sphinx] +all_files = 1 +build-dir = doc/build +source-dir = doc/source + +[pbr] +warnerrors = True + +[wheel] +universal = 1 diff --git a/setup.py b/setup.py new file mode 100755 index 0000000000..c6efeaa625 --- /dev/null +++ b/setup.py @@ -0,0 +1,20 @@ +#!/usr/bin/env python +# 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. + +# THIS FILE IS MANAGED BY THE GLOBAL REQUIREMENTS REPO - DO NOT EDIT +import setuptools + +setuptools.setup( + setup_requires=['pbr'], + pbr=True) diff --git a/test-requirements.txt b/test-requirements.txt new file mode 100644 index 0000000000..6091fdc2bc --- /dev/null +++ b/test-requirements.txt @@ -0,0 +1,3 @@ +sphinx>=1.5.1 # BSD +oslosphinx>=4.7.0 # Apache-2.0 + diff --git a/tox.ini b/tox.ini new file mode 100644 index 0000000000..52cd988bd9 --- /dev/null +++ b/tox.ini @@ -0,0 +1,16 @@ +[tox] +minversion = 2.0 +envlist = docs +skipsdist = True + +[testenv] +install_command = pip install -U {opts} {packages} +setenv = VIRTUAL_ENV={envdir} +deps = -r{toxinidir}/test-requirements.txt +passenv = *_proxy *_PROXY + +[testenv:venv] +commands = {posargs} + +[testenv:docs] +commands = python setup.py build_sphinx