Moved all docs to website

This commit is contained in:
Gavin Bunney
2019-10-14 15:50:22 -07:00
parent 08d0f58674
commit 0ec65e856a
28 changed files with 601 additions and 421 deletions

View File

@@ -1,5 +1,5 @@
---
id: data_application_properties
id: data_bitbucketserver_application_properties
title: bitbucketserver_application_properties
---
@@ -7,7 +7,7 @@ This data source allows you to retrieve version information and other applicatio
## Example Usage
```
```hcl
data "bitbucketserver_application_properties" "main" { }
```

View File

@@ -1,5 +1,5 @@
---
id: data_global_permissions_groups
id: data_bitbucketserver_global_permissions_groups
title: bitbucketserver_global_permissions_groups
---
@@ -7,7 +7,7 @@ Retrieve a list of groups that have been granted at least one global permission.
## Example Usage
```
```hcl
data "bitbucketserver_global_permissions_groups" "all" { }
```
@@ -15,7 +15,7 @@ data "bitbucketserver_global_permissions_groups" "all" { }
Find any groups starting with `dev`.
```
```hcl
data "bitbucketserver_global_permissions_groups" "dev-groups" {
filter = "dev"
}

View File

@@ -1,5 +1,5 @@
---
id: data_global_permissions_users
id: data_bitbucketserver_global_permissions_users
title: bitbucketserver_global_permissions_users
---
@@ -7,7 +7,7 @@ Retrieve a list of users that have been granted at least one global permission.
## Example Usage
```
```hcl
data "bitbucketserver_global_permissions_users" "all" { }
```
@@ -15,7 +15,7 @@ data "bitbucketserver_global_permissions_users" "all" { }
Find any users starting with `malcolm`.
```
```hcl
data "bitbucketserver_global_permissions_users" "malcolms" {
filter = "malcolm"
}

View File

@@ -1,5 +1,5 @@
---
id: data_group_users
id: data_bitbucketserver_group_users
title: bitbucketserver_group_users
---
@@ -7,7 +7,7 @@ Retrieve a list of users for a specific group.
## Example Usage
```
```hcl
data "bitbucketserver_group_users" "stash-users" {
group = "stash-users"
}
@@ -17,7 +17,7 @@ data "bitbucketserver_group_users" "stash-users" {
Find any users starting with `malcolm`.
```
```hcl
data "bitbucketserver_group_users" "malcolms" {
group = "stash-users"
filter = "malcolm"

View File

@@ -1,5 +1,5 @@
---
id: data_groups
id: data_bitbucketserver_groups
title: bitbucketserver_groups
---
@@ -7,7 +7,7 @@ This data source allows you to retrieve a list of groups, optionally matching th
## Example Usage
```
```hcl
data "bitbucketserver_groups" "all" { }
```
@@ -15,7 +15,7 @@ data "bitbucketserver_groups" "all" { }
Find any groups starting with `dev`.
```
```hcl
data "bitbucketserver_groups" "dev-groups" {
filter = "dev"
}

View File

