Skip to main content
Version: 3.1

Import existing buckets using the Portworx Object Service

This page describes how to import existing buckets using either AWS S3 or Pure FlashBlade.

This page describes how to import existing buckets using AWS S3

AWS S3​

Use the following steps to get started with pre-provisioned buckets:

  1. Create a new file named pxbucketclass.yaml, replacing region and object.portworx.io/endpoint with your desired AWS S3 region and endpoint:

    apiVersion: object.portworx.io/v1alpha1
    kind: PXBucketClass
    metadata:
      name: pbclass-s3
    region: us-west-1
    deletionPolicy: Delete
    parameters:
      object.portworx.io/backend-type: S3Driver
      object.portworx.io/endpoint: s3.us-west-1.amazonaws.com

  2. Create the PXBucketClass object:

kubectl apply -f pxbucketclass.yaml

  1. Create a new file named pxbucketaccess.yaml:

    apiVersion: object.portworx.io/v1alpha1
    kind: PXBucketAccess
    metadata:
      name: s3-pba-existing
      namespace: default
    spec:
      bucketClassName: pbclass-s3
      existingBucketId: bucket-name-aws

  2. Once the bucket access is granted, its ACCESSGRANTED state will be marked as true in the CustomResource:

kubectl get pxbucketaccess

NAME              ACCESSGRANTED   CREDENTIALSSECRETNAME               BUCKETID               BACKENDTYPE
s3-pba-existing   true            px-os-credentials-s3-pba-existing   existing-bucket-id     S3Driver
  1. A secret px-os-credentials-s3-pba-existing will be created with all necessary bucket info:

kubectl get secret px-os-credentials-s3-pba -o yaml

apiVersion: v1
data:
  access-key-id: <ACCESS-KEY-ID>
  bucket-id: <BUCKET-ID>
  endpoint: <ENDPOINT>
  region: <REGION>
  secret-access-key: <SECRET-ACCESS-KEY>
kind: Secret
metadata:
  creationTimestamp: "2022-08-03T21:27:25Z"
  finalizers:
  - finalizers.object.portworx.io/access-secret
  name: px-os-credentials-s3-pba
  namespace: default
  resourceVersion: "16022682"
  uid: xxxxxxxx-xxxx-xxxx-xxxx-9e9d30aba97c
type: Opaque

Pure FlashBlade​

Use the following steps to get started with pre-provisioned buckets:

  1. Create a new file named pxbucketclass.yaml, replacing region and object.portworx.io/endpoint with your desired Pure FlashBlade region and endpoint:

    apiVersion: object.portworx.io/v1alpha1
    kind: PXBucketClass
    metadata:
      name: pbclass-fb
    deletionPolicy: Delete
    parameters:
      object.portworx.io/backend-type: PureFBDriver
      object.portworx.io/endpoint: fb.fb.endpoint.example.com

  2. Create the PXBucketClass object:

    kubectl apply -f pxbucketclass.yaml

  3. Create a new file named pxbucketaccess.yaml:

    apiVersion: object.portworx.io/v1alpha1
    kind: PXBucketAccess
    metadata:
      name: fb-pba-existing
      namespace: default
    spec:
      bucketClassName: pbclass-fb
      existingBucketId: bucket-name-aws

  4. Once the bucket access is granted, its ACCESSGRANTED state will be marked as true in the CustomResource:

    kubectl get pxbucketaccess
    NAME              ACCESSGRANTED   CREDENTIALSSECRETNAME               BUCKETID               BACKENDTYPE
    fb-pba-existing   true            px-os-credentials-fb-pba-existing   existing-bucket-id     PureFBDriver

  5. A secret px-os-credentials-fb-pba-existing is created with all necessary bucket info:

    kubectl get secret px-os-credentials-fb-pba -o yaml
    apiVersion: v1
    data:
      access-key-id: <ACCESS-KEY-ID>
      bucket-id: <BUCKET-ID>
      endpoint: <ENDPOINT>
      region: <REGION>
      secret-access-key: <SECRET-ACCESS-KEY>
    kind: Secret
    metadata:
      creationTimestamp: "2022-08-03T21:27:25Z"
      finalizers:
      - finalizers.object.portworx.io/access-secret
      name: px-os-credentials-fb-pba
      namespace: default
      resourceVersion: "16022682"
      uid: xxxxxxxx-xxxx-xxxx-xxxx-9e9d30aba97c
    type: Opaque

Last updated on