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.

Note

If the storage cluster has an RBD mirror daemon not deployed by ceph-ansible, you need to migrate the daemons prior to converting to a containerized cluster. For more details, see Migrating RBD mirroring daemons.

Prerequisites

  • 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.

Procedure

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

    Copy to Clipboard Toggle word wrap
    ceph_docker_image_tag: "latest"
    ceph_docker_image: rhceph/rhceph-4-rhel8
    containerized_deployment: true
    ceph_docker_registry: registry.redhat.io
    Important

    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:

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

    Syntax

    Copy to Clipboard Toggle word wrap
    ansible-playbook ./infrastructure-playbooks/switch-from-non-containerized-to-containerized-ceph-daemons.yml -i INVENTORY_FILE

    Example

    Copy to Clipboard Toggle word wrap
    [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

    Copy to Clipboard Toggle word wrap
    [root@mon ~]$ sudo docker ps

    Red Hat Enterprise Linux 8

    Copy to Clipboard Toggle word wrap
    [root@mon ~]$ sudo podman ps

Additional Resources

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.