Re: RTEMS Project Repos in GitLab

2024-05-13 Thread Gedare Bloom
On Mon, May 13, 2024 at 10:46 AM Frank Kühndel
 wrote:
>
> Hello Chris,
>
> I just did not managed to find git://git.rtems.org/rtems_waf.git on
> gitlab. Has been moved too or will it stay were it was?
>
Thanks for bringing this up. https://gitlab.rtems.org/rtems/tools/rtems-waf

It should work checked out as either 'rtems-waf.git' or
'rtems_waf.git' now,
https://gitlab.rtems.org/administration/gitlab/-/issues/55

I guess someone should submit an Issue and MR for fixing the submodule link

> Thanks,
> Frank
>
> On 5/1/24 08:46, Chris Johns wrote:
> > Hi RTEMS Community.
> >
> > This email explains the RTEMS Project and Repos in GitLab.
> >
> > GitLab is will be open and accounts can be created from 12PM EST / 5PM GM.
> >
> > Note, GitLab failed to automatically identify the RTOS/RTEMS licence and it
> > incorrectly states it is Apache 2.0. It is not and no licences have 
> > changed. An
> > issue is open to sort this out.
> >
> > GitLab lets you have repositories structured as projects. We have a top 
> > level
> > namespace called RTEMS and our repositories reside under this namespace. 
> > Having
> > everything under a single namespace lets us use a lot of cool GitLab 
> > features.
> > The link ishttps://gitlab.rtems.org/rtems.
> >
> > We have some other namespaces alongside RTEMS such as Administration, 
> > Approvers
> > and Architecture. The projects in the top level namespace are place holders 
> > for
> > the groups we use across GitHub and groups let us control what users can do.
> > The Administration project is used to run GitLab and the servers we have at 
> > OSL
> > OSU. If you have found a bug or problem please raise an issue. If you have a
> > feature or a good idea please raise an issue. If you know an answer to an 
> > issue
> > that is open please answer.
> >
> > The Architecture project lets us define groups of users who can own and 
> > approve
> > architecture specific parts of RTEMS. We have this at the top so 
> > architecture
> > owners can manage CI runners.
> >
> > The top level RTEMS Project contains the following project groups:
> >
> >   1. Documentation - Our documentation.
> >
> >   2. Packages - The various packages we can build for RTEMS. Think of them
> >  as 3rd party libraries
> >
> >   3. Pre-Qualification - The pre-qualification projects based on the
> >  recent ESA funded work
> >
> >   4. RTOS - The real-time kernel, its examples and the release scripts
> >
> >   5. Tools - Our ecosystem tools such as the RSB, RTEMS Tools and the
> >  SIS simulator
> >
> >   6. Programs - A place to organise activities similar or related to
> >  Google Summer of Code
> >
> > Main Branch
> >
> > We have chosen this time to move from a master branch to main on all our 
> > repos.
> > Leaving the git.rtems.org repos open while we worked on GitLab meant the 
> > project
> > could continue to function as we deployed GitLab however we have had to make
> > commits in the GitLab repos to add files like CODEOWNERS and to test the
> > platform. The simplest solution for us is to roll any commits to 
> > git.rtems.org
> > into the GitLab repos before we go live. If you have maintained any waiting 
> > to
> > be merged on local branches in your repo you can rebase to the main branch. 
> > The
> > following is an example of how to switch an RTEMS git.rtems.org repo you 
> > use to
> > track RTEMS to RTEMS GitLab:
> >
> >   1. The procedure assumes your local master branch matches the 
> > git.rtems.org
> >  master branch and any changes you have are on local branches.
> >
> >   2. Set the remote  origin to GitLab:
> >   git remote set-url 
> > originssh://g...@gitlab.rtems.org:/rtems/rtos/rtems.git
> >
> >   3. Fetch the GitLab repo:
> >   git fetch
> >
> >   4. Check out the GitLab main branch:
> >   git checkout main
> >
> >   5. We recommend you delete your local master branch:
> >   git branch -D master
> >
> > The following is an example of how to switch an RTEMS git.rtems.org repo you
> > have changed in you wish to post for review and merging to RTEMS GitLab:
> >
> >   1. The procedure assumes your local master branch matches the 
> > git.rtems.org
> >  master branch and any changes you have are on local branches.
> >
> >   2. Fork the GitLab repo to your user account. Open the project repo in 
> > GitLab
> >  and cl

