terraform/website/docs/language/settings/backends/artifactory.html.md

60 lines
1.6 KiB
Markdown
Raw Normal View History

2017-02-15 19:47:30 +01:00
---
layout: "language"
2017-02-15 21:19:38 +01:00
page_title: "Backend Type: artifactory"
2017-02-15 19:47:30 +01:00
sidebar_current: "docs-backends-types-standard-artifactory"
description: |-
2017-02-15 21:19:38 +01:00
Terraform can store state in artifactory.
2017-02-15 19:47:30 +01:00
---
# artifactory
**Kind: Standard (with no locking)**
2017-02-15 21:19:38 +01:00
Stores the state as an artifact in a given repository in
[Artifactory](https://www.jfrog.com/artifactory/).
2017-02-15 19:47:30 +01:00
Generic HTTP repositories are supported, and state from different
configurations may be kept at different subpaths within the repository.
-> **Note:** The URL must include the path to the Artifactory installation.
It will likely end in `/artifactory`.
2017-02-15 21:19:38 +01:00
## Example Configuration
2017-02-15 19:47:30 +01:00
```hcl
2017-02-15 21:19:38 +01:00
terraform {
backend "artifactory" {
username = "SheldonCooper"
password = "AmyFarrahFowler"
url = "https://custom.artifactoryonline.com/artifactory"
repo = "foo"
subpath = "terraform-bar"
2017-02-15 21:19:38 +01:00
}
}
2017-02-15 19:47:30 +01:00
```
## Data Source Configuration
2017-02-15 19:47:30 +01:00
```hcl
2017-02-15 19:47:30 +01:00
data "terraform_remote_state" "foo" {
backend = "artifactory"
config = {
username = "SheldonCooper"
password = "AmyFarrahFowler"
url = "https://custom.artifactoryonline.com/artifactory"
repo = "foo"
subpath = "terraform-bar"
}
2017-02-15 19:47:30 +01:00
}
```
## Configuration variables
The following configuration options / environment variables are supported:
* `username` / `ARTIFACTORY_USERNAME` (Required) - The username
* `password` / `ARTIFACTORY_PASSWORD` (Required) - The password
* `url` / `ARTIFACTORY_URL` (Required) - The URL. Note that this is the base url to artifactory not the full repo and subpath.
* `repo` (Required) - The repository name
* `subpath` (Required) - Path within the repository