porthole/images/ceph-utility/README.md
Lindsey Durway 7b8f9d6147 Editorial changes to documentation files
Edited and revised formatting to improve readability and
consistency with other docs in this repo.

Change-Id: I8693b85fdbd84e625e774ae0fe4d81dae7d74a57
2019-12-16 09:21:19 -06:00

1.3 KiB

Ceph-utility Container

The Ceph utility container enables Operations to check the state/stats of Ceph resources in the Kubernetes cluster. This utility container enables Operations to perform restricted administrative activities without exposing the credentials or keyring.

Generic Docker Makefile

This is a generic make and dockerfile for the Ceph utility container. This can be used to create docker images using different Ceph releases and Ubuntu releases

Usage

   make CEPH_RELEASE=<release_name> UBUNTU_RELEASE=<release_name>

Example:

  1. Create a docker image for the Ceph Luminous release on Ubuntu Xenial (16.04).
       make CEPH_RELEASE=luminous UBUNTU_RELEASE=xenial
  1. Create a docker image for the Ceph Mimic release on Ubuntu Xenial (16.04).
       make CEPH_RELEASE=mimic UBUNTU_RELEASE=xenial
  1. Create a docker image for the Ceph Luminous release on Ubuntu Bionic (18.04).
       make CEPH_RELEASE=luminous UBUNTU_RELEASE=bionic
  1. Create a docker image for the Ceph Mimic release on Ubuntu Bionic (18.04).
       make CEPH_RELEASE=mimic UBUNTU_RELEASE=bionic
  1. Get into the utility pod using kubectl exec. Perform an operation on the Ceph cluster as in the following example.

Example:

   utilscli ceph osd tree
   utilscli rbd ls
   utilscli rados lspools