mirror of
https://github.com/ysoftdevs/terraform-provider-bitbucketserver.git
synced 2026-02-23 19:14:55 +01:00
80 lines
2.7 KiB
Markdown
Executable File
80 lines
2.7 KiB
Markdown
Executable File
---
|
|
id: provider
|
|
title: Getting Started
|
|
---
|
|
|
|
[Bitbucket Server](https://www.atlassian.com/software/bitbucket) is the self-hosted version of Bitbucket.
|
|
Whilst terraform provides a default bitbucket provider, this only works for _Bitbucket Cloud_ - this provider
|
|
unlocks the power of terraform to manage your self-hosted Bitbucket Server instance.
|
|
|
|
## Provider Installation
|
|
|
|
|
|
### Install latest version
|
|
|
|
The following one-liner script will fetch the latest provider version and download it to your `~/.terraform.d/plugins` directory.
|
|
|
|
```bash
|
|
$ mkdir -p ~/.terraform.d/plugins && \
|
|
curl -Ls https://api.github.com/repos/gavinbunney/terraform-provider-bitbucketserver/releases/latest \
|
|
| jq -r ".assets[] | select(.browser_download_url | contains(\"$(uname -s | tr A-Z a-z)\")) | select(.browser_download_url | contains(\"amd64\")) | .browser_download_url" \
|
|
| xargs -n 1 curl -Lo ~/.terraform.d/plugins/terraform-provider-bitbucketserver && \
|
|
chmod +x ~/.terraform.d/plugins/terraform-provider-bitbucketserver
|
|
```
|
|
|
|
### Install manually
|
|
|
|
If you don't want to use the one-liner above, you can download a binary for your system from the [release page](https://github.com/gavinbunney/terraform-provider-bitbucketserver/releases) 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.
|
|
|
|
## Provider Configuration
|
|
|
|
The provider supports parameters to determine the bitbucket server and admin user/password to use.
|
|
|
|
```hcl
|
|
provider "bitbucketserver" {
|
|
server = "https://mybitbucket.example.com"
|
|
username = "admin"
|
|
password = "password"
|
|
}
|
|
```
|
|
|
|
### Authentication
|
|
|
|
The `username` and `password` specified should be of a user with sufficient privileges to perform the operations you are after.
|
|
Typically this is a user with `SYS_ADMIN` global permissions.
|
|
|
|
### Environment Variables
|
|
|
|
You can also specify the provider configuration using the following env vars:
|
|
|
|
* `BITBUCKET_SERVER`
|
|
* `BITBUCKER_USERNAME`
|
|
* `BITBUCKET_PASSWORD`
|
|
|
|
> Note: The hcl provider configuration takes precedence over the environment variables.
|
|
|
|
## Example - Creating a Project and Repository
|
|
|
|
Creating a project and repository is super simple with this provider:
|
|
|
|
```hcl
|
|
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 = "repo-01"
|
|
description = "Test repository"
|
|
}
|
|
```
|