Files
artifactapi/docs/ansible/virtual.md
T
unkin-agent 4b202b1852
ci/woodpecker/pr/pre-commit Pipeline was successful
ci/woodpecker/pr/build Pipeline was successful
ci/woodpecker/pr/test Pipeline was successful
Add ansible virtual repositories
2026-10-18 03:45:30 +11:00

1.0 KiB

ansible virtual

An ansible virtual serves one Galaxy v3 API over local and remote ansible members: ansible-galaxy collection install works against /api/v1/virtual/<name>/.

  • versions/ concatenates member version lists in member order; on a duplicate version the earlier member wins. Pagination (limit up to 100, offset) runs over the merged list.
  • versions/<version>/ is the owning member's detail with href and download_url pointing at the virtual; the download 302s to that member.
  • A member error fails the request with 502; a member without the collection is skipped. Merges are cached for 60s.
resource "artifactapi_virtual" "ansible" {
  name         = "ansible"
  package_type = "ansible"
  members      = [artifactapi_local_ansible.internal.name, artifactapi_remote_ansible.galaxy.name]
}
ansible-galaxy collection install unkin.hello community.general \
  --server https://artifactapi.example.com/api/v1/virtual/ansible/

Publish to the local member directly; the virtual is read-only.