artifactapi/docs/gems/virtual.md

gems virtual

A gems virtual serves one RubyGems source over local and remote gems members: gem install and bundle install work against /api/v1/virtual/<name>/.

• info/<gem> is the union of member lines; on a duplicate version-platform the earlier member wins. A gem only one member has is served verbatim.
• versions regenerates the line (and md5) of every gem several members list from its merged info; other gems' lines pass through. names is the union.
• gems/*.gem and quick/Marshal.4.8/*.gemspec.rz 302 to the member whose info line won.
• A member error fails the request with 502; a member without the gem is skipped. Merges are cached for 60s.

resource "artifactapi_virtual" "gems" {
  name         = "gems"
  package_type = "gems"
  members      = [artifactapi_local_gems.internal.name, artifactapi_remote_gems.rubygems.name]
}

# Gemfile
source "https://artifactapi.example.com/api/v1/virtual/gems/"

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