Stöd för Git-undermodul för Adobe-databaser git-submodule-support
Git-undermoduler kan användas för att sammanfoga innehåll från flera grenar i Git-databaser vid byggtillfället.
När Cloud Manager byggprocess körs, efter att databasen som konfigurerats för pipelinen har klonats och den konfigurerade grenen har checkats ut, körs kommandot om grenen innehåller en .gitmodules-fil i rotkatalogen.
Med följande kommando checkas varje undermodul ut i lämplig katalog.
$ git submodule update --init
Den här tekniken är ett möjligt alternativ till den lösning som beskrivs i dokumentet Arbeta med flera Source Git-databaser för organisationer som är bekväma med att använda Git-undermoduler och inte vill hantera en extern sammanfogningsprocess.
Låt oss till exempel säga att det finns tre databaser, där var och en innehåller en gren med namnet main. I den primära databasen, d.v.s. den som konfigurerats i pipelines, har grenen main en pom.xml-fil som deklarerar projekten i de andra två databaserna.
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>customer.group.id</groupId>
<artifactId>customer-reactor</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<modules>
<module>project-a</module>
<module>project-b</module>
</modules>
</project>
Sedan lägger du till undermoduler för de två andra databaserna.
$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectA/ project-a
$ git submodule add -b main https://git.cloudmanager.adobe.com/ProgramName/projectB/ project-b
Detta resulterar i en .gitmodules-fil som liknar följande.
[submodule "project-a"]
path = project-a
url = https://git.cloudmanager.adobe.com/ProgramName/projectA/
branch = main
[submodule "project-b"]
path = project-b
url = https://git.cloudmanager.adobe.com/ProgramName/projectB/
branch = main
Mer information om Git-undermoduler finns i referenshandboken för Git.
Begränsningar och Recommendations limitations-recommendations
Tänk på följande begränsningar när du använder Git-undermoduler med databaser som hanteras av Adobe.
- Git-URL:en måste vara exakt i den syntax som beskrivs i föregående avsnitt.
- Det finns bara stöd för undermoduler i roten av förgreningen.
- Av säkerhetsskäl ska du inte bädda in autentiseringsuppgifter i Git-URL:er.
- Om inget annat är nödvändigt rekommenderas en kort undermodul.
- Det gör du genom att köra
git config -f .gitmodules submodule.<submodule path>.shallow trueför varje undermodul.
- Det gör du genom att köra
- Git-undermodulreferenser lagras för specifika Git-implementeringar. Detta innebär att när ändringar görs i undermodulens databas måste implementeringen som refereras uppdateras.
- Genom att till exempel använda
git submodule update --remote
- Genom att till exempel använda
Stöd för Git-undermodul för privata databaser private-repositories
Stöd för Git-undermoduler när privata databaser används är i stort sett detsamma som när du använder Adobe-databaser.
När du har konfigurerat din pom.xml-fil och kör git submodule-kommandona måste du lägga till en .gitmodules-fil i rotkatalogen i aggregeringsdatabasen för att Cloud Manager ska kunna identifiera inställningarna för undermodulen.
Begränsningar och Recommendations limitations-recommendations-private-repos
Tänk på följande begränsningar när du använder Git-undermoduler med privata databaser.
- Git-URL:erna för undermodulerna kan antingen vara i HTTPS- eller SSH-format, men de måste länka till en github.com
- Det går inte att lägga till en undermodul i en GitHub-aggregeringsdatabas eller vice versa om du lägger till en undermodul i Adobe.
- GitHub-undermodulerna måste vara tillgängliga för Adobe GitHub-appen.
- Begränsningarna för att använda Git-undermoduler med databaser som hanteras med Adobegäller också.