Re: RTEMS Project Repos in GitLab

2024-05-13 Thread Frank Kühndel

Hello Chris,

I just did not managed to find git://git.rtems.org/rtems_waf.git on 
gitlab. Has been moved too or will it stay were it was?


Thanks,
Frank

On 5/1/24 08:46, Chris Johns wrote:

Hi RTEMS Community.

This email explains the RTEMS Project and Repos in GitLab.

GitLab is will be open and accounts can be created from 12PM EST / 5PM GM.

Note, GitLab failed to automatically identify the RTOS/RTEMS licence and it
incorrectly states it is Apache 2.0. It is not and no licences have changed. An
issue is open to sort this out.

GitLab lets you have repositories structured as projects. We have a top level
namespace called RTEMS and our repositories reside under this namespace. Having
everything under a single namespace lets us use a lot of cool GitLab features.
The link ishttps://gitlab.rtems.org/rtems.

We have some other namespaces alongside RTEMS such as Administration, Approvers
and Architecture. The projects in the top level namespace are place holders for
the groups we use across GitHub and groups let us control what users can do.
The Administration project is used to run GitLab and the servers we have at OSL
OSU. If you have found a bug or problem please raise an issue. If you have a
feature or a good idea please raise an issue. If you know an answer to an issue
that is open please answer.

The Architecture project lets us define groups of users who can own and approve
architecture specific parts of RTEMS. We have this at the top so architecture
owners can manage CI runners.

The top level RTEMS Project contains the following project groups:

  1. Documentation - Our documentation.

  2. Packages - The various packages we can build for RTEMS. Think of them
 as 3rd party libraries

  3. Pre-Qualification - The pre-qualification projects based on the
 recent ESA funded work

  4. RTOS - The real-time kernel, its examples and the release scripts

  5. Tools - Our ecosystem tools such as the RSB, RTEMS Tools and the
 SIS simulator

  6. Programs - A place to organise activities similar or related to
 Google Summer of Code

Main Branch

We have chosen this time to move from a master branch to main on all our repos.
Leaving the git.rtems.org repos open while we worked on GitLab meant the project
could continue to function as we deployed GitLab however we have had to make
commits in the GitLab repos to add files like CODEOWNERS and to test the
platform. The simplest solution for us is to roll any commits to git.rtems.org
into the GitLab repos before we go live. If you have maintained any waiting to
be merged on local branches in your repo you can rebase to the main branch. The
following is an example of how to switch an RTEMS git.rtems.org repo you use to
track RTEMS to RTEMS GitLab:

  1. The procedure assumes your local master branch matches the git.rtems.org
 master branch and any changes you have are on local branches.

  2. Set the remote  origin to GitLab:
  git remote set-url 
originssh://g...@gitlab.rtems.org:/rtems/rtos/rtems.git

  3. Fetch the GitLab repo:
  git fetch

  4. Check out the GitLab main branch:
  git checkout main

  5. We recommend you delete your local master branch:
  git branch -D master

The following is an example of how to switch an RTEMS git.rtems.org repo you
have changed in you wish to post for review and merging to RTEMS GitLab:

  1. The procedure assumes your local master branch matches the git.rtems.org
 master branch and any changes you have are on local branches.

  2. Fork the GitLab repo to your user account. Open the project repo in GitLab
 and click Fork, located top right. You will need to select a namespace
 and it needs to be the one based on your user name. Select the namespace
 drop down in the Project URL field and scroll down or enter your user name
 and click on the entry.

  3. Set the remote  origin to GitLab:
  git remote set-url originssh://g...@gitlab.rtems.org:/chris/rtems.git
 Replace my user name with yours.

  4. Fetch the GitLab repo:
  git fetch

  5. Check out the GitLab main branch:
  git checkout main

  6. We recommend you delete your local master branch:
  git branch -D master

Merge Request Approvers

Every merge request in RTEMS requires two approvers. Approvers are organized as
members of subgroups within the top-level Approvers group
https://gitlab.rtems.org/approvers.

We have added initial CODEOWNERS files in GitLab that details which subgroups
own and approve merge requests. There are some members of the community who need
to be added to specific subgroups but we cannot add them until they have
accounts. If you want to be a code owner and approver please raise an
Administration issue. Anyone in the subgroup of “General Approver” is able to be
one of the approvers of  merge requests. However, at least one approver must
belong to a subgroup that is a code owner for a specific file or directory.
Self-approval by the author of the merge request

