You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/adminguide/service_offerings.rst
+6-7Lines changed: 6 additions & 7 deletions
Original file line number
Diff line number
Diff line change
@@ -402,10 +402,9 @@ To create a new compute offering:
402
402
with the compute offering. When set to true, overriding of disk offering is not allowed on deploy instance
403
403
and change disk offering is not allowed for the ROOT disk
404
404
405
-
- **Enable Lease**: When this flag is enabled, compute offering is created with lease related metadata.
406
-
In CloudStack, a lease represents the specific duration for which an instance is allocated.
407
-
The user rents these resources for the duration of the lease. Once the lease period expires, instance may be stopped or destroyed.
408
-
Lease information is inherited from compute offering and gets associated to Instance.
405
+
- **Enable Lease**: When this flag is enabled, Compute Offering is created with 'Instance Lease' feature enabled.
406
+
In CloudStack, a lease sets a specific time duration after which a chosen lease action action, such as stopping or destroying the instance, will take place.
407
+
These lease settings are defined in the Compute Offering and are automatically applied to any Instance created using it.
409
408
410
409
.. note:: The global configuration ``instance.lease.enabled`` should be configured as true to create compute offering with lease.
411
410
@@ -415,10 +414,10 @@ To create a new compute offering:
415
414
416
415
When the flag is enabled
417
416
418
-
- **Lease Duration (in days)**: Creates a compute offering with Lease duration. Instance created from this compute offering will inherit lease duration by default.
417
+
- **Lease Duration (in days)**: Sets the lease duration. An instance created using this compute offering will inherit the lease duration by default.
419
418
420
-
- **Lease expiry action**: Denotes lease expiry action, which gets executed upon lease expiry for instances created from compute offering.
421
-
Suported values for lease expiry action are as follows:
419
+
- **Lease expiry action**: Lease expiry action: Denotes lease expiry action, which gets executed upon lease expiry for instances created using this compute offering.
420
+
Supported values for lease expiry action are as follows:
Copy file name to clipboardExpand all lines: source/adminguide/virtual_machines.rst
+10-9Lines changed: 10 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -963,20 +963,21 @@ already in use by the Instance.
963
963
Instance Lease
964
964
--------------
965
965
966
-
Cloudstack provides capability to create instance on lease. Lease denotes a set period for which resource is allocated and upon expiry cleanup is performed.
967
-
This feature enables automated cleanup of instances created for specific duration and for specific purpose. This feature gives administrators the ability to automatically reclaim
968
-
resources that are no longer needed by expired virtual machines, helping to optimize resource utilization and reduce wastage.
966
+
CloudStack offers the option to create Instances with a Lease. A Lease defines a set time period after which a selected action, such as stopping or destroying the instance,
967
+
will be automatically performed. This helps optimize cloud resource usage by automatically freeing up resources that are no longer in use.
968
+
If a user needs an instance only for a limited time, this feature can be useful. When deploying an instance, users can either choose a Compute Offering that includes
969
+
the Instance Lease feature or enable it specifically for that instance, setting the number of days after which the instance should be stopped or destroyed once their task is complete.
969
970
970
971
971
-
**Configuring lease feature**
972
+
**Configuring Instance Lease feature**
972
973
973
974
The cloud administrator can use global configuration variables to control the behavior of Instance Lease.
974
975
To set these variables, API or CloudStack UI can be used:
instance.lease.enabled Indicates whether to enable the Instance lease featuew, will be applicable only on instances created after lease is enabled. **Default: false**
980
+
instance.lease.enabled Indicates whether to enable the Instance lease feature, will be applicable only on instances created after lease is enabled. **Default: false**
980
981
instance.lease.scheduler.interval Background task interval in seconds that executes Lease expiry action on eligibile expired instances. Default: 3600.
981
982
instance.lease.alertscheduler.interval Background task interval in seconds that executes Lease alert for instances about to be expired in next N days. Default: 86400
982
983
instance.lease.alert.daysbefore Denotes number of days (N) for alert task. Default: 7 days
@@ -990,8 +991,8 @@ instance.lease.alert.daysbefore Denotes number of days (N) for alert ta
990
991
991
992
Lease may require to be disabled in following scenarios:
992
993
993
-
- During deployment of instance while using compute offering with lease metadata
994
-
- Edit instance with existing lease
994
+
- Users can disable the Instance Lease feature during instance deployment by unchecking the 'Enable Lease' option when using a Compute Offering that supports it.
995
+
- For existing instances with a lease already enabled, the lease can be removed by editing the instance and unchecking the 'Enable Lease' option.
995
996
996
997
**leaseexpiryaction**: There are two expiry action supported:
997
998
@@ -1015,7 +1016,7 @@ lease is removed from the instance for any further action.
1015
1016
1016
1017
#. Lease Assignment: A lease can only be assigned to an instance during deployment.
1017
1018
#. Lease Acquisition: Instances without a lease cannot acquire one by switching to a different compute offering or by editing the instance.
1018
-
#. Lease Inheritance: Instances inherit the lease from a compute offering that contains lease metadata. This lease can be overridden or disabled in the "Advanced Settings".
1019
+
#. Lease Inheritance: Instances inherit the lease from a compute offering with 'Instance Lease' feature enabled. This lease can be overridden or disabled in the “Advanced Settings”.
1019
1020
#. Lease Persistence: A lease is always tied to the instance. Modifications to the compute offering do not affect the instance's lease.
1020
1021
#. Non-Lease Compute offering: Instances can have a lease by enabling it in the "Advanced Settings" for non-lease based compute offering too.
1021
1022
#. Lease Duration Management: The lease duration can be extended or reduced for instances before expiry. However, once the lease is disabled, it cannot be re-enabled for that instance.
@@ -1027,7 +1028,7 @@ lease is removed from the instance for any further action.
1027
1028
1028
1029
There are 2 ways to deploy instance with lease from UI:
1029
1030
1030
-
1. Use compute offering which has associated lease metadata for instance
1031
+
1. Use compute offering which has 'Instance Lease' feature enabled.
0 commit comments