Configuring Ceph-csi

Configure Ceph-csi on the Kubernetes management node, including configuring the csi-config-map.yaml file to deploy config-map and configuring the ceph-config.yaml file to deploy ceph-config.

1. Log in to the storage node and check the Ceph server software version.

   ceph -v

   The following figure shows the Ceph software version:

   

   

   To ensure Ceph service compatibility, you are advised to ensure that the Ceph client version in the Ceph-csi plugin is the same as the Ceph server version. In this example, the Ceph software version is 16.2.7.

2. Query the tag of the Ceph-csi plugin.
   1. Log in to the quay.io website (or search for the Ceph-csi plugin at other image release sites) and query the Ceph client version used by the Ceph-csi plugin.
   2. Click Expanded in the upper right corner of the website to show Ceph-csi plugin tags. Locate the tag whose CEPH_POINT_RELEASE version is the same as the Ceph server version.
      

      The AArch64 architecture uses a tag suffixed with ARM64, whereas the x86_64 architecture uses a tag suffixed with AMD64. Select a proper tag based on the OS architecture. In this example, the tag is v3.5-canary-arm64 and the tag version is v3.5.

      

3. Obtain the YAML configuration template file of the version.

   Replace release-vX.X in the configuration file repository website https://github.com/ceph/ceph-csi/blob/release-vX.X/deploy/rbd/kubernetes/ with the version number corresponding to the tag, access the website, obtain the configuration file csi-config-map.yaml, and save the configuration file to the Kubernetes node.

   In this example, the tag version of the Ceph-csi plugin is v3.5. Visit https://github.com/ceph/ceph-csi/blob/release-v3.5/deploy/rbd/kubernetes/ to obtain the YAML configuration file.

4. Modify the csi-config-map.yaml file.
   1. Open the file.

      csi-config-map.yaml

   2. Press i to enter the insert mode. Replace the value of clusterID with the FSID obtained in 2, and replace the value of monitors with the monitor addresses obtained in 2. See the following figure.

      

      

      Ceph-csi only supports the v1 protocol. Use the monitor address of the v1 protocol.

   3. Press Esc to exit the insert mode. Type :wq! and press Enter to save the file and exit.
5. Deploy the config-map.

   kubectl apply -f csi-config-map.yaml

6. Edit the ceph-config.yaml file
   1. Create a file.

      vi ceph-config.yaml

   2. Press i to enter the insert mode and add the following content to the file:

      apiVersion: v1 
      kind: ConfigMap 
      data: 
        ceph.conf: | 
          [global] 
          auth_cluster_required = cephx 
          auth_service_required = cephx 
          auth_client_required = cephx 
        # keyring is a required key and its value should be empty 
        keyring: | 
      metadata: 
        name: ceph-config

   3. Press Esc to exit the insert mode. Type :wq! and press Enter to save the file and exit.
7. Deploy ceph-config.

   kubectl apply -f ceph-config.yaml