Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 492856 - Request for overlay hosting
Summary: Request for overlay hosting
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Infrastructure
Classification: Unclassified
Component: Gentoo Overlays (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Gentoo Overlays Project
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-11-29 12:36 UTC by Joao Carreira
Modified: 2014-04-03 18:59 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments
SSH pubkey (id_carreira_gentoo.pub,393 bytes, application/vnd.ms-publisher)
2013-11-29 12:36 UTC, Joao Carreira
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Joao Carreira 2013-11-29 12:36:18 UTC
Created attachment 364190 [details]
SSH pubkey

Overlay Name: carreira-overlay
An extra-short description: carreira personal overlay
Owner name and e-mail:
Joao Carreira (jfmcarreira@gmail.com)
SSH pubkey sent attached
Comment 1 Pavlos Ratis (RETIRED) Gentoo Infrastructure gentoo-dev 2014-03-23 22:39:53 UTC
(In reply to Joao Carreira from comment #0)
> Created attachment 364190 [details]
> SSH pubkey
> 
> Overlay Name: carreira-overlay
> An extra-short description: carreira personal overlay
> Owner name and e-mail:
> Joao Carreira (jfmcarreira@gmail.com)
> SSH pubkey sent attached

Hello,

Your user overlay "carreira" is almost ready.
Please read (all of) this guide to get it to work.

If you have any question we'll be here to help.


In this Guide
=============
- Terms of Service
- The Initial Push
- After That
  - Online Browsing
  - Getting into Layman
  - Keeping your overlay healthy


Terms of Service
================
The infra team has worked out the terms of service for us. To make us host your user overlay you need to accept these terms, which I don't expect to be a problem. By pushing to the remote repository you are accepting these terms:

  -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  Use of this service is  limited to overlays containing ebuilds
  and  supporting  files  (e.g.  init.d  scripts,  configuration
  files, patches,  but not distfiles)  and must follow  the same
  guidelines as apply to the gentoo-x86 tree of Gentoo.

  Any or all uses of this  service and all files on this service
  may  be  intercepted,  monitored, recorded,  copied,  audited,
  inspected, and disclosed to authorized site personnel, as well
  as authorized  officials of federal law  enforcement agencies,
  both domestic  and foreign.  By  using this service,  the user
  consents to such interception, monitoring, recording, copying,
  auditing,  inspection, and  disclosure  at  the discretion  of
  authorized site  personnel.  Use  of this  service constitutes
  consent to  security monitoring and testing.   All activity is
  logged with  your host name  and IP address.   Unauthorized or
  improper use of this service  may result in civil and criminal
  penalties.   By continuing  to use  this service  you indicate
  your awareness of and consent to these terms and conditions of
  use.   -- Gentoo Linux Infrastructure Admins

                      CEASE USE IMMEDIATELY,
   if you do not agree to the conditions stated in this warning.
                       *******************
  -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --


The Initial Push
================

First, before anybody can clone from your overlay an initial push is needed.

0) If you start with an empty repository be sure to setup your identity:

     # git init
     # git config user.name 'first last'
     # git config user.email foo@example.org
     [..]

1) Once you have ebuilds in there please set profiles/repo_name to
   'carreira' in order to make it a valid overlay.

     # mkdir profiles
     # echo "carreira" > profiles/repo_name
     # git add profiles/repo_name
     # git commit

2) Now you are ready to push.  Proposed way of doing is this:

     # git remote add overlays-gentoo-org \
           git+ssh://git@git.overlays.gentoo.org/user/carreira.git
     # git push overlays-gentoo-org master


After That
==========

Online Browsing
---------------
After the initial push you can browse your overlay online at:
http://git.overlays.gentoo.org/gitweb/?p=user/carreira.git;a=summary


Getting into Layman
-------------------
We have scripts to get hosted overlay into Layman easily: no need to write XML on your end.  Just let us know that you did complete the procedure from "The Initial Push" to get added.

Once it's in the Layman registry its content will be indexed at http://gpo.zugaina.org/ and two dedicated views of your overlay will appear at http://gentoo-overlays.zugaina.org/carreira/ and http://gpo.zugaina.org/Overlays/carreira/, too.


Keeping your overlay healthy
----------------------------
A few rules of thumb help to keep your overlay most useful to you and others:

 - If you package newer versions of software that is packaged in Gentoo
   already, try to get the version in Gentoo updated, too.
   (If there is no bump request on https://bugs.gentoo.org/ please file
   one and share patches you may have produced.)

 - If you apply custom patches make sure that you never use the very
   same revision that is used in Gentoo, e.g. if you use the ebuild
   of app-arch/bzip2-1.0.6-r3 do not call it app-arch/bzip2-1.0.6-r3
   in your overlay to avoid confusion.

A tool called "overlint" can support you with that process:

  # sudo emerge -av app-portage/overlint

For a quick introduction to overlint see http://blog.hartwork.org/?p=1667 .

