29 lines
1.0 KiB
Markdown
29 lines
1.0 KiB
Markdown
# `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.
|
|
|
|
```hcl
|
|
resource "artifactapi_virtual" "ansible" {
|
|
name = "ansible"
|
|
package_type = "ansible"
|
|
members = [artifactapi_local_ansible.internal.name, artifactapi_remote_ansible.galaxy.name]
|
|
}
|
|
```
|
|
|
|
```bash
|
|
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.
|