@@ -1,5 +1,5 @@
---
id: data_plugin
id: data_bitbucketserver_plugin
title: bitbucketserver_plugin
---
@@ -7,12 +7,14 @@ This data source allows you to retrieve installed plugin information and license
## Example Usage
```
```hcl
data "bitbucketserver_plugin" "my-plugin" {
key = "com.example.plugin-my-plugin"
}
```
## Argument Reference
* `key` - Unique key of the plugin.
## Attribute Reference

View File

@@ -1,5 +1,5 @@
---
id: data_project_permissions_groups
id: data_bitbucketserver_project_permissions_groups
title: bitbucketserver_project_permissions_groups
---
@@ -7,7 +7,7 @@ Retrieve a list of groups that have been granted at least one project level perm
## Example Usage
```
```hcl
data "bitbucketserver_project_permissions_groups" "test-groups" {
project = "TEST"
}
@@ -17,7 +17,7 @@ data "bitbucketserver_project_permissions_groups" "test-groups" {
Find project groups starting with `dev` with project permissions.
```
```hcl
data "bitbucketserver_project_permissions_groups" "dev-groups" {
project = "TEST"
filter = "dev"

View File

@@ -1,5 +1,5 @@
---
id: data_project_permissions_users
id: data_bitbucketserver_project_permissions_users
title: bitbucketserver_project_permissions_users
---
@@ -7,7 +7,7 @@ Retrieve a list of users that have been granted at least one permission for the
## Example Usage
```
```hcl
data "bitbucketserver_project_permissions_users" "test-users" {
project = "TEST"
}
@@ -17,7 +17,7 @@ data "bitbucketserver_project_permissions_users" "test-users" {
Find project users starting with `malcolm`.
```
```hcl
data "bitbucketserver_project_permissions_users" "malcolms" {
project = "TEST"
filter = "malcolm"

View File

@@ -1,5 +1,5 @@
---
id: data_repository_permissions_groups
id: data_bitbucketserver_repository_permissions_groups
title: bitbucketserver_repository_permissions_groups
---
@@ -7,7 +7,7 @@ Retrieve a list of groups that have been granted at least one repository level p
## Example Usage
```
```hcl
data "bitbucketserver_repository_permissions_groups" "my-repo-groups" {
project = "TEST"
repository = "my-repo"
@@ -18,7 +18,7 @@ data "bitbucketserver_repository_permissions_groups" "my-repo-groups" {
Find project groups starting with `dev` with project permissions.
```
```hcl
data "bitbucketserver_repository_permissions_groups" "my-repo-dev-groups" {
project = "TEST"
repository = "my-repo"

View File

@@ -1,5 +1,5 @@
---
id: data_repository_permissions_users
id: data_bitbucketserver_repository_permissions_users
title: bitbucketserver_repository_permissions_users
---
@@ -7,7 +7,7 @@ Retrieve a list of users that have been granted at least one permission for the
## Example Usage
```
```hcl
data "bitbucketserver_repository_permissions_users" "my-repo-users" {
project = "TEST"
repository = "my-repo"
@@ -18,7 +18,7 @@ data "bitbucketserver_repository_permissions_users" "my-repo-users" {
Find repository users starting with `malcolm`.
```
```hcl
data "bitbucketserver_repository_permissions_users" "my-repo-malcolms" {
project = "TEST"
repository = "my-repo"

View File

@@ -0,0 +1,28 @@
---
id: bitbucketserver_global_permissions_group
title: bitbucketserver_global_permissions_group
---
Set global permissions for a given group.
## Example Usage
```hcl
resource "bitbucketserver_global_permissions_group" "test" {
group = "stash-users"
permission = "ADMIN"
}
```
## Argument Reference
* `group` - Required. Name of the group permissions are for.
* `permission` - Required. The permission to grant. Available global permissions are: `LICENSED_USER`, `PROJECT_CREATE`, `ADMIN`, `SYS_ADMIN`
## Import
Import a group global permissions via the group name:
```
terraform import bitbucketserver_global_permissions_group.test my-group
```

View File

@@ -0,0 +1,28 @@
---
id: bitbucketserver_global_permissions_user
title: bitbucketserver_global_permissions_user
---
Set global permissions for a given user.
## Example Usage
```hcl
resource "bitbucketserver_global_permissions_user" "mreynolds" {
user = "mreynolds"
permission = "ADMIN"
}
```
## Argument Reference
* `user` - Required. Name of the user permissions are for.
* `permission` - Required. The permission to grant. Available global permissions are: `LICENSED_USER`, `PROJECT_CREATE`, `ADMIN`, `SYS_ADMIN`
## Import
Import a user global permissions via the user's name:
```
terraform import bitbucketserver_global_permissions_user.test mreynolds
```

View File

@@ -0,0 +1,26 @@
---
id: bitbucketserver_group
title: bitbucketserver_group
---
Create a Bitbucket group.
## Example Usage
```hcl
resource "bitbucketserver_group" "browncoats" {
name = "browncoats"
}
```
## Argument Reference
* `name` - Required. Group to create.
## Import
Import a group reference via the name.
```
terraform import bitbucketserver_group.test browncoats
```

View File

@@ -0,0 +1,38 @@
---
id: bitbucketserver_license
title: bitbucketserver_license
---
Set the license for the bitbucket server.
## Example Usage
```hcl
resource "bitbucketserver_license" "main" {
license = "AAACLg0ODAoPeNqNVEtv4jAQvudXRNpbp"
}
```
## Argument Reference
* `license` - Required. License to apply.
## Attribute Reference
* `creation_date` - License creation date.
* `purchase_date` - License purchase date.
* `expiry_date` - Expiry date of the license.
* `maintenance_expiry_date` - Expiry date of the maintenance period.
* `grace_period_end_date` - Grace period beyond expiry date.
* `maximum_users` - Maximum number of users for license.
* `unlimited_users` - Boolean flag if this is an unlimited user license.
* `server_id` - Server ID.
* `support_entitlement_number` - Entitlement number for support requests.
## Import
Import the license details:
```
terraform import bitbucketserver_license.main license
```

View File

@@ -0,0 +1,36 @@
---
id: bitbucketserver_mail_server
title: bitbucketserver_mail_server
---
Setup mail server configuration.
## Example Usage
```hcl
resource "bitbucketserver_mail_server" "mail" {
hostname = "mail.example.com"
port = 465
protocol = "SMTPS"
sender_address = "bitbucket@example.com"
}
```
## Argument Reference
* `hostname` - Required. Hostname of the mail server.
* `port` - Required. Port number of the mail server. Typically port 25 or 587 for SMTP and 465 for SMTPS.
* `sender_address` - Required. Email address for notification emails.
* `protocol` - Optional. SMTP or SMTPS supported. Default `SMTP`
* `use_start_tls` - Optional. Use SSL/TLS if available. Default `true`
* `require_start_tls` - Optional. Require SSL to be used. Default `false`
* `username` - Optional. User to connect with.
* `password` - Optional. User to connect with.
## Import
Import the existing mail server configuration with the hostname:
```
terraform import bitbucketserver_mail_server.mail mail.example.com
```

View File

@@ -0,0 +1,60 @@
---
id: bitbucketserver_plugin
title: bitbucketserver_plugin
---
Install plugins, manage enabled state and set license details.
## Example Usage
```hcl
resource "bitbucketserver_plugin" "myplugin" {
key = "com.example-my-plugin"
version = "1.2.3"
license = "ABCDEF"
}
```
## Argument Reference
* `key` - Required. Unique key of the plugin.
* `version` - Required. Version to install.
* `license` - Optional. License to apply to the plugin.
* `enabled` - Optional, default `true`. Flag to enable/disable the plugin.
## Attribute Reference
* `enabled_by_default` - Set to `true` if the plugin is enabled by default (for system plugins).
* `name` - Name of the plugin.
* `description` - Plugin description.
* `user_installed` - Set to `true` if this is a user installed plugin vs a system bundled plugin.
* `optional` - Set to `true` if this is an optional plugin.
* `vendor.name` - Name of the vendor.
* `vendor.link` - Vendor homepage.
* `vendor.marketplace_link` - Plugin marketplace link.
* `applied_license.0.valid` - Is the license valid. true/false.
* `applied_license.0.evaluation` - Is the license an evaluation. true/false.
* `applied_license.0.nearly_expired` - Is the license nearly expired. true/false.
* `applied_license.0.maintenance_expiry_date` - Date of maintenance expiry.
* `applied_license.0.maintenance_expired` - Is the maintenance expired. true/false.
* `applied_license.0.license_type` - Type of license.
* `applied_license.0.expiry_date` - Expiry date of the license.
* `applied_license.0.raw_license` - The raw license information.
* `applied_license.0.renewable` - Is the license renewabl. true/false.
* `applied_license.0.organization_name` - Name of the organization the license is for.
* `applied_license.0.enterprise` - Is the license for enterprise. true/false.
* `applied_license.0.data_center` - Is the license for data center. true/false.
* `applied_license.0.subscription` - Is the license a subscription. true/false.
* `applied_license.0.active` - Is the license active. true/false.
* `applied_license.0.auto_renewal` - Is the license renewed automatically. true/false.
* `applied_license.0.upgradable` - Is the license able to be upgraded. true/false.
* `applied_license.0.crossgradeable` - Can the license be crossgraded. true/false.
* `applied_license.0.purchase_past_server_cutoff_date` - The purchase date past the server cutoff date. true/false.
## Import
Import a plugin reference via the key:
```
terraform import bitbucketserver_plugin.myplugin com.example-my-plugin
```

View File

@@ -0,0 +1,33 @@
---
id: bitbucketserver_project
title: bitbucketserver_project
---
Create a Bitbucket Project to hold repositories.
## Example Usage
```hcl
resource "bitbucketserver_project" "test" {
key = "TEST"
name = "test-01"
description = "Test project"
avatar = "data:(content type, e.g. image/png);base64,(data)"
}
```
## Argument Reference
* `key` - Required. Project key to set.
* `name` - Required. Name of the project.
* `description` - Optional. Description of the project.
* `avatar` - Optional. Avatar to use containing base64-encoded image data. Format: `data:(content type, e.g. image/png);base64,(data)`
* `public` - Optional. Flag to make the project public or private. Default `false`.
## Import
Import a project reference via the key:
```
terraform import bitbucketserver_project.test TEST
```

View File

@@ -0,0 +1,34 @@
---
id: bitbucketserver_project_permissions_group
title: bitbucketserver_project_permissions_group
---
Set project level permissions for a given group.
## Example Usage
```hcl
resource "bitbucketserver_project_permissions_group" "my-proj" {
project = "MYPROJ"
group = "stash-users"
permission = "PROJECT_WRITE"
}
```
## Argument Reference
* `project` - Required. Project key to set permissions for.
* `group` - Required. Name of the group permissions are for.
* `permission` - Required. The permission to grant. Available project permissions are:
* `PROJECT_READ`
* `PROJECT_WRITE`
* `PROJECT_ADMIN`
## Import
Import a group project level permissions via the project & group names:
```
terraform import bitbucketserver_project_permissions_group.test MYPROJ/stash-users
```

View File

@@ -0,0 +1,34 @@
---
id: bitbucketserver_project_permissions_user
title: bitbucketserver_project_permissions_user
---
Set project permissions for a given user.
## Example Usage
```hcl
resource "bitbucketserver_project_permissions_user" "mreynolds" {
project = "MYPROJ"
user = "mreynolds"
permission = "PROJECT_WRITE"
}
```
## Argument Reference
* `project` - Required. Name of the project to assign permissions to.
* `user` - Required. Name of the user permissions are for.
* `permission` - Required. The permission to grant. Available project permissions are:
* `PROJECT_READ`
* `PROJECT_WRITE`
* `PROJECT_ADMIN`
## Import
Import a user project permissions via the project and user name:
```
terraform import bitbucketserver_global_permissions_user.test MYPROJ/mreynolds
```

View File

@@ -0,0 +1,40 @@
---
id: bitbucketserver_repository
title: bitbucketserver_repository
---
Create a Bitbucket Repository.
## Example Usage
```hcl
resource "bitbucketserver_repository" "test" {
project = "MYPROJ"
name = "test-01"
description = "Test repository"
}
```
## Argument Reference
* `project` - Required. Name of the project to create the repository in.
* `name` - Required. Name of the repository.
* `slug` - Optional. Slug to use for the repository. Calculated if not defined.
* `description` - Optional. Description of the repository.
* `forkable` - Optional. Enable/disable forks of this repository. Default `true`
* `public` - Optional. Determine if this repository is public. Default `false`
## Attribute Reference
Additional to the above, the following attributes are emitted:
* `clone_ssh` - URL for SSH cloning of the repository.
* `clone_https` - URL for HTTPS cloning of the repository.
## Import
Import a repository using the project key and repository slug:
```
terraform import bitbucketserver_repository.test MYPROJ/test-01
```

View File

@@ -0,0 +1,36 @@
---
id: bitbucketserver_repository_permissions_group
title: bitbucketserver_repository_permissions_group
---
Set repository level permissions for a given group.
## Example Usage
```hcl
resource "bitbucketserver_repository_permissions_group" "my-repo" {
project = "MYPROJ"
repository = "repo1"
group = "stash-users"
permission = "REPO_WRITE"
}
```
## Argument Reference
* `project` - Required. Project key the repository is contained within.
* `repository` - Required. Repository slug to set the permissions for.
* `group` - Required. Name of the group permissions are for.
* `permission` - Required. The permission to grant. Available permissions are:
* `REPO_READ`
* `REPO_WRITE`
* `REPO_ADMIN`
## Import
Import a group project level permissions via the project & group names:
```
terraform import bitbucketserver_repository_permissions_group.test MYPROJ/repo1/stash-users
```

View File

@@ -0,0 +1,36 @@
---
id: bitbucketserver_repository_permissions_user
title: bitbucketserver_repository_permissions_user
---
Set repository permissions for a given user.
## Example Usage
```hcl
resource "bitbucketserver_repository_permissions_user" "mreynolds-repo" {
project = "MYPROJ"
repository = "repo1"
user = "mreynolds"
permission = "REPO_WRITE"
}
```
## Argument Reference
* `project` - Required. Project key the repository is contained within.
* `repository` - Required. Repository slug to set the permissions for.
* `user` - Required. Name of the user permissions are for.
* `permission` - Required. The permission to grant. Available project permissions are:
* `REPO_READ`
* `REPO_WRITE`
* `REPO_ADMIN`
## Import
Import a group project level permissions via the project & group names:
```
terraform import bitbucketserver_repository_permissions_user.test MYPROJ/repo1/mreynolds
```

View File

@@ -0,0 +1,35 @@
---
id: bitbucketserver_user
title: bitbucketserver_user
---
Create a Bitbucket user.
## Example Usage
```hcl
resource "bitbucketserver_user" "admin" {
name = "mreynolds"
display_name = "Malcolm Reynolds"
email_address = "browncoat@example.com"
}
```
## Argument Reference
* `name` - Required. Username of the user.
* `display_name` - Required. User's name to display.
* `email_address` - Required. Email address of user.
* `password_length` - Optional. The length of the generated password on resource creation. Only applies on resource creation. Default `20`.
## Attribute Reference
* `initial_password` - The generated user password. Only available if password was handled on Terraform resource creation, not import.
## Import
Import a user reference via the user's name.
```
terraform import bitbucketserver_user.test mreynolds
```

View File

@@ -0,0 +1,28 @@
---
id: bitbucketserver_user_group
title: bitbucketserver_user_group
---
Assign a User to an existing Bitbucket Group.
## Example Usage
```hcl
resource "bitbucketserver_user_group" "browncoat" {
user = "mreynolds"
group = "browncoats"
}
```
## Argument Reference
* `user` - Required. User to assign group to.
* `group` - Required. Group to assign to the user.
## Import
Import a user group reference via the user and group keys:
```
terraform import bitbucketserver_user_group.browncoat mreynolds/browncoats
```

View File

@@ -4,38 +4,80 @@
"next": "Next",
"previous": "Previous",
"docs": {
"data_application_properties": {
"data_bitbucketserver_application_properties": {
"title": "bitbucketserver_application_properties"
},
"data_global_permissions_groups": {
"data_bitbucketserver_global_permissions_groups": {
"title": "bitbucketserver_global_permissions_groups"
},
"data_global_permissions_users": {
"data_bitbucketserver_global_permissions_users": {
"title": "bitbucketserver_global_permissions_users"
},
"data_group_users": {
"data_bitbucketserver_group_users": {
"title": "bitbucketserver_group_users"
},
"data_groups": {
"data_bitbucketserver_groups": {
"title": "bitbucketserver_groups"
},
"data_plugin": {
"data_bitbucketserver_plugin": {
"title": "bitbucketserver_plugin"
},
"data_project_permissions_groups": {
"data_bitbucketserver_project_permissions_groups": {
"title": "bitbucketserver_project_permissions_groups"
},
"data_project_permissions_users": {
"data_bitbucketserver_project_permissions_users": {
"title": "bitbucketserver_project_permissions_users"
},
"data_repository_permissions_groups": {
"data_bitbucketserver_repository_permissions_groups": {
"title": "bitbucketserver_repository_permissions_groups"
},
"data_repository_permissions_users": {
"data_bitbucketserver_repository_permissions_users": {
"title": "bitbucketserver_repository_permissions_users"
},
"provider": {
"title": "Getting Started"
},
"bitbucketserver_global_permissions_group": {
"title": "bitbucketserver_global_permissions_group"
},
"bitbucketserver_global_permissions_user": {
"title": "bitbucketserver_global_permissions_user"
},
"bitbucketserver_group": {
"title": "bitbucketserver_group"
},
"bitbucketserver_license": {
"title": "bitbucketserver_license"
},
"bitbucketserver_mail_server": {
"title": "bitbucketserver_mail_server"
},
"bitbucketserver_plugin": {
"title": "bitbucketserver_plugin"
},
"bitbucketserver_project_permissions_group": {
"title": "bitbucketserver_project_permissions_group"
},
"bitbucketserver_project_permissions_user": {
"title": "bitbucketserver_project_permissions_user"
},
"bitbucketserver_project": {
"title": "bitbucketserver_project"
},
"bitbucketserver_repository_permissions_group": {
"title": "bitbucketserver_repository_permissions_group"
},
"bitbucketserver_repository_permissions_user": {
"title": "bitbucketserver_repository_permissions_user"
},
"bitbucketserver_repository": {
"title": "bitbucketserver_repository"
},
"bitbucketserver_user_group": {
"title": "bitbucketserver_user_group"
},
"bitbucketserver_user": {
"title": "bitbucketserver_user"
}
},
"links": {},

View File

@@ -4,19 +4,32 @@
"provider"
],
"Data Sources": [
"data_application_properties",
"data_global_permissions_groups",
"data_global_permissions_users",
"data_group_users",
"data_groups",
"data_plugin",
"data_project_permissions_groups",
"data_project_permissions_users",
"data_repository_permissions_groups",
"data_repository_permissions_users"
"data_bitbucketserver_application_properties",
"data_bitbucketserver_global_permissions_groups",
"data_bitbucketserver_global_permissions_users",
"data_bitbucketserver_group_users",
"data_bitbucketserver_groups",
"data_bitbucketserver_plugin",
"data_bitbucketserver_project_permissions_groups",
"data_bitbucketserver_project_permissions_users",
"data_bitbucketserver_repository_permissions_groups",
"data_bitbucketserver_repository_permissions_users"
],
"Resources": [
"bitbucketserver_global_permissions_group",
"bitbucketserver_global_permissions_user",
"bitbucketserver_group",
"bitbucketserver_license",
"bitbucketserver_mail_server",
"bitbucketserver_plugin",
"bitbucketserver_project",
"bitbucketserver_project_permissions_group",
"bitbucketserver_project_permissions_user",
"bitbucketserver_repository",
"bitbucketserver_repository_permissions_group",
"bitbucketserver_repository_permissions_user",
"bitbucketserver_user",
"bitbucketserver_user_group"
]
}
}

View File

@@ -29,6 +29,8 @@ const siteConfig = {
secondaryColor: '#66246c',
},
usePrism: ['yaml', 'js', 'bash', 'sh', 'hcl'],
// This copyright info is used in /core/Footer.js and blog RSS/Atom feeds.
copyright: `Copyright © ${new Date().getFullYear()} Gavin Bunney`,