Terraform Provider Artifactory

Releases

Current provider major release: 6.x

See CHANGELOG.md for full details

Recent Releases

### 6.6.0

IMPROVEMENTS:

• resource/artifactory_group: Add external_id attribute to support Azure AD group. PR: #437. Issue #429

6.5.3

IMPROVEMENTS:

• reorganizing documentation, adding missing documentation links, fixing formatting. No changes in the functionality. PR: GH-435. Issues #422 and #398

6.5.2

IMPROVEMENTS:

• resource/artifactory_artifact_webhook: Added 'cached' event type for Artifact webhook. PR: GH-430.

6.5.1

BUG FIXES:

• provider: Setting the right default value for 'access_token' attribute. PR: GH-426. Issue #425

6.5.0

IMPROVEMENTS:

• Resources added for Pub package type of Local Repository
• Resources added for Pub package type of Remote Repository
• Resources added for Pub package type of Virtual Repository
• Acceptance test case enhanced with Client TLS Certificate

PR: GH-421

Quick Start

Create a new Terraform file with artifactory resources. Also see sample.tf:

HCL Example

# Required for Terraform 0.13 and up (https://www.terraform.io/upgrade-guides/0-13.html)
terraform {
  required_providers {
    artifactory = {
      source  = "registry.terraform.io/jfrog/artifactory"
      version = "6.6.1"
    }
  }
}

provider "artifactory" {
  // supply ARTIFACTORY_USERNAME, ARTIFACTORY_ACCESS_TOKEN, and ARTIFACTORY_URL as env vars
}

resource "artifactory_local_pypi_repository" "pypi-local" {
  key         = "pypi-local"
  description = "Repo created by Terraform Provider Artifactory"
}

resource "artifactory_artifact_webhook" "artifact-webhook" {
  key         = "artifact-webhook"
  event_types = ["deployed", "deleted", "moved", "copied"]
  criteria {
    any_local        = true
    any_remote       = false
    repo_keys        = [artifactory_local_pypi_repository.pypi-local.key]
    include_patterns = ["foo/**"]
    exclude_patterns = ["bar/**"]
  }
  url    = "http://tempurl.org/webhook"
  secret = "some-secret"
  proxy  = "proxy-key"

  custom_http_headers = {
    header-1 = "value-1"
    header-2 = "value-2"
  }

  depends_on = [artifactory_local_pypi_repository.pypi-local]
}

Initialize Terrform:

$ terraform init

Plan (or Apply):

$ terraform plan

Documentation

To use this provider in your Terraform module, follow the documentation on Terraform Registry.

License requirements

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 requires 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

Versioning

In general, this project follows Terraform Versioning Specification as closely as we can for tagging releases of the package.

Contributors

See the contribution guide.

License

Copyright (c) 2022 JFrog.

Apache 2.0 licensed, see LICENSE file.