Configuration et utilisation du nuget ou du dotnet CLI - Amazon CodeCatalyst

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration et utilisation du nuget ou du dotnet CLI

Vous pouvez utiliser CLI des outils tels que NuGet et dotnet pour publier et consommer des packages à partir de CodeCatalyst. Ce document fournit des informations sur la configuration CLI des outils et leur utilisation pour publier ou consommer des packages.

Configuration NuGet avec CodeCatalyst

Pour configurer NuGet avec CodeCatalyst, ajoutez un point de terminaison de référentiel et un jeton d'accès personnel à votre fichier de NuGet configuration pour autoriser nuget ou dotnet pour vous connecter à votre référentiel de CodeCatalyst packages.

Pour configurer NuGet avec votre référentiel de CodeCatalyst packages
  1. Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.

  2. Sur la page d'aperçu de votre projet, sélectionnez Packages.

  3. Choisissez votre référentiel de packages dans la liste des référentiels de packages.

  4. Choisissez Connect to repository.

  5. Dans la boîte de dialogue Connect to repository, choisissez NuGetou dotnet dans la liste des clients du gestionnaire de packages.

  6. Vous aurez besoin d'un jeton d'accès personnel (PAT) pour vous authentifier. NuGet 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 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.

  7. Configurez nuget ou dotnet utilisez le NuGet point de terminaison de votre référentiel et CodeCatalyst PAT. 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 username avec votre nom CodeCatalyst d'utilisateur.

    • Remplacez PAT avec votre CodeCatalyst PAT.

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

    1. Pour nuget, utilisez la commande nuget sources add.

      nuget sources add -name "repo_name" -Source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -username "username" -password "PAT"
    2. Pour dotnet, utilisez la commande dotnet nuget add source.

      Utilisateurs de Linux et de macOS : le chiffrement n'étant pas pris en charge sur les plateformes autres que Windows, vous devez ajouter l'--store-password-in-clear-textindicateur à la commande suivante. Notez que cela enregistrera votre mot de passe sous forme de texte brut dans votre fichier de configuration.

      dotnet nuget add source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -n "proj_name/repo_name" -u "username" -p "PAT" --store-password-in-clear-text

Une fois que vous avez configuré NuGet avec CodeCatalyst, vous pouvez utiliser des NuGet packages stockés dans votre CodeCatalyst référentiel ou dans l'un de ses référentiels en amont et publier des NuGet packages dans votre CodeCatalyst référentiel.

Consommation de NuGet packages à partir d'un CodeCatalyst référentiel

Une fois que vous avez configuré NuGet avec CodeCatalyst, vous pouvez utiliser les NuGet packages stockés dans votre CodeCatalyst référentiel ou dans l'un de ses référentiels en amont.

Pour utiliser une version de package à partir d'un CodeCatalyst référentiel ou de l'un de ses référentiels en amont avec nuget ou dotnet, exécutez la commande suivante. Remplacez packageName avec le nom du package que vous souhaitez consommer et packageSourceName avec le nom de la source de votre dépôt de CodeCatalyst packages dans votre fichier de NuGet configuration, qui doit être le nom du référentiel.

Pour installer un package avec dotnet

dotnet add packageName --source packageSourceName

Pour installer un package avec nuget

nuget install packageName --source packageSourceName

Pour plus d'informations, voir Gérer les packages à l'aide du nuget CLI ou Installer et gérer les packages à l'aide du dotnet CLI dans la documentation Microsoft.

Vous pouvez utiliser des NuGet packages provenant de NuGet.org via un CodeCatalyst référentiel en configurant le référentiel avec une connexion en amont à NuGet.org. Les paquets consommés à partir de NuGet.org sont ingérés et stockés dans votre CodeCatalyst dépôt.

Pour consommer des packages provenant de NuGet .org
  1. Si ce n'est pas déjà fait, configurez votre gestionnaire de NuGet packages avec votre référentiel de CodeCatalyst packages en suivant les étapes décrites dansConfiguration NuGet avec CodeCatalyst.

  2. Assurez-vous que votre dépôt a ajouté NuGet.org en tant que connexion en amont. Vous pouvez vérifier quelles sources en amont sont ajoutées ou ajouter Nuget.org en tant que source en amont en suivant les instructions Ajouter un référentiel en amont et en choisissant le référentiel du NuGet magasin.

Publier NuGet des packages vers CodeCatalyst

Une fois que vous avez configuré NuGet avec CodeCatalyst, vous pouvez utiliser nuget ou dotnet publier des versions de package dans CodeCatalyst des référentiels.

Pour transférer une version de package vers un CodeCatalyst référentiel, exécutez la commande suivante en indiquant le chemin complet de votre .nupkg fichier et le nom de la source de votre CodeCatalyst référentiel dans votre fichier NuGet de configuration.

Pour publier un package avec dotnet

dotnet nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName

Pour publier un package avec nuget

nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName