1a753bf200
Before commands in manual.rst and related files started with $ sign. While this shows, that commands should be executed in shell it also makes them hard to copy-paste. This change removes $ and splits commands, that include ';' into multiple lines. After this change user would be able to copy-paste whole blocks of code into shell and execute them right away. Removes `#` that meant that root privileges are required for the command and adds sudo, where relevant (yum/apt, etc.). Fixes occasional indentation inconsistencies. Change-Id: Ib649ae2a3a110bdf09b0bf9c5fbf54a5ce40ccc6
106 lines
3.0 KiB
ReStructuredText
106 lines
3.0 KiB
ReStructuredText
..
|
|
Copyright 2014 Mirantis, Inc.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
not use this file except in compliance with the License. You may obtain
|
|
a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
License for the specific language governing permissions and limitations
|
|
under the License.
|
|
|
|
|
|
|
|
========================
|
|
Upload image into glance
|
|
========================
|
|
|
|
To deploy applications with murano, virtual machine images should be uploaded into glance in a special way - *murano_image_info* property should be set.
|
|
|
|
1. Use the glance image-create command to import your disk image to glance:
|
|
|
|
.. code-block:: console
|
|
|
|
glance image-create --name <NAME> --is-public true \
|
|
> --disk-format qcow2 --container-format bare \
|
|
> --file <IMAGE_FILE> --property <IMAGE_METADATA>
|
|
..
|
|
|
|
Replace the command line arguments to glance image-create with the appropriate values for your environment and disk image:
|
|
|
|
* Replace **<NAME>** with the name that users will refer to the disk image by. E.g. **ws-2012-std**
|
|
|
|
* Replace **<IMAGE_FILE>** with the local path to the image file to upload. E.g. **ws-2012-std.qcow2**.
|
|
|
|
* Replace **<IMAGE_METADATA>** with the following property string
|
|
|
|
.. code-block:: text
|
|
|
|
murano_image_info='{"title": "Windows 2012 Standard Edition", "type": "windows.2012"}'
|
|
..
|
|
|
|
where:
|
|
|
|
* **title** - user-friendly description of the image
|
|
* **type** - murano image type, see :ref:`murano_image_types`
|
|
|
|
2. To update metadata of the existing image run the command:
|
|
|
|
.. code-block:: console
|
|
|
|
glance image-update <IMAGE_ID> --property <IMAGE_MATADATA>
|
|
..
|
|
|
|
* Replace **<IMAGE_ID>** with image id from the previous command output.
|
|
|
|
* Replace **<IMAGE_METADATA>** with murano_image_info property, e.g.
|
|
|
|
.. code-block:: text
|
|
|
|
murano_image_info='{"title": "Windows 2012 Standard Edition", "type": "windows.2012"}'
|
|
..
|
|
|
|
.. warning::
|
|
|
|
The value of the **--property** argument (named **murano_image_info**) is a JSON string.
|
|
Only double quotes are valid in JSON, so please type the string exactly as in the example above.
|
|
..
|
|
|
|
.. note::
|
|
|
|
Existing images could be marked in a simple way in the horizon UI with the murano dashboard installed.
|
|
Navigate to *Murano -> Manage -> Images -> Mark Image* and fill up a form:
|
|
|
|
* **Image** - ws-2012-std
|
|
* **Title** - My Prepared Image
|
|
* **Type** - Windows Server 2012
|
|
..
|
|
|
|
After these steps desired image can be chosen in application creation wizard.
|
|
|
|
|
|
.. _murano_image_types:
|
|
|
|
Murano image types
|
|
------------------
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Type Name
|
|
- Description
|
|
|
|
* - windows.2012
|
|
- Windows Server 2012
|
|
|
|
* - linux
|
|
- Generic Linux images, Ubuntu / Debian, RedHat / Centos, etc
|
|
|
|
* - cirrus.demo
|
|
- Murano demo image, based on CirrOS
|
|
..
|