Skip to content

2023.1: Ceph RGW docs improvements #1210

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 5, 2024
Merged

2023.1: Ceph RGW docs improvements #1210

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0986345
docs: Remove legacy Member and _member_ roles from Ceph RADOS Gateway…
markgoddard Aug 5, 2024
96f5c8f
docs: Improve Ceph RGW docs
markgoddard Aug 5, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion doc/source/configuration/cephadm.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -347,6 +347,10 @@ should be used in the Kolla Manila configuration e.g.:
RADOS Gateways
--------------

RADOS Gateway integration is described in the :kolla-ansible-doc:`Kolla Ansible
documentation
<https://docs.openstack.org/kolla-ansible/latest/reference/storage/external-ceph-guide.html#radosgw>`.

RADOS Gateways (RGWs) are defined with the following:

.. code:: yaml
Expand Down Expand Up @@ -377,7 +381,7 @@ The set of commands below configure all of these.
- "config set client.rgw rgw_enable_apis 's3, swift, swift_auth, admin'"
- "config set client.rgw rgw_enforce_swift_acls true"
- "config set client.rgw rgw_keystone_accepted_admin_roles 'admin'"
- "config set client.rgw rgw_keystone_accepted_roles 'member, Member, _member_, admin'"
- "config set client.rgw rgw_keystone_accepted_roles 'member, admin'"
- "config set client.rgw rgw_keystone_admin_domain Default"
- "config set client.rgw rgw_keystone_admin_password {{ secrets_ceph_rgw_keystone_password }}"
- "config set client.rgw rgw_keystone_admin_project service"
Expand All @@ -393,6 +397,12 @@ The set of commands below configure all of these.
- "config set client.rgw rgw_swift_account_in_url true"
- "config set client.rgw rgw_swift_versioning_enabled true"

Enable the Kolla Ansible RADOS Gateway integration in ``kolla.yml``:

.. code:: yaml

kolla_enable_ceph_rgw: true

As we have configured Ceph to respond to Swift APIs, you will need to tell
Kolla to account for this when registering Swift endpoints with Keystone. Also,
when ``rgw_swift_account_in_url`` is set, the equivalent Kolla variable should
Expand All @@ -414,6 +424,11 @@ before deploying the RADOS gateways. If you are using the Kolla load balancer

kayobe overcloud service deploy -kt ceph-rgw,keystone,haproxy,loadbalancer

There are two options for load balancing RADOS Gateway:

1. HA with Ceph Ingress services
2. RGWs with hyper-converged Ceph (using the Kolla Ansible deployed HAProxy
load balancer)

.. _RGWs-with-hyper-converged-Ceph:

Expand Down