Deploy AIStor on Kubernetes

This tutorial deploys AIStor onto Kubernetes distributions that follow the upstream API and functionality. The steps in this procedure may work on forked Kubernetes distributions.

This procedure requires the installation of Kubernetes operators and associated resources including CustomResourceDefinitions, Statefulsets, and secrets into new or existing namespaces. You must perform the operations in this procedure as a user that has broad permissions to create resources within multiple namespaces.

Deploy AIStor using Helm

This procedure documents installation on Kubernetes with the AIStor Helm Charts.

  1. Retrieve your License File.

    Log into SUBNET and select the License button in the Deployments view.

    An image of the SUBNET license pop-up.

    The Account License modal

    Save the content of the file in a secure location for use in the next step.

  2. Add the AIStor Helm Repository.

    helm repo add minio https://helm.min.io/
    
  3. Create a YAML manifest to customize the minio/aistor-objectstore-operator chart.

    Use your preferred text editor to create a YAML manifest for the chart named aistor-objectstore-operator-values.yaml. The following YAML example provides the baseline required license key-value pair:

    license: "LICENSE-STRING"
    

    Replace the LICENSE-STRING with the value of your SUBNET license. If there are other customizations you need to make to the aistor-objectstore-operator chart, you can add them in this file. Refer to the AIStor Operator values reference for available customizations.

  4. Install the chart to the aistor namespace with the customization file:

    The minio/aistor-objectstore-operator chart contains the necessary Kubernetes resources for deploying AIStor Server resources through the objectstore chart.

       helm install aistor minio/aistor-objectstore-operator \
         -n aistor --create-namespace \
         -f aistor-objectstore-operator-values.yaml
    

    If successful, the command outputs a summary of installed resources.

  5. Validate the installation by running kubectl get all -n aistor and checking the status of deployed resources. They should resemble the following:

    NAME                                         READY   STATUS    RESTARTS   AGE
    pod/adminjob-operator-cfc97d9f-hjbp5         1/1     Running   0          4m16s
    pod/object-store-operator-78c9f84b85-kmwlv   1/1     Running   0          4m16s
    
    NAME                            TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
    service/object-store-operator   ClusterIP   10.43.210.230   <none>        4221/TCP   4m16s
    
    NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
    deployment.apps/adminjob-operator       1/1     1            1           4m16s
    deployment.apps/object-store-operator   1/1     1            1           4m16s
    
    NAME                                               DESIRED   CURRENT   READY   AGE
    replicaset.apps/adminjob-operator-cfc97d9f         1         1         1       4m16s
    replicaset.apps/object-store-operator-78c9f84b85   1         1         1       4m16s
    
  6. Configure and deploy the minio/aistor-objectstore chart.

    Run the following command to save a copy of the default chart values:

    helm show values minio/aistor-objectstore > aistor-objectstore-values.yaml
    

    Open the file with your preferred text editor and modify the values to reflect your deployment. Remove any default or unmodified values such that the file reflects only your changes. The following example has a minimal set of fields for deploying an 8x8 object store using the AIStor Volume Manager for storage provisioning:

    objectStore:
       name: primary-object-store # name of the AIStor Server
       pools:
       - name: pool-0
         servers: 8 # Number of servers/pods to deploy
         volumesPerServer: 8 # Number of Persistent Volumes per Server/Pod
         size: 2Ti # Size of each PV
    #    storageClassName: directpv-min-io # Storage Class assigned to each PV
       services:
          minio:
             serviceType: NodePort
             nodePort: 31000 # Select an available NodePort in the supported range of 30000-32767
    

    The following command deploys an AIStor Server with the name and namespace of primary-object-store.

    helm install primary-object-store minio/aistor-objectstore \
      -n primary-object-store --create-namespace \
      -f aistor-objectstore-values.yaml
    
  7. Connect to the deployment.

    The previous step configures the S3 API services via NodePort such that you can access them through the IP or hostname of any worker node in the Kubernetes cluster. Use kubectl get nodes -o wide or a similar command to determine the appropriate IP/Hostname to use for access.