From 19a2415a4766e143cdb22f3a8391a5d5296a5166 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Mon, 3 Jun 2024 14:33:25 +0530 Subject: [PATCH 1/2] instance: note on metadata Related to https://github.com/apache/cloudstack/pull/9163 Signed-off-by: Abhishek Kumar --- source/adminguide/virtual_machines.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index 90d041a387..db2ffa09dd 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -205,6 +205,19 @@ following techniques: updateVirtualMachine API. After installing the tools and updating the Instance, stop and start the Instance. +Instance Metdata +~~~~~~~~~~~~~~~~ + +CloudStack provides different means for controlling an instance's metadata. + +- 'extraconfig' parameter of 'deployVirtualMachine' or 'updateVirtualMachine' API methods + can be used for setting different metadata parameters for an instance. +- Global configurations - 'vm.metadata.manufacturer' and 'vm.metadata.product' can be used + to set the manufacturer and product respectively in the instance metadata. However, a + custom value for these parameters may affect cloud-init functionality for the instance + when used with CloudStack datasource. One of the requirement for cloud-init functionality + to work with CloudStack datasource is that product value should contain 'CloudStack'. + Accessing Instances ------------------- From 188f893c2ce209ca13eb0b1feffbc2c1f2719757 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 5 Jun 2024 17:54:50 +0530 Subject: [PATCH 2/2] Update source/adminguide/virtual_machines.rst --- source/adminguide/virtual_machines.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/adminguide/virtual_machines.rst b/source/adminguide/virtual_machines.rst index db2ffa09dd..e99b9a8045 100644 --- a/source/adminguide/virtual_machines.rst +++ b/source/adminguide/virtual_machines.rst @@ -212,7 +212,7 @@ CloudStack provides different means for controlling an instance's metadata. - 'extraconfig' parameter of 'deployVirtualMachine' or 'updateVirtualMachine' API methods can be used for setting different metadata parameters for an instance. -- Global configurations - 'vm.metadata.manufacturer' and 'vm.metadata.product' can be used +- Zone-level configurations - 'vm.metadata.manufacturer' and 'vm.metadata.product' can be used to set the manufacturer and product respectively in the instance metadata. However, a custom value for these parameters may affect cloud-init functionality for the instance when used with CloudStack datasource. One of the requirement for cloud-init functionality