RTEMS Project Repos in GitLab

2024-05-01 Thread Chris Johns
Hi RTEMS Community.

This email explains the RTEMS Project and Repos in GitLab.

GitLab is will be open and accounts can be created from 12PM EST / 5PM GM.

Note, GitLab failed to automatically identify the RTOS/RTEMS licence and it
incorrectly states it is Apache 2.0. It is not and no licences have changed. An
issue is open to sort this out.

GitLab lets you have repositories structured as projects. We have a top level
namespace called RTEMS and our repositories reside under this namespace. Having
everything under a single namespace lets us use a lot of cool GitLab features.
The link is https://gitlab.rtems.org/rtems.

We have some other namespaces alongside RTEMS such as Administration, Approvers
and Architecture. The projects in the top level namespace are place holders for
the groups we use across GitHub and groups let us control what users can do.
The Administration project is used to run GitLab and the servers we have at OSL
OSU. If you have found a bug or problem please raise an issue. If you have a
feature or a good idea please raise an issue. If you know an answer to an issue
that is open please answer.

The Architecture project lets us define groups of users who can own and approve
architecture specific parts of RTEMS. We have this at the top so architecture
owners can manage CI runners.

The top level RTEMS Project contains the following project groups:

 1. Documentation - Our documentation.

 2. Packages - The various packages we can build for RTEMS. Think of them
as 3rd party libraries

 3. Pre-Qualification - The pre-qualification projects based on the
recent ESA funded work

 4. RTOS - The real-time kernel, its examples and the release scripts

 5. Tools - Our ecosystem tools such as the RSB, RTEMS Tools and the
SIS simulator

 6. Programs - A place to organise activities similar or related to
Google Summer of Code

Main Branch

We have chosen this time to move from a master branch to main on all our repos.
Leaving the git.rtems.org repos open while we worked on GitLab meant the project
could continue to function as we deployed GitLab however we have had to make
commits in the GitLab repos to add files like CODEOWNERS and to test the
platform. The simplest solution for us is to roll any commits to git.rtems.org
into the GitLab repos before we go live. If you have maintained any waiting to
be merged on local branches in your repo you can rebase to the main branch. The
following is an example of how to switch an RTEMS git.rtems.org repo you use to
track RTEMS to RTEMS GitLab:

 1. The procedure assumes your local master branch matches the git.rtems.org
master branch and any changes you have are on local branches.

 2. Set the remote  origin to GitLab:
 git remote set-url origin 
ssh://g...@gitlab.rtems.org:/rtems/rtos/rtems.git

 3. Fetch the GitLab repo:
 git fetch

 4. Check out the GitLab main branch:
 git checkout main

 5. We recommend you delete your local master branch:
 git branch -D master

The following is an example of how to switch an RTEMS git.rtems.org repo you
have changed in you wish to post for review and merging to RTEMS GitLab:

 1. The procedure assumes your local master branch matches the git.rtems.org
master branch and any changes you have are on local branches.

 2. Fork the GitLab repo to your user account. Open the project repo in GitLab
and click Fork, located top right. You will need to select a namespace
and it needs to be the one based on your user name. Select the namespace
drop down in the Project URL field and scroll down or enter your user name
and click on the entry.

 3. Set the remote  origin to GitLab:
 git remote set-url origin ssh://g...@gitlab.rtems.org:/chris/rtems.git
Replace my user name with yours.

 4. Fetch the GitLab repo:
 git fetch

 5. Check out the GitLab main branch:
 git checkout main

 6. We recommend you delete your local master branch:
 git branch -D master

Merge Request Approvers

Every merge request in RTEMS requires two approvers. Approvers are organized as
members of subgroups within the top-level Approvers group
https://gitlab.rtems.org/approvers.

We have added initial CODEOWNERS files in GitLab that details which subgroups
own and approve merge requests. There are some members of the community who need
to be added to specific subgroups but we cannot add them until they have
accounts. If you want to be a code owner and approver please raise an
Administration issue. Anyone in the subgroup of “General Approver” is able to be
one of the approvers of  merge requests. However, at least one approver must
belong to a subgroup that is a code owner for a specific file or directory.
Self-approval by the author of the merge request is not allowed.

Please take a few minutes to look over the project structure. A project has its
own issues so when you want to create a new issue please add it to the project
it relates to. We can link issues across projects