https://github.com/cobbler/terraform-provider-cobbler

https://github.com/cobbler/terraform-provider-cobbler

cobbler hacktoberfest terraform terraform-provider

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/cobbler/terraform-provider-cobbler
• Owner: cobbler
• License: mpl-2.0
• Created: 2021-01-16T15:45:08.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-10-26T08:17:02.000Z (about 2 months ago)
• Last Synced: 2024-10-29T11:40:41.924Z (about 2 months ago)
• Topics: cobbler, hacktoberfest, terraform, terraform-provider
• Language: Go
• Homepage: https://registry.terraform.io/providers/cobbler/cobbler/latest
• Size: 6.03 MB
• Stars: 10
• Watchers: 5
• Forks: 9
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Cobbler Terraform Provider

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/d68c9aff2cd74b69afc9366ab4415f6a)](https://app.codacy.com/gh/cobbler/terraform-provider-cobbler/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)

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](https://github.com/jtopjian).

## Prerequisites

- [Terraform](https://terraform.io), 0.14 and above

- [Cobbler](https://cobbler.github.io/), release 3.3.0 (or higher)

## Using the Provider

Full documentation can be found in the [`docs`](/docs) directory.

### Installation

You can use the provider via the [Terraform provider registry](https://registry.terraform.io/providers/cobbler/cobbler).

### Manual installation

You can download a pre-built binary from the [releases](https://github.com/cobbler/terraform-provider-cobbler/releases/)

 page.\

 These are built using [GoReleaser](https://goreleaser.com/) (the [configuration](.goreleaser.yml) is in the repo).

Download and add the pre-built binary for your system (Linux or macOS) to `~/.terraform.d/plugins/`.\

Replace `linux` with `darwin` for the macOS version.

```console

wget https://github.com/cobbler/terraform-provider-cobbler/releases/download/v2.0.3/terraform-provider-cobbler_2.0.3_linux_amd64.zip

unzip terraform-provider-cobbler_2.0.3_linux_amd64.zip

mkdir -p ~/.terraform.d/plugins/

mv terraform-provider-cobbler_v2.0.3 ~/.terraform.d/plugins/

chmod +x ~/.terraform.d/plugins/terraform-provider-cobbler_v2.0.3

```

Don't forget to run `terraform init` after installation of a new binary!

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

```hcl

provider "cobbler" {

  version  = "~> 4.1.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](https://docs.docker.com/get-docker/), 

[docker-compose](https://docs.docker.com/compose/install/) 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.