4.0 KiB
layout | page_title | sidebar_current | description |
---|---|---|---|
clc | clc: clc_server | docs-clc-resource-server | Manages the lifecycle of a CLC server. |
clc_server
Manages a CLC server.
See also Complete API documentation.
Example Usage
# Provision a server
resource "clc_server" "node" {
name_template = "trusty"
source_server_id = "UBUNTU-14-64-TEMPLATE"
group_id = "${clc_group.frontends.id}"
cpu = 2
memory_mb = 2048
password = "Green123$"
additional_disks
{
path = "/var"
size_gb = 100
type = "partitioned"
}
additional_disks
{
size_gb = 10
type = "raw"
}
}
output "server_id" {
value = "clc_server.node.id"
}
Argument Reference
The following arguments are supported:
name_template
- (Required, string) The basename of the server. A unique name will be generated by the platform.source_server_id
- (Required, string) The name or ID of the base OS image. Examples: "ubuntu-14-64-template", "rhel-7-64-template", "win2012r2dtc-64"group_id
- (Required, string) The name or ID of the server group to spawn server into.cpu
- (Required, int) The number of virtual coresmemory_mb
- (Required, int) Provisioned RAMtype
- (Required, string) The virtualization type One of "standard", "hyperscale", "bareMetal"password
- (Optional, string) The root/adminstrator password. Will be generated by platform if not provided.description
- (Optional, string) Description for server (visible in control portal only)power_state
- (Optional, string) See PowerStates below for details. If absent, defaults tostarted
.private_ip_address
- (Optional, string) Set internal IP address. If absent, allocated and assigned from pool.network_id
- (Optional, string) GUID of network to use. (Must be set up in advance from control portal.) When absent, the default network will be used.storage_type
- (Optional, string) Backup and replication strategy for disks. One of "standard", "premium"additional_disks
- (Optional) See Disks below for details.custom_fields
- (Optional) See CustomFields below for details.metadata
- (Optional) Misc state storage for non-CLC metadata.
PowerStates
power_state
may be used to set initial power state or modify existing instances.
on
|started
- machine powered onoff
|stopped
- machine powered off forcefullypaused
- freeze machine: memory, processes, billing, monitoring.shutdown
- shutdown gracefullyreboot
- restart gracefullyreset
- restart forcefully
Disks
additional_disks
is a block within the configuration that may be
repeated to specify the attached disks on a server. Each
additional_disks
block supports the following:
type
- (Required, string) Either "raw" or "partitioned".size_gb
- (Required, int) Size of allocated disk.path
- (Required, string, type:partitioned
) The mountpoint for the disk.
CustomFields
custom_fields
is a block within the configuration that may be
repeated to bind custom fields for a server. CustomFields need be set
up in advance. Each custom_fields
block supports the following:
id
- (Required, string) The ID of the custom field to set.value
- (Required, string) The value for the specified field.
Packages
packages
is a block within the configuration that may be repeated to
specify packages and their associated parameters to be run at
instantiation. Packages facilitate various tasks like ssh key
installation, kernel upgrades, etc. Package ID as well as parameters
are configured via this block.
Example:
# Configure the CLC Provider
provider "clc_server" "ubuntu" {
...
packages
{
id = "77abb844-579d-478d-3955-c69ab4a7ba1a"
SshKey = "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAA..."
}
}