terraform-provider-bitbucketserver/README.md

Bitbucket Server Terraform Provider

This terraform provider allows management of Bitbucket Server resources. The bundled terraform bitbucket provider works only for Bitbucket Cloud.

Using the provider

Download a binary for your system from the release page and remove the -os-arch details so you're left with terraform-provider-bitbucketserver. Use chmod +x to make it executable and then either place it at the root of your Terraform folder or in the Terraform plugin folder on your system.

Example

provider "bitbucketserver" {
  server   = "https://mybitbucket.example.com"
  username = "admin"
  password = "password"
}

resource "bitbucketserver_project" "test" {
  key         = "TEST"
  name        = "test-01"
  description = "Test project"
}

resource "bitbucketserver_repository" "test" {
  project     = bitbucketserver_project.test.key
  name        = "test-01"
  description = "Test repository"
}

Development Guide

Requirements

• Terraform 1.x.x
• Go 1.21+
  • correctly setup [GOPATH](http://golang.org/doc/code.html#GOPATH
  • add $GOPATH/bin to your $PATH
• clone this repository to $GOPATH/src/github.com/xvlcwk-terraform/terraform-provider-bitbucketserver

Building the provider

To build the provider, run make build. This will also put the provider binary in the $GOPATH/bin directory.

$ make build

Testing

In order to test the provider, you can simply run make test.

$ make test

In order to run the full suite of acceptance tests, run make testacc-bitbucket.

$ make testacc-bitbucket

Alternatively, you can manually start Bitbucket Server docker container, run the acceptance tests and then shut down the docker.

$ scripts/start-docker-compose.sh
$ make testacc
$ scripts/stop-docker-compose.sh