ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
terraform/website/source/docs/providers/triton/r/triton_machine.html.markdown

101 lines
3.1 KiB
Markdown
Raw Normal View History

provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
---
layout: "triton"
page_title: "Triton: triton_machine"
Expanded Joyent Triton documentation (#13205) * Added triton_vlan and triton_fabric documentation. Added Data Center information to the Triton provider documentation. Added an Ubuntu example to triton_machine. Cleaned up a copy-and-paste error in the sidebar_current of the Front Matter. * fixed the active resource sidebar highlight * expanded triton firewall ssh example to include authorization for multiple source IPs
2017-03-30 22:23:31 +02:00
sidebar_current: "docs-triton-resource-machine"
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
description: |-
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples
2017-02-18 23:48:50 +01:00
The `triton_machine` resource represents a virtual machine or infrastructure container running in Triton.
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
---
# triton\_machine
The `triton_machine` resource represents a virtual machine or infrastructure container running in Triton.
## Example Usages
Expanded Joyent Triton documentation (#13205) * Added triton_vlan and triton_fabric documentation. Added Data Center information to the Triton provider documentation. Added an Ubuntu example to triton_machine. Cleaned up a copy-and-paste error in the sidebar_current of the Front Matter. * fixed the active resource sidebar highlight * expanded triton firewall ssh example to include authorization for multiple source IPs
2017-03-30 22:23:31 +02:00
### Run a SmartOS base-64 machine.
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
```
Expanded Joyent Triton documentation (#13205) * Added triton_vlan and triton_fabric documentation. Added Data Center information to the Triton provider documentation. Added an Ubuntu example to triton_machine. Cleaned up a copy-and-paste error in the sidebar_current of the Front Matter. * fixed the active resource sidebar highlight * expanded triton firewall ssh example to include authorization for multiple source IPs
2017-03-30 22:23:31 +02:00
resource "triton_machine" "test-smartos" {
name = "test-smartos"
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples
2017-02-18 23:48:50 +01:00
package = "g3-standard-0.25-smartos"
image = "842e6fa6-6e9b-11e5-8402-1b490459e334"
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples
2017-02-18 23:48:50 +01:00
tags = {
hello = "world"
}
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
}
```
Expanded Joyent Triton documentation (#13205) * Added triton_vlan and triton_fabric documentation. Added Data Center information to the Triton provider documentation. Added an Ubuntu example to triton_machine. Cleaned up a copy-and-paste error in the sidebar_current of the Front Matter. * fixed the active resource sidebar highlight * expanded triton firewall ssh example to include authorization for multiple source IPs
2017-03-30 22:23:31 +02:00
### Run an Ubuntu 14.04 LTS machine.
```
resource "triton_machine" "test-ubuntu" {
name = "test-ubuntu"
package = "g4-general-4G"
image = "1996a1d6-c0d9-11e6-8b80-4772e39dc920"
firewall_enabled = true
root_authorized_keys = "Example Key"
user_script = "#!/bin/bash\necho 'testing user-script' >> /tmp/test.out\nhostname $IMAGENAME"
tags = {
purpose = "testing ubuntu"
} ## tags
} ## resource
```
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
## Argument Reference
The following arguments are supported:
* `name` - (string)
The friendly name for the machine. Triton will generate a name if one is not specified.
* `tags` - (map)
A mapping of tags to apply to the machine.
* `package` - (string, Required)
The name of the package to use for provisioning.
* `image` - (string, Required)
The UUID of the image to provision.
provider/triton: Update to the triton machine docs for the list of nics
2017-02-13 19:10:06 +01:00
* `nic` - (list of NIC blocks, Optional)
NICs associated with the machine. The fields allowed in a `NIC` block are defined below.
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
* `firewall_enabled` - (boolean) Default: `false`
Whether the cloud firewall should be enabled for this machine.
* `root_authorized_keys` - (string)
The public keys authorized for root access via SSH to the machine.
* `user_data` - (string)
Data to be copied to the machine on boot.
* `user_script` - (string)
The user script to run on boot (every boot on SmartMachines).
* `administrator_pw` - (string)
The initial password for the Administrator user. Only used for Windows virtual machines.
Minor fix to the triton_machine provider. The docs referred to a `networks` option, which seems to be deprecated. Now, terraform seems to expect a list of maps, which will detail each network interface.
2017-02-08 02:28:26 +01:00
The nested `nic` block supports the following:
* `network` - (string, Optional)
The network id to attach to the network interface. It will be hex, in the format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.
provider/triton: New provider for Joyent Triton This brings across the following resources for Triton from the joyent/triton-terraform repository, and converts them to the canonical Terraform style, introducing Terraform-style documentation and acceptance tests which run against the live API rather than the local APIs: - triton_firewall_rule - triton_machine - triton_key
2016-02-10 21:30:32 +01:00
## Attribute Reference
The following attributes are exported:
website/docs: Run `terraform fmt` on code examples (#12075) * docs/vsphere: Fix code block * docs: Convert `...` to `# ...` to allow `terraform fmt`ing * docs: Trim trailing whitespace * docs: First-pass run of `terraform fmt` on code examples
2017-02-18 23:48:50 +01:00
* `id` - (string) - The identifier representing the firewall rule in Triton.
* `type` - (string) - The type of the machine (`smartmachine` or `virtualmachine`).
* `state` - (string) - The current state of the machine.
* `dataset` - (string) - The dataset URN with which the machine was provisioned.
* `memory` - (int) - The amount of memory the machine has (in Mb).
* `disk` - (int) - The amount of disk the machine has (in Gb).
* `ips` - (list of strings) - IP addresses of the machine.
* `primaryip` - (string) - The primary (public) IP address for the machine.
* `created` - (string) - The time at which the machine was created.
* `updated` - (string) - The time at which the machine was last updated.