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 klonas först pipeline-databasen och den konfigurerade grenen checkas ut. Om grenen innehåller en .gitmodules-fil i rotkatalogen körs kommandot.
$ git submodule update --init
Den här processen checkar ut varje undermodul till lämplig katalog. Den här tekniken är ett möjligt alternativ till att arbeta med flera Git-källdatabaser för organisationer som är bekväma med att använda Git-undermoduler och som 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 två andra databaserna:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://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 andra två 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
Resultatet i filen .gitmodules ser ut så här:
[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 Git-referenshandboken.
Begränsningar limitations
Tänk på följande när du använder Git-undermoduler:
- Git-URL:en måste vara exakt i den syntax som beskrivs ovan.
- Av säkerhetsskäl ska du inte bädda in autentiseringsuppgifter i dessa URL:er.
- Det finns bara stöd för undermoduler i roten av förgreningen.
- 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. - Om du inte behöver något annat rekommenderar Adobe att du använder"grund"-undermoduler genom att köra
git config -f .gitmodules submodule.<submodule path>.shallow trueför varje undermodul.
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 rekommendationer 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 för databaser i Adobe i en GitHub-aggregeringsdatabas eller vice versa.
- 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å.