Cloud-Init enables the automatic initialization and configuration of instances during the initial boot phase. It runs user data scripts to customize an instance, install applications, and configure specific packages or services.
Follow this guide to update Cloud-Init user data on a Vultr Optimized Cloud Compute instance using the Vultr Customer Portal, API, CLI, or Terraform.
Send a GET
request to the List Instances endpoint and note your target instance's ID.
$ curl "https://api.vultr.com/v2/instances" \
-X GET \
-H "Authorization: Bearer ${VULTR_API_KEY}"
Send a PATCH
request to the Update Instance endpoint to update the instance's Cloud-Init user data.
$ curl "https://api.vultr.com/v2/instances/{instance-id}" \
-X PATCH \
-H "Authorization: Bearer ${VULTR_API_KEY}" \
-H "Content-Type: application/json" \
--data '{
"user_data" : "<cloud-init-data>",
}'
List all available instances and note your target instance's ID.
$ vultr-cli instance list
Upload new Cloud-Init user data to the instance from a file on your workstation.
$ vultr-cli instance user-data set <instance-id> --userdata "<script-path>"
Cloud-Init user data can only be set during instance creation in Terraform and cannot be updated on an existing instance without recreating it.
Open your Terraform configuration for the new Optimized Cloud Compute instance.
Add the user_data
argument to the instance resource to run a script at first boot.
resource "vultr_instance" "occ" {
# ...existing fields (region, plan, os_id, label, etc.)
user_data = <<-EOT
#!/bin/bash
apt-get update -y
apt-get install -y nginx
systemctl enable --now nginx
EOT
}
Apply the configuration and observe the following output:
Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
No comments yet.