Konfiguration und Verwendung von mvn - Amazon CodeCatalyst

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfiguration und Verwendung von mvn

Sie verwenden den mvn Befehl, um Maven-Builds auszuführen. Sie müssen mvn für die Verwendung Ihres Paket-Repositorys konfigurieren und ein persönliches Zugriffstoken (PAT) für die Authentifizierung bereitstellen.

Abhängigkeiten werden abgerufen von CodeCatalyst

Um das Abrufen von Abhängigkeiten aus einem CodeCatalyst Repository mvn zu konfigurieren, müssen Sie die Maven-Konfigurationsdatei settings.xml und optional die Project Model Object () POM -Datei Ihres Projekts bearbeiten. Die POM Datei enthält Informationen über das Projekt und Konfigurationsinformationen für Maven, um das Projekt zu erstellen, wie Abhängigkeiten, Build-Verzeichnis, Quellverzeichnis, Testquellverzeichnis, Plugin und Ziele.

Wird verwendet, mvn um Abhängigkeiten aus Ihrem CodeCatalyst Paket-Repository abzurufen
  1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

  2. Wählen Sie auf der Übersichtsseite für Ihr Projekt die Option Pakete aus.

  3. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

  4. Wählen Sie Mit Repository verbinden.

  5. Wählen Sie im Dialogfeld Mit Repository verbinden die Option mvn aus der Liste der Package Manager-Clients aus.

  6. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie sich authentifizieren können. mvn CodeCatalyst Wenn Sie bereits eines haben, können Sie dieses verwenden. Wenn nicht, können Sie hier eine erstellen.

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre zu kopierenPAT.

      Warnung

      Nachdem Sie das Dialogfeld geschlossen haben, können Sie Ihre nicht PAT erneut anzeigen oder kopieren.

  7. Fügen Sie Ihrer settings.xml Datei ein Profil hinzu, das Ihr Repository enthält. Ersetzen Sie die folgenden Werte.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen space_name mit Ihrem CodeCatalyst Bereichsnamen.

    • Ersetzen proj_name mit Ihrem CodeCatalyst Projektnamen.

    • Ersetzen repo_name mit dem Namen Ihres CodeCatalyst Paket-Repositorys.

    <profiles> <profile> <id>repo_name</id> <activation> <activeByDefault>true</activeByDefault> </activation> <repositories> <repository> <id>repo_name</id> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </repositories> </profile> </profiles>
  8. Fügen Sie Ihren Server zur Liste der Server in Ihrer settings.xml Datei hinzu. Ersetzen Sie die folgenden Werte.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen repo_name mit dem Namen Ihres CodeCatalyst Paket-Repositorys.

    • Ersetzen username mit Ihrem CodeCatalyst Benutzernamen.

    • Ersetzen PAT mit deinem CodeCatalystPAT.

    <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT</password> </server> </servers>
  9. (Optional) Richten Sie in Ihrer settings.xml Datei einen Mirror ein, der alle Verbindungen erfasst und sie an Ihr Repository statt an ein Gateway-Repository weiterleitet.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen space_name mit Ihrem CodeCatalyst Bereichsnamen.

    • Ersetzen proj_name mit Ihrem CodeCatalyst Projektnamen.

    • Ersetzen repo_name mit dem Namen Ihres CodeCatalyst Paket-Repositorys.

    <mirrors> <mirror> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> <mirrorOf>*</mirrorOf> </mirror> </mirrors>
Wichtig

Sie können einen beliebigen Wert im <id> Element verwenden, er muss jedoch in den <repository> Elementen <server> und identisch sein. Dadurch können die angegebenen Anmeldeinformationen in Anfragen an aufgenommen werden CodeCatalyst.

Nachdem Sie diese Konfigurationsänderungen vorgenommen haben, können Sie das Projekt erstellen.

mvn compile

Pakete aus externen Paket-Repositorys abrufen über CodeCatalyst

Sie können Maven-Pakete aus öffentlichen Repositorys über ein CodeCatalyst Repository installieren, indem Sie es mit einer Upstream-Verbindung zum Gateway konfigurieren, das das Gateway-Repository darstellt. Aus dem Gateway-Repository installierte Pakete werden aufgenommen und in Ihrem Repository gespeichert. CodeCatalyst

CodeCatalyst Unterstützt derzeit die folgenden öffentlichen Maven-Paket-Repositorys.

  • maven-central-gateway

  • google-android-gateway

  • gradle-plugins-gateway

  • Commonsware-Gateway

Um Pakete aus öffentlichen Maven-Paket-Repositorys zu installieren
  1. Falls Sie es noch nicht getan haben, konfigurieren Sie es mvn mit Ihrem CodeCatalyst Paket-Repository, indem Sie die Schritte unter befolgen. Abhängigkeiten werden abgerufen von CodeCatalyst

  2. Stellen Sie sicher, dass Ihr Repository das Gateway-Repository, von dem aus Sie installieren möchten, als Upstream-Verbindung hinzugefügt hat. Um zu überprüfen, welche Upstream-Quellen hinzugefügt wurden, oder um ein Gateway-Repository als Upstream-Quelle hinzuzufügen, folgen Sie den Anweisungen unterHinzufügen eines Upstream-Repositorys.

Weitere Hinweise zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unter. Eine Paketversion mit Upstream-Repositorys anfordern

