Install Portworx Object service
This page describes how to install Portworx Object Service.
Prerequisites
To install Portworx Object Service, you must meet the following prerequisites:
- Provide access to an AWS S3 or Pure FlashBlade secret access key ID and secret access key
- Use Portworx Enterprise 2.12.0 or newer
- Provide access to an AWS S3 secret access key ID and secret access key
- Use Portworx Enterprise 2.12.0 or newer
Installation
Portworx Object Service objects are managed by Stork, and they interact with a target Portworx Enterprise instance. The Portworx Object Service SDK is located in the target Portworx Enterprise instance. This allows you to create buckets, delete buckets, and provide or revoke access to buckets.
Additionally, you must provide access to the backend bucket service through environment variables. Because Portworx Object Service is in early access, extra steps are required to enable and set up the Portworx Object Service controller. The following steps allow Portworx Enterprise to create and provide access to buckets on behalf of the credentials provided:
-
Enable the Portworx Object Service controller flag in Stork by adding the following
args
to your StorageCluster spec:spec:
...
stork:
enabled: true
args:
px-object-controller: "true"
-
Create a new Kubernetes secret with your AWS S3 or Pure FlashBlade access key ID and secret access key:
-
For AWS S3, add the following:
kubectl create secret generic px-object-s3-admin-credentials \
--from-literal=access-key-id=ACCESS_KEY \
--from-literal=secret-access-key=SECRET_ACCESS_KEY -
For Pure FlashBlade, add the following:
kubectl create secret generic px-object-fb-admin-credentials \
--from-literal=access-key-id=ACCESS_KEY \
--from-literal=secret-access-key=SECRET_ACCESS_KEY
-
- Add environment variables for bucket credentials to your StorageCluster spec.