https://github.com/terraform-ibm-modules/terraform-ibm-dedicated-host
This module provisions dedicated hosts and dedicated host groups, which are designed to provide total isolation, control, and security for your heavy, mission-critical workloads.
https://github.com/terraform-ibm-modules/terraform-ibm-dedicated-host
core-team dedicated-host ibm-cloud terraform terraform-module
Last synced: 11 days ago
JSON representation
This module provisions dedicated hosts and dedicated host groups, which are designed to provide total isolation, control, and security for your heavy, mission-critical workloads.
- Host: GitHub
- URL: https://github.com/terraform-ibm-modules/terraform-ibm-dedicated-host
- Owner: terraform-ibm-modules
- License: apache-2.0
- Created: 2024-11-28T10:10:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-04T03:19:52.000Z (3 months ago)
- Last Synced: 2025-10-04T05:32:58.659Z (3 months ago)
- Topics: core-team, dedicated-host, ibm-cloud, terraform, terraform-module
- Language: HCL
- Size: 189 KB
- Stars: 2
- Watchers: 12
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# IBM Dedicated Host Module
[-green)](https://terraform-ibm-modules.github.io/documentation/#/badge-status)
[](https://github.com/terraform-ibm-modules/terraform-ibm-dedicated-host/releases/latest)
[](https://github.com/pre-commit/pre-commit)
[](https://renovatebot.com/)
[](https://github.com/semantic-release/semantic-release)
This module used to provision dedicated Host which is a fully dedicated, single-tenant physical server hosted in IBM Cloud data centers. It is designed for enterprises that require strict isolation of workloads, enhanced security, and consistent performance. With a dedicated host, customers have full control over server allocation, resource usage, and compliance requirements while leveraging the scalability and reliability of the IBM Cloud.
## Overview
* [terraform-ibm-dedicated-host](#terraform-ibm-dedicated-host)
* [Examples](./examples)
*
*
*
* [Contributing](#contributing)
## terraform-ibm-dedicated-host
### Usage
```hcl
terraform {
required_version = ">= 1.9.0"
required_providers {
ibm = {
source = "IBM-Cloud/ibm"
version = ">= 1.71.2, < 2.0.0"
}
}
}
locals {
region = "us-south"
}
provider "ibm" {
ibmcloud_api_key = "XXXXXXXXXX" # replace with apikey value
region = local.region
}
module "dedicated_host" {
source = "terraform-ibm-modules/dedicated-host/ibm"
version = "X.X.X" # Replace "X.X.X" with a release version to lock into a specific release
prefix = "dhtest"
dedicated_hosts = [
{
host_group_name = "${var.prefix}-dhgroup"
existing_host_group = false
resource_group_id = module.resource_group.resource_group_id
class = "bx2"
family = "balanced"
zone = "${var.region}-1"
resource_tags = var.resource_tags
dedicated_host = [
{
name = "${var.prefix}-dhhost"
profile = "bx2-host-152x608"
}
]
}
]
}
```
### Required IAM access policies
You need the following permissions to run this module.
- Account Management
- **Resource Group** service
- `Viewer` platform access
- IAM Services
- **IBM Cloud Activity Tracker** service
- `Editor` platform access
- `Manager` service access
- **IBM Cloud Monitoring** service
- `Editor` platform access
- `Manager` service access
- **IBM Cloud Object Storage** service
- `Editor` platform access
- `Manager` service access
### Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.9.0 |
| [ibm](#requirement\_ibm) | >= 1.79.0, < 2.0.0 |
### Modules
No modules.
### Resources
| Name | Type |
|------|------|
| [ibm_is_dedicated_host.dh_host](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_dedicated_host) | resource |
| [ibm_is_dedicated_host_group.dh_group](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/is_dedicated_host_group) | resource |
| [ibm_is_dedicated_host_group.existing_dh_group](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/is_dedicated_host_group) | data source |
### Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [dedicated\_hosts](#input\_dedicated\_hosts) | A list of objects which contain the required inputs for the dedicated host and dedicated host groups, a flag indicating the user to use an existing host group by enabling it. Also has the default values for a dedicated host setup which are recommended by IBM Cloud. |
list(object({
host_group_name = string
existing_host_group = optional(bool, false)
resource_group_id = string
class = optional(string, "bx2")
family = optional(string, "balanced")
zone = optional(string, "us-south-1")
dedicated_host = list(object({
name = string
profile = optional(string, "bx2-host-152x608")
access_tags = optional(list(string), [])
}))
})) | n/a | yes |
### Outputs
| Name | Description |
|------|-------------|
| [dedicated\_host\_group\_ids](#output\_dedicated\_host\_group\_ids) | List the Dedicated Host Group ID's |
| [dedicated\_host\_ids](#output\_dedicated\_host\_ids) | List the Dedicated Host ID's |
## Contributing
You can report issues and request features for this module in GitHub issues in the module repo. See [Report an issue or request a feature](https://github.com/terraform-ibm-modules/.github/blob/main/.github/SUPPORT.md).
To set up your local development environment, see [Local development setup](https://terraform-ibm-modules.github.io/documentation/#/local-dev-setup) in the project documentation.