Merge ~mwhudson/curtin:document-ptable-raid into curtin:master

[Michael Hudson-Doyle]

document that you can set ptable on raids

As discovered the hard way :)

[Ryan Harper (raharper)]

Yes, that looks good.

Let's add a short example with a partition:

** RAID Partition Example **::

# create RAID5 array /dev/md0 and first partition /dev/md0p1
- id: md0
   type: raid
   name: md0
   raidlevel: 5
   ptable: gpt
   devices:
     - sda1
     - sdb1
     - sdc1
   spare_devices:
     - sdd1
- id: md0p1
  type: partition
  device: md0
  size: 10G

[Server Team CI bot (server-team-bot)]

PASSED: Continuous integration, rev:90747af9bae0f4ebf7458a48356f3a055e74cd28
https://jenkins.ubuntu.com/server/job/curtin-ci/972/
Executed test runs:
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-amd64/972
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-arm64/972
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-ppc64el/972
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-s390x/972

Click here to trigger a rebuild:
https://jenkins.ubuntu.com/server/job/curtin-ci/972/rebuild

review: Approve (continuous-integration)

90a04da... by Michael Hudson-Doyle on 2018-06-21

we do not expect to handle any other partition types ...

08a530f... by Michael Hudson-Doyle on 2018-06-21

add partitioned raid example

[Ryan Harper (raharper)]

Thanks!

review: Approve

[Server Team CI bot (server-team-bot)]

PASSED: Continuous integration, rev:08a530fa3582455826eae22a8f305dc7d1871b3f
https://jenkins.ubuntu.com/server/job/curtin-ci/973/
Executed test runs:
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-amd64/973
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-arm64/973
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-ppc64el/973
    SUCCESS: https://jenkins.ubuntu.com/server/job/curtin-ci/nodes=metal-s390x/973

Click here to trigger a rebuild:
https://jenkins.ubuntu.com/server/job/curtin-ci/973/rebuild

review: Approve (continuous-integration)

[Ryan Harper (raharper)]

An upstream commit landed for this bug.

To view that commit see the following URL:
https://git.launchpad.net/curtin/commit/?id=37a257fb

diff --git a/doc/topics/storage.rst b/doc/topics/storage.rst
index ca6253c..b28964b 100644
--- a/doc/topics/storage.rst
+++ b/doc/topics/storage.rst
@@ -60,9 +60,9 @@ table. A disk command may contain all or some of the following keys:
 
 **ptable**: *msdos, gpt*
 
-If the ``ptable`` key is present and a valid type of partition table, curtin
-will create an empty partition table of that type on the disk.  At the moment,
-msdos and gpt partition tables are supported.
+If the ``ptable`` key is present and a curtin will create an empty
+partition table of that type on the disk.  Curtin supports msdos and
+gpt partition tables.
 
 **serial**: *<serial number>*
 
@@ -613,6 +613,11 @@ The ``spare_devices`` key specifies a list of the devices that will be used for
 spares in the raid array. Each device must be referenced by ``id`` and the
 device must be previously defined in the storage configuration.  May be empty.
 
+**ptable**: *msdos, gpt*
+
+To partition the array rather than mounting it directly, the
+``ptable`` key must be present and a valid type of partition table,
+i.e. msdos or gpt.
 
 **Config Example**::
 
@@ -801,6 +806,7 @@ Learn by examples.
 - LVM
 - Bcache
 - RAID Boot
+- Partitioned RAID
 - RAID5 + Bcache
 - ZFS Root Simple
 - ZFS Root
@@ -1045,6 +1051,76 @@ RAID Boot
          path: /
          device: md_root
 
+Partitioned RAID
+~~~~~~~~~~~~~~~~
+
+::
+
+  storage:
+    config:
+    - type: disk
+      id: disk-0
+      ptable: gpt
+      path: /dev/vda
+      wipe: superblock
+      grub_device: true
+    - type: disk
+      id: disk-1
+      path: /dev/vdb
+      wipe: superblock
+    - type: disk
+      id: disk-2
+      path: /dev/vdc
+      wipe: superblock
+    - type: partition
+      id: part-0
+      device: disk-0
+      size: 1048576
+      flag: bios_grub
+    - type: partition
+      id: part-1
+      device: disk-0
+      size: 21471690752
+    - id: raid-0
+      type: raid
+      name: md0
+      raidlevel: 1
+      devices: [disk-2, disk-1]
+      ptable: gpt
+    - type: partition
+      id: part-2
+      device: raid-0
+      size: 10737418240
+    - type: partition
+      id: part-3
+      device: raid-0
+      size: 10735321088,
+    - type: format
+      id: fs-0
+      fstype: ext4
+      volume: part-1
+    - type: format
+      id: fs-1
+      fstype: xfs
+      volume: part-2
+    - type: format
+      id: fs-2
+      fstype: ext4
+      volume: part-3
+    - type: mount
+      id: mount-0
+      device: fs-0
+      path: /
+    - type: mount
+      id: mount-1
+      device: fs-1
+      path: /srv
+    - type: mount
+      id: mount-2
+      device: fs-2
+      path: /home
+    version: 1
+
 
 RAID5 + Bcache
 ~~~~~~~~~~~~~~