> -----Original Message----- > From: Rohit Yadav [mailto:rohit.ya...@citrix.com] > Sent: Thursday, November 01, 2012 11:45 AM > To: cloudstack-dev@incubator.apache.org > Subject: RE: CLI for CloudStack: cloudmonkey > > Hi Chip, please go ahead if we can fix the http/s issue. The connection is > based on marvin, I'm sure using CLI we'll find out more bugs and fix anything > in marvin thereby help maintain marvin->tests and CLI. > Please hack that up on tools/marvin/marvin/cloudstackConnection.py > > Edison, yes I'm working on the completedefault, I've figured a solution to the > parsing and tabbing issue to show params for any api and added more verbs > to the grammar like deploy, start etc. > In the new approach doc strings and params needed for an api are fetched > and cached in the class locally to speed up the loading process. > Till it gets committed, cloudmonkey (now) will keep telling the user what > params they are missing until it gets all the required ones.
Great! Thanks for your awesome CLI, people will like it. > > One more thing, for people who may not have unicode support the prompt > may appear weird and history search (up, down ) can mess up the visuals. For > example on Mac it appears as a colorful emoji, but I found that it looks weird > on other platforms. Will probably remove it, or the user can custom set their > prompt, using: set prompt myprompt> > > Regards. > PS. the set command is full of (fun :) hacks because of funtional/generic > programming, it basically can set any attribute on the class, so one can do > something like creating something (var, func). For example set ruler # (so > instead of - you will have a # separator) > > ________________________________________ > From: Chip Childers [chip.child...@sungard.com] > Sent: Thursday, November 01, 2012 11:15 PM > To: cloudstack-dev@incubator.apache.org > Subject: Re: CLI for CloudStack: cloudmonkey > > On Wed, Oct 31, 2012 at 2:10 PM, Rohit Yadav <rohit.ya...@citrix.com> > wrote: > > Hi, > > > > I was working on a CLI for cloudstack, it's based on Marvin (the > > neglected robot) and called cloudmonkey after our beloved mascot :D > > > > I've committed that on master, please review: > > https://git-wip-us.apache.org/repos/asf?p=incubator-cloudstack.git;a=c > > ommit;h=2ceaa3911e792dbeb6c40dfb70961008a01f7e3c > > > > Features: > > - it's a shell and also a terminal tool, accepts file redirection and > > pipes > > - scalable to find and run old and new APIs > > - intuitive grammar and verbs > > - autocompletion (functional hack) > > - shell execution using ! or shell > > - cfg support: user defined variables, like prompt, ruler, host, port etc. > > - history > > - colors (disable using set color false) > > - dynamic API loading and rule generation > > - leverages Marvin to get latest autogenerated APIs > > - emacs like shortcuts on prompt > > - uses apiKey and secretKey to interact with mgmt server > > - logs all client commands > > - PEP-8 compliant code > > > > FIXMEs: > > - Reverse search over history > > - Fix input and output processing > > > > It requires python and clint; > > pip install clint (or if you have to easy_install clint) mvn clean > > install -P developer cd tools/cli/cloudmonkey python cloudmonkey.py > > > > If you want to have the terminal tool installed; cd tools/cli python > > setup.py sdist cd dist pip install cloudmonkey-0.0.4.tar.gz (or > > easy_install etc.) > > > > You can do stuff like; > > cloudmonkey < file-with-commands, or > > cloudmonkey list Users, or as shell; > > > > (If you see unicode chars cloud and monkey below, yes they were put > > intentionally :) > > > > $ cloudmonkey > > ☁ Apache CloudStack CLI. Type help or ? to list commands. > > 🙉 cloudmonkey> set apiKey <your key here> > > 🙉 cloudmonkey> set secretKey <your key here> > > 🙉 cloudmonkey> <tab><tab> > > add api create delete disable enable help list > > quit remove > set shell update > > 🙉 cloudmonkey> list <tab><tab> > > Accounts Alerts AsyncJobs > > Capabilities > Capacity Clusters Configurations > > DiskOfferings DomainChildren Domains > > Events > EventTypes FirewallRules Hosts > > HypervisorCapabilities Hypervisors InstanceGroups > IpForwardingRules IsoPermissions Isos > LBStickinessPolicies > > LoadBalancerRuleInstances LoadBalancerRules NetworkACLs > NetworkDevice NetworkOfferings Networks > NetworkServiceProviders > > OsCategories OsTypes PhysicalNetworks > > Pods > PortForwardingRules PrivateGateways ProjectAccounts > > ProjectInvitations Projects PublicIpAddresses > RemoteAccessVpns ResourceLimits Routers > SecurityGroups > > ServiceOfferings SnapshotPolicies Snapshots > SSHKeyPairs StaticRoutes StorageNetworkIpRange > StoragePools > > SupportedNetworkServices Swifts SystemVms > > Tags > TemplatePermissions Templates TrafficTypeImplementors > > TrafficTypes Users VirtualMachines > VirtualRouterElements VlanIpRanges Volumes > VPCOfferings > > VPCs VpnConnections VpnCustomerGateways > VpnGateways VpnUsers Zones > > 🙉 cloudmonkey> list Users > > … > > 🙉 cloudmonkey> !ls > > # this give you a shell too and one can do things like > > 🙉 cloudmonkey> !for i in Users Account; do echo `cloudmonkey list $i > > | grep id`; done; > > > > Example commands to deploy a datacenter; (fill in dynamic ids etc.) > > create Zone dns1=8.8.8.8 internaldns1=10.147.28.6 name=Zone1 > > networktype=Basic create PhysicalNetwork name=test-network zoneid= > add > > TrafficType traffictype=Guest physicalnetworkid= add TrafficType > > traffictype=Management physicalnetworkid= update PhysicalNetwork > > state=Enabled id= list NetworkServiceProviders name=VirtualRouter > > physicalNetworkId= list VirtualRouterElements nspid= api > > configureVirtualRouterElement enabled=true id= update > > NetworkServiceProvider state=Enabled id= list NetworkServiceProviders > > name=SecurityGroupProvider physicalNetworkId= update > > NetworkServiceProvider state=Enabled id= create Network zoneid= > > name=guestNetworkForBasicZone displaytext=guestNetworkForBasicZone > > networkofferingid= create Pod zoneid= name=Pod1 gateway=10.147.28.1 > > netmask=255.255.255.0 startip=10.147.28.220 endip=10.147.28.235 create > > VlanIpRange podid= networkid= gateway=10.147.28.1 > > netmask=255.255.255.0 startip=10.147.28.236 endip=10.147.28.250 > > forVirtualNetwork=false add Cluster zoneid= hypervisor=XenServer > > clustertype=CloudManaged podid= clustername=Cluster1 add Host > zoneid= > > podid= clusterid= hypervisor=XenServer clustertype=CloudManaged > > username=root password=password url=http://10.147.28.60 create > > StoragePool zoneid= clusterid= name=NFS1 > > url=nfs://10.147.28.7/export/home/rohit/primary > > add SecondaryStorage zoneId= > > url=nfs://10.147.28.7/export/home/rohit/secondary > > update Zone allocationstate=Enabled id= > > > > After some stabilisation, I can put it on pypi so any user can just do pip > install cloudmonkey to get the CLI. > > > > Regards. > > PS. Marvin the neglected robot and hipster cloudmonkey should rule the > > world :D > > Rohit, > > This is really really cool. It puts the "fun" in managing instances from a > command line. I've been testing it against a production CloudStack > environment, and it's working pretty well. > > If you don't mind, I might hack at the code a bit to fill in some gaps that > I'm > seeing. First example is that it assumes http, which doesn't work in a public > deployment where the endpoint is over https. > > -chip
