PowerShift command plugin for creating OpenShift clusters.
Project description
This package provides a plugin for the powershift command line client for managing a local OpenShift cluster. The commands provide a layer around the oc cluster up command, adding the ability to easily maintain persistent profiles for multiple local instances of OpenShift running on a Docker service.
To enhance security, a user database will also be configured so that the default password for the developer account can be changed. Additional user accounts can also be created, with system admin rights if necessary.
Finally a set of persistent volumes will also be associated with each profile. Additional persistent volumes can also be declared, including pre claimed volumes associated with an existing directory on the host containing code or data files.
To install this package, along with the powershift-cli package, and the powershift command line program contained in that package, you should use pip to install the package powershift-cluster[cli], rather than just powershift-cluster. Alternatively, you can install powershift-cli[all], which will install the powershift-cli package along with all plugins currently available for the powershift command line program.
For more details on how to install the powershift command line program and available plugins see:
Available commands
To see all available command you can use inbuilt help features of the powershift command.
$ powershift
Usage: powershift [OPTIONS] COMMAND [ARGS]...
PowerShift client for OpenShift.
This client provides additional functionality useful to users of the
OpenShift platform. Base functionality is minimal, but can be extended by
installing additional plugins.
For more details see:
https://github.com/getwarped/powershift
Options:
--help Show this message and exit.
Commands:
client Install/update oc command line tool.
cluster Manage a local OpenShift cluster.
completion Output completion script for specified shell.
console Open a browser on the OpenShift web console.
server Displays the URL for the OpenShift cluster.
session Display information about current session.
$ powershift cluster
Usage: powershift cluster [OPTIONS] COMMAND [ARGS]...
Manage a local OpenShift cluster.
The OpenShift cluster will run as an all-in-one container on a local
Docker host. Data will be preserved between restarts of the OpenShift
cluster against a named profile. You can create multiple profiles so that
you can setup multiple local OpenShift instances. You can though only run
one instance at a time.
The default routes for exposed applications in the OpenShift cluster will
use xip.io and the local host IP of your OpenShift cluster. A different
route suffix can be supplied when the OpenShift cluster is started up the
first time.
Options:
--help Show this message and exit.
Commands:
destroy Destroys the named OpenShift cluster.
down Stops the active OpenShift cluster.
list List the available OpenShift cluster...
ssh Opens a shell session in the OpenShift master...
status Displays the status of the OpenShift cluster.
up Starts up an OpenShift cluster.
users Manage accounts database for the cluster.
volumes Manage persistent volumes for the cluster.
$ powershift cluster volumes
Usage: powershift cluster volumes [OPTIONS] COMMAND [ARGS]...
Manage persistent volumes for the cluster.
Options:
--help Show this message and exit.
Commands:
create Create a new persistent volume.
list List the available peristent volumes.
$ powershift cluster users
Usage: powershift cluster users [OPTIONS] COMMAND [ARGS]...
Manage accounts database for the cluster.
Options:
--help Show this message and exit.
Commands:
add Adds a new user account.
list List active user accounts.
passwd Change the password for an account.
remove Removes a user account.
Use the --help option on individual commands to see what the command does and what further options can be supplied.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
