greymatter
CLI is a configuration tool for the Grey Matter control plane. Runtime configuration changes can be made with the CLI.greymatter
CLIgmenv
, a manager for installing and setting different greymatter
versionsgmenv
because it allows for easier versioning against different Grey Matter environments.gmenv
${HOME}/.gmenv
)$PATH
any way you likegreymatter
availableNote: If you haven't usedgmenv
before, you will be prompted for your Grey Matter LDAP username and password.
greymatter
using gmenv install <version>
. This will download and install the latest version of the greymatter
CLI:gmenv
to use the newly downloaded version of the Grey Matter CLIgreymatter
was installedgreymatter
binary manuallygreymatter
CLI can be found in the raw-hosted
section under the greymatter/gm-cli
tree direct link. If you need binaries for a different platform, or for a different version, they can all be found on our Nexus repo.curl
. Before executing, replace -u [email protected]
with your username, and make sure the desired artifact is specified.greymatter
is distributed as a precompiled binary. The installation requires two steps:greymatter
binary onto your system's PATH
$PATH
e.g.:csrutil disable
csrutil enable
in step 3.greymatter
when moving the artifact into your $PATH
.greymatter
CLI, you'll need to set the necessary environment variables or command line flags so that you can talk to a deployed Grey Matter API. As each deployment is different, the specific endpoint and security context will be different, so make sure to verify your settings against the deployed environment.greymatter --help
, but some quick examples are shown here.NOTE: If you've used our Install on Kubernetes guide, then yourGREYMATTER_API_PREFIX
will be/services/control-api/latest
like shown below.
{"some":{"flag": "x"}}
.--config
flag; if unspecified, Grey Matter CLI will search a user's home directory for a file with a name prefixed with .greymatter
(e.g. ~/.greymatter.yaml
, ~/.greymatter.yml
, etc). The schema of the same configuration shown in the environment variable section above will look like:GREYMATTER_API_HOST
and many other configuration options will change based upon where the Control API service is deployed.greymatter list zone \
with the following keys and certs to connect to the Grey Matter Control API.Zone
indicates that the connection was successful, and you've been able to inspect the Fabric Mesh.