From Fedora Project Wiki

Revision as of 20:31, 20 February 2013 by Ktdreyer (talk | contribs) (→‎Gitorious Web Application Gems: add shoulda-context)

This document outlines the steps to get Gitorious into Fedora and EPEL.

High Level Steps and Issues

Fedora

  1. Get all Gitorious' dependencies into Fedora.
    • Several Rubygems.
  2. Get Gitorious into Fedora.
    • Bundler issues: If we use different Gem versions than upstream, Bundler wants to write to Gemfile and Gemfile.lock. We must patch upstream's Gemfile/Gemfile.lock to make this work.
    • Init scripts: Create equivalent systemd unit files for Fedora & RHEL 7.
    • Ruby version: Upstream master works with Ruby 1.8; verify Ruby 1.9.x compatability.
    • Gem versions: Upstream uses different Gem versions than Fedora has. The biggest difference is Rails, but others are documented below. Plan of attack is to ensure that the test suite passes with both.
    • Javascript libs: There are a couple Git submodules in upstream (bane, capillary-js, raphael, spin.js). We must unbundle these and package them separately.
    • GeoIP data: Gitorious bundles GeoIP.dat, which is already available in Fedora as the "GeoIP" package.
    • FHS considerations: for the Gitorious web application itself, we need to discover how to split up the package to fit the FHS conventions of /etc/, /usr/, and so on.

EPEL

  1. Get all Gitorious's dependencies into EPEL.
    • Rails. I don't have experience packaging Rails, and there's been questions about which version to put into EPEL.
    • Various Rubygems must be branched for EPEL.
  2. Get Gitorious into EPEL.
    • Ruby 1.8 may make things easier, since this is what upstream currently uses (although this will change, eventually).
    • EPEL has RSpec 1, but some gems (eg riddle) require RSpec 2.

Dependencies

  • Fail - The package is not in Fedora/EPEL
  • Pass - The package is not in Fedora/EPEL, and I'm unsure how to proceed (lib might be deprecated, etc.)
  • Inprogress - The package spec is written, but not yet accepted into Fedora/EPEL
  • Pass - The package is present in Fedora/EPEL and versions differ from upstream
  • Pass - The package is present in Fedora/EPEL and versions match upstream

(FYI, the ordering in these tables matches upstream's Gemfile.)

Gitorious Web Application Gems

Gem Upstream Gemfile Fedora 17 EPEL 6
rails 2.3.17
Warning warn
3.0/3.2 in F18
Inprogress inprogress
2.3.17, git
chronic 0.3.0[1]
Warning warn
0.6.6
Inprogress inprogress
0.3.0, git
geoip 0.8.9
Inprogress inprogress
1.2.1, git
Inprogress inprogress
1.2.1, git
daemons 1.1.0
Warning warn
1.0.10[2]
Inprogress inprogress
1.1.0, git
hoe 2.8.0[1]
Warning warn
2.12.5
Inprogress inprogress
2.8.0, git
echoe 4.3.1[1]
Pass pass
4.3.1
Inprogress inprogress
4.3.1, git
ruby-yadis 0.3.4
Inprogress inprogress
0.3.4, git
Inprogress inprogress
0.3.4, git
ruby-openid 2.2.2
Warning warn
2.1.7[3]
Inprogress inprogress
2.2.2, git
rdiscount 1.3.1.1
Warning warn
1.6.3.2
Inprogress inprogress
1.3.1.1, git
mime-types 1.16
Pass pass
1.16
Pass pass
1.16
diff-lcs 1.1.2
Pass pass
1.1.2
Pass pass
1.1.2
oauth 0.4.4
Warning warn
0.4.7 in F19
Inprogress inprogress
0.4.4, git
typhoeus Buildreq for oauth
Pass pass
Inprogress inprogress
git
curb Buildreq for oauth
Pass pass
Inprogress inprogress
git
actionpack Buildreq for oauth
Warning warn
3.2
Inprogress inprogress
2.3.17 git
paperclip 2.7.4
Inprogress inprogress
3.1.4, git
Inprogress inprogress
2.7.4, git
activesupport Dep for paperclip (2.3.17)
Warning warn
3.2.11 in F18
Inprogress inprogress
2.3.17, git
activerecord Dep for paperclip (2.3.17)
Warning warn
3.2.11 in F18
Inprogress inprogress
2.3.17, git
cocaine Dep for paperclip
Inprogress inprogress
0.2.1, git
Inprogress inprogress
0.3.0, git
bourne Dep for cocaine
Inprogress inprogress
1.1.2, git
Inprogress inprogress
1.0, git
state_machine 0.9.4
Warning warn
1.1.2
Warning warn
1.1.2
rack 1.0.1
Warning warn
1.4.0
Warning warn
1.1.0
thinking-sphinx 1.4.13
Inprogress inprogress
1.4.13, git
Inprogress inprogress
1.4.13, git
after_commit Dep for thinking-sphinx
Inprogress inprogress
1.5.3, git
Inprogress inprogress
1.5.3, git
activerecord-mysql2-adapter BuildReq for thinking-sphinx
Inprogress inprogress
1.0.10 git
Inprogress inprogress
1.0.10 git
riddle Dep for thinking-sphinx (1.5.3)
Inprogress inprogress
1.5.3, git
Inprogress inprogress
1.5.3, git
mysql2 Dep for riddle
Inprogress inprogress
0.3.11, git
Inprogress inprogress
0.3.11, git
yard Dep for riddle
Pass pass
0.8.2.1 in F19
Inprogress inprogress
0.8.2.1, git
rspec-core Dep for yard
Pass pass
Pass pass
rspec-expectations Dep for rspec-core
Pass pass
Pass pass
rspec-mocks Dep for rspec-core
Pass pass
Pass pass
builder 3.0.0
Warning warn
3.1.4 in F19
Inprogress inprogress
3.0.0, git [4]
mysql 2.8.1
Warning warn
2.8.2?
Warning warn
2.8.2?
validates_url_format_of 0.1.1
Inprogress inprogress
0.3.0, git
Inprogress inprogress
0.1.1, git
acts-as-taggable-on 2.0.6
Inprogress inprogress
2.3.3, git
Inprogress inprogress
2.0.6, git
will_paginate 2.3.15
Warning warn
3.0.2
Inprogress inprogress
2.3.15, git
just_paginate 0.0.6
Fail fail
Fail fail
shoulda-context BR for just_paginate
Fail fail
Fail fail
hodel_3000_compliant_logger 0.1.0
Inprogress inprogress
0.1.0, git
Inprogress inprogress
0.1.0, git
net-ldap 0.3.1
Pass pass
0.3.1 in F18
Inprogress inprogress
0.3.1, git
capillary 1.0.2
Inprogress inprogress
1.0.2, git
Inprogress inprogress
1.0.2, git
mini_shoulda BR for capillary
Inprogress inprogress
0.5.0, git
N/A[5]
nokogiri 1.5.0
Warning warn
1.5.5
Warning warn
1.4.3.1,
1.5.0 in git
unicorn 4.3.1
Fail fail
Fail fail
kgio Dep for unicorn (2.7.4)
Fail fail
Inprogress inprogress
2.7.4, git
raindrops Dep for unicorn (0.10.0)
Fail fail
Fail fail
exception_notification 1.0.20090728
Inprogress inprogress
2.6.1, git
Inprogress inprogress
1.0.20090728, git
revo-ssl_requirement 1.1.0
Warning warn
unneeded?[6]
Inprogress inprogress
1.1.0, git
ruby-hmac 0.4.0
Warning warn
unneeded[7]
Inprogress inprogress
0.4.0 in git
json 1.7.7
Warning warn
1.7.5
Warning warn
1.4.6,
1.7.7 in git

Test suite Gem dependencies

Gem Upstream Gemfile Fedora 17 EPEL 6
mocha 0.9.10
Warning warn
0.11.0
Warning warn
0.9.8
factory_girl 1.3.3
Warning warn
2.3.2
Fail fail
shoulda 2.9.2
Warning warn
2.11.3
Warning warn
2.11.3
tuxml 0.0.1
Pass pass
unneeded[8]
Pass pass
rots git clone (!)
Fail fail
Fail fail
capybara 1.0.1
Warning warn
1.1.2
Fail fail
rack-test Dep for capybara (0.6.2)
Warning warn
0.6.0
Warning warn
0.5.4
selenium-webdriver Dep for capybara (2.25.0)
Warning warn
2.3.2
Fail fail
childprocess Dep for selenium-webdriver (0.3.6)
Warning warn
0.2.0
Fail fail
ffi Dep for selenium-webdriver (1.0.11)
Pass pass
1.0.9
Fail fail
multi_json Dep for selenium-webdriver (1.3.6)
Warning warn
1.0.3
Fail fail
rubyzip Dep for selenium-webdriver (0.9.9)
Pass pass
0.9.4
Fail fail
xpath Dep for capybara (0.1.4)
Pass pass
0.1.4
Fail fail
launchy 2.0.5
Warning warn
0.4.0
Warning warn
0.3.7
addressable Dep for launchy (2.2.8)
Pass pass
2.2.6 in F17/F18
2.3.2 in F19
Fail fail
(unneeded?)

Possibly optional Gem dependencies

Gem Upstream Gemfile Fedora 17 EPEL 6
foreman (for dev) 0.60.2
Fail fail
Fail fail
thor (for dev) Dep for foreman (0.14.6)
Pass pass
0.14.6
Fail fail
stompserver 0.9.9
Fail fail
[9]
Fail fail
thin (for dev) 1.5.0
Warning warn
1.3.1[10]
Warning warn
1.2.8
proxymachine (for dev, and git proxy) 1.2.4
Fail fail
Fail fail
eventmachine Dep for proxymachine (0.12.10)
Pass pass
0.12.10
Pass pass
0.12.10
rake (for git proxy) 0.8.7
Warning warn
0.9.6 in F18
10.0.3 in F19
Pass pass
0.8.7
resque (for resque) 1.9.8
Fail fail
Fail fail
redis (for resque) 2.2.2
Fail fail
Fail fail
redis-namespace (for resque) 0.7.0
Fail fail
Fail fail
sinatra 1.0
Warning warn
1.3.2 in F19
Pass pass
vegas (for resque) 0.1.11
Fail fail
Fail fail
SystemTimer (for resque) 1.2.3
Warning warn
(gone from Ruby[11])
Fail fail
stomp (for stomp) 1.1
Warning warn
1.2.2
Warning warn
1.1.8
activemessaging (for active messaging) 0.7.1 (gone from rails?)
Fail fail

Bundled (vendored) dependencies

These deps are bundled in /vendor:

Name Bundled version Fedora 17 EPEL 6
diff-display ???
Fail fail
Fail fail
grit ???
Warning warn
2.4.1
Fail fail
ruby-git ???
Warning warn
1.2.5[12]
Fail fail
plugins/localized_dates ???
Unknown unknown
Fail fail
plugins/open_id_authentication ???
Unknown unknown
Fail fail
plugins/restful_authentication ???
Unknown unknown
Fail fail
plugins/routing-filter ???
Unknown unknown
Fail fail

These deps are git submodules under public/javascripts/lib/:

Name Bundled version Fedora 17 EPEL 6
bane 0.4.0
Inprogress inprogress
0.4.0, git
Inprogress inprogress
0.4.0, git
capillary-js 0.1.0
Inprogress inprogress
0.1.0, git
Inprogress inprogress
0.1.0, git
raphael 2.1.0
Inprogress inprogress
2.1.0, git
Inprogress inprogress
2.1.0, git
spin.js 1.2.7
Inprogress inprogress
1.2.7, git
Inprogress inprogress
1.2.7, git


  1. 1.0 1.1 1.2 Gone in Gitorious's upstream/feature/rails3 branch
  2. RFE filed at https://bugzilla.redhat.com/906159
  3. RFE filed at https://bugzilla.redhat.com/903854
  4. Request for EPEL 6 branch: https://bugzilla.redhat.com/723145
  5. EPEL 6's minitest 1.6.0 is too old for mini_shoulda, so we cannot run the test suite for mini_shoulda (and by extension, capillary).
  6. SSL requirement is built into Rails 3
  7. https://groups.google.com/d/topic/gitorious/yNDA9ipKe8I/discussion
  8. tuxml is apparently only needed for automated builds inside Hudson. In F17, Gitorious tests crash with "uninitialized constant Test::Unit::AutoRunner::RUNNERS", which comes from tuxml. Remove it and the tests succeed.
  9. We just need a stomp-compatible server. ActiveMQ Messaging Server would work equally well. The stompserver gem needs this patch to not crash on Ruby 1.9. TBD: investigate the "stompserver_ng" fork.
  10. See https://bugzilla.redhat.com/837568. Emailed maintainer January 2013.
  11. does not build on Fedora 17
  12. Called "rubygem-git" in Fedora