Skip to content

user_data.html.markdown

Latest commit

 

History

History
126 lines (97 loc) · 2.97 KB

user_data.html.markdown

File metadata and controls

126 lines (97 loc) · 2.97 KB
layout cloudstack
page_title CloudStack: cloudstack_user_data
sidebar_current docs-cloudstack-datasource-user-data
description Get information about a CloudStack user data.

cloudstack_user_data

Use this data source to retrieve information about a CloudStack user data by either its name or ID.

Example Usage

Find User Data by Name

data "cloudstack_user_data" "web_init" {
  filter {
    name  = "name"
    value = "web-server-init"
  }
}

# Use the user data in an instance
resource "cloudstack_instance" "web" {
  name        = "web-server"
  userdata_id = data.cloudstack_user_data.web_init.id
  # ... other arguments ...
}

Find User Data by ID

data "cloudstack_user_data" "app_init" {
  filter {
    name  = "id"
    value = "12345678-1234-1234-1234-123456789012"
  }
}

Find Project-Scoped User Data

data "cloudstack_user_data" "project_init" {
  project = "my-project"
  
  filter {
    name  = "name"
    value = "project-specific-init"
  }
}

Argument Reference

The following arguments are supported:

  • filter - (Required) One or more name/value pairs to filter off of. You can apply multiple filters to narrow down the results. See Filters below for more details.

  • project - (Optional) The name or ID of the project to search in.

Filters

The filter block supports the following arguments:

  • name - (Required) The name of the filter. Valid filter names are:

    • id - Filter by user data ID
    • name - Filter by user data name
    • account - Filter by account name
    • domainid - Filter by domain ID

  • value - (Required) The value to filter by.

Attributes Reference

The following attributes are exported:

  • id - The user data ID.
  • name - The name of the user data.
  • userdata - The user data content.
  • account - The account name owning the user data.
  • domain_id - The domain ID where the user data belongs.
  • project_id - The project ID if the user data is project-scoped.
  • params - The list of parameter names defined in the user data (comma-separated string).

Example with Template Integration

# Find existing user data
data "cloudstack_user_data" "app_bootstrap" {
  filter {
    name  = "name"
    value = "application-bootstrap"
  }
}

# Use with template
resource "cloudstack_template" "app_template" {
  name         = "application-template"
  display_text = "Application Template with Bootstrap"
  # ... other template arguments ...
  
  userdata_link {
    userdata_id     = data.cloudstack_user_data.app_bootstrap.id
    userdata_policy = "ALLOWOVERRIDE"
  }
}

# Deploy instance with parameterized user data
resource "cloudstack_instance" "app_server" {
  name     = "app-server-01"
  template = cloudstack_template.app_template.id
  # ... other instance arguments ...
  
  userdata_id = data.cloudstack_user_data.app_bootstrap.id
  
  userdata_details = {
    "environment" = "production"
    "app_version" = "v2.1.0"
    "debug_enabled" = "false"
  }
}