Git/Workflow/Stage: Difference between revisions
Line 151: | Line 151: | ||
. \ \ | . \ \ | ||
........o----o stage/next | ........o----o stage/next | ||
|} | |||
==Updating a Topic== | |||
Perhaps after merging to '''next''' you discover that an additional change is needed. | |||
{| | |||
!width=30%|Actions | |||
!width=30%|Results | |||
!Troubleshooting | |||
|- | |||
|colspan="2"| | |||
Since the merge was done by the topic stage repository we never switched branches locally. | |||
Just continue development: | |||
|- | |||
| | |||
:<code>$ edit files</code><br> | |||
:<code>$ git commit</code><br> | |||
| | |||
...o----o master | |||
\ | |||
o----o----o *'''''topic-name''''' | |||
^ stage/''topic-name'' | |||
|- | |||
|colspan="2"| | |||
Push the topic to the stage. | |||
|- | |||
| | |||
:{| | |||
| | |||
$ git push stage HEAD | |||
To git@public.kitware.com:stage/''repo''.git | |||
171b457..27c71e8 HEAD -> ''topic-name'' | |||
|} | |||
| | |||
...o----o master | |||
\ | |||
o----o----o *'''''topic-name''''', stage/''topic-name'' | |||
|- | |||
|colspan="2"| | |||
The stage's reference to the topic will fast-forward. | |||
We can see that the topic head is no longer reachable from '''next''': | |||
|- | |||
| | |||
:{| | |||
| | |||
$ ssh git@public.kitware.com stage ''repo'' print | |||
... | ... | |||
''topic-name'' | master=0 next=0 | |||
''other-topic'' | master=0 next=1 | |||
... | ... | |||
|} | |||
| | |||
...o----o stage/master | |||
. \ \ | |||
. \ o----o----o stage/''topic-name'' | |||
. \ \ | |||
. o----o \ stage/''other-topic'' | |||
. \ \ | |||
........o----o stage/next | |||
|- | |||
|colspan="2"| | |||
Merge the topic into '''next''' again: | |||
|- | |||
| | |||
:{| | |||
| | |||
$ ssh git@public.kitware.com stage ''repo'' merge -b next ''topic-name'' | |||
Fetching upstream next | |||
Merge branch ''topic-name'' | |||
Pushing upstream next | |||
To ../../''repo''.git | |||
|} | |||
|- | |||
|colspan="2"| | |||
Now '''next''' can see the whole topic again: | |||
|- | |||
| | |||
:{| | |||
| | |||
$ ssh git@public.kitware.com stage ''repo'' print | |||
... | ... | |||
''topic-name'' | master=0 next=1 | |||
''other-topic'' | master=0 next=1 | |||
... | ... | |||
|} | |||
| | |||
...o----o stage/master | |||
. \ \ | |||
. \ o----o----o stage/''topic-name'' | |||
. \ \ \ | |||
. o----o \ \ stage/''other-topic'' | |||
. \ \ \ | |||
........o----o----o stage/next | |||
|} | |} |
Revision as of 17:27, 8 July 2010
Introduction
Our Topic Stage repositories provide a central staging area for topic branches under development. Unlike an official repository a topic stage may have any number of branches. Developers are free to create, update, and delete topics in the stage through Git's ssh protocol.
Tutorial
Initial Setup
Add a remote called "stage
" to refer to the topic stage:
$ git remote add stage git://public.kitware.com/stage/repo.git $ git config remote.stage.pushurl git@public.kitware.com:stage/repo.git
One may fetch from the stage at any time:
$ git fetch stage --prune
Use the "--prune
" option to remove local references to remote topic branches that have been deleted.
Staging a Topic
Actions | Results | Troubleshooting |
---|---|---|
Create a local topic branch and develop on it. Here we use the placeholder topic-name for the branch name. | ||
...o----o master, ^ *topic-name | ||
...o----o master \ o----o *topic-name | ||
When the topic is ready for publication push it to the stage.
Pushing | ||
|
...o----o master, stage/master \ o----o *topic-name, stage/topic-name |
Viewing all Topics
Actions | Results | Troubleshooting | |
---|---|---|---|
Print the current stage topic table: | |||
|
...o----o stage/master . \ \ . \ o----o stage/topic-name . \ . o----o stage/other-topic . \ ........o stage/next | ||
Each row represents one topic. The first column names the topic, the rest name each integration branch with a 0 or 1 indicating whether it can reach the topic. | |||
One may also get machine-readable output:
|
Merging a Topic
Actions | Results | Troubleshooting |
---|---|---|
Tell the stage to merge the topic into next. It automatically computes a merge commit based on the latest upstream next. | ||
| ||
Print the new state of the stage: | ||
|
...o----o stage/master . \ \ . \ o----o stage/topic-name . \ \ . o----o \ stage/other-topic . \ \ ........o----o stage/next |
Updating a Topic
Perhaps after merging to next you discover that an additional change is needed.
Actions | Results | Troubleshooting |
---|---|---|
Since the merge was done by the topic stage repository we never switched branches locally. Just continue development: | ||
|
...o----o master \ o----o----o *topic-name ^ stage/topic-name | |
Push the topic to the stage. | ||
|
...o----o master \ o----o----o *topic-name, stage/topic-name | |
The stage's reference to the topic will fast-forward. We can see that the topic head is no longer reachable from next: | ||
|
...o----o stage/master . \ \ . \ o----o----o stage/topic-name . \ \ . o----o \ stage/other-topic . \ \ ........o----o stage/next | |
Merge the topic into next again: | ||
| ||
Now next can see the whole topic again: | ||
|
...o----o stage/master . \ \ . \ o----o----o stage/topic-name . \ \ \ . o----o \ \ stage/other-topic . \ \ \ ........o----o----o stage/next |