Chapter 5. Migrating a non-containerized Red Hat Ceph Storage cluster to a containerized environment

To manually migrate a non-containerized, bare-metal, Red Hat Ceph Storage cluster to a containerized environment, use the ceph-ansible switch-from-non-containerized-to-containerized-ceph-daemons.yml playbook.


  • A running Red Hat Ceph Storage non-containerized, bare-metal, cluster.
  • Access to the Ansible administration node.
  • An ansible user account.
  • Sudo access to the ansible user account.


  1. Edit the group_vars/all.yml file to include configuration for containers:

    ceph_docker_image_tag: "latest"
    ceph_docker_image: rhceph/rhceph-4-rhel8
    containerized_deployment: true

    For the ceph_docker_image_tag, use latest if your current storage cluster is on latest version or use the appropriate image tag. See the What are the Red Hat Ceph Storage releases and corresponding Ceph package versions? for more information.

  2. Navigate to the /usr/share/ceph-ansible directory:

    [ansible@admin ~]$ cd /usr/share/ceph-ansible
  3. On the Ansible administration node, run the Ansible migration playbook:


    ansible-playbook ./infrastructure-playbooks/switch-from-non-containerized-to-containerized-ceph-daemons.yml -i INVENTORY_FILE


    [ansible@admin ceph-ansible]$ ansible-playbook ./infrastructure-playbooks/switch-from-non-containerized-to-containerized-ceph-daemons.yml -i hosts

    Verify the cluster is switched to containerized environment.

  4. On the monitor node, list all running containers:

    Red Hat Enterprise Linux 7

    [root@mon ~]$ sudo docker ps

    Red Hat Enterprise Linux 8

    [root@mon ~]$ sudo podman ps

Additional Resources