Terraform Provider LanDB

This is a terraform provider for LanDB. LanDB is an internal asset management system used at CERN to track and manage information about network-connected devices and their associations with users, locations, and services.

For more information about LanDB see the LanDB docs

Provider usage

To use the provider you just have to declare a provider block:

provider "landb" {
	endpoint       ="<YOUR-LANDB-SERVER>"
	client_id      ="<YOUR-CLIENT-id>"
	client_secret  ="<YOUR-CLIENT-SECRET>"
	audience       ="<YOUR-AUDIENCE>"
}

By default the endpoint and audience are set to https://landb.cern.ch/api/ or production-microservice-landb-rest respectively.

It is also possible to set these variables via environment variables. The provider expects them to be named LANDB_ENDPOINT, LANDB_SSO_CLIENT_ID, LANDB_SSO_CLIENT_SECRET and LANDB_SSO_AUDIENCE.

To be able to use the Provider valid Kerberos tickets must also be present

Requirements

• Terraform >= 1.0
• Go >= 1.22

Building The Provider

1. Clone the repository
2. Enter the repository directory
3. Build the provider using the Go install command:

go install

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (see Requirements above).

To compile the provider, run go install. This will build the provider and put the provider binary in the $GOPATH/bin directory.

To generate or update documentation, run make generate.

In order to run the full suite of Acceptance tests, run make testacc.

make testacc