View a markdown version of this page

Konfiguration und Verwendung von mvn - Amazon CodeCatalyst
Abhängigkeiten werden abgerufen von CodeCatalystAbrufen von Paketen aus externen Paket-Repositorys über CodeCatalystPakete veröffentlichen in CodeCatalystPakete von Drittanbietern veröffentlichen

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von 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 die Konfiguration 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.

Um mvn zu verwenden, um Abhängigkeiten aus Ihrem Paket-Repository abzurufen CodeCatalyst

  1. Öffnen Sie die CodeCatalyst Konsole unter. https://codecatalyst.aws/

  2. Wählen Sie auf der Übersichtsseite für Ihr Projekt 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 Projektarchiv verbinden die Option mvn aus der Liste der Paketmanager-Clients aus.

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

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre PAT zu kopieren.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

  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 Sie es space_name durch Ihren CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den 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 Sie es durch repo_name den Namen Ihres CodeCatalyst Paket-Repositorys.

    • usernameErsetzen Sie es durch Ihren CodeCatalyst Benutzernamen.

    • Ersetzen Sie PAT durch Ihre CodeCatalyst PAT.

    <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 von der Konsole aus kopieren, sollten die folgenden Werte für Sie aktualisiert und nicht geändert werden.

    • Ersetzen Sie es space_name durch Ihren CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den 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

Abrufen von Paketen aus externen Paket-Repositorys über CodeCatalyst

Sie können Maven-Pakete aus öffentlichen Repositorys über ein CodeCatalyst Repository installieren, indem Sie es mit einer Upstream-Verbindung zu dem Gateway konfigurieren, das das Gateway-Repository darstellt. Pakete, die aus dem Gateway-Repository installiert wurden, 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 den Schritten unter folgen. Abhängigkeiten werden abgerufen von CodeCatalyst

  2. Stellen Sie sicher, dass Ihr Repository das Gateway-Repository, von dem Sie die Installation durchführen 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 unterEin Upstream-Repository hinzufügen.

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

Pakete veröffentlichen in 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.

Um mvn zu verwenden, um 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 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 Projektarchiv verbinden die Option mvn aus der Liste der Paketmanager-Clients aus.

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

    1. Wählen Sie Token erstellen.

    2. Wählen Sie Kopieren, um Ihre PAT zu kopieren.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben.

  7. Konfigurieren Sie mit Ihrem PAT eine Umgebungsvariable auf Ihrem lokalen Computer. 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, damit 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 Paketquellcode oder 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 keine haben.

Um ein persönliches Zugriffstoken (PAT) zu erstellen

  1. Wählen Sie in der oberen Menüleiste Ihr Profil-Badge aus und wählen Sie dann Meine Einstellungen aus.

    Tipp

    Du findest dein Benutzerprofil auch, indem du auf der Mitgliederseite eines Projekts oder Bereichs deinen Namen aus der Mitgliederliste auswählst.

  2. Geben Sie im Feld PAT-Name einen beschreibenden Namen für Ihren PAT ein.

  3. Belassen Sie unter Ablaufdatum das Standarddatum oder wählen Sie das Kalendersymbol, um ein benutzerdefiniertes Datum auszuwählen. Das Ablaufdatum ist standardmäßig auf ein Jahr ab dem aktuellen Datum festgelegt.

  4. Wählen Sie 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

    Im vorherigen Beispiel wird veröffentlichtcommons-cli 1.4. Ändern Sie die Argumente GroupId, ArtifactId, Version und file, um eine andere JAR zu veröffentlichen.

Diese Anweisungen basieren auf Beispielen aus dem Handbuch zur Bereitstellung von JARs von Drittanbietern im Remote-Repository aus der Apache Maven-Dokumentation.

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