So checken Sie in Jenkins ein Projekt in ein bestimmtes Verzeichnis aus (mit GIT)

Entschuldigung für den ‘svn’-Stil – wir befinden uns in einem Migrationsprozess von SVN zu GIT (einschließlich unserer CI Jenkins-Umgebung).

Was wir brauchen, ist in der Lage zu sein, Jenkins dazu zu bringen, das GIT-Projekt (Repository?) in ein bestimmtes Verzeichnis auszuchecken (oder sollte ich sagen, klonen?). Wir haben einige Refspecs-Magie ausprobiert, aber es war nicht zu offensichtlich, um sie erfolgreich zu verstehen und zu verwenden.

Wenn wir außerdem im selben Jenkins-Projekt mehrere private GitHub-Repositories in mehrere separate Verzeichnisse unter einem Projektstamm auschecken müssen, wie können wir das bitte tun?

Wir haben das GitHub-Plugin installiert. Hoffe, wir haben die Dinge richtig formuliert.

In der neuen Jenkins 2.0-Pipeline (früher Workflow-Plug-in genannt) wird dies anders gemacht für:

• Das Hauptlager
• Andere zusätzliche Repositories

Hier beziehe ich mich speziell auf die Multibranch Pipeline Version 2.9.

Hauptlager

Dies ist das Repository, das Ihre enthält Jenkinsfile.

Im Konfigurieren Bildschirm für Ihr Pipeline-Projekt, geben Sie Ihren Repository-Namen ein usw.

Verwende nicht Zusätzliche Verhaltensweisen > In ein Unterverzeichnis auschecken. Dies wird Ihre setzen Jenkinsfile im Unterverzeichnis wo Jenkins es nicht finden kann.

In Jenkinsfilechecken Sie das Haupt-Repository im Unterverzeichnis mit aus dir():

dir('subDir') {
    checkout scm
}

Zusätzliche Repositories

Wenn Sie weitere Repositories auschecken möchten, verwenden Sie die Pipeline-Syntax -Generator, um automatisch ein Groovy-Code-Snippet zu generieren.

Im Konfigurieren Bildschirm für Ihr Pipeline-Projekt:

1. Wählen Pipeline-Syntax. Im Beispielschritt Dropdown-Menü, wählen Sie Kasse: Allgemeiner SCM.
2. Wählen Sie Ihr SCM-System aus, z Git. Geben Sie die üblichen Informationen zu Ihrem Repository oder Depot ein.
3. Beachten Sie, dass in der Multibranch-Pipeline die Umgebungsvariable
   env.BRANCH_NAME enthält den Zweignamen des Haupt-Repositorys.
4. Im Zusätzliche Verhaltensweisen Dropdown-Menü auswählen
   Checken Sie in ein Unterverzeichnis aus
5. Klicken Generieren Sie Groovy. Jenkins zeigt das Groovy-Code-Snippet an, das dem von Ihnen angegebenen SCM-Checkout entspricht.
6. Kopieren Sie diesen Code in Ihr Pipeline-Skript oder Jenkinsfile.

Ich stimme @Łukasz Rżanek zu, dass wir verwenden können git-plugin

Aber ich verwende Option: Checkout in eine Unterrichtung, was wie folgt aktiviert ist:

In Quellcodeverwaltungkreuzen Sie Git an

Klicken Sie auf die Schaltfläche Hinzufügen, wählen Sie Auschecken in ein Unterverzeichnis

Der Standard git-plugin denn Jenkins macht den Job ganz gut.

Nach dem Hinzufügen eines neuen Git-Repositorys (Projektkonfiguration > Quellcodeverwaltung > Aktivieren Sie die GIT-Option) zum Projekt, navigieren Sie zum Ende der Plugin-Einstellungen, direkt darüber Repository-Browser Region. Es sollte eine geben Fortschrittlich Taste. Nachdem Sie darauf geklickt haben, sollte ein neues Formular erscheinen, mit einem Wert, der als beschrieben wird Lokales Unterverzeichnis für Repo (optional). Setzen Sie dies auf folder bewirkt, dass das Plugin das Repository in den Ordner relativ zu Ihrem Arbeitsbereich auscheckt. Auf diese Weise können Sie in Ihrem Projekt so viele Repositories haben, wie Sie benötigen, alle an separaten Orten.

