Récupération des dépendances depuis CodeCatalyst Récupération de packages à partir de référentiels de packages externes via CodeCatalyst Publication de packages vers CodeCatalyst Publication de packages tiers

Configuration et utilisation de mvn

Vous utilisez la mvn commande pour exécuter les versions de Maven. Vous devez configurer mvn pour utiliser votre référentiel de packages et fournir un jeton d'accès personnel (PAT) pour l'authentification.

Table des matières

Récupération des dépendances depuis CodeCatalyst

Pour configurer mvn la récupération des dépendances à partir d'un CodeCatalyst référentiel, vous devez modifier le fichier de configuration Maven settings.xml et, éventuellement, le fichier Project Model Object (POM) de votre projet. Le fichier POM contient des informations sur le projet et des informations de configuration permettant à Maven de créer le projet, telles que les dépendances, le répertoire de construction, le répertoire source, le répertoire source de test, le plug-in et les objectifs.

Pour utiliser `mvn` pour récupérer les dépendances depuis votre référentiel de packages CodeCatalyst

Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.
Sur la page de présentation de votre projet, choisissez Packages.
Choisissez votre référentiel de packages dans la liste des référentiels de packages.
Choisissez Se connecter au référentiel.
Dans la boîte de dialogue Connexion au référentiel, choisissez mvn dans la liste des clients du gestionnaire de packages.
Vous aurez besoin d'un jeton d'accès personnel (PAT) pour vous authentifier. mvn CodeCatalyst Si vous en avez déjà un, vous pouvez l'utiliser. Si ce n'est pas le cas, vous pouvez en créer un ici.
1. Choisissez Créer un jeton.
2. Choisissez Copier pour copier votre PAT.
  
  Avertissement
  Vous ne pourrez plus voir ni copier à nouveau votre PAT après avoir fermé la boîte de dialogue.
Ajoutez un profil contenant votre référentiel à votre settings.xml fichier. Remplacez les valeurs suivantes.

Note
Si vous copiez à partir des instructions de la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez-le space_name par le nom de votre CodeCatalyst espace.
- Remplacez-le proj_name par le nom de votre CodeCatalyst projet.
- Remplacez-le repo_name par le nom de votre référentiel de CodeCatalyst packages.
```
<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>
```
Ajoutez votre serveur à la liste des serveurs de votre settings.xml fichier. Remplacez les valeurs suivantes.

Note
Si vous copiez à partir des instructions de la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez-le repo_name par le nom de votre référentiel de CodeCatalyst packages.
- usernameRemplacez-le par votre nom CodeCatalyst d'utilisateur.
- PATRemplacez-le par votre CodeCatalyst PAT.
```
<servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>
```
(Facultatif) Définissez un miroir dans votre settings.xml fichier qui capture toutes les connexions et les achemine vers votre référentiel au lieu d'un référentiel de passerelle.

Note
Si vous copiez à partir des instructions de la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez-le space_name par le nom de votre CodeCatalyst espace.
- Remplacez-le proj_name par le nom de votre CodeCatalyst projet.
- Remplacez-le repo_name par le nom de votre référentiel de CodeCatalyst packages.
```
<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>
```

Important

Vous pouvez utiliser n'importe quelle valeur dans l'<id>élément, mais elle doit être la même dans les <repository> éléments <server> et. Cela permet d'inclure les informations d'identification spécifiées dans les demandes adressées à CodeCatalyst.

Après avoir apporté ces modifications de configuration, vous pouvez créer le projet.


mvn compile

Récupération de packages à partir de référentiels de packages externes via CodeCatalyst

Vous pouvez installer des packages Maven à partir de référentiels publics via un CodeCatalyst référentiel en le configurant avec une connexion en amont à la passerelle qui représente le référentiel de passerelle. Les packages installés à partir du référentiel de la passerelle sont ingérés et stockés dans votre CodeCatalyst référentiel.

Prend actuellement en CodeCatalyst charge les référentiels publics de packages Maven suivants.

passerelle Maven Central
passerelle Google-Android
passerelle Gradle-Plugins-Gateway
passerelle Common Software

Pour installer des packages à partir de référentiels de packages Maven publics

Si ce n'est pas déjà fait, configurez mvn avec votre référentiel de CodeCatalyst packages en suivant les étapes décrites dansRécupération des dépendances depuis CodeCatalyst.
Assurez-vous que votre référentiel a ajouté le référentiel de passerelle à partir duquel vous souhaitez effectuer l'installation en tant que connexion en amont. Pour vérifier quelles sources en amont sont ajoutées ou pour ajouter un référentiel de passerelle en tant que source en amont, suivez les instructions figurant dansAjout d’un référentiel en amont.

Pour plus d'informations sur la demande de packages depuis les référentiels en amont, consultezDemande d'une version de package avec des référentiels en amont.

Publication de packages vers CodeCatalyst

Pour publier un package Maven dans un CodeCatalyst référentiel, vous devez également modifier ~/.m2/settings.xml et modifier le POM du projet. mvn

Pour utiliser `mvn` pour publier des packages dans votre CodeCatalyst référentiel de packages

Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.
Sur la page de présentation de votre projet, choisissez Packages.
Choisissez votre référentiel de packages dans la liste des référentiels de packages.
Choisissez Se connecter au référentiel.
Dans la boîte de dialogue Connexion au référentiel, choisissez mvn dans la liste des clients du gestionnaire de packages.
Vous aurez besoin d'un jeton d'accès personnel (PAT) pour vous authentifier. mvn CodeCatalyst Si vous en avez déjà un, vous pouvez l'utiliser. Si ce n'est pas le cas, vous pouvez en créer un ici.
1. Choisissez Créer un jeton.
2. Choisissez Copier pour copier votre PAT.
  
  Avertissement
  Vous ne pourrez plus voir ni copier à nouveau votre PAT après avoir fermé la boîte de dialogue.
Configurez une variable d'environnement sur votre machine locale avec votre PAT. Vous allez utiliser cette variable d'environnement dans votre setting.xml fichier.
```
export CODECATALYST_ARTIFACTS_TOKEN=your_PAT
```

Ajoutez une <servers> section à settings.xml avec une référence à la variable d'CodeCatalyst_ARTIFACTS_TOKENenvironnement afin que Maven transmette le jeton dans les requêtes HTTP.


<settings>
...
    <servers>
        <server>
            <id>repo-name</id>
            <username>username</username>
            <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password>
        </server>
    </servers>
...
</settings>

Ajoutez une <distributionManagement> section à votre projetpom.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>

Après avoir apporté ces modifications de configuration, vous pouvez créer le projet et le publier dans le référentiel spécifié.


mvn deploy

Vous pouvez accéder à votre référentiel de packages dans la CodeCatalyst console pour vérifier que le package a été publié avec succès.

Publication de packages tiers

Vous pouvez publier des packages Maven tiers dans un CodeCatalyst référentiel avecmvn deploy:deploy-file. Cela peut être utile pour les utilisateurs qui souhaitent publier des packages et ne disposent que de fichiers JAR et n'ont pas accès au code source des packages ou aux fichiers POM.

La mvn deploy:deploy-file commande générera un fichier POM sur la base des informations transmises dans la ligne de commande.

Tout d'abord, créez un PAT si vous n'en avez pas.

Pour créer un jeton d'accès personnel (PAT)

Dans la barre de menu supérieure, choisissez votre badge de profil, puis sélectionnez Mes paramètres.

Astuce
Vous pouvez également trouver votre profil utilisateur en vous rendant sur la page des membres d'un projet ou d'un espace et en choisissant votre nom dans la liste des membres.
Dans Nom du PAT, entrez un nom descriptif pour votre PAT.
Dans Date d'expiration, conservez la date par défaut ou choisissez l'icône du calendrier pour sélectionner une date personnalisée. La date d'expiration par défaut est d'un an à compter de la date actuelle.
Choisissez Créer.

Vous pouvez également créer ce jeton lorsque vous choisissez Clone repository for a source repository.
Enregistrez le secret PAT dans un endroit sécurisé.

Important
Le secret PAT ne s'affiche qu'une seule fois. Vous ne pouvez pas le récupérer après avoir fermé la fenêtre.

Pour publier des packages Maven tiers

Créez un ~/.m2/settings.xml fichier avec le contenu suivant :



<settings>
    <servers>
        <server>
            <id>repo_name</id>
            <username>username</username>
            <password>PAT}</password>
        </server>
    </servers>
</settings>

Exécutez la commande mvn deploy:deploy-file :


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/

Note

L'exemple précédent publiecommons-cli 1.4. Modifiez les arguments groupId, artifactId, version et file pour publier un autre JAR.

Ces instructions sont basées sur des exemples contenus dans le Guide de déploiement de fichiers JAR tiers sur un référentiel distant figurant dans la documentation Apache Maven.

Pour plus d'informations, consultez les rubriques suivantes sur le site Web du projet Apache Maven :

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration et utilisation de Gradle Groovy

Publier des packages avec curl

Configuration et utilisation de mvn

Table des matières

Récupération des dépendances depuis CodeCatalyst

Pour utiliser mvn pour récupérer les dépendances depuis votre référentiel de packages CodeCatalyst

Avertissement

Note

Note

Note

Important

Récupération de packages à partir de référentiels de packages externes via CodeCatalyst

Pour installer des packages à partir de référentiels de packages Maven publics

Publication de packages vers CodeCatalyst

Pour utiliser mvn pour publier des packages dans votre CodeCatalyst référentiel de packages

Avertissement

Publication de packages tiers

Pour créer un jeton d'accès personnel (PAT)

Astuce

Important

Pour publier des packages Maven tiers

Note

Pour utiliser `mvn` pour récupérer les dépendances depuis votre référentiel de packages CodeCatalyst

Pour utiliser `mvn` pour publier des packages dans votre CodeCatalyst référentiel de packages