Container Storage Interface for S3 (S3-CSI)

Go to your VK Cloud management console.

Select the project that contains the required cluster.

Go to Containers → Kubernetes clusters.

Find the cluster you need in the list.

Make sure that the cluster has a dedicated group of worker nodes that will host add-ons.

If there is no such group — add it.

Customise for this node group, if it hasn't already been done:

• Kubernetes labels: key addonNodes, value dedicated.
• Node taints: effect NoSchedule, key addonNodes, value dedicated.

Go to your VK Cloud management console.

Select the project that contains the required cluster.

Go to Containers → Kubernetes clusters.

Click on the name of the required cluster.

Go to Addons tab.

If there are already installed add-ons in the cluster, click the Add addon button.

Click the Install button on the s3-csi add-on card.

Select the required version from the drop-down list.

Click the Install addon button.

Edit if necessary:

• selected version
• application name
• the name of the namespace where the add-on will be installed

Configure the addon code to work with the S3-compatible storage. To do this, add the required values to the secret block:

 
secret: ... # S3 Access Key ID accessKey: "<ACCESS_KEY_ID>" # S3 Secret Key secretKey: "<SECRET_KEY>" # The endpoint of the S3 service to be used. You can provide a custom S3 endpoint address. # Defaults to the VK Object Storage URL. endpoint: "{{ <STORAGE_URL> }}" # The S3 service region to be used. region: "<REGION>"

Here:

• <ACCESS_KEY_ID> ans <SECRET_KEY> are the values you copied when creating the VK Object Storage account.
• <STORAGE_URL> is the endpoint of the S3-compatible storage API. If you are using VK Object Storage, you do not need to specify this parameter, it is set by default.
• <REGION> is the region of the object storage. If you are using VK Object Storage, you do not need to specify this parameter. For other object storages, refer to the official documentation of your vendor to learn whether this parameter is required.

If necessary, add other changes to the add-on settings code.

Set the necessary tolerations and nodeSelector in the add-on settings code:

 
tolerations:  - key: "addonNodes"    operator: "Equal"    value: "dedicated"    effect: "NoSchedule"

 
nodeSelector:  addonNodes: dedicated

Click the Install addon button.

The installation of the add-on in the cluster will begin. This process can take a long time.

Go to VK Cloud management console.

Select the project that contains the required cluster.

Go to Containers → Kubernetes clusters.

Click on the name of the required cluster.

Go to Addons tab.

If there are already installed add-ons in the cluster, click the Add addon button.

Click the Install button on the s3-csi add-on card.

Select the required version from the drop-down list.

Click the Install addon button.

Edit if necessary:

• selected version
• application name
• the name of the namespace where the add-on will be installed

Click the Install addon button.

The installation of the add-on in the cluster will begin. This process can take a long time.