Poky Contributions - Revision history

Joshua Watt: Moved to YP docs

2023-08-30T15:33:15Z

Moved to YP docs

MichaelHalstead: /* Request Write Access */ ed25519 is fully supported, switch to that by default.

2023-02-02T19:12:58Z

Request Write Access: ed25519 is fully supported, switch to that by default.

← Older revision		Revision as of 19:12, 2 February 2023
Line 26:		Line 26:

	To write to a repo on git.yoctoproject.org, including poky-contrib, please send an email to [mailto:it-coreprojects-helpdesk@linuxfoundation.org the helpdesk] and:		To write to a repo on git.yoctoproject.org, including poky-contrib, please send an email to [mailto:it-coreprojects-helpdesk@linuxfoundation.org the helpdesk] and:
	# Attach your ssh '''public''' key which usually named id_rsa.pub. If you don't have one generate it by running <tt>ssh-keygen -t ~~rsa -b 4096~~ -C "your_email@example.com"</tt>.		# Attach your ssh '''public''' key which usually named id_rsa.pub or id_ed25519.pub. If you don't have one generate it by running <tt>ssh-keygen -t ed25519 -C "your_email@example.com"</tt>. Find you public key at ~/.ssh/id_ed25519.pub
	# List the repositories you're planning to contribute to.		# List the repositories you're planning to contribute to.
	# Include your preferred branch prefix for *-contrib repositories. See [http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/refs/heads git.yoctoproject.org] to see which prefixes are already in use.		# Include your preferred branch prefix for *-contrib repositories. See [http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/refs/heads git.yoctoproject.org] to see which prefixes are already in use.

MichaelHalstead at 17:14, 22 March 2022

2022-03-22T17:14:18Z

← Older revision		Revision as of 17:14, 22 March 2022
Line 25:		Line 25:
	=== Request Write Access ===		=== Request Write Access ===

	To write to a repo on git.yoctoproject.org, including poky-contrib, please send an email to [mailto:~~mhalstead~~@linuxfoundation.org ~~Michael Halstead~~] and:		To write to a repo on git.yoctoproject.org, including poky-contrib, please send an email to [mailto:it-coreprojects-helpdesk@linuxfoundation.org the helpdesk] and:
	# Attach your ssh '''public''' key which usually named id_rsa.pub. If you don't have one generate it by running <tt>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</tt>.		# Attach your ssh '''public''' key which usually named id_rsa.pub. If you don't have one generate it by running <tt>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</tt>.
	# List the repositories you're planning to contribute to.		# List the repositories you're planning to contribute to.

MichaelHalstead: Update ssh URLs to use new push.yoctoproject.org domain

2017-09-26T14:28:53Z

Update ssh URLs to use new push.yoctoproject.org domain

← Older revision		Revision as of 14:28, 26 September 2017
Line 34:		Line 34:
	Once you have access, you will be able to clone and push to:		Once you have access, you will be able to clone and push to:

	<pre>git@~~git~~.yoctoproject.org:poky-contrib.git</pre>		<pre>git@push.yoctoproject.org:poky-contrib.git</pre>

	Or any of the other repositories at git.yoctoproject.org.		Or any of the other repositories at git.yoctoproject.org.
Line 71:		Line 71:
	'''Read-write:'''		'''Read-write:'''

	<pre>$ git remote add poky-contrib ssh://git@~~git~~.yoctoproject.org/poky-contrib</pre>		<pre>$ git remote add poky-contrib ssh://git@push.yoctoproject.org/poky-contrib</pre>

	=== Clone a (non-Poky) Repository from git.yoctoproject.org ===		=== Clone a (non-Poky) Repository from git.yoctoproject.org ===
Line 83:		Line 83:
	'''Read-write:'''		'''Read-write:'''

	<pre>$ git clone ssh://git@~~git~~.yoctoproject.org/<repository-name></pre>		<pre>$ git clone ssh://git@push.yoctoproject.org/<repository-name></pre>

MichaelHalstead: Updated access request section.

2017-05-05T00:15:59Z

Updated access request section.

← Older revision		Revision as of 00:15, 5 May 2017
Line 23:		Line 23:
	There are a number of git repositories at the [http://git.yoctoproject.org/cgit/cgit.cgi/ Yocto Project git server]. If you need to contribute to any of these repos you can follow the instructions below. Consider that poky-contrib is the most solicited repo so it is also the example that appears in the guide.		There are a number of git repositories at the [http://git.yoctoproject.org/cgit/cgit.cgi/ Yocto Project git server]. If you need to contribute to any of these repos you can follow the instructions below. Consider that poky-contrib is the most solicited repo so it is also the example that appears in the guide.

	=== Request Access ===		=== Request Write Access ===

	To ~~access~~ a repo ~~from~~ git.yoctoproject.org, including poky-contrib, please send an email to [mailto:mhalstead@linuxfoundation.org Michael Halstead] ~~with an~~ ssh key ~~from each person needing access along with~~ the ~~list of~~ repositories you're ~~trying~~ to contribute to.		To write to a repo on git.yoctoproject.org, including poky-contrib, please send an email to [mailto:mhalstead@linuxfoundation.org Michael Halstead] and:
			# Attach your ssh '''public''' key which usually named id_rsa.pub. If you don't have one generate it by running <tt>ssh-keygen -t rsa -b 4096 -C "your_email@example.com"</tt>.
			# List the repositories you're planning to contribute to.
			# Include your preferred branch prefix for *-contrib repositories. See [http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/refs/heads git.yoctoproject.org] to see which prefixes are already in use.

	== Poky Contrib Repository ==		== Poky Contrib Repository ==

Benjamin: /* Git workflow */

2016-06-17T01:23:48Z

Git workflow

← Older revision		Revision as of 01:23, 17 June 2016
Line 44:		Line 44:

	== Git workflow ==		== Git workflow ==

			[http://git.yoctoproject.org/cgit/cgit.cgi/poky/ Poky] is a read-only repository that only the maintainers are able to write to. For contributions, there exists [http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/ poky-contrib]. The first part of the git workflow explanation intends to let you know how to use these two repositories for:

			# Base your code changes from the poky repository
			# Publish your contributions to the poky-contrib repository

			You can skip to the [[Poky_Contributions#Clone_a_Repository_from_git.yoctoproject.org \| Clone a Repository from git.yoctoproject.org]] section if you are not working in the poky-contrib repository, not all the repositories require this double relationship for contributions.

			=== Git Clone Poky===

	Clone the main git tree (if you haven't already):		Clone the main git tree (if you haven't already):

	git clone git://git.yoctoproject.org/poky		<pre>$ git clone git://git.yoctoproject.org/poky</pre>

	Add ~~the~~ poky-contrib as a ~~read only remote repository:~~		=== Add poky-contrib as a Git Remote ===

	~~git remote~~ add poky-contrib ~~git~~:~~//git.yoctoproject.org/poky-contrib~~		You have the option to add the poky-contrib remote as a read-only (perhaps for the case where you haven't sent the ssh access keys) or as read-write if you have cleared your write access as indicated in [[Poky_Contributions#Request_Access]]. Execute only one of the two following instructions:

	- ~~or since you probably want to be able to push your branch back to~~ poky-contrib~~, check it out as a read~~/write ~~repository~~:		'''Read-only:'''

			<pre>$ git remote add poky-contrib git://git.yoctoproject.org/poky-contrib</pre>

			'''Read-write:'''

	git remote add poky-contrib ssh://git@git.yoctoproject.org/poky-contrib		<pre>$ git remote add poky-contrib ssh://git@git.yoctoproject.org/poky-contrib</pre>

			=== Clone a (non-Poky) Repository from git.yoctoproject.org ===

			The process is simple for contributions that are not based off of the Poky repository. For any other repository at [http://git.yoctoproject.org/cgit/cgit.cgi/ git.yoctoproject.org] that is not Poky, you can just clone it either read-only or read-write as follows:

	~~Create a branch, originating at the tip, that you will push to poky~~-~~contrib~~:		'''Read-only:'''

	git checkout -b name/topic-of-branch		<pre>$ git clone git://git.yoctoproject.org/<repository-name></pre>

			'''Read-write:'''

			<pre>$ git clone ssh://git@git.yoctoproject.org/<repository-name></pre>


			=== Developer Git Branches ===

			Create a branch, originating at the tip, that you will push:

			<pre>git checkout -b name/topic-of-branch</pre>

	The convention is that the branch name contains your name followed by a forward slash and then the topic of the branch e.g. "michaelw/fixes-thing".		The convention is that the branch name contains your name followed by a forward slash and then the topic of the branch e.g. "michaelw/fixes-thing".

	Add changes to this branch ensuring commit messages follow the standard format defined below. When ~~they~~ are ready, you can push them:		Add changes to this branch ensuring commit messages follow the standard format defined below.

			==== Pushing Developer Git Branches ====

			When your changes are ready, you can push them:

			'''Pushing to poky-contrib'''
			<pre>git push -u poky-contrib branch-name:remote-branch-name</pre>

	~~git push -u poky-contrib branch-name~~:~~remote-branch-name~~		'''Pushing to any other repository:'''

	~~If you want to replace an existing~~ branch ~~on poky~~-~~contrib with a new one, i.e. you fixed something or the old one was merged and you want to reuse the~~ branch ~~for new patches, add~~ -~~f to the git push command.~~		<pre>git push branch-name:remote-branch-name</pre>

	When this is done, you'll be able to see your branch at http://git.yoctoproject.org/cgit/cgit.cgi/~~poky-contrib/~~		When this is done, you'll be able to see your branch at the [http://git.yoctoproject.org/cgit/cgit.cgi/ gitweb interface], just navigate to the repository you pushed it to.

	Once it's ~~merged~~ please remember to delete your branch from ~~poky-contrib~~.		Once it's no longer useful please remember to delete your branch from the remote.

	== Git commit messages ==		== Git commit messages ==

Benjamin at 00:47, 17 June 2016

2016-06-17T00:47:28Z

← Older revision		Revision as of 00:47, 17 June 2016
Line 19:		Line 19:
	# Richard/Saul pulls target branch into Poky upstream		# Richard/Saul pulls target branch into Poky upstream

	== ~~Poky Contrib Branch~~ ==		== Access to git.yoctoproject.org Repositories==

	~~To access~~ the poky-contrib ~~tree please send Michael Halstead an ssh key from each person needing access~~. ~~You will then be able to clone and push to:~~		There are a number of git repositories at the [http://git.yoctoproject.org/cgit/cgit.cgi/ Yocto Project git server]. If you need to contribute to any of these repos you can follow the instructions below. Consider that poky-contrib is the most solicited repo so it is also the example that appears in the guide.

	git@git.yoctoproject.org:poky-contrib.git		=== Request Access ===

			To access a repo from git.yoctoproject.org, including poky-contrib, please send an email to [mailto:mhalstead@linuxfoundation.org Michael Halstead] with an ssh key from each person needing access along with the list of repositories you're trying to contribute to.

			== Poky Contrib Repository ==

			Once you have access, you will be able to clone and push to:

			<pre>git@git.yoctoproject.org:poky-contrib.git</pre>

			Or any of the other repositories at git.yoctoproject.org.

	You might want to use git remote to pull from the master poky tree so that you pull in updates from there.		You might want to use git remote to pull from the master poky tree so that you pull in updates from there.

Bavery at 15:38, 18 August 2015

2015-08-18T15:38:21Z

← Older revision		Revision as of 15:38, 18 August 2015
Line 39:		Line 39:
	git clone git://git.yoctoproject.org/poky		git clone git://git.yoctoproject.org/poky

	Add the poky-contrib as a remote repository:		Add the poky-contrib as a read only remote repository:

	git remote add poky-contrib git://git.yoctoproject.org/poky-contrib		git remote add poky-contrib git://git.yoctoproject.org/poky-contrib

			- or since you probably want to be able to push your branch back to poky-contrib, check it out as a read/write repository:

			git remote add poky-contrib ssh://git@git.yoctoproject.org/poky-contrib

	Create a branch, originating at the tip, that you will push to poky-contrib:		Create a branch, originating at the tip, that you will push to poky-contrib:

Michael Wood at 10:40, 9 April 2015

2015-04-09T10:40:15Z

← Older revision		Revision as of 10:40, 9 April 2015
Line 57:		Line 57:
	When this is done, you'll be able to see your branch at http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/		When this is done, you'll be able to see your branch at http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/

			Once it's merged please remember to delete your branch from poky-contrib.

	== Git commit messages ==		== Git commit messages ==

Michael Wood at 14:43, 7 April 2015

2015-04-07T14:43:46Z

← Older revision		Revision as of 14:43, 7 April 2015
Line 31:		Line 31:
	http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/		http://git.yoctoproject.org/cgit/cgit.cgi/poky-contrib/

	~~where~~ existing user branches can be seen~~. Since none of the work is confidential at this time, its fine to use the public server~~.		Where existing user branches can be seen.

	== Git workflow ==		== Git workflow ==

	Clone the main git tree:		Clone the main git tree (if you haven't already):

	git clone git://git.yoctoproject.org/poky		git clone git://git.yoctoproject.org/poky

			Add the poky-contrib as a remote repository:

	git remote add poky-contrib git://git.yoctoproject.org/poky-contrib		git remote add poky-contrib git://git.yoctoproject.org/poky-contrib