terraform-provider-artifactapi

Terraform provider for managing ArtifactAPI remotes and virtual repositories.

Requirements

• Go >= 1.23
• Terraform >= 1.0

Building

make build

Installation

Install the provider to your local Terraform plugin directory:

make install

This places the binary at ~/.terraform.d/plugins/git.unkin.net/unkin/artifactapi/<version>/<os_arch>/.

A make install build is referenced with source = "git.unkin.net/unkin/artifactapi" (the provider address, matching that path); the artifactapi.example.com/terraform-unkin/artifactapi source below is for installing from an artifactapi registry.

Provider Configuration

terraform {
  required_providers {
    artifactapi = {
      source  = "artifactapi.example.com/terraform-unkin/artifactapi"
      version = "0.0.1"
    }
  }
}

provider "artifactapi" {
  endpoint = "https://artifactapi.example.com"
  token    = var.artifactapi_token # optional
}

Attribute	Required	Description
endpoint	Yes	ArtifactAPI server endpoint URL
token	No	Bearer token sent as Authorization header; falls back to ARTIFACTAPI_TOKEN

Resources and Data Sources

Each resource is documented in docs/resources/ and each data source in docs/data-sources/, with a matching example under examples/.

Import

Resources can be imported by name:

terraform import artifactapi_remote_docker.dockerhub dockerhub
terraform import artifactapi_virtual.helm helm

Development

make build    # Build the provider binary
make install  # Install to local plugin directory
make test     # Run tests
make lint     # Run go vet
make fmt      # Format code
make clean    # Remove binary