Gentoo Forums
Gentoo Forums
Gentoo Forums
Quick Search: in
How do I create an overlay?
View unanswered posts
View posts from last 24 hours

 
Reply to topic    Gentoo Forums Forum Index Other Things Gentoo
View previous topic :: View next topic  
Author Message
audiodef
Watchman
Watchman


Joined: 06 Jul 2005
Posts: 6639
Location: The soundosphere

PostPosted: Tue Nov 17, 2015 12:52 am    Post subject: How do I create an overlay? Reply with quote

I've found plenty of information about hosting overlays, but I haven't found useful information about creating an overlay. Is there a file with a specific structure I need to create? Do I use git/subversion? What exactly goes into that git/subversion repo? How do I turn my local overlay into something I can share with other people through layman?
_________________
decibel Linux: https://decibellinux.org
Github: https://github.com/Gentoo-Music-and-Audio-Technology
Facebook: https://www.facebook.com/decibellinux
Discord: https://discord.gg/73XV24dNPN
Back to top
View user's profile Send private message
khayyam
Watchman
Watchman


Joined: 07 Jun 2012
Posts: 6227
Location: Room 101

PostPosted: Tue Nov 17, 2015 3:14 am    Post subject: Reply with quote

audiodef ...

If you have a local overlay then this is pretty much ready to go ... all you need do is find somewhere to host it (ie, github.com or anongit.gentoo.org). An overlay is simply a directory tree and a profiles/repo_name.

As for the hosting you could use github, or contact infra with regard to anongit.gentoo.org. For the former you need to create an account and then select 'repositories', then 'new', and provide a name for the repo. You then 'pull' the (empty) repo so there is a local copy, add the files and 'git push' ... you might want to setup a ssh key on github before hand. It might also be a good idea to replace the /path/to/overlay with the git repo you pulled (once you've moved all the files from the former).

To get your overlay into repositories.xml you need to send an email to 'overlays AT gentoo dot org'.

HTH & best ... khay
Back to top
View user's profile Send private message
steveL
Watchman
Watchman


Joined: 13 Sep 2006
Posts: 5153
Location: The Peanut Gallery

PostPosted: Tue Nov 17, 2015 11:19 am    Post subject: Reply with quote

You don't need:
Code:
echo aname > profiles/repo_name
You can just put it in the required file metadata/layout.conf:
Code:
repo-name = aname
masters = gentoo
profile-formats = portage-2
cache-formats = md5-dict
thin-manifests = true
use-manifests = strict
# git signing: git config user.signingkey "$key_id"
sign-commits = true
Thanks to mv for those (can't find the post) and Ant P (next post).

See man portage; layout.conf is under SPECIFIC FILE DESCRIPTIONS, in /usr/portage/metadata
around line 900 or so. Searching /layout.conf is useful, as it's mentioned in relation to other settings.

edit: sign-commits, profile-formats, use-manifests = strict


Last edited by steveL on Sun Nov 22, 2015 7:55 am; edited 1 time in total
Back to top
View user's profile Send private message
Ant P.
Watchman
Watchman


Joined: 18 Apr 2009
Posts: 6920

PostPosted: Sat Nov 21, 2015 7:34 pm    Post subject: Reply with quote

If you're using git, it's good practice to put "sign-commits = true" in there too.

layout.conf keys are documented in `man 5 portage`, line 900 or so.
Back to top
View user's profile Send private message
steveL
Watchman
Watchman


Joined: 13 Sep 2006
Posts: 5153
Location: The Peanut Gallery

PostPosted: Sun Nov 22, 2015 7:58 am    Post subject: Reply with quote

Cheers for the info, Ant; updated the post to reflect.

Wasn't sure about:
Code:
# indicate that this repo enables repoman's --echangelog=y option automatically
update-changelog = true
# indicate that this repo contains both md5-dict and pms cache formats,
# which may be generated by egencache(1)
cache-formats = md5-dict pms
(latter is what mv recommends to avoid?)
Back to top
View user's profile Send private message
Display posts from previous:   
Reply to topic    Gentoo Forums Forum Index Other Things Gentoo All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum