Difference between revisions of "Activity Team/How to migrate from OLPC"

From Sugar Labs
Jump to navigation Jump to search
 
(14 intermediate revisions by 12 users not shown)
Line 1: Line 1:
== Migrating activities from dev.laptop.org ==
+
== Migrate the code ==
 
 
 
* If you are not the author of the activity, '''query''' the author to let them know about the move.
 
* If you are not the author of the activity, '''query''' the author to let them know about the move.
 
* '''Create''' an account on http://git.sugarlabs.org and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
 
* '''Create''' an account on http://git.sugarlabs.org and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account].
* '''[http://git.sugarlabs.org/projects/new Create a new project]''' (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in '''category "activities"'''.
+
* '''Create a new project''' (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in '''category "activities"'''.
 
* '''Clone''' your activity from [http://dev.laptop.org/git dev.laptop.org].
 
* '''Clone''' your activity from [http://dev.laptop.org/git dev.laptop.org].
 
  git clone git://dev.laptop.org/projects/pippy-activity
 
  git clone git://dev.laptop.org/projects/pippy-activity
Line 10: Line 9:
 
  git checkout -b sucrose-0.82 origin/sucrose-0.82
 
  git checkout -b sucrose-0.82 origin/sucrose-0.82
 
* '''Push''' to git.sugarlabs.org with something like:
 
* '''Push''' to git.sugarlabs.org with something like:
 
 
  git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
 
  git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
 +
* '''Clone''' the project from the new repository in order to be able to push your changes.  You'll need to do a git clone into an empty directory, using the same URL you used with your previous push:
 +
git clone gitorious@git.sugarlabs.org:sugar/mainline.git sugar
 +
If you're getting a message saying '''fatal: The remote end hung up unexpectedly''' that probably means that this URL is incorrect.
  
* To be able to push your changes to the new repository in the future you'll need to do a git clone on the new location into an empty directory, then change the remote origin url in .git/config within the "mainline" directory in that new directory to the new URL you used with your previous push:
+
== Set up SugarLabs services ==
 +
* '''Add''' the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to [[User:RafaelOrtiz|dirakx]] to point pootle to new remote.
 +
* '''Upload a xo bundle''' to [http://activities.sugarlabs.org/ activities.sugarlabs.org].  Be sure to include a couple of screenshots of your activity in action.
 +
* If your activity is part of Fructose, '''upload a .tar.bz2''' to [http://download.sugarlabs.org/ download.sugarlabs.org].  Request a shell account from the [[Infrastructure Team]] if you don't have one already.
 +
* '''Update the OLPC wiki page''' for the Activity, noting the migration. Use the [http://wiki.laptop.org/go/Template:Migrated_to_sl.o Migrated to sl.o] template.
 +
* '''Change sugar-jhbuild''' to point to the new repository if this activity was included in sugar-jhbuild (enter a ticket in http://dev.sugarlabs.org if you have no access).
 +
* Ask an [[Activity Team/Contacts|Activity Team Coordinator]] to create a '''Trac component''' for your activity.
  
[remote "origin"]
+
== Notify the community ==
      url = gitorious@git.sugarlabs.org:sugar/mainline.git
+
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
      fetch = +refs/heads/*:refs/remotes/origin/*
+
* Transfer or resolve '''existing tickets''' related to the code in the [http://dev.laptop.org/query?status=assigned&status=new&status=reopened&component=acoustic-measure-activity&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=milestone OLPC Trac]. 
 +
* Update pages on wiki.laptop.org that contain '''stale links''' to the OLPC repo and latest bundle.  (e.g. Activities/All , the OBX box on the activity homepage, etc.)  See [[olpc:Maintaining activity web information#Migrating activities to SugarLabs]]
 +
* '''Tag''' the activity at [[Activity Team/Activity Status]] as '''migrated'''.
  
* If you're getting a message saying ''fatal: The remote end hung up unexpectedly'' that probably means that this URL is incorrect.
+
== Clean up wiki.laptop.org ==
 +
Adjust the activity's old wiki page on wiki.laptop.org:
 +
* Put the <nowiki>{{</nowiki>[[olpc:Template:Activity migrated to sl.o|Activity migrated to sl.o]]}} template at the top of the old wiki page.
 +
* Clean up the information on the old wiki page.  You can either continue to update the "OBX" badges and semantic information on it, or remove most of this information.
  
* '''Add''' the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to [[User:SayaminduDasgupta|Sayamindu]] to point pootle to new remote.
+
You need to continue to maintain the activity's "activity template fragment"(s) on wiki.laptop.org such as [[olpc:Activities/Etoys (latest)|Activities/Etoys (latest)]].
* '''Upload''' xo bundles and .tar.bz2 files to download.sugarlabs.org.  If you don't already have one, you will need to request a shell account from the [[InfrastructureTeam]].  ''This is temporary.  In the future, addons.sugarlabs.org will fill this role. You may also choose to leave the downloads on the laptop.org infrastructure until the new site is in place.''
+
 
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
+
For more information on wiki.laptop.org activity pages, see [[olpc:Maintaining activity web information]].
* '''Make sure''' that sugar-jhbuild points to the new repository (enter a ticket in http://dev.sugarlabs.org if you have no access)
 
* Ask an [[ActivityTeam/Contacts|ActivityTeam Coordinator]] to create a '''Trac component''' for your activity.
 
* Transfer or resolve '''existing tickets''' related to the code in the [http://dev.laptop.org/query?status=assigned&status=new&status=reopened&component=acoustic-measure-activity&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=milestone OLPC Trac]. 
 
* Update any pages on wiki.laptop.org that may contain '''stale links''' to OLPC repo.  (e.g. Activities/All , the OBX box on the activity homepage, etc.)
 
* '''Tag''' the activity at [[ActivityTeam/ActivityStatus]] as '''migrated'''.
 
  
[[Category:Activity]]
+
[[Category:Activity Team]]

Latest revision as of 23:10, 14 March 2011

Migrate the code

  • If you are not the author of the activity, query the author to let them know about the move.
  • Create an account on http://git.sugarlabs.org and log in. Add your public SSH key to your account.
  • Create a new project (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in category "activities".
  • Clone your activity from dev.laptop.org.
git clone git://dev.laptop.org/projects/pippy-activity
  • If you want to migrate a non-master branch...
git remote show origin
git checkout -b sucrose-0.82 origin/sucrose-0.82
  • Push to git.sugarlabs.org with something like:
git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
  • Clone the project from the new repository in order to be able to push your changes. You'll need to do a git clone into an empty directory, using the same URL you used with your previous push:
git clone gitorious@git.sugarlabs.org:sugar/mainline.git sugar

If you're getting a message saying fatal: The remote end hung up unexpectedly that probably means that this URL is incorrect.

Set up SugarLabs services

  • Add the pootle user as a committer (from the "add committer" link on the mainline page) and send mail to dirakx to point pootle to new remote.
  • Upload a xo bundle to activities.sugarlabs.org. Be sure to include a couple of screenshots of your activity in action.
  • If your activity is part of Fructose, upload a .tar.bz2 to download.sugarlabs.org. Request a shell account from the Infrastructure Team if you don't have one already.
  • Update the OLPC wiki page for the Activity, noting the migration. Use the Migrated to sl.o template.
  • Change sugar-jhbuild to point to the new repository if this activity was included in sugar-jhbuild (enter a ticket in http://dev.sugarlabs.org if you have no access).
  • Ask an Activity Team Coordinator to create a Trac component for your activity.

Notify the community

Clean up wiki.laptop.org

Adjust the activity's old wiki page on wiki.laptop.org:

  • Put the {{Activity migrated to sl.o}} template at the top of the old wiki page.
  • Clean up the information on the old wiki page. You can either continue to update the "OBX" badges and semantic information on it, or remove most of this information.

You need to continue to maintain the activity's "activity template fragment"(s) on wiki.laptop.org such as Activities/Etoys (latest).

For more information on wiki.laptop.org activity pages, see olpc:Maintaining activity web information.