HiHAT Development - Revision history

imported>Niveditasinghvi at 06:24, August 17, 2017

2017-08-17T06:24:47Z

← Older revision		Revision as of 06:24, August 17, 2017
Line 51:		Line 51:
	You can check which groups you are in from the Gerrit Web UI -> My -> Groups Dashboard page.		You can check which groups you are in from the Gerrit Web UI -> My -> Groups Dashboard page.

	* '''ldap/hihat-admin''': project admin (same as project for now); authority to do all project operations		* '''ldap/hihat-admin''': project admin (same as project owner for now); authority to do all project operations
	* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity		* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity
	* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.		* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.

imported>Niveditasinghvi at 06:24, August 17, 2017

2017-08-17T06:24:05Z

← Older revision		Revision as of 06:24, August 17, 2017
Line 8:		Line 8:
	This wiki page provides information for working with the public HiHAT git repo intended for community use.		This wiki page provides information for working with the public HiHAT git repo intended for community use.

	~~[This page is under development today - Wed, Aug 16, 2017. It should be complete by tonight PT. This message will be removed once the intended content has all been moved here.]~~

	=== Software Tools ===		=== Software Tools ===
Line 36:		Line 35:
	# Login to [https://xstg.modelado.org/gerrit/ XSTG Gerrit] with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.		# Login to [https://xstg.modelado.org/gerrit/ XSTG Gerrit] with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.
	# Clone the HiHAT git repo on your local system		# Clone the HiHAT git repo on your local system
	#: <~~nowiki~~>$ git clone https://xstg.modelado.org/gerrit/HiHAT</~~nowiki~~>		#:<code> $ git clone https://xstg.modelado.org/gerrit/HiHAT</code>
	# In your top level HiHAT git clone directory, move (or use ln -s) the hooks ~~repo~~ to .git		# In your top level HiHAT git clone directory, move back out the original hooks/ and move the (or use ln -s) the git-hooks dir to .git/
	#: <~~nowiki~~> ~~HiHAT~~$ mv git-hooks .git/hooks</~~nowiki~~>		#:<code> $ mv .git/hooks/ .git/hooks_old</code>
			#:<code> $ mv git-hooks .git/hooks</code>
	# Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:		# Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:
	#: <~~nowiki~~> $git add .; git commit .</~~nowiki~~>		#:<code> $ git add .</code>
	#: Note the git commit msg length limitation above in the Caveats section!		#:<code> $ git commit .</code>
			#: WARNING! Note the git commit msg length limitation above in the Caveats section!
	# Push upstream		# Push upstream
	#: <~~nowiki~~> git push origin HEAD:refs/for/master</~~nowiki~~>		#:<code> $ git push origin HEAD:refs/for/master</code>
	# Check the Gerrit Web UI to see your patch submission		# Check the Gerrit Web UI to see your patch submission
			# Further steps in the code flow can be performed via the Gerrit Web UI (see below).

	=== Project Groups ===		=== Project Groups ===
Line 58:		Line 59:
	=== Working With Gerrit Web UI ===		=== Working With Gerrit Web UI ===
	Gerrit is a git repo manager providing code review and verification of patches for submission to a git repository. Gerrit stages submitted patches and provides powerful, fine-grained control over all aspects of the git development environment. The Web User Interface can be confusing at first, hence a few brief tips are provided here.		Gerrit is a git repo manager providing code review and verification of patches for submission to a git repository. Gerrit stages submitted patches and provides powerful, fine-grained control over all aspects of the git development environment. The Web User Interface can be confusing at first, hence a few brief tips are provided here.

			Gerrit essentially stages submitted patches for code review, verification and revision. A patchset requires 2 approvals:
			* Code Review Approval: It must receive a +2 from a reviewer who is authorized to provide a +2 level approval
			* Verification: It must receive a +1 from a member with Verification permissions (group ldap/hihat-developers)

			Normally, the verification approval would be obtained automatically from a triggered build/test infrastructure component. However, in the case of the HiHAT project initial phase, we have configured manual verification sign-off from authorized people. At the moment, this group is the ldap/hihat-developers group. A patchset can be submitted into the target branch once both the above approvals have been obtained.

			Patches can be revised and uploaded to the same change-id based on comments and feedback.

	==== Access and Sign-in ====		==== Access and Sign-in ====
Line 74:		Line 83:
	* '''My''' -> '''Groups''' does not always reflect what has been configured in LDAP or on the system. Gerrit does a "lazy load" of data. Before working in git, please make sure you login to the Gerrit Web UI with your account and access projects or changes.		* '''My''' -> '''Groups''' does not always reflect what has been configured in LDAP or on the system. Gerrit does a "lazy load" of data. Before working in git, please make sure you login to the Gerrit Web UI with your account and access projects or changes.

	==== Code Review ====		==== Code Review and Verification ====
	* You can access the change you want to review from the '''All''' or '''My''' menus		* You can access the change you want to review from the '''All''' or '''My''' menus
	* Once you click on the change, you will be taken to the dashboard for that change.		* Once you click on the change, you will be taken to the dashboard for that change.

imported>Niveditasinghvi: /* Working With Gerrit Web UI */

2017-08-16T21:38:44Z

Working With Gerrit Web UI

← Older revision		Revision as of 21:38, August 16, 2017
Line 53:		Line 53:
	* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity		* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity
	* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.		* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.



	=== Working With Gerrit Web UI ===		=== Working With Gerrit Web UI ===
	Gerrit is a git repo manager providing code review and verification of patches for submission to a git repository. Gerrit stages submitted patches and provides powerful, fine-grained control over all aspects of the git development environment. The Web User Interface can be confusing at first, hence a few brief tips are provided here.		Gerrit is a git repo manager providing code review and verification of patches for submission to a git repository. Gerrit stages submitted patches and provides powerful, fine-grained control over all aspects of the git development environment. The Web User Interface can be confusing at first, hence a few brief tips are provided here.

			==== Access and Sign-in ====
	* Access: https://xstg.modelado.org/gerrit/		* Access: https://xstg.modelado.org/gerrit/
			* The Sign-in box is on the far top right of the page. On some browsers, you might not see this right away. The Search box can over-extend.

			==== Menus ====
	* Top level Gerrit Web UI Menu		* Top level Gerrit Web UI Menu
	** All: Shows you current items in the queue for processing (patches submitted for approval, etc.)		** '''All''': Shows you current items in the queue for processing (patches submitted for approval, etc.)
	** My: Shows items associated with your account (either open items you submitted or are watching)		** '''My''': Shows items associated with your account (either open items you submitted or are watching)
	** Projects: Lists the visible projects (not in hidden state) being managed by this Gerrit server		** '''Projects''': Lists the visible projects (not in hidden state) being managed by this Gerrit server
	** People: group information		** '''People''': group information
	** Plugins:		** '''Plugins''':
	** Documentation:		** '''Documentation''':
	* Note that you also need to actually click on a sub-tab, it does not immediately switch the content of the page to the top-level tab		* Note that you also need to actually click on a sub-tab, it does not immediately switch the content of the page to the top-level tab
			* '''My''' -> '''Groups''' does not always reflect what has been configured in LDAP or on the system. Gerrit does a "lazy load" of data. Before working in git, please make sure you login to the Gerrit Web UI with your account and access projects or changes.

			==== Code Review ====
			* You can access the change you want to review from the '''All''' or '''My''' menus
			* Once you click on the change, you will be taken to the dashboard for that change.
			* If you are a recognized group member, you will see the buttons for the functions you are authorized to provide, once they are enabled by required pre-steps and context.
			** For example, individual contributors (ldap/hihat-contrib) will only see '''Reply''' for code reviews.
			** Developers (ldap/hihat-developers) will see a '''Reply''' button, but once there is a +2 Code Review, they will also see a button to '''Verify''' (provide +1 verify approval).
			** Once a change has received Code Review approval as well as Verification Step approval, developers will also see the '''Submit''' button to merge the change into the tree.

imported>Niveditasinghvi at 21:25, August 16, 2017

2017-08-16T21:25:56Z

← Older revision		Revision as of 21:25, August 16, 2017
Line 2:		Line 2:


	Welcome to the development environment for HiHAT. This is a brief tutorial on how to set up a development environment and work with the existing development infrastructure on xstg. There are two HiHAT project repos:		Welcome to the development environment for HiHAT. This is a brief tutorial on how to set up a development environment and work with the existing development infrastructure on xstg. There are two HiHAT project repositories (aka "repos"):
	* HiHAT - public repo for community development		* HiHAT - public repo for community development
	* hihat_int - internal repo for special development		* hihat_int - internal repo for special development
Line 20:		Line 20:
	=== Pre-Requisites ===		=== Pre-Requisites ===
	* Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.		* Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.
	* A brief introduction to the Gerrit Web User Interface is provided later in this document. You can use it to perform code reviews, check your submissions, check your permissions and membership, etc. You will need it before you start with git.		* Gerrit is a git repo management utility which enables code reviews, verification and merging of patches into git repositories. These functions are typically required in a distributed code development project. A brief introduction to the Gerrit Web User Interface is provided later in this document. You can use it to perform code reviews, check your submissions, check your permissions and membership, etc. You will need it before you start with git.


Line 47:		Line 47:


	=== Project Groups ===		=== Project Groups ===
			You can check which groups you are in from the Gerrit Web UI -> My -> Groups Dashboard page.

	* '''ldap/hihat-admin''': project admin (same as project for now); authority to do all project operations		* '''ldap/hihat-admin''': project admin (same as project for now); authority to do all project operations
	* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity		* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity
	* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.		* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.

			=== Working With Gerrit Web UI ===
			Gerrit is a git repo manager providing code review and verification of patches for submission to a git repository. Gerrit stages submitted patches and provides powerful, fine-grained control over all aspects of the git development environment. The Web User Interface can be confusing at first, hence a few brief tips are provided here.

			* Access: https://xstg.modelado.org/gerrit/
			* Top level Gerrit Web UI Menu
			** All: Shows you current items in the queue for processing (patches submitted for approval, etc.)
			** My: Shows items associated with your account (either open items you submitted or are watching)
			** Projects: Lists the visible projects (not in hidden state) being managed by this Gerrit server
			** People: group information
			** Plugins:
			** Documentation:
			* Note that you also need to actually click on a sub-tab, it does not immediately switch the content of the page to the top-level tab

imported>Niveditasinghvi at 20:49, August 16, 2017

2017-08-16T20:49:42Z

← Older revision		Revision as of 20:49, August 16, 2017
Line 14:		Line 14:
	* git - [https://git-scm.com/book/en/v2 Git Book]		* git - [https://git-scm.com/book/en/v2 Git Book]
	* Gerrit - [https://gerrit-review.googlesource.com/Documentation/index.html#_guides Gerrit Documentation]		* Gerrit - [https://gerrit-review.googlesource.com/Documentation/index.html#_guides Gerrit Documentation]
	* Redmine - [http://www.redmine.org/ Redmine Overview]		* Redmine Bug Tracking - [http://www.redmine.org/ Redmine Overview]
	* OpenLDAP + LAM - [https://www.ldap-account-manager.org/lamcms/ LDAP Account Manager (LAM)]		* OpenLDAP + LAM - [https://www.ldap-account-manager.org/lamcms/ LDAP Account Manager (LAM)]

imported>Niveditasinghvi at 20:48, August 16, 2017

2017-08-16T20:48:19Z

← Older revision		Revision as of 20:48, August 16, 2017
Line 1:		Line 1:
	HiHAT Development Environment on xstg.modelado.org		= HiHAT Development Environment on xstg.modelado.org =


Line 8:		Line 8:
	This wiki page provides information for working with the public HiHAT git repo intended for community use.		This wiki page provides information for working with the public HiHAT git repo intended for community use.

			[This page is under development today - Wed, Aug 16, 2017. It should be complete by tonight PT. This message will be removed once the intended content has all been moved here.]

	=== Software Tools ===		=== Software Tools ===

imported>Niveditasinghvi at 20:33, August 16, 2017

2017-08-16T20:33:12Z

← Older revision		Revision as of 20:33, August 16, 2017
Line 24:		Line 24:
	=== Before You Code, Caveats ===		=== Before You Code, Caveats ===
	* Please read the instructions here completely before you get started		* Please read the instructions here completely before you get started
	* Note that you should not commit a patch to your local tree with a long commit message subject/body. Keep the total shorter than 80 chars and the subject line shorter than 70 characters. Your commit will succeed but your push to the upstream repo will fail with a "commit message length exceeded" error. We can configure this to be more flexible going forward.
	* Make sure your xstg account user name and email match what you provide to the commits in your local git tree (configure your git environment correctly)		* Make sure your xstg account user name and email match what you provide to the commits in your local git tree (configure your git environment correctly)
	* Ensure your origin points to the correct repo URL after cloning		* Ensure your origin points to the correct repo URL after cloning
	<nowiki> $ git remote -v</nowiki>		<nowiki> $ git remote -v</nowiki>
			* Keep your commit messages short! The total length should be shorter than 80 chars, the subject line shorter than 70 characters. Your commit might succeed but your push to the upstream repo will fail with a "commit message length exceeded" error. [We can configure this to be more flexible going forward].
			* Ensure that your git log shows a Change-Id: line (automatically added by /.git/hooks/commit-msg)


Line 43:		Line 44:
	#: <nowiki> git push origin HEAD:refs/for/master</nowiki>		#: <nowiki> git push origin HEAD:refs/for/master</nowiki>
	# Check the Gerrit Web UI to see your patch submission		# Check the Gerrit Web UI to see your patch submission


			=== Project Groups ===
			* '''ldap/hihat-admin''': project admin (same as project for now); authority to do all project operations
			* '''ldap/hihat-developer''': key developer or maintainer, has authority to approve code submissions (+2 reviews), verify patches (+1 verify in place of build/test automated verification methods, and most other code-flow activity
			* '''ldap/hihat-contributor''': individual contributor who can clone repos, submit patches, and provide +1 level code reviews, etc.

imported>Niveditasinghvi at 20:20, August 16, 2017

2017-08-16T20:20:35Z

← Older revision		Revision as of 20:20, August 16, 2017
Line 38:		Line 38:
	#: <nowiki> HiHAT$ mv git-hooks .git/hooks</nowiki>		#: <nowiki> HiHAT$ mv git-hooks .git/hooks</nowiki>
	# Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:		# Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:
	#: <nowiki> git add .; git commit .</nowiki>		#: <nowiki> $git add .; git commit .</nowiki>
			#: Note the git commit msg length limitation above in the Caveats section!
	# Push upstream		# Push upstream
	#: <nowiki> git push origin HEAD:refs/for/master</nowiki>		#: <nowiki> git push origin HEAD:refs/for/master</nowiki>
	# Check the Gerrit Web UI to see your patch submission		# Check the Gerrit Web UI to see your patch submission

imported>Niveditasinghvi at 20:00, August 16, 2017

2017-08-16T20:00:52Z

← Older revision		Revision as of 20:00, August 16, 2017
Line 7:		Line 7:

	This wiki page provides information for working with the public HiHAT git repo intended for community use.		This wiki page provides information for working with the public HiHAT git repo intended for community use.


	=== Software Tools ===		=== Software Tools ===
Line 14:		Line 15:
	* Redmine - [http://www.redmine.org/ Redmine Overview]		* Redmine - [http://www.redmine.org/ Redmine Overview]
	* OpenLDAP + LAM - [https://www.ldap-account-manager.org/lamcms/ LDAP Account Manager (LAM)]		* OpenLDAP + LAM - [https://www.ldap-account-manager.org/lamcms/ LDAP Account Manager (LAM)]


	=== Pre-Requisites ===		=== Pre-Requisites ===
	* Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.		* Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.
			* A brief introduction to the Gerrit Web User Interface is provided later in this document. You can use it to perform code reviews, check your submissions, check your permissions and membership, etc. You will need it before you start with git.


			=== Before You Code, Caveats ===
			* Please read the instructions here completely before you get started
			* Note that you should not commit a patch to your local tree with a long commit message subject/body. Keep the total shorter than 80 chars and the subject line shorter than 70 characters. Your commit will succeed but your push to the upstream repo will fail with a "commit message length exceeded" error. We can configure this to be more flexible going forward.
			* Make sure your xstg account user name and email match what you provide to the commits in your local git tree (configure your git environment correctly)
			* Ensure your origin points to the correct repo URL after cloning
			<nowiki> $ git remote -v</nowiki>


	=== Quick Start-Up ===		=== Quick Start-Up: Cloning and Submitting Patches Upstream ===
	# Sync with the xstg team to ensure you have an account in LDAP on xstg.modelado.org		# Sync with the xstg team to ensure you have an account in LDAP on xstg.modelado.org
	# Login to [https://xstg.modelado.org/gerrit/ XSTG Gerrit] with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.		# Login to [https://xstg.modelado.org/gerrit/ XSTG Gerrit] with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.
	# Clone the HiHAT git repo on your local system		# Clone the HiHAT git repo on your local system
	<nowiki>$ git clone https://xstg.modelado.org/gerrit/HiHAT </nowiki>		#: <nowiki>$ git clone https://xstg.modelado.org/gerrit/HiHAT</nowiki>
	# In your top level HiHAT git clone directory, move (or use ln -s) the hooks repo to .git		# In your top level HiHAT git clone directory, move (or use ln -s) the hooks repo to .git
	<nowiki> HiHAT$ mv git-hooks .git/hooks</nowiki>		#: <nowiki> HiHAT$ mv git-hooks .git/hooks</nowiki>
			# Make your development changes in your git tree, and commit them to your tree via your usual preferred git operations. e.g.:
			#: <nowiki> git add .; git commit .</nowiki>
			# Push upstream
			#: <nowiki> git push origin HEAD:refs/for/master</nowiki>
			# Check the Gerrit Web UI to see your patch submission

imported>Niveditasinghvi at 19:37, August 16, 2017

2017-08-16T19:37:06Z

← Older revision		Revision as of 19:37, August 16, 2017
Line 2:		Line 2:


	Welcome to the development environment for HiHAT. This is a brief tutorial on how to set up a development environment and work with the existing development infrastructure on xstg.		Welcome to the development environment for HiHAT. This is a brief tutorial on how to set up a development environment and work with the existing development infrastructure on xstg. There are two HiHAT project repos:
			* HiHAT - public repo for community development
			* hihat_int - internal repo for special development

	=== ~~Pre-requisites~~ ===		This wiki page provides information for working with the public HiHAT git repo intended for community use.

			=== Software Tools ===
	The HiHAT development environment uses the following tools for its Continuous Integration Pipeline:		The HiHAT development environment uses the following tools for its Continuous Integration Pipeline:
	* git - [https://git-scm.com/book/en/v2 Git Book]		* git - [https://git-scm.com/book/en/v2 Git Book]
	* Gerrit - [https://gerrit-review.googlesource.com/Documentation/index.html#_guides Gerrit Documentation]		* Gerrit - [https://gerrit-review.googlesource.com/Documentation/index.html#_guides Gerrit Documentation]
	* Redmine - [http://www.redmine.org/ Redmine Overview]		* Redmine - [http://www.redmine.org/ Redmine Overview]
	* OpenLDAP + LAM -		* OpenLDAP + LAM - [https://www.ldap-account-manager.org/lamcms/ LDAP Account Manager (LAM)]

			=== Pre-Requisites ===
			* Git is a broadly used open source distributed version control utility. This page assumes you have a working knowledge of git.

	~~Git~~ is a ~~broadly used open source distributed version control utility~~. ~~This page assumes you have a working knowledge of~~ git.		=== Quick Start-Up ===
			# Sync with the xstg team to ensure you have an account in LDAP on xstg.modelado.org
			# Login to [https://xstg.modelado.org/gerrit/ XSTG Gerrit] with that account. This is a necessary step to push your credentials to Gerrit before you undertake git operations from your client system.
			# Clone the HiHAT git repo on your local system
			<nowiki>$ git clone https://xstg.modelado.org/gerrit/HiHAT </nowiki>
			# In your top level HiHAT git clone directory, move (or use ln -s) the hooks repo to .git
			<nowiki> HiHAT$ mv git-hooks .git/hooks</nowiki>