-
Notifications
You must be signed in to change notification settings - Fork 1
deploystack Client
Welcome to the DeployStack wiki. This page documents all available CLI commands, their arguments, and usage examples.
Starts the full OpenStack deployment on the current node.
Syntax:
deploystack deploy [options]| Argument | Default | Description |
|---|---|---|
--allinone |
— | Generate an automatic configuration on the system and automatically start the deployment. |
--config-file <config-file-path> |
— | Start deployment from an existing configuration file. |
--install-cinder {yes,no} |
yes |
Install the Cinder (Block Storage) service if set to yes. |
--install-horizon {yes,no} |
yes |
Install Horizon (Dashboard) if set to yes. |
--lvm-image-size-in-gb <size-in-gigabytes> |
5 |
LVM image size for Cinder. |
--neutron-driver {ovs,ovn} |
ovs |
Network driver to use for Neutron. |
--os-release <openstack-release> |
caracal |
The OpenStack release to install for deployment. |
--generate-only |
— | Generate the configuration automatically without starting the deployment. |
Generate a pre-compiled configuration file without deploying:
deploystack deploy --allinone --generate-onlyThen start the deployment using the generated file:
deploystack deploy --config-file openstack-config-xxxx.yamlGenerates an empty template configuration file that must be filled in manually before deployment.
Syntax:
deploystack generate-config FILE_PATHdeploystack generate-config ~/openstack-config.yamlNote:
deploy --allinone --generate-onlycreates a pre-compiled configuration file for the current system, whilegenerate-configcreates an empty file that you must compile manually.
Quickly launches an OpenStack instance using the default image, flavor, and network.
Syntax:
deploystack launch [options]| Argument | Default | Description |
|---|---|---|
--name <name> |
(auto-generated) | Name of the instance. |
--image <image> |
cirros |
Image to use. |
--flavor <flavor> |
m1.tiny |
Flavor to use. |
--keypair <keypair> |
(auto-generated) | SSH key to log into the instance. Leave empty to let the utility generate a new keypair automatically. |
--password <password> |
— | Password for the administrator user (for compatible Linux/Windows images only). |
--network <network> |
internal |
The main network that will be connected to the instance |
--timeout <seconds> |
100 |
Maximum time to wait for the instance to become active. (Useful for large images) |
deploystack launch --name test-instance --password MySecret123Upload a new Linux cloud image from the web to OpenStack distribution.
Syntax:
deploystack image upload [options]| Argument | Default | Description |
|---|---|---|
--os <os> |
— | Operating system of the image (ubuntu, centos, debian, etc.) |
--image-name <name> |
(auto-generated) | Name to assign to the uploaded image. |
--version <version> |
— | OS version of the image. |
--visibility {public,private,shared} |
public |
Visibility of the image in Glance. |
--output-dir <path> |
/tmp |
Directory where the image will be temporarily downloaded. |
--keep |
no |
Keep the downloaded image file after upload. |
--arch <arch> |
amd64 |
Architecture of the image. |
--timeout <seconds> |
300 |
Maximum time to wait for the image to become active. |
Upload an Ubuntu Bionic image with default settings:
deploystack image upload --os ubuntu --version nobleUpload with a custom name and shared visibility:
deploystack image upload --os ubuntu --version noble --image-name "Ubuntu Noble" --visibility sharedNote: If
--image-nameis not provided, DeployStack generates a name based on OS, version, and architecture.
Removes an image from the current OpenStack deployment.
Syntax:
deploystack image remove <image_name>| Argument | Default | Description |
|---|---|---|
--image-name <image_name> |
— | Name of the image to remove from Glance. |
--image-id <image_id> |
— | ID of the image to remove from Glance. |
Note: You must specify either
--image-nameor--image-id.
Remove an image named ubuntu-jammy-amd64:
deploystack image remove ubuntu-jammy-amd64Warning: This operation permanently deletes the image from OpenStack. Ensure no running instances rely on this image.
For issues or contributions, visit the project repository.