Revision c0d88cf3 docs/admin-guide.rst
b/docs/admin-guide.rst | ||
---|---|---|
847 | 847 |
$ kamaki config set user.url https://accounts.example.com |
848 | 848 |
$ kamaki config set token ... |
849 | 849 |
|
850 |
To test that everything works, try authenticating the current account with kamaki: |
|
850 |
To test that everything works, try authenticating the current account with |
|
851 |
kamaki: |
|
851 | 852 |
|
852 | 853 |
.. code-block:: console |
853 | 854 |
|
854 | 855 |
$ kamaki user authenticate |
855 | 856 |
|
856 |
This will output some user information. For example, *uuid* (unique user id) is quite useful.
|
|
857 |
This will output user information.
|
|
857 | 858 |
|
858 | 859 |
Upload Image |
859 | 860 |
------------ |
860 | 861 |
|
861 |
By convention, images are stored in a container called ``images``. Check if the container exists, by listing all containers in your account: |
|
862 |
By convention, images are stored in a container called ``images``. Check if the |
|
863 |
container exists, by listing all containers in your account: |
|
862 | 864 |
|
863 | 865 |
.. code-block:: console |
864 | 866 |
|
... | ... | |
870 | 872 |
|
871 | 873 |
$ kamaki file create images |
872 | 874 |
|
873 |
You are now ready to upload an image to container ``images``. You can upload it with a Pithos+ client, or use kamaki directly: |
|
875 |
You are now ready to upload an image to container ``images``. You can upload it |
|
876 |
with a Pithos+ client, or use kamaki directly: |
|
874 | 877 |
|
875 | 878 |
.. code-block:: console |
876 | 879 |
|
877 | 880 |
$ kamaki file upload ubuntu.iso images |
878 | 881 |
|
879 |
You can use any Pithos+ client to verify that the image was uploaded correctly, or you can list the contents of the container with kamaki: |
|
882 |
You can use any Pithos+ client to verify that the image was uploaded correctly, |
|
883 |
or you can list the contents of the container with kamaki: |
|
880 | 884 |
|
881 | 885 |
.. code-block:: console |
882 | 886 |
|
883 | 887 |
$ kamaki file list images |
884 | 888 |
|
885 | 889 |
The full Pithos URL for the previous example will be |
886 |
``pithos://u53r-un1qu3-1d/images/ubuntu.iso`` |
|
887 |
where ``u53r-un1qu3-1d`` is the unique user id (uuid). |
|
888 |
|
|
890 |
``pithos://u53r-un1qu3-1d/images/ubuntu.iso`` where ``u53r-un1qu3-1d`` is the |
|
891 |
unique user id (uuid). |
|
889 | 892 |
|
890 | 893 |
Register Image |
891 | 894 |
-------------- |
Also available in: Unified diff