-Commands
-========
+List of commands
+================
-Command specifications for kamaki.cli
+The commands described bellow are grouped by service. The examples showcase a sample set of group commands. The kamaki interactive shell (check `Usage section <usage.html#interactive-shell>`_ for details) is chosen as the execution environment.
-cyclades_cli
-------------
-.. automodule:: kamaki.cli.commands.cyclades_cli
- :members:
- :show-inheritance:
- :undoc-members:
+user (Identity Manager)
+-----------------------
+.. code-block:: text
-pithos_cli
-----------
+ authenticate: Authenticate a user
-.. automodule:: kamaki.cli.commands.pithos_cli
- :members:
- :show-inheritance:
- :undoc-members:
+Showcase: get user information
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-image_cli
----------
+In the following, the token has been set in a previous step (see `setup section <setup.html>`_ or the `quick setup guide <usage.html#quick-setup>`_)
-.. automodule:: kamaki.cli.commands.image_cli
- :members:
- :show-inheritance:
- :undoc-members:
+.. code-block:: console
+ :emphasize-lines: 1,4
+ * Enter user context *
+ [kamaki]: user
-astakos_cli
------------
+ * Authenticate user *
+ [user]: authenticate
+ auth_token_created: 2012-11-13T14:12:40.917034
+ auth_token_expires: 2012-12-13T14:12:40.917035
+ email :
+ myaccount@grnet.gr
+ myotheraccount@grnet.gr
+ name : My Real Name
+ username : usually@an.email.org
+ uuid : ab1cde23-45fg-6h7i-8j9k-10l1m11no2pq
-.. automodule:: kamaki.cli.commands.astakos_cli
- :members:
- :show-inheritance:
- :undoc-members:
+flavor (Compute/Cyclades)
+-------------------------
-config_cli
-----------
+.. code-block:: text
-.. automodule:: kamaki.cli.commands.config_cli
- :members:
- :show-inheritance:
- :undoc-members:
+ info: Get flavor details
+ list: List flavors
-history_cli
------------
+Showcase: show details for flavor with id 43
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-.. automodule:: kamaki.cli.commands.history_cli
- :members:
- :show-inheritance:
- :undoc-members:
+.. code-block:: console
+ :emphasize-lines: 1,4
+
+ * Enter flavor context *
+ [kamaki]: flavor
+
+ * Get details about flavor with id 43 *
+ [flavor]: info 43
+ SNF:disk_template: drbd
+ cpu : 4
+ disk : 10
+ id : 43
+ name : C4R2048D10
+ ram : 2048
+
+image (Plankton commands + Compute Image subcommands)
+-----------------------------------------------------
+
+.. code-block:: text
+
+ addmember : Add a member to an image
+ addproperty: Add an image property
+ delmember : Remove a member from an image
+ list : List images accessible by user
+ members : Get image members
+ meta : Get image metadata
+ register : (Re)Register an image
+ setmembers : Set the members of an image
+ shared : List shared images
+ compute : Compute Image API commands
+ list : List images
+ delete : Delete image
+ info : Get image details
+ properties : Get image properties
+ delproperty: Delete an image property
+ setproperty: Update an image property
+
+Showcase: Pick an image and list the properties
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: console
+ :emphasize-lines: 1,4,18
+
+ * Enter image context *
+ [kamaki]: image
+
+ * list all available images *
+ [image]: list
+ 1. Windows Server 2008
+ container_format: bare
+ disk_format : diskdump
+ id : 926ab1c5-2d85-49d4-aebe-0fce712789b9
+ size : 11917066240
+ status : available
+ 2. Windows Server 2012
+ container_format: bare
+ disk_format : diskdump
+ id : 78262ee7-949e-4d70-af3a-85360c3de57a
+ size : 11697913856
+ status : available
+ 3. ubuntu
+ container_format: bare
+ disk_format : diskdump
+ id : 5ed5a29b-292c-4fe0-b32c-2e2b65628635
+ size : 2578100224
+ status : available
+ 4. Debian_Wheezy_Base
+ container_format: bare
+ disk_format : diskdump
+ id : 1f8454f0-8e3e-4b6c-ab8e-5236b728dffe
+ size : 795107328
+ status : available
+
+ * Get properties of image with id 1f8454f0-8e3e-4b6c-ab8e-5236b728dffe *
+ [image]: compute properties 1f8454f0-8e3e-4b6c-ab8e-5236b728dffe
+ description : Debian 6.0.6 (Squeeze) Base System
+ gui : No GUI
+ kernel : 2.6.32
+ os : debian
+ osfamily : linux
+ root_partition: 1
+ sortorder : 1
+ users : root
+
+server (Compute/Cyclades)
+-------------------------
+
+.. code-block:: text
+
+ addmeta : Add server metadata
+ addr : List a server's nic address
+ console : Get a VNC console
+ create : Create a server
+ delete : Delete a server
+ delmeta : Delete server metadata
+ firewall: Set the server's firewall profile
+ info : Get server details
+ list : List servers
+ meta : Get a server's metadata
+ reboot : Reboot a server
+ rename : Update a server's name
+ setmeta : Update server's metadata
+ shutdown: Shutdown a server
+ start : Start a server
+ stats : Get server statistics
+ wait : Wait for server to finish
+
+Showcase: Create a server
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: console
+ :emphasize-lines: 1,4,21,35,44,62
+
+ * Enter server context *
+ [kamaki]: server
+
+ * See server-create help *
+ [server]: create -h
+ usage: create <name> <flavor id> <image id>
+ [--personality PERSONALITY] [-h] [--config CONFIG]
+
+ Create a server
+
+ optional arguments:
+ -v, --verbose More info at response
+ --personality PERSONALITY
+ add a personality file
+ -d, --debug Include debug output
+ -h, --help Show help message
+ -i, --include Include protocol headers in the output
+ --config CONFIG Path to configuration file
+ -s, --silent Do not output anything
+
+ * List all available images *
+ [server]: /image compute list
+ 1395fdfb-51b4-419f-bb02-f7d632860611 Ubuntu Desktop LTS
+ 1580deb4-edb3-4496-a27f-7a246c4c0528 Ubuntu Desktop
+ 18a82962-43eb-4b32-8e28-8f8880af89d7 Kubuntu LTS
+ 6aa6eafd-dccb-422d-a904-67fe2bdde87e Debian Desktop
+ 6b5681e4-7502-46ae-b1e9-9fd837932095 maelstrom
+ 78262ee7-949e-4d70-af3a-85360c3de57a Windows Server 2012
+ 86bc2414-0fb3-4898-a637-240292243302 Fedora
+ 926ab1c5-2d85-49d4-aebe-0fce712789b9 Windows Server 2008
+ b2dffe52-64a4-48c3-8a4c-8214cc3165cf Debian Base
+ baf2321c-57a0-4a69-825d-49f49cea163a CentOS
+ c1d27b46-d875-4f5c-b7f1-f39b5af62905 Kubuntu
+
+ * See details of flavor with id 1 *
+ [server]: /flavor info 1
+ SNF:disk_template: drbd
+ cpu : 1
+ disk : 20
+ id : 1
+ name : C1R1024D20
+ ram : 1024
+
+ * Create a debian server named 'My Small Debian Server'
+ [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
+
+ * wait for server to build (optional) *
+ [server]: wait 11687
+ Server 11687 still in BUILD mode ||||||||||||||||| | 80%
+ Server 11687 is now in ACTIVE mode
+
+.. Note:: In kamaki shell, / is used to access top-level command groups while working in command group contexts
+
+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
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: console
+ :emphasize-lines: 1,4,9,24,27,44
+
+ * Enter network context *
+ [kamaki]: network
+
+ * List user-owned VMs *
+ [network]: /server list
+ 11687 (My Small Debian Server)
+ 11688 (An Ubuntu server)
+
+ * Try network-connect (to get help) *
+ [network]: connect
+ Syntax error
+ usage: connect <server id> <network id> [-s] [-h] [-i] [--config CONFIG]
+
+ 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
+
+ * Connect VM with id 11687 to network with id 1409
+ [network]: connect 11687 1409
+
+ * Get details on network with id 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
+
+ * Get connectivity details on VM with id 11687 *
+ [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
+
+.. Note:: In kamaki shell, / is used to access top-level command groups while working in command group contexts
+
+file (Storage/Pithos+)
+----------------------
+
+.. code-block:: text
+
+ append : Append local file to remote
+ cat : Print a file to console
+ copy : Copy an object
+ create : Create a container
+ delete : Delete a container [or an object]
+ delgroup : Delete a user group
+ delmeta : Delete an existing metadatum for an account [, container [or object]]
+ delpermissions: Delete all sharing permissions
+ download : Download a file or directory
+ group : Get user groups details
+ hashmap : Get the hashmap of an object
+ info : Get information for account [, container [or object]]
+ list : List containers, object trees or objects in a directory
+ manifest : Create a remote file with uploaded parts by manifestation
+ meta : Get custom meta-content for account [, container [or object]]
+ mkdir : Create a directory
+ move : Copy an object
+ overwrite : Overwrite part (from start to end) of a remote file
+ permissions : Get object read/write permissions
+ publish : Publish an object
+ purge : Purge a container
+ quota : Get quota for account
+ setgroup : Create/update a new user group
+ setmeta : Set a new metadatum for account [, container [or object]]
+ setpermissions: Set sharing permissions
+ containerlimit: Container size limit commands
+ set : Set container data limit
+ get : Get container data limit
+ setversioning : Set new versioning (auto, none) for account [or container]
+ sharers : List the accounts that share objects with default account
+ touch : Create an empty object (file)
+ truncate : Truncate remote file up to a size
+ unpublish : Unpublish an object
+ upload : Upload a file or directory
+ versioning : Get versioning for account [or container ]
+ versions : Get the version list of an object
+
+Showcase: Upload and download a file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: console
+ :emphasize-lines: 1,7,11,16,21,29,33,37,41,44,51,55,60,64
+
+ * Create a random binarry file at current OS path *
+ [kamaki]: !dd bs=4M if=/dev/zero of=rndm_local.file count=5
+ 5+0 records in
+ 5+0 records out
+ 20971520 bytes (21 MB) copied, 0.016162 s, 1.3 GB/s
+
+ * Enter file context *
+ [kamaki]: file
+
+
+ * Check local file *
+ [file]: !ls -lh rndm_local.file
+ -rw-rw-r-- 1 ******** ******** 20M Nov 26 15:36 rndm_local.file
+
+
+ * Create two containers *
+ [file]: create mycont1
+ [file]: create mycont2
+
+
+ * List accessible containers *
+ [file]: list
+ 1. mycont1 (0B, 0 objects)
+ 2. mycont2 (0B, 0 objects)
+ 3. pithos (0B, 0 objects)
+ 4. trash (0B, 0 objects)
+
+
+ * Upload local file to 1st container *
+ [file]: upload rndm_local.file mycont1
+
+
+ * Check if file has been uploaded *
+ [file]: list mycont1
+ 1. 20M rndm_local.file
+
+ * Create directory mydir on second container *
+ [file]: mkdir mycont2:mydir
+
+
+ * Move file from 1st to 2nd container (and in the directory) *
+ [file]: move mycont1:rndm_local.file mycont2:mydir/rndm_local.file
+
+ * Check contents of both containers *
+ [file]: list mycont1
+ [file]: list mycont2
+ 1. D mydir/
+ 2. 20M mydir/rndm_local.file
+
+
+ * Copy file from 2nd to 1st container, with a new name *
+ [file]: copy mycont2:mydir/rndm_local.file mycont1:rndm_remote.file
+
+
+ * Check pasted file *
+ [file]: list mycont1
+ 1. 20M rndm_remote.file
+
+
+ * Download pasted file to local file system *
+ [file]: download mycont1:rndm_remote.file rndm_remote.file
+
+
+ * Check if file is downloaded and if it is the same to original *
+ [file]: !ls -lh *.file
+ -rw-rw-r-- 1 ******** ******** 20M Nov 26 15:36 rndm_local.file
+ -rw-rw-r-- 1 ******** ******** 20M Nov 26 15:42 rndm_remote.file
+ [file]: !diff rndm_local.file rndm_remote.file
+
+.. Note:: In kamaki shell, ! is used to execute OS shell commands (bash in the above)
+
+.. warning:: The container:object/path syntax does not function if the container and / or the object path contain one or more : characters. To use containers and objects with : use the --container and --dst-container arguments, e.g. to copy test.py object from grnet:dev container to grnet:deploy ::
+
+ $ kamaki file copy --container=grnet:dev test.py --dst-container=grnet:deploy