Difference between revisions of "Updating the Git master branch"

From BlackBox Framework Wiki
Jump to navigation Jump to search
 
(23 intermediate revisions by 2 users not shown)
Line 2: Line 2:


This task should be conducted by the Center Chair after a vote has approved the proposed changes.
This task should be conducted by the Center Chair after a vote has approved the proposed changes.
__TOC__


== Close the issue ==
== Close the issue ==


Go to
* Go to Redmine https://redmine.blackboxframework.org/projects/blackbox/issues.
  https://redmine.blackboxframework.org/projects/blackbox/issues
* Alternatively:
Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
Go to the Center page: https://forum.blackboxframework.org
*# Click on the top level yellow option "Redmine mirror"
Click on the top level yellow option "Redmine mirror"
*# Click on the "Issues" tab.
Click on the "Issues" tab.


Click on the issue. You can use either the number "#" or the "Subject" in the list of issues.
* Click on the issue. You can use either the number "#" or the "Subject" in the list of issues.


You now need to be logged in.
* You now need to be logged in.


Select the "Edit" option (upper right hand corner).
* Select the "Edit" option (upper right hand corner).


Change the "Status" to "Closed".
* Change the "Status" to "Closed".


"Submit" to apply the change; this button is in the bottom-left corner.
* Check that the "Target version:" is set correctly. (This might read "1.7.3" in December 2019.)


Exit redmine.
* "Submit" to apply the change; this button is in the bottom-left corner.


* Exit redmine.


== Merge the Branch ==
== Merge the branch ==


Go to GitHub
* Go to GitHub https://github.com/BlackBoxCenter/blackbox.
https://github.com/BlackBoxCenter/blackbox
* Alternatively:
Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
Go to the Center page: https://forum.blackboxframework.org
*# Click on the top level yellow option "GitHub repository"
Click on the top level yellow option "Github repository"
*# Click on the large blue "blackbox" text in the center of the page.
Click on the large blue "blackbox" text in the center of the page.


Use the drop-down on the left of the page "Branch: master ▼" to select the required branch.
* Use the drop-down on the left of the page "Branch: master ▼" to select the required branch. The branch is identified by its issue number.
The branch is identified by its issue number.


Press "New pull request" button just to the right of the previous drop-down.
* You now need to be signed in.


Click the large green "Create pull request" button.
* Press "New pull request" button just to the right of the previous drop-down.


Click the large green "Merge pull request" button.
* Click the large green "Create pull request" button.
This assumes there were no "conflicts with the base branch".


Click the large green "Confirm merge" button.
* Click the large green "Merge pull request" button. This assumes there were no "conflicts with the base branch".


You should now have a box that says "Pull request successfully merged and closed".
* Click the large green "Confirm merge" button.
In this box click the "Delete branch" button.
 
* You should now have a box that says "Pull request successfully merged and closed". In this box click the "Delete branch" button.


== Check the new build ==
== Check the new build ==


This should be the end of the task.
You can confirm the master has been built successfully by going to: http://blackboxframework.org/unstable/master/.
 
You can confirm the master has been updated successfully by going to:
http://blackboxframework.org/unstable/master/
I find this as below; there may be a more direct route:
I find this as below; there may be a more direct route:
Go to the Center page: https://forum.blackboxframework.org
# Go to the Center page: https://forum.blackboxframework.org.
Click on the top level yellow option "Main page"
# Click on the top level yellow option "Main page"
Click on "Goto Download page" (bottom of top-left region).
# Click on "Download BlackBox" (bottom of top-left region) which takes you to the Download page.
Click on "A repository of all Center development versions is available".
# Click on "A repository of all Center development versions ''is available here''".
Click on the "master/" directory.
# Click on the "master/" directory.


Check the date / time of the latest master.
Check the date / time of the latest master.
It may take a few minutes before the new master is available.
It may take a few minutes before the new master build is available.
If the build failed, inspect the build log.
If the problem cannot be identified, notify the administrator of the build engine.
 
== Archive the discussion ==
 
For this task you must have ''Moderator'' status on the BlackBox Framework Center board.
 
* Goto the topic where the discussion took place.
* At the bottom select the "Quick-mod tools:" option "Move topic".
* Click "Go".
* Select as the destination "Resolved". Note that there are several "Resolved" forums, take care to select the appropriate one.
* ''Important'': Uncheck "Leave shadow in place".
* Click "Yes" to the question "Are you sure you want to move the topic into a new forum?".

Latest revision as of 11:18, 14 December 2019

This page describes how to update the Git master branch with the changes in an alternative branch.

This task should be conducted by the Center Chair after a vote has approved the proposed changes.

Close the issue

  • Click on the issue. You can use either the number "#" or the "Subject" in the list of issues.
  • You now need to be logged in.
  • Select the "Edit" option (upper right hand corner).
  • Change the "Status" to "Closed".
  • Check that the "Target version:" is set correctly. (This might read "1.7.3" in December 2019.)
  • "Submit" to apply the change; this button is in the bottom-left corner.
  • Exit redmine.

Merge the branch

  • Use the drop-down on the left of the page "Branch: master ▼" to select the required branch. The branch is identified by its issue number.
  • You now need to be signed in.
  • Press "New pull request" button just to the right of the previous drop-down.
  • Click the large green "Create pull request" button.
  • Click the large green "Merge pull request" button. This assumes there were no "conflicts with the base branch".
  • Click the large green "Confirm merge" button.
  • You should now have a box that says "Pull request successfully merged and closed". In this box click the "Delete branch" button.

Check the new build

You can confirm the master has been built successfully by going to: http://blackboxframework.org/unstable/master/.

I find this as below; there may be a more direct route:

  1. Go to the Center page: https://forum.blackboxframework.org.
  2. Click on the top level yellow option "Main page"
  3. Click on "Download BlackBox" (bottom of top-left region) which takes you to the Download page.
  4. Click on "A repository of all Center development versions is available here".
  5. Click on the "master/" directory.

Check the date / time of the latest master. It may take a few minutes before the new master build is available. If the build failed, inspect the build log. If the problem cannot be identified, notify the administrator of the build engine.

Archive the discussion

For this task you must have Moderator status on the BlackBox Framework Center board.

  • Goto the topic where the discussion took place.
  • At the bottom select the "Quick-mod tools:" option "Move topic".
  • Click "Go".
  • Select as the destination "Resolved". Note that there are several "Resolved" forums, take care to select the appropriate one.
  • Important: Uncheck "Leave shadow in place".
  • Click "Yes" to the question "Are you sure you want to move the topic into a new forum?".