1619a8138f
* govendor: update go-cloudstack dependency * Separate security groups and rules This commit separates the creation and management of security groups and security group rules. It extends the `icmp` options so you can supply `icmp_type` and `icmp_code` to enbale more specific configs. And it adds lifecycle management of security group rules, so that security groups do not have to be recreated when rules are added or removed. This is particulary helpful since the `cloudstack_instance` cannot update a security group without having to recreate the instance. In CloudStack >= 4.9.0 it is possible to update security groups of existing instances, but as that is just added to the latest version it seems a bit too soon to start using this (causing backwards incompatibility issues for people or service providers running older versions). * Add and update documentation * Add acceptance tests
2.7 KiB
layout, page_title, sidebar_current, description
| layout | page_title | sidebar_current | description |
|---|---|---|---|
| cloudstack | CloudStack: cloudstack_instance | docs-cloudstack-resource-instance | Creates and automatically starts a virtual machine based on a service offering, disk offering, and template. |
cloudstack_instance
Creates and automatically starts a virtual machine based on a service offering, disk offering, and template.
Example Usage
resource "cloudstack_instance" "web" {
name = "server-1"
service_offering= "small"
network_id = "6eb22f91-7454-4107-89f4-36afcdf33021"
template = "CentOS 6.5"
zone = "zone-1"
}
Argument Reference
The following arguments are supported:
-
name- (Required) The name of the instance. -
display_name- (Optional) The display name of the instance. -
service_offering- (Required) The name or ID of the service offering used for this instance. -
network_id- (Optional) The ID of the network to connect this instance to. Changing this forces a new resource to be created. -
ip_address- (Optional) The IP address to assign to this instance. Changing this forces a new resource to be created. -
template- (Required) The name or ID of the template used for this instance. Changing this forces a new resource to be created. -
root_disk_size- (Optional) The size of the root disk in gigabytes. The root disk is resized on deploy. Only applies to template-based deployments. Changing this forces a new resource to be created. -
group- (Optional) The group name of the instance. -
affinity_group_ids- (Optional) List of affinity group IDs to apply to this instance. -
affinity_group_names- (Optional) List of affinity group names to apply to this instance. -
security_group_ids- (Optional) List of security group IDs to apply to this instance. Changing this forces a new resource to be created. -
security_group_names- (Optional) List of security group names to apply to this instance. Changing this forces a new resource to be created. -
project- (Optional) The name or ID of the project to deploy this instance to. Changing this forces a new resource to be created. -
zone- (Required) The name or ID of the zone where this instance will be created. Changing this forces a new resource to be created. -
user_data- (Optional) The user data to provide when launching the instance. -
keypair- (Optional) The name of the SSH key pair that will be used to access this instance. -
expunge- (Optional) This determines if the instance is expunged when it is destroyed (defaults false)
Attributes Reference
The following attributes are exported:
id- The instance ID.display_name- The display name of the instance.