pxc

README

Overview

px is a client side application which communicates with Portworx, Kubernetes, and other services to provide users with an integrated tool.

Status: Pre-alpha

This tool is under heavy development.

Downloads

Please refer to the Releases page to download the latest build.

Usage

px is a tool that communicates with Portworx as well as Container Orchestration systems like Kubernetes. To use this tool you must first create a context with the appropriate information. px uses the context to connect to the appropriate Portworx cluster to execute the requested command.

Creating a context

You can create a context using the following command:

$ px context create --name=mycluster --endpoint=<ip of cluster>:9020

NOTE: The default gRPC SDK port for Portworx is 9020

What if you don't have a Portworx cluster?

px uses the OpenStorage SDK to communicate with Portworx, therefore it is fully compatible with OpenStorage's mock-sdk-server. If you do not have a Portworx cluster, you can run the following to start the mock-sdk-server:

$ docker run --rm --name sdk -d -p 9100:9100 -p 9110:9110 openstorage/mock-sdk-server
$ px context create --name=mycluster --endpoint=localhost:9100

Status

Now that px has been setup with a context, you can do the following commands:

$ px status
$ px get volume
$ px get volume -o wide
$ px get nodes
$ px get nodes -o wide

Development

Please visit Development

Documentation

Overview

Copyright © 2019 Portworx

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.