150 lines
3.4 KiB
ReStructuredText
150 lines
3.4 KiB
ReStructuredText
.. _ceph:
|
||
|
||
====================
|
||
Ceph and Swift guide
|
||
====================
|
||
|
||
This guide provides instruction for adding Ceph and Swift support for CCP
|
||
deployment.
|
||
|
||
.. NOTE:: It's expected that an external Ceph cluster is already available and
|
||
accessible from the all k8s nodes. If you don't have a Ceph cluster, but
|
||
still want to try CCP with Ceph, you can use :doc:`ceph_cluster` guide for
|
||
deploying a simple 3 node Ceph cluster.
|
||
|
||
Ceph
|
||
~~~~
|
||
|
||
Prerequirements
|
||
---------------
|
||
|
||
You need to ensure that these pools are created:
|
||
|
||
* images
|
||
* volumes
|
||
* vms
|
||
|
||
And that users "glance" and "cinder" are created and have these permissions:
|
||
|
||
::
|
||
|
||
client.cinder
|
||
caps: [mon] allow r
|
||
caps: [osd] allow rwx pool=volumes, allow rwx pool=vms, allow rx pool=images
|
||
client.glance
|
||
caps: [mon] allow r
|
||
caps: [osd] allow rwx pool=images, allow rwx pool=vms
|
||
|
||
|
||
Deploy CCP with Ceph
|
||
--------------------
|
||
|
||
In order to deploy CCP with Ceph you have to edit the ``ccp.yaml`` the file:
|
||
|
||
::
|
||
|
||
configs:
|
||
ceph:
|
||
fsid: "FSID_OF_THE_CEPH_CLUSTER"
|
||
mon_host: "CEPH_MON_HOSTNAME"
|
||
cinder:
|
||
ceph:
|
||
enable: true
|
||
key: "CINDER_CEPH_KEY"
|
||
rbd_secret_uuid: "RANDOM_UUID"
|
||
glance:
|
||
ceph:
|
||
enable: true
|
||
key: "GLANCE_CEPH_KEY"
|
||
nova:
|
||
ceph:
|
||
enable: true
|
||
|
||
Example:
|
||
|
||
::
|
||
|
||
configs:
|
||
ceph:
|
||
fsid: "afca8524-2c47-4b81-a0b7-2300e62212f9"
|
||
mon_host: "10.90.0.5"
|
||
cinder:
|
||
ceph:
|
||
enable: true
|
||
key: "AQBShfJXID9pFRAAm4VLpbNXa4XJ9zgAh7dm2g=="
|
||
rbd_secret_uuid: "b416770d-f3d4-4ac9-b6db-b6a7ac1c61c0"
|
||
glance:
|
||
ceph:
|
||
enable: true
|
||
key: "AQBShfJXzXyNBRAA5kqXzCKcFoPBn2r6VDYdag=="
|
||
nova:
|
||
ceph:
|
||
enable: true
|
||
|
||
|
||
- ``fsid`` - Should be the same as ``fsid`` variable in the Ceph cluster
|
||
``ceph.conf`` file.
|
||
- ``mon_host`` - Should contain any Ceph mon node IP or hostname.
|
||
- ``key`` - Should be taken from the corresponding Ceph user. You can
|
||
use the ``ceph auth list`` command on the Ceph node to fetch list of all
|
||
users and their keys.
|
||
- ``rbd_secret_uuid`` - Should be randomly generated. You can use the
|
||
``uuidgen`` command for this.
|
||
|
||
Make sure that your deployment topology has a ``cinder`` service. You could
|
||
use ``etc/topology-with-ceph-example.yaml`` as a reference.
|
||
|
||
Now you’re ready to deploy CCP with Ceph support.
|
||
|
||
Swift
|
||
~~~~~
|
||
|
||
Prerequirements
|
||
---------------
|
||
|
||
Make sure that your deployment topology has a ``radosgw`` service. You could
|
||
use ``etc/topology-with-ceph-example.yaml`` as a reference.
|
||
|
||
Deploy CCP with Swift
|
||
---------------------
|
||
|
||
.. NOTE:: Currently, in CCP, only Glance supports Swift as a backend.
|
||
|
||
In order to deploy CCP with Swift you have to edit ``ccp.yaml`` the file:
|
||
|
||
::
|
||
|
||
ceph:
|
||
fsid: "FSID_OF_THE_CEPH_CLUSTER"
|
||
mon_host: "CEPH_MON_HOSTNAME"
|
||
radosgw:
|
||
key: "RADOSGW_CEPH_KEY"
|
||
glance:
|
||
swift:
|
||
enable: true
|
||
store_create_container_on_put: true
|
||
|
||
Example:
|
||
|
||
::
|
||
|
||
ceph:
|
||
fsid: "afca8524-2c47-4b81-a0b7-2300e62212f9"
|
||
mon_host: "10.90.0.2,10.90.0.3,10.90.0.4"
|
||
radosgw:
|
||
key: "AQBIGP5Xs6QFCRAAkCf5YWeBHBlaj6S1rkcCYA=="
|
||
glance:
|
||
swift:
|
||
enable: true
|
||
store_create_container_on_put: true
|
||
|
||
Troubleshooting
|
||
---------------
|
||
|
||
If the Glance image upload failed, you should check few things:
|
||
|
||
- Glance-api pod logs
|
||
- Radosgw pod logs
|
||
- Keystone pod logs
|
||
|