Revision f0497c25 docs/admin-guide.rst
| b/docs/admin-guide.rst | ||
|---|---|---|
| 642 | 642 |
|
| 643 | 643 |
.. code-block:: console |
| 644 | 644 |
|
| 645 |
$ kamaki image register "Debian Base" \ |
|
| 646 |
pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \ |
|
| 645 |
$ kamaki image register --name="Debian Base" \
|
|
| 646 |
--location=pithos://u53r-un1qu3-1d/images/debian_base-6.0-7-x86_64.diskdump \
|
|
| 647 | 647 |
--public \ |
| 648 | 648 |
--disk-format=diskdump \ |
| 649 | 649 |
--property OSFAMILY=linux --property ROOT_PARTITION=1 \ |
| ... | ... | |
| 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