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

• Provide access to an AWS S3 secret access key ID and secret access key

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:

1. 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"

2. 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 

3. Add environment variables for bucket credentials to your StorageCluster spec.

Related topics

• Portworx Object Service Reference