Skip to content

Abhinandan-Purkait/openebsctl

 
 

Repository files navigation

OpenEBS Logo

OpenEBSCTL

Go Report Card Contributors release License Releases FOSSA Status codecov.io

OpenEBSCTL is a kubectl plugin to manage OpenEBS storage components.

Project Status

Alpha. Under active development and seeking contributions from the community. The CLI currently supports managing cStor, Jiva, LocalPV-LVM, LocalPV-ZFS Cas-Engines.

Table of Contents

Installation

OpenEBSCTL is available on Linux, macOS and Windows platforms.

  • (Recommended) The latest binary can be installed via krew

    $ kubectl krew install openebs
    ...
    ...
    $ kubectl krew list
    PLUGIN    VERSION
    openebs    v0.2.0
    ...
    ...
    # to update the openebs plugin
    $ kubectl krew upgrade openebs
    ...
    ...
  • Binaries for Linux, Mac and Windows are available as tarballs and zip in the release page.

  • Or, if you don't want to setup krew, you run the following to get latest version :-

    wget https://raw.githubusercontent.com/openebs/openebsctl/develop/scripts/install-latest.sh -O - | bash
    

Build

  • Clone this repo to your system. git clone https://github.com/openebs/openebsctl
  • cd openebsctl
  • Run make openebsctl

Usage

  • $ kubectl openebs
    openebs is a a kubectl plugin for interacting with OpenEBS storage components such as storage(pools, volumegroups), volumes, blockdevices, pvcs.
    Find out more about OpenEBS on https://openebs.io/
    
    Usage:
    kubectl openebs [command] [resource] [...names] [flags]
    
    Available Commands:
    completion  Outputs shell completion code for the specified shell (bash or zsh)
    describe    Provide detailed information about an OpenEBS resource
    get         Provides fetching operations related to a Volume/Pool
    help        Help about any command
    version     Shows openebs kubectl plugin's version
    
    Flags:
    -h, --help                           help for openebs
    -n, --namespace string               If present, the namespace scope for this CLI request
        --openebs-namespace string       to read the openebs namespace from user.
                                         If not provided it is determined from components.
        --cas-type                       to specify the cas-type of the engine, for engine based filtering.
                                         ex- cstor, jiva, localpv-lvm, localpv-zfs.
        --debug                          to launch the debugging mode for cstor pvcs.
    
    Use "kubectl openebs command --help" for more information about a command.
  • To know more about various engine specific commands check these:-

Contributing

OpenEBS welcomes your feedback and contributions in any form possible.

For more details checkout CONTRIBUTING.md.

License

FOSSA Status

About

OpenebsCTL is a plugin for kubectl. It allows users to fetch details of their OpenEBS storage components.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 97.7%
  • Shell 1.6%
  • Makefile 0.7%