Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

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
<a name="packages-maven-mvn"></a>

Sie verwenden den `mvn` Befehl, um Maven-Builds auszuführen. Sie müssen `mvn` für die Verwendung Ihres Paket-Repositorys konfigurieren und ein Personal Access Token (PAT) für die Authentifizierung bereitstellen.

**Contents**
+ [Abhängigkeiten werden abgerufen von CodeCatalyst](#mvn-fetch-dependencies)
+ [Pakete aus externen Paket-Repositorys abrufen über CodeCatalyst](#mvn-install-public)
+ [Veröffentlichen von Paketen auf CodeCatalyst](#mvn-publish-packages)
+ [Pakete von Drittanbietern veröffentlichen](#publishing-third-party-packages)

## Abhängigkeiten werden abgerufen von CodeCatalyst
<a name="mvn-fetch-dependencies"></a>

Um das Abrufen von Abhängigkeiten aus einem CodeCatalyst Repository `mvn` zu konfigurieren, müssen Sie die Maven-Konfigurationsdatei `settings.xml` und optional die POM-Datei (Project Model Object) 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/](https://codecatalyst.aws/).

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

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

1. Wählen Sie **Mit Repository verbinden**.

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

1. 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**.

   1. 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.

1. 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.
   + {{space\_name}}Ersetzen Sie sie durch Ihren CodeCatalyst Bereichsnamen.
   + 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>
   ```

1. 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.
   + {{username}}Ersetze es durch deinen CodeCatalyst Benutzernamen.
   + Ersetzen Sie es {{PAT}} durch Ihr CodeCatalyst PAT.

   ```
   <servers>
     <server>
       <id>{{repo_name}}</id>
       <username>{{username}}</username>
       <password>{{PAT}}</password>
     </server>
   </servers>
   ```

1. (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.
   + {{space\_name}}Ersetzen Sie sie durch Ihren CodeCatalyst Bereichsnamen.
   + 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, dieser 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
<a name="mvn-install-public"></a>

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](#mvn-fetch-dependencies)

1. 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 unter[Ein Upstream-Repository hinzufügen](packages-upstream-repositories-add.md).

Weitere Hinweise zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unter. [Eine Paketversion mit Upstream-Repositorys anfordern](packages-upstream-repositories-request.md)

## Veröffentlichen von Paketen auf CodeCatalyst
<a name="mvn-publish-packages"></a>

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

**`mvn`Um Pakete in Ihrem CodeCatalyst Paket-Repository zu veröffentlichen**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

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

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

1. Wählen Sie **Mit Repository verbinden**.

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

1. 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**.

   1. 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.

1. 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}}
   ```

1. 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>
   ```

1. 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
<a name="publishing-third-party-packages"></a>

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 über JAR-Dateien verfügen und keinen Zugriff auf den 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 noch keine haben.

**Um ein persönliches Zugriffstoken (PAT) zu erstellen**

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.

1. Geben Sie im Feld **PAT-Name** einen aussagekräftigen Namen für Ihr PAT ein.

1. 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.

1. Wählen Sie **Erstellen** aus.

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

1. 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>
   ```

1. 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öffentlicht`commons-cli 1.4`. Ändern Sie die Argumente groupId, artifactID, version und file, um eine andere JAR zu veröffentlichen.

Diese Anweisungen basieren auf Beispielen im [Leitfaden zur Bereitstellung eines JARs Drittanbieter-Repositorys](https://maven.apache.org/guides/mini/guide-3rd-party-jars-remote.html) in der *Apache* Maven-Dokumentation. 

 Weitere Informationen finden Sie in den folgenden Themen auf der Apache Maven Project-Website:
+  [Einrichtung mehrerer Repositorys](https://maven.apache.org/guides/mini/guide-multiple-repositories.html) 
+  [Referenz für Einstellungen](https://maven.apache.org/settings.html) 
+  [Vertriebsmanagement](https://maven.apache.org/pom.html#Distribution_Management) 
+  [Profile](https://maven.apache.org/pom.html#Profiles)