x/cloud-init
Code Issues Proposed changes

OpenNebula documentation tuning.

Browse Source
This commit is contained in:
Vlastimil Holer
2013-02-20 13:46:18 +01:00
parent 11ff0c19b9
commit 6502b34cdc
1 changed files with 24 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
doc/sources/opennebula/README.rst
View File

@@ -1,14 +1,14 @@
The `OpenNebula`_ DataSource supports the OpenNebula contextualization disk. The `OpenNebula`_ (ON) datasource supports the contextualization disk.
See `contextualization overview`_, `contextualizing VMs`_ and See `contextualization overview`_, `contextualizing VMs`_ and
`network configuration`_ in the public documentation for `network configuration`_ in the public documentation for
more information. more information.
OpenNebula's virtual machines are contextualized (parametrized) by OpenNebula's virtual machines are contextualized (parametrized) by
CD-ROM image data, which contains a shell script *context.sh* with CD-ROM image, which contains a shell script *context.sh* with
custom variables defined on virtual machine start. There are no custom variables defined on virtual machine start. There are no
fixed contextualization variables, but the datasource accepts fixed contextualization variables, but the datasource accepts
many used and recommended across OpenNebula's documentation. many used and recommended across the documentation.
Datasource configuration Datasource configuration
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -32,7 +32,7 @@ The following criteria are required:
1. Must be formatted with `iso9660`_ fs. or have fs. label of **CDROM** 1. Must be formatted with `iso9660`_ fs. or have fs. label of **CDROM**
2. Must contain file *context.sh* with contextualization variables. 2. Must contain file *context.sh* with contextualization variables.
File is generated by OpenNebula, it has a KEY="VALUE" format and File is generated by OpenNebula, it has a KEY="VALUE" format and
can be easily read by shell script. can be easily read (via *source*) by shell
Contextualization variables Contextualization variables
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -74,7 +74,7 @@ Instance hostname.
If no hostname has been specified, cloud-init will try to create hostname If no hostname has been specified, cloud-init will try to create hostname
from instance's IP address in 'local' dsmode. In 'net' dsmode, cloud-init from instance's IP address in 'local' dsmode. In 'net' dsmode, cloud-init
try to resolve one of its IP addresses to get hostname. tries to resolve one of its IP addresses to get hostname.
:: ::
@@ -91,24 +91,26 @@ One or multiple SSH keys (separated by newlines) can be specified.
cloud-init user data. cloud-init user data.
Example OpenNebula's Virtual Machine template Example VM's context section
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
CONTEXT=[ ::
PUBLIC_IP="$NIC[IP]",
SSH_KEY="$USER[SSH_KEY]
$USER[SSH_KEY1]
$USER[SSH_KEY2] ",
USER_DATA="#cloud-config
# see https://help.ubuntu.com/community/CloudInit
packages: [] CONTEXT=[
PUBLIC_IP="$NIC[IP]",
SSH_KEY="$USER[SSH_KEY]
$USER[SSH_KEY1]
$USER[SSH_KEY2] ",
USER_DATA="#cloud-config
# see https://help.ubuntu.com/community/CloudInit
mounts: packages: []
- [vdc,none,swap,sw,0,0]
runcmd: mounts:
- echo 'Instance has been configured by cloud-init.' | wall - [vdc,none,swap,sw,0,0]
" ] runcmd:
- echo 'Instance has been configured by cloud-init.' | wall
" ]
.. _OpenNebula: http://opennebula.org/ .. _OpenNebula: http://opennebula.org/
.. _contextualization overview: http://opennebula.org/documentation:documentation:context_overview .. _contextualization overview: http://opennebula.org/documentation:documentation:context_overview