Thanks,

Pavlos Ratis
for the Gentoo Overlays Team
Comment 2 Joao Carreira 2014-04-03 18:59:25 UTC
(In reply to Pavlos Ratis from comment #1)
> (In reply to Joao Carreira from comment #0)
> > Created attachment 364190 [details]
> > SSH pubkey
> > 
> > Overlay Name: carreira-overlay
> > An extra-short description: carreira personal overlay
> > Owner name and e-mail:
> > Joao Carreira (jfmcarreira@gmail.com)
> > SSH pubkey sent attached
> 
> Hello,
> 
> Your user overlay "carreira" is almost ready.
> Please read (all of) this guide to get it to work.
> 
> If you have any question we'll be here to help.
> 
> 
> In this Guide
> =============
> - Terms of Service
> - The Initial Push
> - After That
>   - Online Browsing
>   - Getting into Layman
>   - Keeping your overlay healthy
> 
> 
> Terms of Service
> ================
> The infra team has worked out the terms of service for us. To make us host
> your user overlay you need to accept these terms, which I don't expect to be
> a problem. By pushing to the remote repository you are accepting these terms:
> 
>   -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
>   Use of this service is  limited to overlays containing ebuilds
>   and  supporting  files  (e.g.  init.d  scripts,  configuration
>   files, patches,  but not distfiles)  and must follow  the same
>   guidelines as apply to the gentoo-x86 tree of Gentoo.
> 
>   Any or all uses of this  service and all files on this service
>   may  be  intercepted,  monitored, recorded,  copied,  audited,
>   inspected, and disclosed to authorized site personnel, as well
>   as authorized  officials of federal law  enforcement agencies,
>   both domestic  and foreign.  By  using this service,  the user
>   consents to such interception, monitoring, recording, copying,
>   auditing,  inspection, and  disclosure  at  the discretion  of
>   authorized site  personnel.  Use  of this  service constitutes
>   consent to  security monitoring and testing.   All activity is
>   logged with  your host name  and IP address.   Unauthorized or
>   improper use of this service  may result in civil and criminal
>   penalties.   By continuing  to use  this service  you indicate
>   your awareness of and consent to these terms and conditions of
>   use.   -- Gentoo Linux Infrastructure Admins
> 
>                       CEASE USE IMMEDIATELY,
>    if you do not agree to the conditions stated in this warning.
>                        *******************
>   -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
> 
> 
> The Initial Push
> ================
> 
> First, before anybody can clone from your overlay an initial push is needed.
> 
> 0) If you start with an empty repository be sure to setup your identity:
> 
>      # git init
>      # git config user.name 'first last'
>      # git config user.email foo@example.org
>      [..]
> 
> 1) Once you have ebuilds in there please set profiles/repo_name to
>    'carreira' in order to make it a valid overlay.
> 
>      # mkdir profiles
>      # echo "carreira" > profiles/repo_name
>      # git add profiles/repo_name
>      # git commit
> 
> 2) Now you are ready to push.  Proposed way of doing is this:
> 
>      # git remote add overlays-gentoo-org \
>            git+ssh://git@git.overlays.gentoo.org/user/carreira.git
>      # git push overlays-gentoo-org master
> 
> 
> After That
> ==========
> 
> Online Browsing
> ---------------
> After the initial push you can browse your overlay online at:
> http://git.overlays.gentoo.org/gitweb/?p=user/carreira.git;a=summary
> 
> 
> Getting into Layman
> -------------------
> We have scripts to get hosted overlay into Layman easily: no need to write
> XML on your end.  Just let us know that you did complete the procedure from
> "The Initial Push" to get added.
> 
> Once it's in the Layman registry its content will be indexed at
> http://gpo.zugaina.org/ and two dedicated views of your overlay will appear
> at http://gentoo-overlays.zugaina.org/carreira/ and
> http://gpo.zugaina.org/Overlays/carreira/, too.
> 
> 
> Keeping your overlay healthy
> ----------------------------
> A few rules of thumb help to keep your overlay most useful to you and others:
> 
>  - If you package newer versions of software that is packaged in Gentoo
>    already, try to get the version in Gentoo updated, too.
>    (If there is no bump request on https://bugs.gentoo.org/ please file
>    one and share patches you may have produced.)
> 
>  - If you apply custom patches make sure that you never use the very
>    same revision that is used in Gentoo, e.g. if you use the ebuild
>    of app-arch/bzip2-1.0.6-r3 do not call it app-arch/bzip2-1.0.6-r3
>    in your overlay to avoid confusion.
> 
> A tool called "overlint" can support you with that process:
> 
>   # sudo emerge -av app-portage/overlint
> 
> For a quick introduction to overlint see http://blog.hartwork.org/?p=1667 .
> 
> Thanks,
> 
> Pavlos Ratis
> for the Gentoo Overlays Team


The initial build of the overlay is finished. Packages are update.
Will the repo now be available in the layman database?