Revision 9190b227
b/docs/admin-guide.rst | ||
---|---|---|
1660 | 1660 |
|
1661 | 1661 |
.. code-block:: console |
1662 | 1662 |
|
1663 |
$ kamaki config set image.url https://cyclades.example.com/image |
|
1664 |
$ kamaki config set file.url https://pithos.example.com/v1 |
|
1665 |
$ kamaki config set user.url https://accounts.example.com |
|
1666 |
$ kamaki config set token ... |
|
1663 |
$ kamaki config set cloud.default.url https://example.com/identity/v2.0 |
|
1664 |
$ kamaki config set cloud.default.token ... |
|
1667 | 1665 |
|
1668 | 1666 |
To test that everything works, try authenticating the current account with |
1669 | 1667 |
kamaki: |
... | ... | |
1682 | 1680 |
|
1683 | 1681 |
.. code-block:: console |
1684 | 1682 |
|
1685 |
$ kamaki file list |
|
1683 |
$ kamaki file list /images
|
|
1686 | 1684 |
|
1687 | 1685 |
If the container ``images`` does not exist, create it: |
1688 | 1686 |
|
1689 | 1687 |
.. code-block:: console |
1690 | 1688 |
|
1691 |
$ kamaki file create images
|
|
1689 |
$ kamaki container create images
|
|
1692 | 1690 |
|
1693 | 1691 |
You are now ready to upload an image to container ``images``. You can upload it |
1694 | 1692 |
with a Pithos client, or use kamaki directly: |
1695 | 1693 |
|
1696 | 1694 |
.. code-block:: console |
1697 | 1695 |
|
1698 |
$ kamaki file upload ubuntu.iso images |
|
1696 |
$ kamaki file upload ubuntu.iso /images
|
|
1699 | 1697 |
|
1700 | 1698 |
You can use any Pithos client to verify that the image was uploaded correctly, |
1701 | 1699 |
or you can list the contents of the container with kamaki: |
1702 | 1700 |
|
1703 | 1701 |
.. code-block:: console |
1704 | 1702 |
|
1705 |
$ kamaki file list images |
|
1703 |
$ kamaki file list /images
|
|
1706 | 1704 |
|
1707 | 1705 |
The full Pithos URL for the previous example will be |
1708 | 1706 |
``pithos://u53r-un1qu3-1d/images/ubuntu.iso`` where ``u53r-un1qu3-1d`` is the |
... | ... | |
1711 | 1709 |
Register Image |
1712 | 1710 |
-------------- |
1713 | 1711 |
|
1714 |
To register an image you will need to use the full Pithos URL. To register as
|
|
1715 |
a public image the one from the previous example use: |
|
1712 |
To register an image you will need to use the full or the relative Pithos URL.
|
|
1713 |
To register as a public image the one from the previous example use:
|
|
1716 | 1714 |
|
1717 | 1715 |
.. code-block:: console |
1718 | 1716 |
|
1719 |
$ kamaki image register Ubuntu pithos://u53r-un1qu3-1d/images/ubuntu.iso --public
|
|
1717 |
$ kamaki image register --name=Ubuntu --location=/images/ubuntu.iso --public
|
|
1720 | 1718 |
|
1721 | 1719 |
The ``--public`` flag is important, if missing the registered image will not |
1722 | 1720 |
be listed by ``kamaki image list``. |
... | ... | |
1726 | 1724 |
|
1727 | 1725 |
.. code-block:: console |
1728 | 1726 |
|
1729 |
$ kamaki image register Ubuntu pithos://u53r-un1qu3-1d/images/ubuntu.iso \
|
|
1727 |
$ kamaki image register --name Ubuntu --location /images/ubuntu.iso \
|
|
1730 | 1728 |
--public --disk-format diskdump --property kernel=3.1.2 |
1731 | 1729 |
|
1732 | 1730 |
To verify that the image was registered successfully use: |
1733 | 1731 |
|
1734 | 1732 |
.. code-block:: console |
1735 | 1733 |
|
1736 |
$ kamaki image list --name-like=ubuntu
|
|
1734 |
$ kamaki image list --name-like ubuntu
|
|
1737 | 1735 |
|
1738 | 1736 |
|
1739 | 1737 |
Miscellaneous |
Also available in: Unified diff