~ubuntu-branches/ubuntu/saucy/cloud-init/saucy

« back to all changes in this revision

Viewing changes to doc/examples/cloud-config-disk-setup.txt

  • Committer: Scott Moser
  • Date: 2013-09-27 23:47:33 UTC
  • mfrom: (1.4.7)
  • Revision ID: smoser@ubuntu.com-20130927234733-d6g4ngz3lyfclq9a
* New upstream snapshot.
  * fixes to disk_setup config module and enabling of partition
    creation and filesystem creation on Azure.

Show diffs side-by-side

added added

removed removed

Lines of Context:
19
19
 
20
20
Default disk definitions for Windows Azure
21
21
------------------------------------------
22
 
(Not implemented yet due to conflict with WALinuxAgent in Ubuntu)
23
22
 
 
23
device_aliases: {'ephemeral0': '/dev/sdb'}
24
24
disk_setup:
25
 
    /dev/sdb:
 
25
    ephemeral0:
26
26
         type: mbr
27
27
         layout: True
28
28
         overwrite: False
29
29
 
30
30
fs_setup:
31
31
    - label: ephemeral0
32
 
      filesystem: ext3
 
32
      filesystem: ext4
33
33
      device: ephemeral0
34
 
      partition: any
 
34
      partition: auto
35
35
 
36
36
 
37
37
Default disk definitions for SmartOS
38
38
------------------------------------
39
39
 
40
 
ephemeral_disk: /dev/vdb
 
40
device_aliases: {'ephemeral0': '/dev/sdb'}
41
41
disk_setup:
42
 
    /dev/vdb:
 
42
    ephemeral0:
43
43
         type: mbr
44
 
         layout: True
 
44
         layout: False
45
45
         overwrite: False
46
46
 
47
47
fs_setup:
48
48
    - label: ephemeral0
49
49
      filesystem: ext3
50
 
      device: /dev/vdb
51
 
      partition: 1
 
50
      device: ephemeral0
 
51
      partition: auto
52
52
 
53
53
Cavaut for SmartOS: if ephemeral disk is not defined, then the disk will
54
54
    not be automatically added to the mounts.
188
188
        of the ephemeral storage layer.
189
189
 
190
190
    <PART_VALUE>: The valid options are:
191
 
        "auto": auto is a special in the sense that you are telling cloud-init
192
 
            not to care whether there is a partition or not. Auto will put the
193
 
            first partition that does not contain a file system already. In
194
 
            the absence of a partition table, it will put it directly on the
195
 
            disk.
196
 
 
197
 
        "none": Put the partition directly on the disk.
 
191
        "auto|any": tell cloud-init not to care whether there is a partition
 
192
            or not. Auto will use the first partition that does not contain a
 
193
            file system already. In the absence of a partition table, it will
 
194
            put it directly on the disk.
 
195
 
 
196
            "auto": If a file system that matches the specification in terms of
 
197
            label, type and device, then cloud-init will skip the creation of
 
198
            the file system.
 
199
 
 
200
            "any": If a file system that matches the file system type and device,
 
201
            then cloud-init will skip the creation of the file system.
 
202
 
 
203
            Devices are selected based on first-detected, starting with partitions
 
204
            and then the raw disk. Consider the following:
 
205
                NAME     FSTYPE LABEL
 
206
                xvdb
 
207
                |-xvdb1  ext4
 
208
                |-xvdb2
 
209
                |-xvdb3  btrfs  test
 
210
                \-xvdb4  ext4   test
 
211
 
 
212
            If you ask for 'auto', label of 'test, and file system of 'ext4'
 
213
            then cloud-init will select the 2nd partition, even though there
 
214
            is a partition match at the 4th partition.
 
215
 
 
216
            If you ask for 'any' and a label of 'test', then cloud-init will
 
217
            select the 1st partition.
 
218
 
 
219
            If you ask for 'auto' and don't define label, then cloud-init will
 
220
            select the 1st partition.
 
221
 
 
222
            In general, if you have a specific partition configuration in mind,
 
223
            you should define either the device or the partition number. 'auto'
 
224
            and 'any' are specifically intended for formating ephemeral storage or
 
225
            for simple schemes.
 
226
 
 
227
        "none": Put the file system directly on the device.
198
228
 
199
229
        <NUM>: where NUM is the actual partition number.
200
230