Veröffentlichen von Paketen auf CodeCatalyst

Um ein Maven-Paket mit in einem CodeCatalyst Repository mvn zu veröffentlichen, müssen Sie auch das Projekt POM bearbeiten~/.m2/settings.xml.

mvnUm Pakete in Ihrem CodeCatalyst Paket-Repository zu veröffentlichen
  1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

  2. Wählen Sie auf der Übersichtsseite für Ihr Projekt die Option Pakete aus.

  3. Wählen Sie Ihr Paket-Repository aus der Liste der Paket-Repositorys aus.

  4. Wählen Sie Mit Repository verbinden.

  5. Wählen Sie im Dialogfeld Mit Repository verbinden die Option mvn aus der Liste der Package Manager-Clients aus.

  6. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie sich authentifizieren können. mvn CodeCatalyst Wenn Sie bereits eines haben, können Sie dieses verwenden. Wenn nicht, können Sie hier eine erstellen.

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre zu kopierenPAT.

      Warnung

      Nachdem Sie das Dialogfeld geschlossen haben, können Sie Ihre nicht PAT erneut anzeigen oder kopieren.

  7. Konfigurieren Sie eine Umgebungsvariable auf Ihrem lokalen Computer mit IhremPAT. Sie werden diese Umgebungsvariable in Ihrer setting.xml Datei verwenden.

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
  8. Fügen Sie einen <servers> Abschnitt settings.xml mit einem Verweis auf die CodeCatalyst_ARTIFACTS_TOKEN Umgebungsvariable hinzu, sodass Maven das Token in HTTP Anfragen weitergibt.

    <settings> ... <servers> <server> <id>repo-name</id> <username>username</username> <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password> </server> </servers> ... </settings>
  9. Fügen Sie Ihrem Projekt einen <distributionManagement> Abschnitt hinzu. pom.xml

    <project> ... <distributionManagement> <repository> <id>repo_name</id> <name>repo_name</name> <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url> </repository> </distributionManagement> ... </project>

Nachdem Sie diese Konfigurationsänderungen vorgenommen haben, können Sie das Projekt erstellen und im angegebenen Repository veröffentlichen.

mvn deploy

Sie können in der CodeCatalyst Konsole zu Ihrem Paket-Repository navigieren, um zu überprüfen, ob das Paket erfolgreich veröffentlicht wurde.

Pakete von Drittanbietern veröffentlichen

Sie können Maven-Pakete von Drittanbietern in einem CodeCatalyst Repository mit mvn deploy:deploy-file veröffentlichen. Dies kann für Benutzer hilfreich sein, die Pakete veröffentlichen möchten und nur JAR Dateien haben und keinen Zugriff auf den Paketquellcode oder die POM Dateien haben.

Der mvn deploy:deploy-file Befehl generiert eine POM Datei auf der Grundlage der in der Befehlszeile übergebenen Informationen.

Erstellen Sie zunächst eine, PAT falls Sie noch keine haben.

Um ein persönliches Zugriffstoken zu erstellen (PAT)
  1. Wählen Sie in der oberen Menüleiste Ihr Profil-Badge und dann Meine Einstellungen aus.

    Tipp

    Du kannst dein Benutzerprofil auch finden, indem du die Mitgliederseite für ein Projekt oder einen Bereich aufrufst und deinen Namen aus der Mitgliederliste auswählst.

  2. Geben Sie im Feld PATName einen aussagekräftigen Namen für Ihren PAT ein.

  3. Behalten Sie im Feld Ablaufdatum das Standarddatum bei oder wählen Sie das Kalendersymbol, um ein benutzerdefiniertes Datum auszuwählen. Das Ablaufdatum liegt standardmäßig auf einem Jahr ab dem aktuellen Datum.

  4. Wählen Sie Create (Erstellen) aus.

    Sie können dieses Token auch erstellen, wenn Sie Repository klonen für ein Quell-Repository wählen.

  5. Speichern Sie das PAT Geheimnis an einem sicheren Ort.

    Wichtig

    Das PAT Geheimnis wird nur einmal angezeigt. Sie können es nicht abrufen, nachdem Sie das Fenster geschlossen haben.

Um Maven-Pakete von Drittanbietern zu veröffentlichen
  1. Erstellen Sie eine ~/.m2/settings.xml Datei mit dem folgenden Inhalt:

    <settings> <servers> <server> <id>repo_name</id> <username>username</username> <password>PAT}</password> </server> </servers> </settings>
  2. Führen Sie den Befehl mvn deploy:deploy-file aus:

    mvn deploy:deploy-file -DgroupId=commons-cli \ -DartifactId=commons-cli \ -Dversion=1.4 \ -Dfile=./commons-cli-1.4.jar \ -Dpackaging=jar \ -DrepositoryId=repo-name \ -Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/
    Anmerkung

    Das vorherige Beispiel veröffentlichtcommons-cli 1.4. Ändern Sie die ArgumentegroupId, artifactID, version und file, um ein anderes zu veröffentlichen. JAR

Diese Anweisungen basieren auf Beispielen im Leitfaden zur Bereitstellung eines JARs Drittanbieter-Repositorys in der Apache Maven-Dokumentation.

Weitere Informationen finden Sie in den folgenden Themen auf der Apache Maven Project-Website: