{"id":18909153,"url":"https://github.com/jruby/rubygems-servlets","last_synced_at":"2025-04-15T06:14:10.588Z","repository":{"id":17059478,"uuid":"19824118","full_name":"jruby/rubygems-servlets","owner":"jruby","description":"webapp which hosts rubygems or a proxy to rubygems. delivers gem maven artifacts as well","archived":false,"fork":false,"pushed_at":"2016-11-12T17:24:46.000Z","size":106,"stargazers_count":9,"open_issues_count":9,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-15T06:14:03.692Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jruby.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-05-15T15:12:16.000Z","updated_at":"2020-01-14T14:20:53.000Z","dependencies_parsed_at":"2022-07-12T18:23:12.380Z","dependency_job_id":null,"html_url":"https://github.com/jruby/rubygems-servlets","commit_stats":null,"previous_names":["torquebox/rubygems-servlets"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jruby%2Frubygems-servlets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jruby%2Frubygems-servlets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jruby%2Frubygems-servlets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jruby%2Frubygems-servlets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jruby","download_url":"https://codeload.github.com/jruby/rubygems-servlets/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249016639,"owners_count":21198833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T09:31:18.983Z","updated_at":"2025-04-15T06:14:10.573Z","avatar_url":"https://github.com/jruby.png","language":"Java","readme":"rubygems-servlets\n=================\n\n[![Build Status](https://secure.travis-ci.org/torquebox/rubygems-servlets.png)](http://travis-ci.org/torquebox/rubygems-servlets)\n\nwebapp which hosts rubygems or a proxy to rubygems. delivers gem maven artifacts as well. the proxy can be configured to be caching proxy or non-caching proxy\n\nbuild\n--\n\nthe regular webapp with hosted and (caching-)proxy can be built with\n\n     mvn package\n\nor just run it in place with\n\n     mvn jetty:run\n\nwhere the hosted rubygems are located under \u003chttp://localhost:8989/hosted\u003e and the proxy with \u003chttps://rubygems.org\u003e as source is reachable under \u003chttp://localhost:8989/caching\u003e or \u003chttp://localhost:8989/proxy\u003e. and the  \u003chttp://localhost:8989/merge\u003e will combine all three to on rubygems repository.\n\nexecutable standalone\n---\n\nyou also can start the war like this (using embedded jetty):\n\n     mvn package -Pexecutable\n     java -jar target/rubygems.war\n\nand adjust the \u003crubygems.properties\u003e to your liking.\n\nusage\n--\n\nadd them to your gem command\n\n* ```gem sources add \u003chttp://localhost:8989/hosted\u003e```\n* ```gem sources add \u003chttp://localhost:8989/caching\u003e```\n* ```gem sources add \u003chttp://localhost:8989/proxy\u003e```\n* ```gem sources add \u003chttp://localhost:8989/merged\u003e```\n\nor use the (caching-)proxy with bundler (example only for https://rubygems.org)\n\n* ```bundler config mirror.https://rubygems.org http://localhost:8989/proxy```\n* ```bundler config mirror.https://rubygems.org http://localhost:8989/caching```\n* ```bundler config mirror.https://rubygems.org http://localhost:8989/merged```\n\nthe Gem-Artifacts are accessible via\n\n*  \u003chttp://localhost:8989/hosted/maven/releases\u003e\n*  \u003chttp://localhost:8989/hosted/maven/prereleases\u003e\n*  \u003chttp://localhost:8989/caching/maven/releases\u003e\n*  \u003chttp://localhost:8989/caching/maven/prereleases\u003e\n*  \u003chttp://localhost:8989/proxy/maven/releases\u003e\n*  \u003chttp://localhost:8989/proxy/maven/prereleases\u003e\n*  \u003chttp://localhost:8989/merged/maven/releases\u003e\n*  \u003chttp://localhost:8989/merged/maven/prereleases\u003e\n\nyou need a mirror declaration \u003chttp://rubygems-proxy.torquebox.org/releases\u003e and \u003chttp://rubygems-proxy.torquebox.org/prereleases\u003e in your settings.xml\n\n    \u003csettings\u003e\n      \u003cmirrors\u003e\n        \u003cmirror\u003e\n          \u003cid\u003egems\u003c/id\u003e\n          \u003cname\u003eRubygems\u003c/name\u003e\n          \u003curl\u003ehttp://localhost:8989/caching/maven/releases\u003c/url\u003e\n          \u003cmirrorOf\u003erubygems-releases\u003c/mirrorOf\u003e\n        \u003c/mirror\u003e\n        \u003cmirror\u003e\n          \u003cid\u003epregems\u003c/id\u003e\n          \u003cname\u003eRubygems Prereleases\u003c/name\u003e\n          \u003curl\u003ehttp://localhost:8989/caching/maven/prereleases\u003c/url\u003e\n          \u003cmirrorOf\u003erubygems-prereleases\u003c/mirrorOf\u003e\n        \u003c/mirror\u003e\n\nsince some old gem-artifacts use the those repositories (old in sense they originally came from rubygems-proxy.torquebox.org)\n\nfor more details about Gem-Artifacts see \u003chttps://github.com/sonatype/nexus-ruby-support/wiki/Gem-Artifacts\u003e. for a solution with access control, more advanced proxy features and merging (group) to repositories see \u003chttps://github.com/sonatype/nexus-ruby-support\u003e.\n\n\nhosted\n---\n\nthe underlying library nexus-ruby-tools can handle `gem push my-1.0.0.gem` but somehow I have not deciphered how to use rubygems.org and a local repo without manually editing the config files.\n\nthe easiest way is to use the `nexus` gem which was tailor made for the nexus-ruby-tools.\n\n\n```\ngem install nexus\n``\n\nthen you can upload your gem with\n\n```\ngem nexus my-1.0.0.gem\n```\n\nit will prompt for the url which is http://localhost:8989/hosted from above. empty username and password will finally push the gem. since the username and passoword was empty it will be prompted again.\n\n\nnon-caching proxy\n---\n\nthis proxy configuration does not cache the gem-files itself but instead sends a redirect to \u003crubygems.org\u003e. all other files are cached the same way as the caching proxy:\n\n    mvn jetty:run -P proxy\n\nwith url \u003chttp://localhost:8989/proxy\u003e\n\nrubygems-proxy.torquebox.org (not yet installed)\n--\n\nthe webapp for this rubygems-proxy is under the profile **legacy**\n\n     mvn clean package -Plegacy\n\nwhich is just a proxy (mvn jetty:run -Plegacy)\n\n*  \u003chttp://localhost:8989/releases\u003e\n*  \u003chttp://localhost:8989/prereleases\u003e\n\n\ntests\n====\n\nsome integration tests for proxy feature can be executed with\n\n    mvn -P run-its\n\t\n    mvn -P run-its -Plegacy\n\ndeploy to maven central\n-----------------------\n\n    mvn versions:set\n    git ci -m 'prepare release' pom.xml\n    mvn -Prelease,executable\n    git tag ...\n    mvn versions:set\n    git ci -m 'next dev version' pom.xml\n    git push\n    git push --tags\n\ncontributing\n------------\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Added some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\nmeta-fu\n-------\n\nenjoy :) \n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjruby%2Frubygems-servlets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjruby%2Frubygems-servlets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjruby%2Frubygems-servlets/lists"}