Récupération des dépendances depuis CodeCatalyst Récupération de packages depuis des référentiels de packages externes via CodeCatalyst Publier des 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 afin d'extraire les dépendances 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 POM fichier 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 des sources, le répertoire des sources de test, le plugin et les objectifs.

À utiliser `mvn` pour récupérer les dépendances depuis votre dépôt de CodeCatalyst packages

Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.
Sur la page d'aperçu de votre projet, sélectionnez Packages.
Choisissez votre référentiel de packages dans la liste des référentiels de packages.
Choisissez Connect to repository.
Dans la boîte de dialogue Connect to repository, 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. Sinon, vous pouvez en créer un ici.
1. Choisissez Créer un jeton.
2. Choisissez Copier pour copier votrePAT.
  
  Avertissement
  Vous ne pourrez ni voir ni copier à nouveau le vôtre PAT une fois que vous aurez fermé la boîte de dialogue.
Ajoutez à votre fichier un profil contenant votre settings.xml dépôt. Remplacez les valeurs suivantes.

Note
Si vous copiez les instructions depuis la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez space_name avec le nom CodeCatalyst de votre espace.
- Remplacez proj_name avec le nom CodeCatalyst de votre projet.
- Remplacez repo_name avec le nom CodeCatalyst du dépôt de votre package.
```
<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 les instructions depuis la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez repo_name avec le nom CodeCatalyst du dépôt de votre package.
- Remplacez username avec votre nom CodeCatalyst d'utilisateur.
- Remplacez PAT avec votre CodeCatalystPAT.
```
<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 les instructions depuis la console, les valeurs suivantes doivent être mises à jour pour vous et ne doivent pas être modifiées.
- Remplacez space_name avec le nom CodeCatalyst de votre espace.
- Remplacez proj_name avec le nom CodeCatalyst de votre projet.
- Remplacez repo_name avec le nom CodeCatalyst du dépôt de votre package.
```
<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 identique 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 depuis des 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 passerelle sont ingérés et stockés dans votre CodeCatalyst référentiel.

Actuellement, CodeCatalyst prend en charge les référentiels de packages Maven publics suivants.

maven-central-gateway
google-android-gateway
gradle-plugins-gateway
passerelle commonware

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 dansAjouter un référentiel en amont.

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

Publier des packages vers CodeCatalyst

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

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

Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.
Sur la page d'aperçu de votre projet, sélectionnez Packages.
Choisissez votre référentiel de packages dans la liste des référentiels de packages.
Choisissez Connect to repository.
Dans la boîte de dialogue Connect to repository, 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. Sinon, vous pouvez en créer un ici.
1. Choisissez Créer un jeton.
2. Choisissez Copier pour copier votrePAT.
  
  Avertissement
  Vous ne pourrez ni voir ni copier à nouveau le vôtre PAT une fois que vous aurez fermé la boîte de dialogue.
Configurez une variable d'environnement sur votre machine locale avec votrePAT. 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 HTTP demandes.


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

Ajoutez une <distributionManagement> section à celle de 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 bien été publié.

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 aux utilisateurs qui souhaitent publier des packages et qui ne disposent que de JAR fichiers et qui n'ont pas accès au code source ou aux POM fichiers des packages.

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

Créez d'abord 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 accéder à 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 PATle champ Nom, entrez un nom descriptif pour votrePAT.
Dans Date d'expiration, laissez la date par défaut ou cliquez sur 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.
Sélectionnez Create (Créer).

Vous pouvez également créer ce jeton lorsque vous choisissez Clone un référentiel pour un référentiel source.
Enregistrez le PAT secret dans un endroit sûr.

Important
Le PAT secret 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 groupId arguments artifactID, version et file pour en publier un autre. JAR

Ces instructions sont basées sur des exemples du Guide de déploiement d'un tiers JARs sur un dépôt distant, extrait de la documentation d'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

Publication de packages avec curl

Configuration et utilisation de mvn

Table des matières

Récupération des dépendances depuis CodeCatalyst

À utiliser mvn pour récupérer les dépendances depuis votre dépôt de CodeCatalyst packages

Avertissement

Note

Note

Note

Important

Récupération de packages depuis des référentiels de packages externes via CodeCatalyst

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

Publier des packages vers CodeCatalyst

À utiliser mvn pour publier des packages dans votre référentiel de CodeCatalyst 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

À utiliser `mvn` pour récupérer les dépendances depuis votre dépôt de CodeCatalyst packages

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