Skip to content

Commit e128641

Browse files
authored
added volume group types (#96)
1 parent ccd92b3 commit e128641

3 files changed

Lines changed: 84 additions & 0 deletions

File tree

docs/_openstack/changelog/index.en.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@ Notable Changes on the OpenStack Platform are documented here.
1919

2020
## Completed
2121

22+
### 2026-02-25
23+
24+
- Added volume group type
25+
2226
### 2025-11-01
2327

2428
- End of beta phase for Octavia OVN-based loadbalancers

docs/_openstack/specs/volume_specification/index.de.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,43 @@ Sie können beim Erstellen eines Volumes mit dem folgenden Befehl einen der zwei
3737
Sie können den gewählten Typ eines Volumes anpassern, dazu könne Sie im Dashboard die Funktion "Change Voume Type" nutzen. Alternativ können sie den Typ über die CLI mit dem folgenden Command ändern:
3838
`$ openstack volume set <volume-name> --type high-iops`
3939
Eine Änderung des Volume Types ist jedoch nur möglich wenn das Volume nicht an einer Instanz in Verwendung ist.
40+
41+
## Volume-Gruppen Spezifikationen
42+
43+
In OpenStack sind "Volume-Gruppen" eine Möglichkeit, mehrere Volumes logisch zusammenzufassen. Dies vereinfacht die Verwaltung (z. B. das Erstellen von Snapshots für alle Volumes einer Gruppe) und hilft bei der Organisation komplexer Setups.
44+
45+
## Liste der Volume-Gruppentypen
46+
47+
Wir stellen aktuell den folgenden Gruppentyp bereit:
48+
49+
| Name | Beschreibung | Datenkonsistenz (Consistency) | Öffentlich (Public) |
50+
| :--- | :--- | :--- | :--- |
51+
| **standard_group** | Standard-Gruppierung für zusammengehörige Volumes. | Nein | Ja |
52+
53+
> **HINWEIS:** Der Typ `standard_group` bietet ausschließlich eine logische Gruppierung. Er garantiert jedoch keine Volume-übergreifende Konsistenz (Consistency Group). Snapshots werden nacheinander erstellt.
54+
55+
## Nutzung von Volume-Gruppen
56+
57+
### 1. Erstellen einer Volume-Gruppe
58+
59+
Um eine neue Gruppe zu erstellen, muss der Typ `standard_group` angegeben werden:
60+
61+
```bash
62+
openstack volume group create --type standard_group <gruppen-name>
63+
```
64+
65+
### 2. Volumes zu einer Gruppe hinzufügen
66+
67+
Ein Volume kann direkt beim Erstellen einer Gruppe zugewiesen werden:
68+
69+
```bash
70+
openstack volume create --size 10 --group <gruppen-name> <volume-name>
71+
```
72+
73+
### 3. Gruppen-Snapshots erstellen
74+
75+
Sie können einen gemeinsamen Snapshot-Punkt für alle Volumes in der Gruppe initiieren:
76+
77+
```bash
78+
openstack volume group snapshot create --group <gruppen-name> <snapshot-name>
79+
```

docs/_openstack/specs/volume_specification/index.en.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,3 +37,43 @@ You can select one of the two volume types upon creation of a volume with the fo
3737
You can adjust the selected type of a volume. To do so, you can use the "Change Volume Type" function in the dashboard. Alternatively, you can change the type via the CLI with the following command:
3838
`$ openstack volume set <volume-name> --type high-iops`
3939
However, changing the volume type is only possible if the volume is not currently in use by an instance.
40+
41+
## Volume Group Specifications
42+
43+
In OpenStack, "Volume Groups" provide a way to logically group multiple volumes. This simplifies management (e.g., creating snapshots for all volumes in a group) and helps organize complex application environments.
44+
45+
## Volume Group Type List
46+
47+
We currently provide the following volume group type:
48+
49+
| Name | Description | Consistency Support | Public |
50+
| :--- | :--- | :--- | :--- |
51+
| **standard_group** | Standard grouping for related volumes. | No | Yes |
52+
53+
> **NOTE:** The `standard_group` type serves as a logical container. However, it does not support cross-volume consistency (Consistency Groups). Snapshots are taken sequentially.
54+
55+
## Using Volume Groups
56+
57+
### 1. Creating a Volume Group
58+
59+
To create a new group, you must specify the `standard_group` type:
60+
61+
```bash
62+
openstack volume group create --type standard_group <group-name>
63+
```
64+
65+
### 2. Adding Volumes to a Group
66+
67+
A volume can be assigned to a group during its creation:
68+
69+
```bash
70+
openstack volume create --size 10 --group <group-name> <volume-name>
71+
```
72+
73+
### 3. Creating Group Snapshots
74+
75+
You can initiate a common snapshot point for all volumes within the group:
76+
77+
```bash
78+
openstack volume group snapshot create --group <group-name> <snapshot-name>
79+
```

0 commit comments

Comments
 (0)