noobaa-operator

command module
v1.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 26, 2019 License: Apache-2.0 Imports: 2 Imported by: 0

README

NooBaa Operator

NooBaa is an object data service for hybrid and multi cloud environments. NooBaa runs on kubernetes, provides an S3 object store service (and Lambda with bucket triggers) to clients both inside and outside the cluster, and uses storage resources from within or outside the cluster, with flexible placement policies to automate data use cases.

About NooBaa

Using the operator as CLI

For Mac

brew install noobaa/noobaa/noobaa
# or
wget https://github.com/noobaa/noobaa-operator/releases/download/v1.1.1/noobaa-mac-v1.1.1; mv noobaa-mac-* noobaa; chmod +x noobaa

For Linux

wget https://github.com/noobaa/noobaa-operator/releases/download/v1.1.1/noobaa-linux-v1.1.1; mv noobaa-linux-* noobaa; chmod +x noobaa
  • Run: ./noobaa --help for CLI usage
  • Install the operator and noobaa with: ./noobaa install The install output includes S3 service endpoint and credentials, as well as web management console address with credentials.
  • Getting this information is always available with: ./noobaa status
  • Remove NooBaa deployment can be done with: ./noobaa uninstall

Troubleshooting

  • The operator is running, but there is no noobaa-core-0 pod

    Make sure that there is a single default storage class with oc get sc. run oc describe sts for more information

  • The operator is running, but the noobaa-core-0 is pending

    Verify that there are enough resrouces. run oc describe pod noobaa-core-0 for more information

Operator Design

CRDs

  • NooBaa - The basic CRD to deploy a NooBaa system.
  • BackingStore - Connection to cloud or local storage to use in policies.
  • BucketClass - Policies applied to a class of buckets.

Applications

  • S3 Account - Method to obtain S3 account credentials for native S3 applications.
  • OBC Provisioner - Method to claim a new/existing bucket.

Developing

  • Fork and clone the repo: git clone https://github.com/<username>/noobaa-operator
  • Use minikube: minikube start
  • Use you package manager to install go, operator-sdk and python3.
  • Source the devenv into your shell: . devenv.sh
  • Build the project: make
  • Test with the alias nb that runs the local operator from build/_output/bin (alias created by devenv)
  • Install the operator and create the system with: nb install

Documentation

Overview

Package main is the top level package in the noobaa-operator project which means that running bare go commands like `go generate` and `go build` will refer to this main package.

Directories

Path Synopsis
cmd
manager
Package main is the one created initially by operator-sdk new.
Package main is the one created initially by operator-sdk new.
pkg
apis/noobaa
Package noobaa contains API Schema definitions for the noobaa API group
Package noobaa contains API Schema definitions for the noobaa API group
apis/noobaa/v1alpha1
Package v1alpha1 contains API Schema definitions for the noobaa v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=noobaa.io Package v1alpha1 contains API Schema definitions for the noobaa v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=noobaa.io
Package v1alpha1 contains API Schema definitions for the noobaa v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=noobaa.io Package v1alpha1 contains API Schema definitions for the noobaa v1alpha1 API group +k8s:deepcopy-gen=package,register +groupName=noobaa.io
cli
crd
nb
Package nb makes client API calls to noobaa servers.
Package nb makes client API calls to noobaa servers.
obc
olm

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL