

Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).

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 de la CLI nuget ou dotnet
<a name="packages-nuget-cli"></a>

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

**Contents**
+ [Configuration NuGet avec CodeCatalyst](#nuget-configure-cli)
+ [Consommation de NuGet packages à partir d'un CodeCatalyst référentiel](#nuget-consume-cli)
+ [Consommer NuGet des packages depuis NuGet .org via CodeCatalyst](#nuget-consume-nuget-gallery)
+ [Publier NuGet des packages vers CodeCatalyst](#nuget-publish-cli)

## Configuration NuGet avec CodeCatalyst
<a name="nuget-configure-cli"></a>

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/](https://codecatalyst.aws/).

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

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

1. Choisissez **Connect to repository**.

1. Dans la boîte de dialogue **Connect to repository**, choisissez **NuGet**ou **dotnet** dans la liste des clients du gestionnaire de packages. 

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

   1. Choisissez **Copier** pour copier votre PAT.
**Avertissement**  
Vous ne pourrez plus voir ou copier votre PAT une fois que vous aurez fermé la boîte de dialogue.

1. Configurez `nuget` ou utilisez `dotnet` le NuGet point de terminaison et le CodeCatalyst PAT de votre référentiel. 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* par votre nom CodeCatalyst d'utilisateur.
   + *PAT*Remplacez-le par votre CodeCatalyst PAT.
   + Remplacez *space\$1name* par le nom de votre CodeCatalyst espace.
   + Remplacez *proj\$1name* par le nom CodeCatalyst de votre projet.
   + *repo\$1name*Remplacez-le par 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"
      ```

   1. 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-text`indicateur à 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](#nuget-consume-cli) stockés dans votre CodeCatalyst référentiel ou dans l'un de ses référentiels en amont et [publier des NuGet packages](#nuget-publish-cli) dans votre CodeCatalyst référentiel.

## Consommation de NuGet packages à partir d'un CodeCatalyst référentiel
<a name="nuget-consume-cli"></a>

Une fois que vous avez [configuré NuGet avec CodeCatalyst](#nuget-configure-cli), 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 depuis un CodeCatalyst référentiel ou l'un de ses référentiels en amont avec nuget ou dotnet, exécutez la commande suivante. Remplacez-le *packageName* par le nom du package que vous souhaitez consommer et *packageSourceName* par le nom de la source de votre référentiel 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 de la CLI nuget](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-nuget-cli) ou [Installer et gérer les packages à l'aide de la CLI dotnet](https://docs.microsoft.com/en-us/nuget/consume-packages/install-use-packages-dotnet-cli) dans la documentation *Microsoft*.

## Consommer NuGet des packages depuis NuGet .org via CodeCatalyst
<a name="nuget-consume-nuget-gallery"></a>

Vous pouvez utiliser des NuGet packages provenant de [NuGet.org](https://www.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 depuis **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 dans[Configuration NuGet avec CodeCatalyst](#nuget-configure-cli). 

1. 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 [Ajout d’un référentiel en amont](packages-upstream-repositories-add.md) et en choisissant le référentiel du **NuGet magasin**.

## Publier NuGet des packages vers CodeCatalyst
<a name="nuget-publish-cli"></a>

Une fois que vous avez [configuré NuGet avec CodeCatalyst](#nuget-configure-cli), 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
```