aboutsummaryrefslogtreecommitdiff
path: root/doc/source/reference/storage
AgeCommit message (Collapse)AuthorFilesLines
2026-06-19docs: warn about password resets in ceph RGW docBertrand Lanson1-0/+9
Keeping this value to true with external RGW as object storage endpoints can cause outages that are annoying to recover from. We should warn operators about this. Change-Id: I37965382bed6b9762782ec3f9ec3103143d738cc Signed-off-by: Bertrand Lanson <bertrand.lanson@infomaniak.com> (cherry picked from commit 8510b763fec5fbfdcd677177809c682eb69e97dc)
2026-04-27Drop zun and kuryrMichal Nasiadka1-28/+0
Zun is broken in 2026.1, it has been released broken and there are no reviews on the patch to fix it [1]. [1]: https://review.opendev.org/c/openstack/zun/+/982362 Depends-On: https://review.opendev.org/c/openstack/ansible-collection-kolla/+/986150 Change-Id: I8ced621754d03c44b7672dd94fc3d7d2173ac734 Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2026-04-20Merge "cinder: Change default destination for cinder-volume/backup containers"Zuul1-34/+13
2026-04-17cinder: Change default destination for cinder-volume/backup containersMichal Nasiadka1-34/+13
Kolla-Ansible defaulted for long time to deploy cinder-volume/backup containers on storage group, which is good for Cinder LVM deployments. Problem is - majority of deployments does not use Cinder LVM backend - they use mainly Ceph (based on OpenStack User Survey) and probably some other proprietary vendors which are API driven. Let's change the default to reflect reality. If a user has cinder lvm enabled - we will deploy it as it was before If a user has both cinder lvm and something else enabled - we will deploy cinder-volume and cinder-backup in both places (cinder group and storage group) If a user doesn't have cinder lvm enabled - we deploy only in the cinder group Change-Id: Ia4a874de8f1b8eab8ff688eab4c6af013449c18c Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2026-04-12Fix: Update outdated documentationPiotr Milewski8-19/+19
Change-Id: I5dc53f74afd9a5b565201dc9d3039d82cb65dabc Signed-off-by: Piotr Milewski <vurmil@gmail.com>
2025-08-07Drop VMware supportMichal Nasiadka1-6/+0
Change-Id: I20a669bf7796285df04723a9110f9c74788600e1 Signed-off-by: Michal Nasiadka <mnasiadka@gmail.com>
2025-06-03Fix docs rendering errors.Michael Still4-29/+29
I was reading https://docs.openstack.org's version of the kolla-ansible advanced configuration guide and noticed some RST rendering errors. This patch corrects those errors so that the page renders correctly. Change-Id: I330678d8971d286e67f115eace1cb606d30433b6
2025-04-28Add Pure Storage FlashBlade as Manila backendSimon Dodsley2-0/+287
Follow existing patterns to add support for the Pure Storage FlashBlade NFS Manila driver. Change-Id: I5ed40748439111e5986d6bf44ecb6b9fe7478dc9
2025-03-27Merge "add lightbits driver support"Zuul3-0/+37
2025-03-21Remove Swift roleMichal Nasiadka2-316/+0
Since Swift is broken and since deprecation nobody did pick up the work to make it working - let's remove swift role and associated integrations/CI scripts. Change-Id: I08e92aaeea644053fd25f80ce1f276a495cebbfc
2025-03-12add lightbits driver supportyuval3-0/+37
Change-Id: I50c5a1443c5d2012388debed20b96274bc69e7e7
2025-02-03[Pure Storage] Update Pure reference page in documentationSimon Dodsley1-2/+7
From the release of 2024.2 (Dalmatian) the SDK required by the Pure Cinder driver changes from ``purestorage`` to ``py-pure-client``. This patch updates the Pure documentation to reflect this change. Change-Id: I7092f3b7ca00019822b8d8f6f425fbb13db9d8ae
2025-01-22docs: fix link to Cinder HA pagePierre Riteau1-1/+3
Fix URL by switching from KOLLA_OPENSTACK_RELEASE to OPENSTACK_RELEASE introduced in [1]. This replaces `master` by `latest` in the URL. The link was also not rendered correctly because of a syntax error. [1] https://review.opendev.org/c/openstack/kolla-ansible/+/937440 Change-Id: Ie8c90ff5c8682aec07e851909bc820cba7602bec
2024-12-05docs: minor fixes to external Ceph guidePierre Riteau1-8/+6
When a path is broken into two separate lines, the generated HTML includes an incorrect space character in the middle of the path. We need to ignore doc8 linting on this file as this change breaks the max line length check. I tried using ``ignore-path-errors`` to exclude only D001 for this file, but doc8 does not like a relative path for this option [1]. [1] https://github.com/PyCQA/doc8/issues/162 Change-Id: I1cf0b7a6b7506a68876bce2de5080718280a47be
2024-11-25Enhance Ceph Integration for Multiple ClustersMichal Arbet1-75/+124
This patch enhances Kolla-Ansible's existing support for multiple Ceph clusters by improving the management of custom users, pools, and cluster names. It aligns the Ceph integration more closely with the official Ceph user management guidelines [1]. Keyrings now follow the format `$cluster.client.$user.keyring`, and configurations are easier to handle when multiple Ceph clusters are in use, especially in environments with multiple availability zones. Previously, workarounds were needed for keyrings and config files, which this patch eliminates, providing a cleaner and more structured configuration approach which follows the Ceph best practices. The default Kolla setup remains unaffected by these changes, ensuring backward compatibility. Updated documentation and examples are included. [1] https://docs.ceph.com/en/latest/rados/operations/user-management/#keyring-management Change-Id: I2593b6df737b384f1a5fba22f69e851c575990b4
2024-10-25Merge "cinder: Add prechecks and docs for HA/clustering"Zuul1-0/+17
2024-10-25cinder: Add prechecks and docs for HA/clusteringMichal Nasiadka1-0/+17
Change-Id: I33a3ec11b0cdef94b08cd7551008284755824cb7
2024-10-25cinder: Drop Hitachi HNAS NFS driver supportMichal Nasiadka3-215/+0
It has been removed in I23867aa98f68298beb5db4558c66c1ffd4e7d6f1 Change-Id: I12d287b9f7f1e5ddf754b7f2ca1dee39778e710e
2024-08-20Add NVMe-TCP Cinder driver support for Pure StorageSimon Dodsley2-0/+17
From OpenStack 2023.2 (Bobcat) the Pure Storage Cinder driver supports NVMe-TCP as a dataplane protocol. This patch adds support for this new driver type. Change-Id: I3c0ad7652a03388ab2eafa173c644a55b0405cc6
2023-10-25Deploy Glance and Cinder Backup with S3 backend supportSergei Raiskii1-0/+28
Kolla Ansible should deploy Glance and Cinder Backup with S3 backend support working out-of-the-box. The S3 backend had been re-introduced in Ussuri after being deprecated around the Mitaka timeframe, and having some local object storage options is nice for testing.. Closes-Bug: #1977515 Change-Id: I4ca58382d1ee568bfca2ad108495422163f81260 Co-authored-by: Juan Pablo Suazo <jsuazo@whitestack.com> Co-authored-by: Maksim Malchuk <maksim.malchuk@gmail.com>
2023-07-17Correct glance.conf example in external Ceph guideMatt Crees1-1/+1
Under the Glance section of the external Ceph guide, to enable copy-on-write the config heading should be ``[DEFAULT]``, rather than ``[GLOBAL]``. For reference, see the Glance docs: https://docs.openstack.org/glance/latest/configuration/glance_api.html#DEFAULT.show_image_direct_url Closes-Bug: #2017643 Change-Id: I2d77e01637ecae0bd10319eac4bc75340dd6f61f
2023-06-14Add support for multiple ceph filesMichal Arbet1-120/+328
This patch is adding a feature for an option to copy different ceph configuration files and corresponding keyrings for cinder, glance, manila, gnocchi and nova services. This is especially useful when the deployment uses availability zones as below example. - Individual compute can read/write to individual ceph cluster in same AZ. - Cinder can write to several ceph clusters in several AZs. - Glance can use multistore and upload images to several ceph clusters in several AZs at once. Change-Id: Ie4d8ab5a3df748137835cae1c943b9180cd10eb1
2023-03-28Add note about removing leading tabs in ceph.conf filesTom Fifield1-0/+8
As reported in bug #1914814, common ways to generate ceph config files result in files that have leading tabs. These tabs make Kolla Ansible's ini parser unhappy, so add a note to remind users to remove them. Closes-Bug: #1914814 Change-Id: I4b06eae75bf238f2f093bfb76ba37c7f75dfd616
2022-11-07Add NVMe-RoCE Cinder driver support for Pure StorageSimon Dodsley2-3/+20
From OpenStack Zed the Pure Storage Cinder driver supports NVMe-RoCE as a dataplane protocol. This patch adds support for this new driver type. Also amend a couple of documentation formatting typos. Change-Id: Ic1eed7d19e9b583e22419625c92ac3507ea4614d
2022-08-17Introduce variables for cinder backend namesWill Szumski1-0/+52
This allows you to use a more descriptive name if you desire. For example, when using cinder with multiple ceph backends, rbd-1, doesn't convey much information. You could include location, disk technology, etc. in the name. Change-Id: Icfdc2e5726fec8b645d6c2c63391a13c31f2ce9a
2022-05-13Add support for Pure Storage FlashArray backend to CinderSimon Dodsley2-0/+50
Add an enable_cinder_backend_pure_iscsi and enable_cinder_backend_pure_fc options to etc/kolla/globals.yml to enable use of the FlashArray backend. Update the documentation to include a section on configuring Cinder with the FlashArray. Implements: blueprint pure-cinder-driver Change-Id: I464733f1322237321ed1ffff8636cf30bd1cbb38
2022-02-02Deploy Zun with Cinder Ceph supportBuddhika Sanjeewa1-0/+27
Enables zun to access cinder volumes when cinder is configured to use external ceph. Copies ceph config file and ceph cinder keyring to /etc/ceph in zun_compute container. Closes-Bug: 1848934 Change-Id: Ie56868d5e9ed37a9274b8cbe65895f3634b895c8
2021-12-23Deprecate storage_interface variableRadosław Piliszek1-1/+1
Per [1] and exchange on IRC. [1] http://lists.openstack.org/pipermail/openstack-discuss/2021-December/026437.html Change-Id: I322500e7204eb129d7bf085006627e8c4aaaa934
2021-12-23[docs] swift: fix mentions of interfaces configRadosław Piliszek1-9/+9
Change-Id: I27496528c684c993a3e470265ba86cc29c136c7b
2021-10-20Merge "Update Manila deploy steps for Wallaby"Zuul1-0/+7
2021-10-06Docs: Update to opendev.org domainPiotr Parczewski1-1/+1
Curl would not work without -L on old openstack.org URLs. TrivialFix Change-Id: I7ed7bd336f4b874fc6027cb9ad20669b08e4a7e9
2021-09-30Merge "docs: ceph: add copy-on-write for Glance"Zuul1-0/+14
2021-09-30Add support for Ceph RadosGW integrationMark Goddard1-0/+71
* Register Swift-compatible endpoints in Keystone * Load balance across RadosGW API servers using HAProxy The support is exercised in the cephadm CI jobs, but since RGW is not currently enabled via cephadm, it is not yet tested. https://docs.ceph.com/en/latest/radosgw/keystone/ Implements: blueprint ceph-rgw Change-Id: I891c3ed4ed93512607afe65a42dd99596fd4dbf9
2021-09-30docs: ceph: add copy-on-write for GlanceMichał Nasiadka1-0/+14
Change-Id: I51e2b62f563e66b6bb919621272662f3f8721eb2
2021-08-17Update Manila deploy steps for WallabySkylar Kelty1-0/+7
Manila has changed from using subfolders to subvolumes. We need a bit of a tidy up to prevent deploy errors. This change also adds the ability to specify the ceph FS Manila uses instead of relying on the default "first found". Closes-Bug: #1938285 Closes-Bug: #1935784 Change-Id: I1d0d34919fbbe74a4022cd496bf84b8b764b5e0f
2021-07-28nova: Use cinder user for CephMark Goddard1-7/+6
In Ussuri, nova stopped using separate Ceph keys for the volumes and vms pools by default. Instead, we set ceph_nova_keyring to the value of ceph_cinder_keyring by default, which is ceph.client.cinder.keyring. This is in line with the Ceph OpenStack integration guide [1]. However, the user used by nova to access the vms pool (ceph_nova_user) defaults to nova, meaning that nova will still try to use a ceph.client.nova.keyring, which probably does not exist. We did not see this issue in CI, because we set ceph_nova_user to cinder. This change fixes the issue by setting ceph_nova_user to the value of ceph_cinder_user by default, which is cinder. Closes-Bug: #1934145 Related-Bug: #1928690 [1] https://docs.ceph.com/en/latest/rbd/rbd-openstack/ Change-Id: I6aa8db2214e07906f1f3e035411fc80ba911a274
2021-02-07Merge "docs: improve external Ceph docs"Zuul1-35/+66
2021-01-27[docs] Unify project's naming conventionPiotr Parczewski1-1/+1
There are inconsitencies across the documentation and the source code files when it comes to project's name (Kolla Ansible vs. Kolla-Ansible). This commit aims at unifying it so that the naming becomes consistent everywhere. Change-Id: I903b2e08f5458b1a1abc4af3abefe20b66c23a54
2020-12-28Fix Ceph linksSergei Chekanov1-4/+3
and drop the reference to ceph-deploy (seems abandoned). Change-Id: I763317a6f8207357991c23fa5a2fc8cc6f8a17f4
2020-11-20docs: improve external Ceph docsMark Goddard1-35/+66
* make each section independent * move enable flags to specific sections * move inventory changes to Cinder section * move Nova config that is actually for Cinder volumes to Cinder section * add an introduction about each integration Change-Id: Ie8d82010bf8d5b8af2c039f285744e5ae67316dc
2020-10-24Add support for GlusterFS NFS Manila backendlinpeiwen1-0/+63
Follows existing backends patterns to add support for the GlusterFS NFS driver. NFS server type used by the GlusterFS backend, Gluster or Ganesha, currently supports Gluster. The GlusterFS NFS driver needs to install the glusterfs-fuse package in the kolla images manila share container in advance, which has been merged in https://review.opendev.org/747510 Change-Id: I7fdb121b5bf9850d62246a24f9b17d226028c2ca
2020-02-20Update docs to say that external Ceph requiredJason Anderson1-3/+10
There is no longer support for provisioning Ceph in Kolla Ansible, so we should no longer say that it's only sometimes necessary to create the cluster/pools/keyrings externally. Change-Id: Ia3026cfeebfb8258b79490f9facc341c928845f9
2020-02-11Remove kolla-cephMichal Nasiadka4-549/+3
Kolla-Ansible Ceph deployment mechanism has been deprecated in Train [1]. This change removes the Ansible code and associated CI jobs. [1]: https://review.opendev.org/669214 Change-Id: Ie2167f02ad2f525d3b0f553e2c047516acf55bc2
2020-01-30doc: external Ceph - add manila ceph caps noteMichal Nasiadka1-1/+6
Change-Id: Iad7347b6bdd34fc99872e1035e673fe69d6c55ea
2020-01-29doc: fix bullets in external_ceph.rstMichal Nasiadka1-1/+3
Bullets under Cinder paragraph were not properly formatted. Change-Id: I0626c93435c989447feb257cd24ddc3af2d05851
2020-01-29External Ceph: add ceph_*_user variablesMichal Nasiadka1-80/+21
To make the configuration easier for the user, and to allow non-standard ceph authentication ids - introduce ceph_*_user variables. Change-Id: I24e01c43c826b62b6748d93a498f4b7d8ce9e309
2020-01-22External Ceph: keys as variablesMichal Nasiadka1-161/+108
Introduce user modifiable variables instead of fixed-names of Ceph keyring files for external Ceph functionality. Change-Id: I1a33b3f9d6eca5babf53b91187461e43aef865ce
2019-09-24Swift: add swift_extra_ring_files variable to handle multi-policies deploymentAlexis Deberg1-0/+10
The current tasks only use a hardcoded list deploying only the required files. When using multiple custom policies, additionnal object-*.builder and object*.gz files are to be deployed as well. This adds a new default-empty variable that can be overridden when needed Change-Id: I29c8e349c7cc83e3a2e01ff702d235a0cd97340e Closes-Bug: #1844752
2019-09-18Remove support for OracleLinuxMark Goddard1-1/+1
We have agreed to remove support for Oracle Linux. http://lists.openstack.org/pipermail/openstack-discuss/2019-June/006896.html Change-Id: If11b4ff37af936a0cfd34443e8babb952307882b
2019-09-12Merge "Enable Swift Recon"Zuul1-3/+31