General command line utility for working with Pivotal Operations Manager
a mantra, or vibration, that is traditionally chanted
omis a tool that helps you configure and deploy tiles to Ops-Manager. Currently being maintained by the PCF Platform Automation team, with engineering support and review from PCF Release Engineering. The (private) backlog for Platform Automation is here.
See here for useful examples and documentation.
When working with
om, it can sometimes be useful to reference the Ops Manager API docs. You can find them at
NOTE: Additional documentation for om commands used in Pivotal Platform Automation can be found in Pivotal Documentation.
omwent 1.0.0 on May 7, 2019
As of that release,
omis semantically versioned. When consumig
omin your CI system, it is now safe to pin to a particular minor version line (major.minor.patch) without fear of breaking changes.
omAPI consists of:
omcommands not marked EXPERIMENTAL, and the flags for those commands
"EXPERIMENTAL" commands are still in development. We may rename them, alter their flags or behavior, or remove them entirely. When we're confident a command has the right basic shape and behavior, we'll remove the "EXPERIMENTAL" designation.
Changes internal to
omwill NOT be included as a part of the om API. The versioning here is for the CLI tool, not any libraries or packages included therein. The
omteam may change any internal structs, interfaces, etc, without reflecting such changes in the version, so long as the outputs and behavior of the commands remain the same.
omis used heavily in Platform Automation for PCF, which is also semantically versioned.
omis versioned independently from
omgo to Releases.
Alternatively, you can install
apt-getvia Stark and Wayne:
# apt-get: sudo wget -q -O - https://raw.githubusercontent.com/starkandwayne/homebrew-cf/master/public.key | sudo apt-key add - sudo echo "deb http://apt.starkandwayne.com stable main" | sudo tee /etc/apt/sources.list.d/starkandwayne.list sudo apt-get update sudo apt-get install om -y
Or by the Linux and Mac
brew tap pivotal-cf/om https://github.com/pivotal-cf/om brew install om
You can also build from source.
You'll need at least Go 1.12, as
omuses Go Modules to manage dependencies.
To build from source, after you've cloned the repo, run these commands from the top level of the repo:
GO112MODULE=on go mod download GO112MODULE=on go build
Go 1.11 uses some heuristics to determine if Go Modules should be used. The process above overrides those heuristics to ensure that Go Modules are always used. If you have cloned this repo outside of your GOPATH,
GO111MODULE=oncan be excluded from the above steps.