/terraform-provider-artifactory

Terraform provider to manage Artifactory

Primary LanguageGoApache License 2.0Apache-2.0

Terraform Provider Artifactory

Actions Status Go Report Card Join the chat at https://gitter.im/jfrog/terraform

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:

  • Terraform 0.11
  • Go 1.11+ (to build the provider plugin)

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).

Sign the CLA

License

Copyright (c) 2019 Atlassian and others.
Copyright (c) 2020 JFrog.

Apache 2.0 licensed, see LICENSE file.