Wenn das von Ihnen verwendete Projekt dies zulässt, können Sie alternativ GIT-Untermodule verwenden, die externen Pfaden in SVN ähneln. Im GIT-Buch es gibt einen Abschnitt zu genau diesem Thema. Wenn dies nicht gegen eine Richtlinie verstößt, sind Submodule ziemlich einfach zu verwenden und bieten Ihnen eine leistungsstarke Möglichkeit, die Speicherorte, Versionen/Tags/Zweige zu steuern, die importiert werden, UND sie werden in Ihrem lokalen Repository verfügbar sein und Ihnen auch eine bessere Portabilität bieten.

Offensichtlich unterstützt das GIT-Plugin das Auschecken von Submodulen, sodass Jenkins recht effektiv mit ihnen arbeiten kann.

Es lohnt sich, das Pipeline-Plugin zu untersuchen. Mit dem Plugin können Sie mehrere VCS-Projekte in relative Verzeichnispfade auschecken. Vorher ein Verzeichnis per VCS-Checkout anlegen. Geben Sie dann Befehle an den neu ausgecheckten VCS-Arbeitsbereich aus. In meinem Fall verwende ich git. Aber Sie sollten die Idee bekommen.

node{
    def exists = fileExists 'foo'
    if (!exists){
        new File('foo').mkdir()
    }
    dir ('foo') {
        git branch: "<ref spec>", changelog: false, poll: false, url: '<clone url>'
        ......
    }
    def exists = fileExists 'bar'
    if (!exists){
        new File('bar').mkdir()
    }
    dir ('bar') {
        git branch: "<ref spec>", changelog: false, poll: false, url: '<clone url>'
        ......
    }
    def exists = fileExists 'baz'
    if (!exists){
        new File('baz').mkdir()
    }
    dir ('baz') {
        git branch: "<ref spec>", changelog: false, poll: false, url: '<clone url>'
        ......
    }
}

Wenn wir außerdem im selben Jenkins-Projekt mehrere private GitHub-Repositories in mehrere separate Verzeichnisse unter einem Projektstamm auschecken müssen. Wie können wir das bitte machen?

Der Jenkins Multiple SCMs-Plugin hat das mehrere Repositories Problem für mich sehr gut gelöst. Ich habe gerade an einem Projekt-Build gearbeitet, der vier verschiedene Git-Repos in einem gemeinsamen Ordner auscheckt. (Ich zögere etwas, Git-Superprojekte zu verwenden, wie zuvor von Łukasz Rżanek vorgeschlagen, da Git ohne Submodule komplex genug ist.)

Suchen Sie repoName aus der URL und checken Sie dann in das angegebene Verzeichnis aus.

String url="https://github.com/foo/bar.git";
String[] res = url.split("https://stackoverflow.com/");
String repoName = res[res.length-1];
if (repoName.endsWith('.git')) repoName=repoName.substring(0, repoName.length()-4);

checkout([
  $class: 'GitSCM', 
  branches: [[name: 'refs/heads/'+env.BRANCH_NAME]],
  doGenerateSubmoduleConfigurations: false,
  extensions: [
    [$class: 'RelativeTargetDirectory', relativeTargetDir: repoName],
    [$class: 'GitLFSPull'],
    [$class: 'CheckoutOption', timeout: 20],
    [$class: 'CloneOption',
        depth: 3,
        noTags: false,
        reference: '/other/optional/local/reference/clone',
        shallow: true,
        timeout: 120],
    [$class: 'SubmoduleOption', depth: 5, disableSubmodules: false, parentCredentials: true, recursiveSubmodules: true, reference: '', shallow: true, trackingSubmodules: true]
  ],
  submoduleCfg: [],
  userRemoteConfigs: [
    [credentialsId: 'foobar',
    url: url]
  ]
])

fügen Sie einfach “dir wrapper” zur Git-Operation hinzu:

dir('subDir') {
    checkout scm
}