Resource Metadata
Expose key workspace information to your users via coder_metadata resources in your template code.
Coder automatically generates the type metadata.
You can use coder_metadata to show
- Compute resources
- IP addresses
- Secrets
- Important file paths
and any other Terraform resource attribute.
Example
Expose the disk size, deployment name, and persistent directory in a Kubernetes template with:
resource "kubernetes_persistent_volume_claim" "root" {
...
}
resource "kubernetes_deployment" "coder" {
# My deployment is ephemeral
count = data.coder_workspace.me.start_count
...
}
resource "coder_metadata" "pvc" {
resource_id = kubernetes_persistent_volume_claim.root.id
item {
key = "size"
value = kubernetes_persistent_volume_claim.root.spec[0].resources[0].requests.storage
}
item {
key = "dir"
value = "/home/coder"
}
}
resource "coder_metadata" "deployment" {
count = data.coder_workspace.me.start_count
resource_id = kubernetes_deployment.coder[0].id
item {
key = "name"
value = kubernetes_deployment.coder[0].metadata[0].name
}
}
Hiding resources in the UI
Some resources don't need to be exposed in the UI; this helps keep the workspace view clean for developers. To hide a resource, use the hide attribute:
resource "coder_metadata" "hide_serviceaccount" {
count = data.coder_workspace.me.start_count
resource_id = kubernetes_service_account.user_data.id
hide = true
item {
key = "name"
value = kubernetes_deployment.coder[0].metadata[0].name
}
}
Using custom resource icon
To use custom icons on your resources, use the icon attribute (must be a valid path or URL):
resource "coder_metadata" "resource_with_icon" {
count = data.coder_workspace.me.start_count
resource_id = kubernetes_service_account.user_data.id
icon = "/icon/database.svg"
item {
key = "name"
value = kubernetes_deployment.coder[0].metadata[0].name
}
}
To make easier for you to customize your resource we added some built-in icons:
- Folder
/icon/folder.svg - Memory
/icon/memory.svg - Image
/icon/image.svg - Widgets
/icon/widgets.svg - Database
/icon/database.svg
We also have other icons related to the IDEs. You can see all the icons here.
Up next
See an opportunity to improve our docs? Make an edit.
On this page