55 lines
1.6 KiB
Markdown
55 lines
1.6 KiB
Markdown
|
---
|
||
|
|
layout: "remotestate"
|
||
|
|
page_title: "Remote State Backend: artifactory"
|
||
|
|
sidebar_current: "docs-state-remote-artifactory"
|
||
|
|
description: |-
|
||
|
|
Terraform can store the state remotely, making it easier to version and work with in a team.
|
||
|
|
---
|
||
|
|
|
||
|
|
# artifactory
|
||
|
|
|
||
|
|
Stores the state as an artifact in a given repository in [Artifactory](https://www.jfrog.com/artifactory/).
|
||
|
|
|
||
|
|
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`.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
terraform remote config \
|
||
|
|
-backend=artifactory \
|
||
|
|
-backend-config="username=SheldonCooper" \
|
||
|
|
-backend-config="password=AmyFarrahFowler" \
|
||
|
|
-backend-config="url=https://custom.artifactoryonline.com/artifactory" \
|
||
|
|
-backend-config="repo=foo" \
|
||
|
|
-backend-config="subpath=terraform-bar"
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example Referencing
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "terraform_remote_state" "foo" {
|
||
|
|
backend = "artifactory"
|
||
|
|
config {
|
||
|
|
username = "SheldonCooper"
|
||
|
|
password = "AmyFarrahFowler"
|
||
|
|
url = "https://custom.artifactoryonline.com/artifactory"
|
||
|
|
repo = "foo"
|
||
|
|
subpath = "terraform-bar"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## 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
|