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.
-
Retrieve your License File.
Log into SUBNET and select the License button in the Deployments view.
The Account License modal
Save the content of the file in a secure location for use in the next step.
-
Add the AIStor Helm Repository.
helm repo add minio https://helm.min.io/
-
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 requiredlicense
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 theaistor-objectstore-operator
chart, you can add them in this file. Refer to the AIStor Operator values reference for available customizations. -
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 theobjectstore
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.
-
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
-
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
-
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. Usekubectl get nodes -o wide
or a similar command to determine the appropriate IP/Hostname to use for access.