aboutsummaryrefslogtreecommitdiff
path: root/specs
diff options
context:
space:
mode:
Diffstat (limited to 'specs')
-rw-r--r--specs/kubernetes-deployment.rst113
1 files changed, 0 insertions, 113 deletions
diff --git a/specs/kubernetes-deployment.rst b/specs/kubernetes-deployment.rst
deleted file mode 100644
index a445f405d..000000000
--- a/specs/kubernetes-deployment.rst
+++ /dev/null
@@ -1,113 +0,0 @@
-===================================
-Deploy Kolla images with Kubernetes
-===================================
-
-https://blueprints.launchpad.net/kolla/+spec/kolla-kubernetes
-
-Kubernetes was evaluated by the Kolla team in the first two months of the project
-and it was found to be problematic because it did not support net=host,
-pid=host, and --privileged features of docker. Since then, it has developed
-these features. (https://github.com/kubernetes/kubernetes/releases/tag/v1.2.0)
-
-Though Kolla deploys the containers using Ansible, we can leverage the current
-work by using the config generation and injecting the configs into
-the Kubernetes pod.
-
-
-Problem description
-===================
-
-Kubernetes
-- life-cycle management: service monitoring, restarting, and scaling
-- upgrades: rolling and all at once upgrades
-
-Kubernetes has services/tools that can provide service monitoring, health
-checks, service scaling, and upgrades.
-
-We can use the scheduler to assign work loads to appropriate nodes.
-Kubernetes has built in health checks that will maintain the container's status.
-And we can use the replication processes[1] to scale up and down our stack.
-
-For upgrades, Kubernetes has a tool called 'deployments'[2], which will
-detect when there is a config change in the container and start scaling
-down the current running container and scaling up the new container. If
-the new container fails, it can roll back, a nice feature containers provide
-for us. Though this is oversimplified for OpenStack, we can make use of this.
-
-
-Proposed change
-===============
-
-- Add a deployment specific git repo (kolla-kubernetes) to contain the
- Kubernetes deployment code.
-
-Bootstrapping
--------------
-
-Kubernetes provides RestartPolicy which allows to define whether a container
-should be restarted and when[3]. It may be used for bootstraping.
-
-Another alternative is Ansible, which runs a number of scripts to setup the
-database, keystone, etc..
-
-Security impact
----------------
-
-The deployed OpenStack’s security should not be affected by the deployment tool.
-In addition, if we containerize the config data so that it can be injected into
-a pod, we can leverage the selinux capabilities in the config container.
-
-Performance Impact
-------------------
-
-Unknown
-
-
-Implementation
-==============
-
-Primary Assignee(s)
------------
- Ryan Hallisey (rhallisey)
-
-Other contributor(s):
- Michal Rostecki (mrostecki)
- Swapnil Kulkarni (coolsvap)
- MD NADEEM (mail2nadeem92)
- Vikram Hosakote (vhosakot)
- <Please add your name here if you are getting involved in kolla-kubernetes>
-
-Milestones
-----------
-
-Target Milestone for completion:
- unknown
-
-Work Items
-----------
-1. Change start.yml files so that they can inject configs into Kubernetes pod.
-2. Add support for kolla-kubernetes to kolla-cli.
-
-
-Testing
-=======
-
-Functional tests will be implemented in the OpenStack check/gating system to
-automatically checks that the Kubernetes deployment works for an AIO
-environment.
-
-
-Documentation Impact
-====================
-Add a quick start guide which will explain how to deploy kolla-kubernetes.
-Add a develop guide on how to contribute, which also explains how the
-deployment works.
-
-
-References
-==========
-
-- [1] http://kubernetes.io/v1.0/docs/user-guide/managing-deployments.html
-- [2] https://cloud.google.com/container-engine/docs/replicationcontrollers/
-- [3] https://github.com/kubernetes/kubernetes/blob/master/docs/user-guide/pod-states.md#restartpolicy
-- https://github.com/kubernetes/kubernetes