Bug 817641 - Document how to use Redhat rubygems with letters in version string
Summary: Document how to use Redhat rubygems with letters in version string
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise WFK Platform 2
Classification: Retired
Component: TorqueBox
Version: 2.0.0.ER5
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 2.0.0.GA
Assignee: Isaac Rooskov
QA Contact: Karel Piwko
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-04-30 17:58 UTC by Marek Novotny
Modified: 2015-08-06 05:54 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-08-07 11:55:47 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)

Description Marek Novotny 2012-04-30 17:58:21 UTC
Description of problem:
Document how to use Redhat rubygems artifacts which are need to use letters in version string to differentiate with regarding to community releases.

we will use community version as the basement
and redhat as string qualifier and build number for easy recognition for repeated builds.

example result: 2.0.1.redhat.1

Comment 1 Bob McWhirter 2012-04-30 18:24:43 UTC
Assuming that the user has an exploded local copy of our torquebox-rubygems-repo.zip, or an internally-hosted repository (akin to internal hosting of the WFK maven repo), the user who installs gems manually can use a command involving the --pre flag with a generic name

  gem install --pre torquebox-messaging

I think it may also be possible (needs verification) to skip the --pre flag and specify just a distinct -v for version

  gem install torquebox-messaging -v 2.0.2.redhat.1

Without these steps, assuming the user includes RubyGems.org (akin to Maven central), the community versions will be grabbed, as RubyGems.org hosts them, and they are considered non-pre.

For users using Gemfiles, they can add the appropriate source URL, and version specifier.  The "spermy" operator may be used to selectively grab the latest 2.0.2.redhat.WHATEVER version.

# Source to user-hosted repository
source 'http://internal-rubygems-repo.mycorp.com"

# Regular RubyGems.org central repository
source :rubygems

# Grab a very specific version of 2.0.2.redhat.1
gem "torquebox-messaging", '2.0.2.redhat.1'

# Grab the "latest" 2.0.2.redhat series 
gem "torquebox-capistrano-support", '~> 2.0.0.redhat'

# Use rails from RubyGems.org
gem "rails", '3.1.1'

Comment 2 Marek Novotny 2012-05-30 11:00:50 UTC
Rebecca,

 please add this documentation note to TorqueBox docs

Comment 3 Rebecca Newton 2012-05-31 03:43:43 UTC
Sorry, guys, what do I actually need to document, and where in the TB guide should it go?

Comment 4 Marek Novotny 2012-05-31 06:57:52 UTC
I would say that it should be somewhere in installation section of TB reference guide and probably in RN too. Bob, what do you think?

Comment 5 Bob McWhirter 2012-06-05 15:56:16 UTC
The text from my comment (#1) should be included in the installation notes, alongside Ben's README from https://bugzilla.redhat.com/show_bug.cgi?id=828165

Comment 7 Karel Piwko 2012-08-07 11:55:47 UTC
Closed, verified as a part of final TB documentation.


Note You need to log in before you can comment on or make changes to this bug.