From 004ea9600102e8d649d899f4f4bfda24b750f89b Mon Sep 17 00:00:00 2001
From: dwalex <113127196+dwalex@users.noreply.github.com>
Date: Wed, 26 Mar 2025 07:33:23 +0700
Subject: [PATCH] openstack-{help, image, server, volume}: add page (#15843)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
---
 pages/common/openstack-help.md   | 16 ++++++++++++++++
 pages/common/openstack-image.md  | 24 +++++++++++++++++++++++
 pages/common/openstack-server.md | 33 ++++++++++++++++++++++++++++++++
 pages/common/openstack-volume.md | 29 ++++++++++++++++++++++++++++
 4 files changed, 102 insertions(+)
 create mode 100644 pages/common/openstack-help.md
 create mode 100644 pages/common/openstack-image.md
 create mode 100644 pages/common/openstack-server.md
 create mode 100644 pages/common/openstack-volume.md

diff --git a/pages/common/openstack-help.md b/pages/common/openstack-help.md
new file mode 100644
index 0000000000..886f798a9a
--- /dev/null
+++ b/pages/common/openstack-help.md
@@ -0,0 +1,16 @@
+# openstack help
+
+> Display help information about the openstackclient cli.
+> More information: <https://docs.openstack.org/python-openstackclient/latest/cli/man/openstack.html>.
+
+- Display a description of a particular command:
+
+`openstack help {{command_name}}`
+
+- Get help for Identity v3:
+
+`openstack --os-identity-api-version 3 --help`
+
+- Display help:
+
+`openstack --help`
diff --git a/pages/common/openstack-image.md b/pages/common/openstack-image.md
new file mode 100644
index 0000000000..72de4b52fb
--- /dev/null
+++ b/pages/common/openstack-image.md
@@ -0,0 +1,24 @@
+# openstack image
+
+> OpenStack Image service, aka OpenStack Glance, allows users to upload and discover data assets meant to be used with other services.
+> More information: <https://docs.openstack.org/python-openstackclient/latest/cli/command-objects/image-v2.html>.
+
+- List available images:
+
+`openstack image list {{--private|--shared|--all}}`
+
+- Display image details:
+
+`openstack image show --human-readable {{image_id}}`
+
+- Create/upload an image:
+
+`openstack image create --file {{path/to/file}} {{--private|--shared|--all}} {{image_name}}`
+
+- Delete image(s):
+
+`openstack image delete {{image_id1 image_id2 ...}}`
+
+- Save an image locally:
+
+`openstack image save --file {{filename}} {{image_id}}`
diff --git a/pages/common/openstack-server.md b/pages/common/openstack-server.md
new file mode 100644
index 0000000000..c93b906c4f
--- /dev/null
+++ b/pages/common/openstack-server.md
@@ -0,0 +1,33 @@
+# openstack server
+
+> Manage OpenStack virtual machines.
+> OpenStack Compute service, aka OpenStack Nova, mainly hosts and manages cloud computing systems.
+> More information: <https://docs.openstack.org/python-openstackclient/latest/cli/command-objects/server.html>.
+
+- List servers:
+
+`openstack server list`
+
+- Start server(s):
+
+`openstack server start {{instance_id1 instance_id2 ...}}`
+
+- Stop server:
+
+`openstack server stop {{instance_id1 instance_id2 ...}}`
+
+- Create new server:
+
+`openstack server create --image {{image_id}} --flavor {{flavor_id}} --network {{network_id}} --wait {{server_name}}`
+
+- Delete server(s):
+
+`openstack server delete {{instance_id1 instance_id2 ...}}`
+
+- Migrate server to different host:
+
+`openstack server migrate --live {{host_hostname}} {{--shared-migration|--block-migration}} --wait {{instance_id}}`
+
+- Perform a soft or hard reset to the server:
+
+`openstack server reboot {{--soft|--hard}} --wait {{instance_id}}`
diff --git a/pages/common/openstack-volume.md b/pages/common/openstack-volume.md
new file mode 100644
index 0000000000..08bbaafcc8
--- /dev/null
+++ b/pages/common/openstack-volume.md
@@ -0,0 +1,29 @@
+# openstack volume
+
+> Manage OpenStack volumes.
+> OpenStack Block Storage service, aka OpenStack Cinder, provides volumes to Nova vm's, Ironic bare-metal hosts, containers, and others.
+> More information: <https://docs.openstack.org/python-openstackclient/latest/cli/command-objects/volume.html>.
+
+- List volumes:
+
+`openstack volume list --all-projects`
+
+- Show volume details:
+
+`openstack volume show {{volume_id}}`
+
+- Create new volume:
+
+`openstack volume create --size {{size_in_GB}} --image {{image_id}} --snapshot {{snapshot_id}} {{--bootable|--non-bootable}} {{volume_name}}`
+
+- Delete volumes(s):
+
+`openstack volume delete {{volume_id1 volume_id2 ...}}`
+
+- Migrate volume to a new host:
+
+`openstack volume migrate --host {{host_hostname}} {{instance_id}}`
+
+- Set volume properties:
+
+`openstack volume set --name {{volume_new_name}} --size {{volume_new_size}} {{--attached|--detached}} {{--bootable|--non-bootable}} {{volume_id}}`