Enable Ceph RADOS Gateway Object Storage

Pelagia enables you to deploy Ceph RADOS Gateway (RGW) Object Storage instances and automatically manage its resources such as users.

Pelagia has an integration for Ceph Object Storage with OpenStack Object Storage (Swift) provided by Rockoon.

Ceph RGW Object Storage parameters

  • name - Mandatory. Ceph Object Storage instance name.

  • usedForOpenstack - Optional. Enables consumption of the current Ceph RGW instance by OpenStack, which allows adding the required OpenStack parameters to the Ceph RGW configuration. For the first such instance, Pelagia also creates the rgw-ceilometer user for OpenStack metrics. If gatewayHTTPRoutes is not specified, Pelagia creates the default <name>-openstack-route Gateway API HTTPRoute for the instance. If lcmConfig.useIngress is set to true in the Helm chart values, Pelagia also creates an Ingress for the instance.

  • auxiliaryService - Optional. Enables the current Ceph RGW instance to operate without a StorageClass and external API access. Useful for auxiliary instances, such as a Ceph RGW multisite replication daemon or an instance providing Ceph RGW admin API access.

  • servedByIngress - Optional. Enables the current Ceph RGW instance to be used by the Ingress controller. Takes effect only if lcmConfig.useIngress is set to true in the Helm chart values, which is false by default. Deprecated in favor of the Gateway API HTTPRoutes.

  • spec - Mandatory. Represents the Rook CephObjectStore specification. For details, see CephObjectStore CRD and CephObjectStore API specification.

Enable Ceph RGW Object Storage

  1. Open the CephDeployment resource for editing:

    kubectl -n ceph-lcm-mirantis edit cephdpl <name>
    

    Substitute <name> with the name of your CephDeployment.

  2. Update the objectStorage.objectStores section specification using the configuration reference above. For example:

    objectStores:
    - name: rgw-store
      spec:
        dataPool:
          deviceClass: hdd
          erasureCoded:
            codingChunks: 1
            dataChunks: 2
          failureDomain: host
        metadataPool:
          deviceClass: hdd
          failureDomain: host
          replicated:
            size: 3
        gateway:
          instances: 3
          port: 80
          securePort: 8443
        preservePoolsOnDelete: false
    
  3. Save the changes and exit the editor.

To expose the Ceph Object Gateway on a public endpoint and configure TLS, use the Gateway API. For details, see Configure Ceph Object Gateway TLS.