mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-01-10 11:00:21 -05:00
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
86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
---
|
|
layout: "cloudstack"
|
|
page_title: "CloudStack: cloudstack_instance"
|
|
sidebar_current: "docs-cloudstack-resource-instance"
|
|
description: |-
|
|
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.
|
|
|