README
¶
What
conch is a CLI for accessing the Conch API.
Documentation
Documentation, including the build process, can be found here
Notes
Joyent Employees
The latest production release at https://github.com/joyent/conch-shell/releases/latest is certified against the production instance.
The most recent release is not certified for production yet (thus the 'pre-release' tag) and probably works best against the staging instance. Grab it at https://github.com/joyent/conch-shell/releases
SSL Certs
Go makes a lot of assumptions about a user's runtime environment. One assumption
is that a system holds SSL certs in a set of default directories which are
hardcoded into the go runtime by platform. If the user's runtime differs from
go's expectation, the user will receive a message like x509: failed to load system roots and no roots provided.
To set a custom location for SSL certs, one can specify SSL_CERT_DIR or
SSL_CERT_FILE in the environment before running conch shell.
For instance: SSL_CERT_FILE=/opt/certs.pem conch login
Copyright / License
Copyright Joyent Inc
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
pkg
|
|
|
commands/admin
Package admin contains administrative commands for the conch api
|
Package admin contains administrative commands for the conch api |
|
commands/api
Package api contains commands that allow direct API access
|
Package api contains commands that allow direct API access |
|
commands/devices
Package devices contains commands pertaining to individual devices
|
Package devices contains commands pertaining to individual devices |
|
commands/global
Package global contains commands that operate on structures in the global domain, rather than a workspace.
|
Package global contains commands that operate on structures in the global domain, rather than a workspace. |
|
commands/hardware
Package hardware contains commands related to hardware products, profiles, and the like
|
Package hardware contains commands related to hardware products, profiles, and the like |
|
commands/profile
Package profile contains commands pertaining to login profiles
|
Package profile contains commands pertaining to login profiles |
|
commands/relay
Package relay contains commands that pertain to relay devices
|
Package relay contains commands that pertain to relay devices |
|
commands/update
Package update contains commands related to updating conch-shell
|
Package update contains commands related to updating conch-shell |
|
commands/user
Package user contains command pertaining to the active Conch user
|
Package user contains command pertaining to the active Conch user |
|
commands/validation
Package validation contains commands for validation related commands Package validation contains commands for validation related commands Package validation contains commands for validation related commands Package validation contains commands for validation related commands
|
Package validation contains commands for validation related commands Package validation contains commands for validation related commands Package validation contains commands for validation related commands Package validation contains commands for validation related commands |
|
commands/workspaces
Package workspaces contains commands for dealing with objects tied to a workspace
|
Package workspaces contains commands for dealing with objects tied to a workspace |
|
conch
Package conch provides access to the Conch API
|
Package conch provides access to the Conch API |
|
config
Package config wraps a conch shell config.
|
Package config wraps a conch shell config. |
|
util
Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base
|
Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base Package util contains common routines used throughout the command base |