Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To proxy an external Gem repository, like RubyGems, simply create a new Proxy Repository as documented in Managing Repositories. The Provider has to be set to Rubygems. The Remote Storage Location has to be set to the URL of the remote repository you want to proxy. The official URL for Rubygems.org is

...

This main configuration for proxying RubyGems is visible in Figure 17.1, “Proxy Gem Repository Configuration for RubyGems”. Further configuration details are available in Managing Repositories.

Figure 17.1. Proxy Gem Repository Configuration for RubyGems

...

To create a hosted Gem repository, simply create a new Hosted Repository and set the Provider to Rubygems as documented in Managing Repositories. A sample configuration for an internal hosted Gem repository is displayed in Figure 17.2, “Example Configuration for a Private Gem Repository”.

...

A scheduled task can be used to rebuild the metadata of a hosted gem repository and can be configured as documented in Managing Scheduled Tasks.

Grouping Gem Repositories

A repository group is the recommended way to expose all your Gem repositories to your users, without needing any further client side configuration after initial setup. A repository group allows you to expose the aggregated content of multiple proxy and hosted Gem repositories with one URL to gem and other tools. This is possible for Gem repositories by creating a new Repository Group with the Provider set to Rubygems as documented in Managing Repository Groups.

A typical, useful example would be to group the proxy repository that proxies the RubyGems repository, a hosted Gem repository with internal software gems, and another hosted Gem repository with third-party gems. The configuration for such a setup is displayed in Figure 17.3, “A Gem Repository Group Combining the RubyGems Proxy Repository and Two Private Gem Repositories”.

...