github-mirrors/terraform-provider-bitbucketserver
1
0
Fork 0
mirror of https://github.com/ysoftdevs/terraform-provider-bitbucketserver.git synced 2026-03-26 19:31:07 +01:00
Code Issues Packages Projects Releases 1 Wiki Activity

Update README and development instructions

Browse Source
This commit is contained in:
Martin Litvaj
2020-07-17 18:56:05 +02:00
parent f116e39d79
commit 9911ca71f3
1 changed files with 23 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

61
README.md
View File

@@ -1,18 +1,17 @@
Bitbucket Server Terraform Provider # Bitbucket Server Terraform Provider
==================
[![Build Status](https://travis-ci.org/gavinbunney/terraform-provider-bitbucketserver.svg?branch=master)](https://travis-ci.org/gavinbunney/terraform-provider-bitbucketserver) [![codecov](https://codecov.io/gh/gavinbunney/terraform-provider-bitbucketserver/branch/master/graph/badge.svg)](https://codecov.io/gh/gavinbunney/terraform-provider-bitbucketserver) [![user guide](https://img.shields.io/badge/-user%20guide-blue)](https://gavinbunney.github.io/terraform-provider-bitbucketserver) [![Build Status](https://travis-ci.org/gavinbunney/terraform-provider-bitbucketserver.svg?branch=master)](https://travis-ci.org/gavinbunney/terraform-provider-bitbucketserver) [![codecov](https://codecov.io/gh/gavinbunney/terraform-provider-bitbucketserver/branch/master/graph/badge.svg)](https://codecov.io/gh/gavinbunney/terraform-provider-bitbucketserver) [![user guide](https://img.shields.io/badge/-user%20guide-blue)](https://gavinbunney.github.io/terraform-provider-bitbucketserver)
This terraform provider allows management of bitbucket server resources. This terraform provider allows management of **Bitbucket Server** resources. The bundled terraform bitbucket provider works only for Bitbucket Cloud.
> Note: The bundled terraform bitbucket provider works for bitbucket cloud - this provider is for bitbucket server only!
## Using the provider ## 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`. 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. 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.
### Quick Start See [User Guide](https://gavinbunney.github.io/terraform-provider-bitbucketserver) for details on all the provided data and resource types.
### Example
```hcl ```hcl
provider "bitbucketserver" { provider "bitbucketserver" {
@@ -34,45 +33,25 @@ resource "bitbucketserver_repository" "test" {
} }
``` ```
See [User Guide](https://gavinbunney.github.io/terraform-provider-bitbucketserver) for details on all the provided data and resource types.
---
## Development Guide ## Development Guide
### Requirements ### Requirements
- [Terraform](https://www.terraform.io/downloads.html) 0.12.x - [Terraform](https://www.terraform.io/downloads.html) 0.12.x
- [Go](https://golang.org/doc/install) 1.11 (to build the provider plugin) - [Go](https://golang.org/doc/install) 1.11+
- correctly setup [GOPATH](http://golang.org/doc/code.html#GOPATH
- add `$GOPATH/bin` to your `$PATH`
- clone this repository to `$GOPATH/src/github.com/gavinbunney/terraform-provider-bitbucketserver`
### Building The Provider ### Building the provider
Clone repository to: `$GOPATH/src/github.com/gavinbunney/terraform-provider-bitbucketserver` To build the provider, run `make build`. This will also put the provider binary in the `$GOPATH/bin` directory.
```sh ```sh
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers
$ git clone git@github.com:gavinbunney/terraform-provider-bitbucketserver
```
Enter the provider directory and build the provider
```sh
$ cd $GOPATH/src/github.com/gavinbunney/terraform-provider-bitbucketserver
$ make build $ make build
``` ```
### Developing the Provider ### Testing
If you wish to work on the provider, you'll first need [Go](http://www.golang.org) installed on your machine (version 1.11+ is *required*). You'll also need to correctly setup a [GOPATH](http://golang.org/doc/code.html#GOPATH), as well as adding `$GOPATH/bin` to your `$PATH`.
To compile the provider, run `make build`. This will build the provider and put the provider binary in the `$GOPATH/bin` directory.
```sh
$ make bin
...
$ $GOPATH/bin/terraform-provider-bitbucketserver
...
```
In order to test the provider, you can simply run `make test`. In order to test the provider, you can simply run `make test`.
@@ -80,10 +59,16 @@ In order to test the provider, you can simply run `make test`.
$ make test $ make test
``` ```
In order to run the full suite of Acceptance tests, run `make testacc`. In order to run the full suite of acceptance tests, run `make testacc-bitbucket`.
*Note:* Acceptance tests create real resources, and often cost money to run.
```sh ```sh
$ make testacc $ make testacc-bitbucket
```
Alternatively, you can manually start Bitbucket Server docker container, run the acceptance tests and then shut down the docker.
```sh
$ scripts/start-docker-compose.sh
$ make testacc
$ scripts/stop-docker-compose.sh
``` ```