| Mohammed Naser | a546734 | 2024-04-30 00:34:16 -0400 | [diff] [blame] | 1 | ################# |
| 2 | CSI Configuration |
| 3 | ################# |
| 4 | |
| 5 | This section details how to configure Container Storage Interfaces (CSI) for |
| 6 | your Kubernetes cluster that Atmosphere runs on. You will need to follow the |
| 7 | steps below to enable specific CSI drivers based on your storage requirements. |
| 8 | |
| 9 | ******** |
| 10 | Ceph RBD |
| 11 | ******** |
| 12 | |
| 13 | If you are using the Ceph storage solution that Atmosphere deploys out of the |
| 14 | box, no additional configuration is required. The necessary settings are |
| 15 | automatically applied during the installation process. |
| 16 | |
| 17 | *************** |
| 18 | Dell PowerStore |
| 19 | *************** |
| 20 | |
| 21 | For environments requiring the integration of PowerStore for storage, |
| 22 | configure the PowerStore CSI driver by updating your Ansible inventory as |
| 23 | follows: |
| 24 | |
| 25 | .. code-block:: yaml |
| 26 | |
| 27 | csi_driver: powerstore |
| 28 | powerstore_csi_config: |
| 29 | arrays: |
| 30 | - endpoint: https://<FILL IN>/api/rest |
| 31 | globalID: <FILL IN> |
| 32 | username: <FILL IN> |
| 33 | password: <FILL IN> |
| 34 | skipCertificateValidation: true |
| 35 | isDefault: true |
| 36 | blockProtocol: <FILL IN> # FC or iSCSI |
| 37 | |
| 38 | Ensure that you replace ``<FILL IN>`` with actual values relevant to your |
| 39 | PowerStore configuration. This includes specifying the block protocol, which |
| 40 | can either be Fibre Channel (FC) or iSCSI, depending on your network |
| 41 | infrastructure. |
| 42 | |
| Mohammed Naser | edeb56a | 2024-06-17 20:43:27 -0400 | [diff] [blame] | 43 | ********* |
| 44 | IBM Block |
| 45 | ********* |
| 46 | |
| 47 | If you're using a storage array that is compatible with the IBM Block CSI |
| 48 | driver, you can configure it by updating your Ansible inventory as follows: |
| 49 | |
| 50 | .. code-block:: yaml |
| 51 | |
| 52 | csi_driver: ibm_block |
| 53 | ibm_block_csi_driver_management_address: <FILL IN> |
| 54 | ibm_block_csi_driver_username: <FILL IN> |
| 55 | ibm_block_csi_driver_password: <FILL IN> |
| 56 | ibm_block_csi_driver_pool: <FILL IN> |
| 57 | ibm_block_csi_driver_io_group: <FILL IN> |
| 58 | |
| 59 | Optionally, you can control the ``SpaceEfficiency`` setting which defaults to |
| 60 | `thin` to enable thin provisioning. To change it to any other value, you |
| 61 | can set the following variable: |
| 62 | |
| 63 | .. code-block:: yaml |
| 64 | |
| 65 | ibm_block_csi_driver_space_efficiency: <FILL IN> |
| 66 | |
| 67 | Ensure that you replace ``<FILL IN>`` with actual values relevant to your IBM |
| 68 | Block configuration. You can use the `Creating a StorageClass <https://www.ibm.com/docs/en/stg-block-csi-driver/1.11.3?topic=configuring-creating-storageclass>`_ |
| 69 | documentation to help you determine the values to use. |
| 70 | |
| Mohammed Naser | a546734 | 2024-04-30 00:34:16 -0400 | [diff] [blame] | 71 | ******** |
| 72 | StorPool |
| 73 | ******** |
| 74 | |
| 75 | For environments requiring the integration of StorPool for storage, configure |
| 76 | the StorPool CSI driver by updating your Ansible inventory as follows: |
| 77 | |
| 78 | .. code-block:: yaml |
| 79 | |
| 80 | csi_driver: storpool |
| 81 | storpool_csi_template: k8s |
| 82 | |
| 83 | The ``storpool_csi_template`` variable specifies the StorPool template to use |
| 84 | for the deployment which is set to ``k8s`` in the example above. |