RepoMirrors/ceph
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2025-02-19 08:57:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #18886 from BlaineEXE/update-kube-helm-start-doc

Browse Source 
doc: Add newbie-friendly updates to Helm start doc

Reviewed-by: Alex Marangone <amarango@redhat.com>
This commit is contained in:
Sage Weil 2017-12-29 11:53:12 -06:00 committed by GitHub
commit 4d08f03af4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/start/kube-helm.rst
View File

@ -13,14 +13,19 @@ Current limitations
in your Ceph cluster and create its secret in Kubernetes
- ceph-mgr can only run with 1 replica
Install and start helm
Install and start Helm
======================
Helm can be installed by following these instructions_.
Once installed, run::
Helm finds the Kubernetes cluster by reading from the local Kubernetes config file; make sure this is downloaded and accessible to the ``helm`` client.
A Tiller server must be configured and running for your Kubernetes cluster, and the local Helm client must be connected to it. It may be helpful to look at the Helm documentation for init_. To run Tiller locally and connect Helm to it, run::
$ helm init
The ceph-helm project uses a local Helm repo by default to store charts. To start a local Helm repo server, run::
$ helm serve &
$ helm repo add local http://localhost:8879/charts
@ -35,7 +40,7 @@ Add ceph-helm to Helm local repos
Configure your Ceph cluster
===========================
Create a ``~/ceph-overrides.yaml`` that will contain your Ceph configuration::
Create a ``ceph-overrides.yaml`` that will contain your Ceph configuration. This file may exist anywhere, but for this docuiment will be assumed to reside in the user's home directory.::
$ cat ~/ceph-overrides.yaml
network:
@ -60,6 +65,13 @@ Create a ``~/ceph-overrides.yaml`` that will contain your Ceph configuration::
.. note:: The ``ceph-helm/ceph/ceph/values.yaml`` file contains the full
list of option that can be set
Create the Ceph cluster namespace
==================================
By default, ceph-helm components assume they are to be run in the ``ceph`` Kubernetes namespace. To create the namespace, run::
$ kubectl create namespace ceph
Configure RBAC permissions
==========================
@ -342,3 +354,4 @@ For instance, to access the cluster-tail-log, one can run::
.. _ceph-helm: https://github.com/ceph/ceph-helm/
.. _instructions: https://github.com/kubernetes/helm/blob/master/docs/install.md
.. _init: https://github.com/kubernetes/helm/blob/master/docs/helm/helm_init.md