README.md

Cobbler Terraform Provider

The Cobbler provider is used to interact with a locally installed Cobbler service.
The provider needs to be configured with the proper credentials before it can be used.

Original code by Joe Topjian.

Prerequisites

• Terraform 1.0 or above, or OpenTofu 1.6 or above
• Cobbler, release 4.0.0 (or higher)

OpenTofu Support

This provider uses terraform-plugin-framework (protocol v6), which is fully compatible with OpenTofu. You can use the provider with OpenTofu by referencing it from the OpenTofu Registry.

terraform {
  required_providers {
    cobbler = {
      source  = "cobbler/cobbler"
      version = "~> 6.0"
    }
  }
}

Using the Provider

Full documentation can be found in the docs directory.

Installation

You can use the provider via the Terraform provider registry.

Make sure the file variables.tf contains the right version in the provider block:

provider "cobbler" {
  version  = "~> 6.0.0"
  username = var.cobbler_username
  password = var.cobbler_password
  url      = var.cobbler_url
}

Development

If you want to build from source, you can simply use make in the root of the repository.

Testing

To run the acceptance tests, type make testacc. You will need docker, docker-compose and xorriso installed. Xorriso can be installed using: sudo apt-get install -y xorriso, sudo yum install xorriso -y, or sudo zypper install -y xorriso depending on your distro. The Ubuntu 20.04 ISO will be downloaded idempotently to test importing a distro, this is < 1GB.