Difference between revisions of "Activity Team/How to migrate from OLPC"
Jump to navigation
Jump to search
(Flesh out some of the steps as people were getting stuck.) |
RafaelOrtiz (talk | contribs) |
||
(17 intermediate revisions by 12 users not shown) | |||
Line 1: | Line 1: | ||
− | == | + | == 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]. | ||
− | * ''' | + | * '''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 | + | 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. | ||
− | + | == 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. | ||
− | + | == 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. | ||
− | + | * 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 [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]] |
− | * Update | + | * '''Tag''' the activity at [[Activity Team/Activity Status]] as '''migrated'''. |
− | * '''Tag''' the activity at [[ | + | |
+ | == 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]] | + | [[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
- Notify sugar-devel and OLPC devel about the move.
- 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
- 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 {{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.