2.7 KiB
2.7 KiB
artifactapi_remote_vcs
Caches GitHub (base_url = "https://github.com") or Gitea source archives and release assets. Tag, commit and release-download paths are immutable; branch archives redirect to the archive of the branch's current commit, re-resolved after mutable_ttl. Paths: vcs remote.
Common Attributes
| Attribute | Required | Default | Description |
|---|---|---|---|
name |
Yes | Unique name (forces replacement on change) | |
base_url |
Yes | Upstream repository URL | |
description |
No | "" |
Human-readable description |
username |
No | "" |
Upstream auth username (sensitive) |
password |
No | "" |
Upstream auth password (sensitive) |
immutable_ttl |
No | 0 |
TTL in seconds for immutable artifacts (0 = cache forever) |
mutable_ttl |
No | 3600 |
TTL in seconds for mutable artifacts |
check_mutable |
No | true |
Enable conditional revalidation for mutable artifacts |
patterns |
No | Allowlist of path patterns to proxy (empty = all) | |
blocklist |
No | Paths to always deny (checked before patterns) | |
mutable_patterns |
No | Override: treat matching paths as mutable | |
immutable_patterns |
No | Override: treat matching paths as immutable | |
quarantine_enabled |
No | false |
Enable quarantine for new artifacts |
quarantine_days |
No | 3 |
Days to quarantine new artifacts |
stale_on_error |
No | true |
Serve stale cache when upstream is unreachable |
upstream_dial_timeout |
No | 0 |
Upstream TCP connect timeout in seconds (0 = server default) |
upstream_tls_timeout |
No | 0 |
Upstream TLS handshake timeout in seconds (0 = server default) |
upstream_response_header_timeout |
No | 0 |
Upstream response-header timeout in seconds (0 = server default) |
Example
See examples/resources/artifactapi_remote_vcs/main.tf.