github.com/pmcatominey/terraform@v0.7.0-rc2.0.20160708105029-1401a52a5cc5/website/source/docs/providers/vcd/r/vapp.html.markdown (about)

     1  ---
     2  layout: "vcd"
     3  page_title: "vCloudDirector: vcd_vapp"
     4  sidebar_current: "docs-vcd-resource-vapp"
     5  description: |-
     6    Provides a vCloud Director vApp resource. This can be used to create, modify, and delete vApps.
     7  ---
     8  
     9  # vcd\_vapp
    10  
    11  Provides a vCloud Director vApp resource. This can be used to create,
    12  modify, and delete vApps.
    13  
    14  ## Example Usage
    15  
    16  ```
    17  resource "vcd_network" "net" {
    18      ...
    19  }
    20  
    21  resource "vcd_vapp" "web" {
    22      name          = "web"
    23      catalog_name  = "Boxes"
    24      template_name = "lampstack-1.10.1-ubuntu-10.04"
    25      memory        = 2048
    26      cpus          = 1
    27  
    28      network_name  = "${vcd_network.net.name}"
    29      network_href  = "${vcd_network.net.href}"
    30      ip            = "10.10.104.160"
    31  
    32      metadata {
    33          role    = "web"
    34          env     = "staging"
    35          version = "v1"
    36      }
    37  
    38  }
    39  ```
    40  
    41  ## Argument Reference
    42  
    43  The following arguments are supported:
    44  
    45  * `name` - (Required) A unique name for the vApp
    46  * `catalog_name` - (Required) The catalog name in which to find the given vApp Template
    47  * `template_name` - (Required) The name of the vApp Template to use
    48  * `memory` - (Optional) The amount of RAM (in MB) to allocate to the vApp
    49  * `cpus` - (Optional) The number of virtual CPUs to allocate to the vApp
    50  * `initscript` (Optional) A script to be run only on initial boot
    51  * `network_name` - (Required) Name of the network this vApp should join
    52  * `network_href` - (Optional) The vCloud Director generated href of the network this vApp
    53    should join. If empty it will use the network name and query vCloud Director to discover
    54    this
    55  * `ip` - (Optional) The IP to assign to this vApp. Must be an IP address or
    56    one of dhcp, allocated or none. If given the address must be within the
    57    `static_ip_pool` set for the network. If left blank, and the network has
    58    `dhcp_pool` set with at least one available IP then this will be set with
    59    DHCP.
    60  * `metadata` - (Optional) Key value map of metadata to assign to this vApp
    61  * `power_on` - (Optional) A boolean value stating if this vApp should be powered on. Default to `true`