Documentation

PLEASE NOTE: This document applies to v2.18 version and not to the latest stable release v2.19

Documentation for other releases can be found by using the version selector in the top right of any doc page.

mdadm

Manage Linux software RAID arrays using mdadm.

Attributes

check_mode:
  support: full

Parameters

Parameter	Type	Values	Description
action	string	create assemble stop destroy info	Action to perform on the RAID array. [default: `"info"`]
bitmap	boolean		Enable write-intent bitmap. [default: `false`]
chunk	string		Chunk size (e.g., 64K, 512K).
device	string		RAID device path (e.g., /dev/md0).
devices	array		List of component devices.
force	boolean		Force operation. [default: `false`]
level	integer		RAID level (0, 1, 5, 6, 10).
metadata	string		Metadata format. [default: `"1.2"`]
name	string		Array name.
raid_devices	integer		Number of active devices in the array.
spare_devices	array		List of spare devices.

Example

- name: Create RAID1 array
  mdadm:
    action: create
    device: /dev/md0
    name: data
    level: 1
    devices:
      - /dev/sdb1
      - /dev/sdc1
    metadata: 1.2

- name: Assemble existing array
  mdadm:
    action: assemble
    device: /dev/md0
    devices:
      - /dev/sdb1
      - /dev/sdc1

- name: Stop RAID array
  mdadm:
    action: stop
    device: /dev/md0

- name: Destroy RAID array (wipe superblocks)
  mdadm:
    action: destroy
    devices:
      - /dev/sdb1
      - /dev/sdc1
    force: true

- name: Get array info
  mdadm:
    action: info
    device: /dev/md0
  register: raid_info