From 588cf14c4be733465a69cc2f1a49d9593fd94ddc Mon Sep 17 00:00:00 2001 From: Abhisar Sinha <63767682+abh1sar@users.noreply.github.com> Date: Wed, 27 Aug 2025 07:28:15 +0530 Subject: [PATCH 1/3] Added Limitations section to Extensions --- source/adminguide/extensions.rst | 2 + .../extensions/builtin_extensions.rst | 1 + source/adminguide/extensions/limitations.rst | 55 +++++++++++++++++++ 3 files changed, 58 insertions(+) create mode 100644 source/adminguide/extensions/limitations.rst diff --git a/source/adminguide/extensions.rst b/source/adminguide/extensions.rst index 3f5732490d..7dbe02426c 100644 --- a/source/adminguide/extensions.rst +++ b/source/adminguide/extensions.rst @@ -92,6 +92,8 @@ CloudStack provides sample built-in orchestrator extensions for demonstration an .. include:: extensions/builtin_extensions.rst +.. include:: extensions/limitations.rst + .. include:: extensions/troubleshooting.rst .. include:: extensions/developer.rst diff --git a/source/adminguide/extensions/builtin_extensions.rst b/source/adminguide/extensions/builtin_extensions.rst index 17c17317e1..cfcca8690a 100644 --- a/source/adminguide/extensions/builtin_extensions.rst +++ b/source/adminguide/extensions/builtin_extensions.rst @@ -179,6 +179,7 @@ Adding Hyper-V to CloudStack #. **Add Host.** Add a host to the newly created cluster with the following details: |hyperv-add-host.png| + **Note**: Add the detail **verify_tls_certificate** set to **false** to skip TLS certificate verification for self-signed certificates. #. **Create Template.** A Template in CloudStack can map to either a `Template` or an `ISO` in Hyper-V. Provide a dummy `url` and template name. Select `External` as the hypervisor and `HyperV` as the extension. Under `External Details`, specify: diff --git a/source/adminguide/extensions/limitations.rst b/source/adminguide/extensions/limitations.rst new file mode 100644 index 0000000000..6af6ef2ecd --- /dev/null +++ b/source/adminguide/extensions/limitations.rst @@ -0,0 +1,55 @@ +.. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information# + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + + +Limitations +=========== + +Although the external Instances behave a lot like CloudStack managed +Instances in many ways, there are some limitations. Some of these +limitations are due to the framework itself, while others can be addressed +by adding custom actions in the scripts written for the built-in extensions. + +**Features / Actions not supported at the framework level:** + + - Console access to the external Instances. + + - Data volumes. + + - User Data and Metadata services. + + - SSH key injection. + + - Affinity Groups. + + - Usage and Billing. + +**Actions which can be implemented using Custom Actions in built-in extensions:** + + - Reinstall Instance. + + - Migrate Instance to another Host. + + - Migrate Instance to another Storage. + + - Backup and Restore. + + - Recurring Snapshots. + + - Change Service Offering. + + - Resize Volume. + + - Attach ISO. From 51b68651fd02a6f187eec541e5f14095628b50bc Mon Sep 17 00:00:00 2001 From: Abhisar Sinha <63767682+abh1sar@users.noreply.github.com> Date: Wed, 27 Aug 2025 10:53:29 +0530 Subject: [PATCH 2/3] review comments from @shwstppr --- source/adminguide/extensions/limitations.rst | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/source/adminguide/extensions/limitations.rst b/source/adminguide/extensions/limitations.rst index 6af6ef2ecd..44d92b2317 100644 --- a/source/adminguide/extensions/limitations.rst +++ b/source/adminguide/extensions/limitations.rst @@ -34,16 +34,12 @@ by adding custom actions in the scripts written for the built-in extensions. - Affinity Groups. - - Usage and Billing. + - Migrate Instance. **Actions which can be implemented using Custom Actions in built-in extensions:** - Reinstall Instance. - - Migrate Instance to another Host. - - - Migrate Instance to another Storage. - - Backup and Restore. - Recurring Snapshots. From 2db95a97797a635097603fa7f9795aa29a9c7dbc Mon Sep 17 00:00:00 2001 From: Abhisar Sinha <63767682+abh1sar@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:58:18 +0530 Subject: [PATCH 3/3] review comments from @rohityadavcloud --- source/adminguide/extensions/limitations.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/adminguide/extensions/limitations.rst b/source/adminguide/extensions/limitations.rst index 44d92b2317..a0b74d3481 100644 --- a/source/adminguide/extensions/limitations.rst +++ b/source/adminguide/extensions/limitations.rst @@ -22,7 +22,7 @@ Instances in many ways, there are some limitations. Some of these limitations are due to the framework itself, while others can be addressed by adding custom actions in the scripts written for the built-in extensions. -**Features / Actions not supported at the framework level:** +**Some general features/actions not supported at the framework level:** - Console access to the external Instances. @@ -36,6 +36,10 @@ by adding custom actions in the scripts written for the built-in extensions. - Migrate Instance. + - Host Capacity and Utilization Stats. + + - Add Nics to Instance post deployment. + **Actions which can be implemented using Custom Actions in built-in extensions:** - Reinstall Instance.