You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@turbine.apache.org by Georg Kallidis <ge...@cedis.fu-berlin.de> on 2022/01/11 09:23:59 UTC
New Git repo structures
Hi Turbine Devs,
for all interested participating in the development of the Turbine Project
(and this is the Turbine Dev list :-)!) I want to share some information
here about two GIT structural repos, which may not be known to many of us
yet as they are quite new (and more information is still not available on
our sites).
Two GIT structures are created in Git (Apache gitbox/Gitbox):
https://github.com/apache/turbine-build
and https://github.com/apache/turbine-fulcrum-build.
They reflect on the one side old behaviour in SVN (e.g. building Fulcrum
modules), on the other side are a good place to share common
informations/integrations.
It all started with the migration from SVN to GIT beginning what to do
with the site building (you may find some INFRA tickets if you want) ...
First: As a result site deployment has changed as may have occurred to
some already. Find here more information about the mechanism in general:
https://cwiki.apache.org/confluence/display/INFRA/git+-+.asf.yaml+features
and how it is done in Turbine:
https://github.com/apache/turbine-build/blob/master/README_TECHNICAL_SITE_STRUCTURE.md
The way to go from here seems to be to try to do it more automatically
e.g. using a Jenkinsfile, that is use the Apache Jenkins build environment
to trigger build processes.
This is currently still "work in process" (check the Jenkinsfiles in the
two repos and the pipeline integrations, if you 've access to the test
environment here: https://ci-builds.apache.org/job/Turbine/; if you
haven't access, ask for it as a committer).
Second: To build and check shared sub projects turbine-build contains the
turbine-fulcrum-build and the other "main Turbine projects": Core,
Archetypes, Parent and Site, while the turbine-fulcrum-build contains the
Fulcrum components. "Containing" does mean containing the "real" projects
as Git submodules. The result could be seen at the moment two-fold: The
container pom.xml provides a maven module structure allowing a plain build
from the git modules and secondly having a place to share information
relevant for all or many projects (READMEs, Build tools like Jenkinsfile).
One important caveat here: To use it properly make you familiar with the
intricaties of git submodule, which are a some times very useful, some
times cumbersome.
Some basic imformation to deal with this are shared here:
https://github.com/apache/turbine-build/blob/master/README_TECHNICAL_GITMODULES.md
I hope you find it useful and do not hesitate to give feedback !
Thanks and best regards, Georg