Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

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:

  --help  Show this message and exit.

  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 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.

  --help  Show this message and exit.

  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.

  --help  Show this message and exit.

  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.

  --help  Show this message and exit.

  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.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for powershift-cluster, version 2.3.1
Filename, size File type Python version Upload date Hashes
Filename, size powershift-cluster-2.3.1.tar.gz (11.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page