Terraform Provider Artifactory
To use this provider in your Terraform module, follow the documentation here.
Important note:
This provider requires access to Artifactory APIs, which are only available in the licensed pro and enterprise editions.
You can determine which license you have by accessing the following URL
${host}/artifactory/api/system/licenses/
You can either access it via api, or web browser - it does require admin level credentials, but it's one of the few
APIs that will work without a license (side node: you can also install your license here with a POST
)
curl -sL ${host}/artifactory/api/system/licenses/ | jq .
{
"type" : "Enterprise Plus Trial",
"validThrough" : "Jan 29, 2022",
"licensedTo" : "JFrog Ltd"
}
The following 3 license types (jq .type
) do NOT support APIs:
- Community Edition for C/C++
- JCR Edition
- OSS
Build the Provider
If you're building the provider, follow the instructions to install it as a plugin.
After placing it into your plugins directory, run terraform init
to initialize it.
Requirements:
Clone repository to: $GOPATH/src/github.com/jfrog/terraform-provider-artifactory
Enter the provider directory and build the provider
cd $GOPATH/src/github.com/jfrog/terraform-provider-artifactory
go build
To install the provider
cd $GOPATH/src/github.com/jfrog/terraform-provider-artifactory
go install
Versioning
In general, this project follows semver as closely as we can for tagging releases of the package. We've adopted the following versioning policy:
- We increment the major version with any incompatible change to functionality, including changes to the exported Go API surface or behavior of the API.
- We increment the minor version with any backwards-compatible changes to functionality.
- We increment the patch version with any backwards-compatible bug fixes.
Contributors
Pull requests, issues and comments are welcomed. For pull requests:
- Add tests for new features and bug fixes
- Follow the existing style
- Separate unrelated changes into multiple pull requests
See the existing issues for things to start contributing.
For bigger changes, make sure you start a discussion first by creating an issue and explaining the intended change.
JFrog requires contributors to sign a Contributor License Agreement, known as a CLA. This serves as a record stating that the contributor is entitled to contribute the code/documentation/translation to the project and is willing to have it used in distributions and derivative works (or is willing to transfer ownership).
License
Copyright (c) 2019 Atlassian and others.
Copyright (c) 2020 JFrog.
Apache 2.0 licensed, see LICENSE file.