Documentation ¶
Index ¶
- Constants
- Variables
- func AddCommands()
- func AddGlobalFlags()
- func ArgCheck(num int, comp string, cmd *cobra.Command, args []string) error
- func CatChain(cmd *cobra.Command, args []string)
- func CatService(cmd *cobra.Command, args []string)
- func CheckoutChain(cmd *cobra.Command, args []string)
- func ContractsDeploy(cmd *cobra.Command, args []string)
- func ContractsExport(cmd *cobra.Command, args []string)
- func ContractsImport(cmd *cobra.Command, args []string)
- func ContractsTest(cmd *cobra.Command, args []string)
- func CurrentChain(cmd *cobra.Command, args []string)
- func DoAction(cmd *cobra.Command, args []string)
- func EditAction(cmd *cobra.Command, args []string)
- func EditChain(cmd *cobra.Command, args []string)
- func EditService(cmd *cobra.Command, args []string)
- func ExecChain(cmd *cobra.Command, args []string)
- func ExecData(cmd *cobra.Command, args []string)
- func ExecService(cmd *cobra.Command, args []string)
- func Execute()
- func ExportAction(cmd *cobra.Command, args []string)
- func ExportChain(cmd *cobra.Command, args []string)
- func ExportData(cmd *cobra.Command, args []string)
- func ExportService(cmd *cobra.Command, args []string)
- func FilesCat(cmd *cobra.Command, args []string)
- func FilesGet(cmd *cobra.Command, args []string)
- func FilesList(cmd *cobra.Command, args []string)
- func FilesManageCached(cmd *cobra.Command, args []string)
- func FilesPin(cmd *cobra.Command, args []string)
- func FilesPut(cmd *cobra.Command, args []string)
- func GraduateChain(cmd *cobra.Command, args []string)
- func ImportAction(cmd *cobra.Command, args []string)
- func ImportChain(cmd *cobra.Command, args []string)
- func ImportData(cmd *cobra.Command, args []string)
- func ImportService(cmd *cobra.Command, args []string)
- func InitializeConfig()
- func InspectChain(cmd *cobra.Command, args []string)
- func InspectData(cmd *cobra.Command, args []string)
- func InspectService(cmd *cobra.Command, args []string)
- func InstallChain(cmd *cobra.Command, args []string)
- func KillChain(cmd *cobra.Command, args []string)
- func KillService(cmd *cobra.Command, args []string)
- func ListActions(cmd *cobra.Command, args []string)
- func ListAllExisting()
- func ListAllKnown()
- func ListChains(cmd *cobra.Command, args []string)
- func ListExistingServices(cmd *cobra.Command, args []string)
- func ListKnownChains(cmd *cobra.Command, args []string)
- func ListKnownData(cmd *cobra.Command, args []string)
- func ListKnownServices(cmd *cobra.Command, args []string)
- func ListRunningChains(cmd *cobra.Command, args []string)
- func ListRunningServices(cmd *cobra.Command, args []string)
- func LogChain(cmd *cobra.Command, args []string)
- func LogService(cmd *cobra.Command, args []string)
- func NewAction(cmd *cobra.Command, args []string)
- func NewChain(cmd *cobra.Command, args []string)
- func NewService(cmd *cobra.Command, args []string)
- func PlopChain(cmd *cobra.Command, args []string)
- func PortsChain(cmd *cobra.Command, args []string)
- func PortsService(cmd *cobra.Command, args []string)
- func RegisterChain(cmd *cobra.Command, args []string)
- func RenameAction(cmd *cobra.Command, args []string)
- func RenameChain(cmd *cobra.Command, args []string)
- func RenameData(cmd *cobra.Command, args []string)
- func RenameService(cmd *cobra.Command, args []string)
- func RmAction(cmd *cobra.Command, args []string)
- func RmChain(cmd *cobra.Command, args []string)
- func RmData(cmd *cobra.Command, args []string)
- func RmService(cmd *cobra.Command, args []string)
- func Router(cmd *cobra.Command, args []string)
- func StartChain(cmd *cobra.Command, args []string)
- func StartService(cmd *cobra.Command, args []string)
- func UpdateChain(cmd *cobra.Command, args []string)
- func UpdateService(cmd *cobra.Command, args []string)
Constants ¶
const VERSION = version.VERSION
Variables ¶
var Actions = &cobra.Command{ Use: "actions", Short: "Manage and Perform Structured Actions.", Long: `Display and Manage actions for various components of the Eris platform and for the platform itself. Actions are bundles of commands which rely upon a project which is currently in scope or on a global set of actions. Actions are held in yaml, toml, or json action-definition files within the action folder in the eris tree (globally scoped actions) or in a directory pointed to by the actions field of the currently checked out project (project scoped actions). Actions are a sequence of commands which operate in a similar fashion to how a circle.yml file or a .travis.yml script field may operate. Actions execute in a series of individual sub-shells ran on the host. Note actions do not run from inside containers but can interact with containers either via the installed eris commands or via the docker cli itself or, indeed, any other programs installed *on the host*.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Actions Sub-Command flags to add: --global --project
var Chains = &cobra.Command{ Use: "chains", Short: "Start, Stop, and Manage Blockchains.", Long: `Start, Stop, and Manage Blockchains. The chains subcommand is used to work on erisdb smart contract blockchain networks. The name is not perfect, as eris is able to operate a wide variety of blockchains out of the box. Most of those existing blockchains should be ran via the eris services ... commands. As they fall under the rubric of "things I just want to turn on or off". While you can develop against those blockchains, you generally aren't developing those blockchains themselves. Eris chains is built to help you build blockchains. It is our opinionated gateway to the wonderful world of permissioned smart contract networks. Your own baby blockchain/smart contract machine is just an eris chains new away!`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Chains Sub-Command
var Config = &cobra.Command{ Use: "config", Short: "Manage Configuration Settings for Eris.", Long: `Display and Manage configuration settings for various components of the Eris platform and for the platform itself. NOTE: [eris config] is only for configuring the Eris platform it will not work to configure any of the blockchains, services or projects which are managed by the Eris platform. To configure blockchains use [eris chains config]; to configure services use [eris services config]; to configure projects use [eris projects config].`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
var Contracts = &cobra.Command{ Use: "contracts", Short: "Deploy, Test, and Manage Your Smart Contracts.", Long: `The contracts subcommand is used to test and deploy smart contracts for use by your application.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Contracts Sub-Command
var Cum []int
var Data = &cobra.Command{ Use: "data", Short: "Manage Data Containers for your Application.", Long: `The data subcommand is used to import, and export data into containers for use by your application. eris data import and eris data export should be thought of from the point of view of the container. eris data import sends files *as is* from ~/.eris/data/NAME on the host to ~/.eris/ inside of the data container. eris data export performs this process in the reverse. It sucks out whatever is in the volumes of the data container and sticks it back into ~/.eris/data/NAME on the host. At eris, we use this functionality to formulate little jsons and configs on the host and then "stick them back into the containers" `, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Data Sub-Command
var ErisCmd = &cobra.Command{ Use: "eris [command] [flags]", Short: "The Blockchain Application Platform", Long: `Eris is a platform for building, testing, maintaining, and operating distributed applications with a blockchain backend. Eris makes it easy and simple to wrangle the dragons of smart contract blockchains. Made with <3 by Eris Industries. Complete documentation is available at https://docs.erisindustries.com ` + "\nVersion:\n " + VERSION, PersistentPreRun: func(cmd *cobra.Command, args []string) { var logLevel log.LogLevel if do.Verbose { logLevel = 2 } else if do.Debug { logLevel = 3 } log.SetLoggers(logLevel, config.GlobalConfig.Writer, config.GlobalConfig.ErrorWriter) ipfs.IpfsHost = config.GlobalConfig.Config.IpfsHost util.DockerConnect(do.Verbose, do.MachineName) }, PersistentPostRun: func(cmd *cobra.Command, args []string) { err := config.SaveGlobalConfig(config.GlobalConfig.Config) if err != nil { logger.Errorln(err) } log.Flush() }, }
Defining the root command
var Files = &cobra.Command{ Use: "files", Short: "Manage Files Needed for Your Application Using IPFS.", Long: `The files subcommand is used to import, and export files to and from IPFS for use on the host machine. These commands are provided in addition to the various functionality which is included throughout the tool, such as services import or services export which operate more precisely. The eris files command is used as a general wrapper around an IPFS gateway which would be running as eris services ipfs. At times, due to the manner in which IPFS boots files commands will fail. If you get errors when running eris files commands then please run [eris services start ipfs] give that a second or two to boot and then retry the eris files command which failed.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Files Sub-Command Flags to add: ipfsHost
var Init = &cobra.Command{ Use: "init", Aliases: []string{"update"}, Short: "Initialize the ~/.eris directory with default files or update to latest version", Long: `Create the ~/.eris directory with actions and services subfolders and clone eris-ltd/eris-actions eris-ltd/eris-services into them, respectively. `, Run: func(cmd *cobra.Command, args []string) { Router(cmd, args) }, }
flags to add: --no-clone
var ListExisting = &cobra.Command{ Use: "ls", Short: "List everything that is installed and built.", Long: `Lists the built services and chains known to Eris. To list the known services: [eris services known]. This will show all services which exist in the form of locally held service definition files. To list the running services: [eris services ps]. This is the service which are currently running. To start a service use: [eris services start serviceName].`, Run: func(cmd *cobra.Command, args []string) { ListAllExisting() }, }
var ListKnown = &cobra.Command{ Use: "known", Short: "List everything Eris knows about.", Long: `Lists all the services, chains, & data containers which Eris has installed locally as definition files. To install a new service, use: [eris services import]. To install a new chain, use: [eris chains import]. Services include all executable services supported by the Eris platform which are NOT blockchains or key managers. Blockchains are handled using the [eris chains] command. `, Run: func(cmd *cobra.Command, args []string) { ListAllKnown() }, }
var Projects = &cobra.Command{ Use: "projects", Short: "Start, Stop, and Manage Projects or Applications.", Long: `Start, stop, and manage projects or applications. Within the Eris platform, projects are a bundle of services, and actions which are configured to run in a specific manner. Projects may be defined either by a package.json file in the root of an application's directory or via a docker-compose.yml file in the root of an application's directory. Projects are given a human readable name so that Eris can checkout and operate the application or project.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Projects Sub-Command
var Remotes = &cobra.Command{ Use: "remotes", Short: "Manage and Perform Remote Machines and Services.", Long: `Display and Manage remote machines which are operating various services reachable by the Eris platform. Actions, if configured as such, can utilize remote machines. To register and manage remote machines for sending of actions to those machines, use this command.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
var Services = &cobra.Command{ Use: "services", Short: "Start, Stop, and Manage Services Required for your Application.", Long: `Start, Stop, and Manage Services Required for your Application. Services are all services known and used by the Eris platform with the exception of blockchain services.`, Run: func(cmd *cobra.Command, args []string) { cmd.Help() }, }
Primary Services Sub-Command
Functions ¶
func AddGlobalFlags ¶
func AddGlobalFlags()
Flags that are to be used by commands are handled by the Do struct Define the persistent commands (globals)
func CatService ¶
func ContractsDeploy ¶
func ContractsExport ¶
func ContractsImport ¶
func ContractsTest ¶
func CurrentChain ¶
func EditAction ¶
func EditService ¶
func ExecService ¶ added in v0.10.2
func ExportAction ¶
func ExportChain ¶
func ExportData ¶
func ExportService ¶
func FilesManageCached ¶ added in v0.10.2
func GraduateChain ¶
func ImportAction ¶
func ImportChain ¶
import a chain definition file
func ImportData ¶
func InitializeConfig ¶
func InitializeConfig()
func InspectChain ¶
func InspectData ¶
func InspectService ¶
func InstallChain ¶
fetch and install a chain
the idea here is you will either specify a chainName as the arg and that will double as the chainID, or you want a local reference name for the chain, so you specify the chainID with a flag and give your local reference name as the arg
func KillService ¶
func ListActions ¶
func ListAllKnown ¶
func ListAllKnown()
func ListChains ¶
func ListExistingServices ¶
func ListKnownChains ¶
func ListKnownData ¶
----------------------------------------------------
func ListRunningChains ¶
func ListRunningServices ¶
func LogService ¶
func NewChain ¶
create a new chain
genesis is either given or a simple single-validator genesis will be laid for you
func NewService ¶
func PortsChain ¶ added in v0.10.2
func PortsService ¶ added in v0.10.2
func RegisterChain ¶ added in v0.10.3
register a chain in the etcb chain registry
func RenameAction ¶
func RenameChain ¶
func RenameData ¶
func RenameService ¶
func StartChain ¶
func StartService ¶
func UpdateChain ¶
func UpdateService ¶
Updates an installed service, or installs it if it has not been installed.
Types ¶
This section is empty.