@@ -98,6 +98,8 @@ To use kamaki as an one-command tool, run:
Commands
^^^^^^^^
Client commands are grouped by service (see example 3.1.1 on how to list available groups). Commands behavior is as uniform as possible, but there are still differences between groups due to the special nature of each service and server-side implementation.
Typically, commands consist of a group name (e.g. store for storage commands) one or more terms (e.g. list for listing) and the command specific parameters (e.g. the name of the container), if any.
.. code-block:: console
...
...
@@ -132,7 +134,7 @@ The following pattern applies to all client commands up to version 0.6.1:
kamaki <group> <command> [arguments]
The commands supported in version 0.6.1 are described bellow, grouped by service:
The commands supported in version 0.6.1 are described bellow, grouped by service. The examples showcase a sample set of group commands and were run in the kamaki interactive shell:
astakos (Identity Manager)
""""""""""""""""""""""""""
...
...
@@ -141,6 +143,24 @@ astakos (Identity Manager)
authenticate: Authenticate a user
Showcase: get user information, provided the token was set
Showcase: Create a server: Show create help, find a flavor and an image make a server. Wait for server to be build, get server details. Note that the progress bar feature is optional (see )
[server]:create 'My Small Debian Server' 1 b2dffe52-64a4-48c3-8a4c-8214cc3165cf
adminPass: L8gu2wbZ94
created : 2012-11-23T16:56:04.190813+00:00
flavorRef: 1
hostId :
id : 11687
imageRef : b2dffe52-64a4-48c3-8a4c-8214cc3165cf
metadata :
values:
os : debian
users: root
name : My Small Debian Server
progress : 0
status : BUILD
suspended: False
updated : 2012-11-23T16:56:04.761962+00:00
[server]:wait 11687
Server 11687 still in BUILD mode ||||||||||||||||| | 80% - 3s
Server 11687 is now in ACTIVE mode
[server]:
network (Compute/Cyclades)
""""""""""""""""""""""""""
.. code-block:: text
connect : Connect a server to a network
create : Create a network
delete : Delete a network
disconnect: Disconnect a nic of a server to a network
info : Get network details
list : List networks
rename : Update network name
Showcase: Connect a network to a VM: create a network, list available VMs, connect to 'My Small Debian Server', check network info and server connectivity.
.. code-block:: console
:emphasize-lines: 1, 2, 5, 14, 15, 30, 42
[kamaki]:network
[network]:/server list
11687 (My Small Debian Server)
11688 (An Ubuntu server)
[network]:connect
Connect a server to a network
Syntax: connect <server id> <network id>
--config : Path to configuration file
-d,--debug : Include debug output
-h,--help : Show help message
-i,--include: Include protocol headers in the output
-s,--silent : Do not output anything
-v,--verbose: More info at response
[network]: connect 11687 1409
[network]:info 1409
attachments:
nic-11687-1
cidr : 192.168.1.0/24
cidr6 : None
created : 2012-11-23T17:17:20.560098+00:00
dhcp : True
gateway : None
gateway6 : None
id : 1409
name : my network
public : False
status : ACTIVE
type : PRIVATE_MAC_FILTERED
updated : 2012-11-23T17:18:25.095225+00:00
[network]:/server addr 11687
id: nic-11687-1
ipv4 : 192.168.1.1
ipv6 : None
mac_address: aa:0f:c2:0b:0e:85
network_id : 1409
firewallProfile: DISABLED
id: nic-11687-0
ipv4 : 83.212.106.111
ipv6 : 2001:648:2ffc:1116:a80c:f2ff:fe12:a9e
mac_address : aa:0c:f2:12:0a:9e
network_id : 1369
[network]:
store (Storage/Pithos+)
"""""""""""""""""""""""
...
...
@@ -403,7 +583,6 @@ To run kamaki in verbose mode use the -v or --verbose option
Client commands
"""""""""""""""
Client commands are grouped by service (see example 3.1.1 for how to list availabel groups). Commands behavior is as uniform as possible, but there are still differences between groups due to the special nature of each service and server-side implementation.
Kamaki commands can be used along with advanced shell features.
...
...
@@ -414,10 +593,10 @@ Kamaki commands can be used along with advanced shell features.
Example 4.4.1: Store a vm list in file vmlist.txt in a unix shell
In that case, kamaki modifies the output (e.g. removes colors - if enabled)
