Commit 153dbe21 authored by Giorgos Verigakis's avatar Giorgos Verigakis
Browse files

Improve the documentation

parent 40146039
......@@ -6,8 +6,7 @@ Configure kamaki
To upload, register or modify an image you will need the **kamaki** tool.
Before proceeding make sure that it is configured properly. Verify that
*image_url*, *storage_url*, *storage_account*, *storage_container* and
*token* are set as needed:
*image_url*, *storage_url*, and *token* are set as needed:
.. code-block:: console
......@@ -17,14 +16,29 @@ To chage a setting use ``kamaki config set``:
.. code-block:: console
kamaki config set storage_account okeanos
kamaki config set storage_container images
kamaki config set image_url https://cyclades.okeanos.grnet.gr/plankton
kamaki config set storage_url https://pithos.okeanos.grnet.gr/v1
kamaki config set token ...
Upload an image
---------------
As a shortcut, you can configure a default account and container that will be
used by the ``kamaki store`` commands:
.. code-block:: console
kamaki config set storage_account okeanos
kamaki config set storage_container images
If the container does not exist, you will have to create it before uploading
any images:
.. code-block:: console
kamaki store create images
You are now ready to upload an image. You can upload it with a Pithos client
or use kamaki directly:
......@@ -33,6 +47,8 @@ or use kamaki directly:
kamaki store upload ubuntu.iso
You can use any Pithos client to verify that the image was uploaded correctly.
The full Pithos URL for the previous example will be
``pithos://okeanos/images/ubuntu.iso``.
Register the image
......@@ -45,6 +61,9 @@ a public image the one from the previous example use:
kamaki glance register Ubuntu pithos://okeanos/images/ubuntu.iso --public
The ``--public`` flag is important, if missing the registered image will not
be listed by ``kamaki glance list``.
Use ``kamaki glance register`` with no arguments to see a list of available
options. A more complete example would be the following:
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment