porthole/images/ceph-utility
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
..
Dockerfile.ubuntu_xenial Updating the image to quay.io airshipit/porthole and adding zuul gates 2019-10-07 16:10:58 -05:00
README.md Editorial changes to documentation files 2019-12-16 09:21:19 -06:00

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