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

From Sugar Labs
Jump to navigation Jump to search
(clean up steps needed)
 
(26 intermediate revisions by 13 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.
 
* '''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
 
* '''If''' you want to migrate a non-master branch...
 
* '''If''' you want to migrate a non-master branch...
 
  git remote show origin
 
  git remote show origin
 
  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
 +
* '''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.
  
  git push gitorious@git.sugarlabs.org:sugar/mainline.git --mirror
+
== 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.
  
* '''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.
+
== Notify the community ==
 
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
 
* '''Notify''' [http://lists.sugarlabs.org/listinfo/sugar-devel sugar-devel] and [http://lists.laptop.org/listinfo/devel OLPC devel] about the move.
* '''Make sure''' that sugar-jhbuild points to the new repository (ask someone to do it for you if you have no access)
+
* 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].
*Transfer or resolve existing tickets related to the code in the 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]]
*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 [[Activity Team/Activity Status]] as '''migrated'''.
 +
 
 +
== 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.
 +
 
 +
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)]].
 +
 
 +
For more information on wiki.laptop.org activity pages, see [[olpc:Maintaining activity web information]].
 +
 
 +
[[Category:Activity Team]]

Latest revision as of 22: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.