(quick note: a markdown formatted version of this content is available at [3])
All,
There was a flurry of messages as we sought to get some quick details out about our migration to the ASF Gitbox system and I wanted to take this message to consolidate those items into a comprehensive and less hastily composed message.
There are a few different paths to consider and I will try to enumerate those with the associated steps, so please choose your own adventure. Please note that this change does affect ALL repositories in the NiFi community and all references to NiFi refer to our efforts as a whole.
You have one or more repositories checked out. These repositories are either from GitHub (in the case of NiFi, https://github.com/apache/nifi) or git-wip (in the case of NiFi, http://git-wip-us.apache.org/repos/asf/nifi.git). Each of the repositories will need to be handled based on your role in the community and desired functionality.
-
GitHub: There are no actions required from you. You can continue to make use of the workflow already in place.
-
git-wip: You will need to update your remote to point to the new gitbox location. This can be accomplished via
git remote set-url origin https://gitbox.apache.org/repos/asf/nifi.git
The key distinction is that the ASF Gitbox service considers both GitHub and Gitbox repos as writable repositories. This is in contrast to before the migration where GitHub was strictly a mirror of the git-wip repositories.
-
git-wip: You will need to update your remote to point to the new gitbox location. This can be accomplished via
git remote set-url origin https://gitbox.apache.org/repos/asf/nifi.git
-
GitHub: No changes are needed, but you will not be able to push to the repository.
I am an Apache NiFi committer and would like access to the GitHub functionality (Manually closing PRs, pushing to the GitHub repository directly)
-
git-wip (Optional): You will need to update your remote to point to the new gitbox location. This can be accomplished via
git remote set-url origin https://gitbox.apache.org/repos/asf/nifi.git
-
GitHub: You will need to
- link your Apache account to GitHub via https://id.apache.org/
- enable 2-Factor Authentication on GitHub for the account you wish to link at https://github.com/settings/security
- link your Apache & GitHub accounts to the GitBox service at https://gitbox.apache.org/setup/
NOTE: There are automated, periodic tasks that perform these synchronizations. Give up to 30 minutes after completing each step should you get stuck in the process before trying again.
- You should receive emails inviting you to various teams on GitHub.
nifi-committers
is the team needed for access to our repositories on GitHub - You now have push access to the GitHub repositories in NiFi. You can choose to maintain the https:// url for the repositories or, should you wish to leverage an existing GitHub ssh-key, update your remote for any repository via:
git remote set-url origin git@github.com:apache/nifi
You can get the narrative of one committer setting this up and used as the reference for the above list [1].
For more detail and background about GitBox, check out [2].
[2] https://gitbox.apache.org/
[3] https://gist.github.com/apiri/1c934fb8b5b3b38e1b01a70f1cfe4be7