Konfiguration und Verwendung von Nuget oder Dotnet CLI

Sie können CLI Tools wie NuGet und verwendendotnet, um Pakete von zu veröffentlichen und zu konsumieren CodeCatalyst. Dieses Dokument enthält Informationen zur Konfiguration der CLI Tools und zu ihrer Verwendung zum Veröffentlichen oder Verwenden von Paketen.

Inhalt

• Konfiguration NuGet mit CodeCatalyst
• NuGet Pakete aus einem CodeCatalyst Repository konsumieren
• NuGet Pakete von.org konsumieren bis NuGet CodeCatalyst
• Pakete veröffentlichen NuGet auf CodeCatalyst

Konfiguration NuGet mit CodeCatalyst

Um NuGet mit zu konfigurieren CodeCatalyst, fügen Sie Ihrer NuGet Konfigurationsdatei einen Repository-Endpunkt und ein persönliches Zugriffstoken hinzu, um Ihr CodeCatalyst Paket-Repository dotnet zu ermöglichen nuget oder eine Verbindung zu diesem herzustellen.

Zur Konfiguration NuGet mit Ihrem CodeCatalyst Paket-Repository

1. Öffnen Sie die CodeCatalyst Konsole unter https://codecatalyst.aws/.

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

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

4. Wählen Sie Mit Repository verbinden.

5. Wählen Sie im Dialogfeld Mit Repository verbinden die Option NuGetoder dotnet aus der Liste der Package Manager-Clients aus.

6. Sie benötigen ein persönliches Zugriffstoken (PAT), mit dem Sie sich authentifizieren können. NuGet 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.

   2. Wählen Sie Kopieren, um Ihre zu kopierenPAT.

      Warnung

      Nachdem Sie das Dialogfeld geschlossen haben, können Sie Ihre nicht PAT erneut anzeigen oder kopieren.

7. Konfigurieren nuget oder verwenden dotnet Sie den NuGet Endpunkt Ihres Repositorys und CodeCatalyst PAT. 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 username mit Ihrem CodeCatalyst Benutzernamen.

   • Ersetzen PAT mit deinem CodeCatalyst PAT.

   • Ersetzen space_name mit deinem CodeCatalyst Raumnamen.

   • Ersetzen proj_name mit Ihrem CodeCatalyst Projektnamen.

   • Ersetzen repo_name mit dem Namen Ihres CodeCatalyst Paket-Repositorys.

   1. Verwenden Sie für nuget den Befehl 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. Verwenden Sie für dotnet den Befehl dotnet nuget add source.

      Linux- und macOS-Benutzer: Da Verschlüsselung auf Nicht-Windows-Plattformen nicht unterstützt wird, müssen Sie dem folgenden Befehl das --store-password-in-clear-text Flag hinzufügen. Beachten Sie, dass dadurch Ihr Passwort als Klartext in Ihrer Konfigurationsdatei gespeichert wird.

      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

Sobald Sie NuGet mit konfiguriert haben CodeCatalyst, können Sie NuGet Pakete verwenden, die in Ihrem CodeCatalyst Repository oder einem seiner Upstream-Repositorys gespeichert sind, und NuGet Pakete in Ihrem CodeCatalyst Repository veröffentlichen.

NuGet Pakete aus einem CodeCatalyst Repository konsumieren

Sobald Sie NuGet mit konfiguriert haben CodeCatalyst, können Sie NuGet Pakete nutzen, die in Ihrem CodeCatalyst Repository oder einem seiner Upstream-Repositorys gespeichert sind.

Um eine Paketversion aus einem CodeCatalyst Repository oder einem seiner Upstream-Repositorys mit Nuget oder Dotnet zu nutzen, führen Sie den folgenden Befehl aus. Ersetzen packageName mit dem Namen des Pakets, das Sie konsumieren möchten, und packageSourceName mit dem Quellnamen für Ihr CodeCatalyst Paket-Repository in Ihrer NuGet Konfigurationsdatei, was der Repository-Name sein sollte.

Um ein Paket zu installieren mit dotnet

dotnet add packageName --source packageSourceName

Um ein Paket zu installieren mit nuget

nuget install packageName --source packageSourceName

Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Pakete mithilfe des Nuget verwalten CLI oder Pakete mithilfe des CLI Punktnetzes installieren und verwalten.

NuGet Pakete von.org konsumieren bis NuGet CodeCatalyst

Sie können NuGet Pakete von NuGet.org über ein CodeCatalyst Repository konsumieren, indem Sie das Repository mit einer Upstream-Verbindung zu NuGet.org konfigurieren. Pakete, die von NuGet.org konsumiert werden, werden aufgenommen und in Ihrem CodeCatalyst Repository gespeichert.

Um Pakete von NuGet .org zu konsumieren

1. Falls Sie es noch nicht getan haben, konfigurieren Sie Ihren NuGet Paketmanager mit Ihrem CodeCatalyst Paket-Repository, indem Sie die Schritte unter befolgenKonfiguration NuGet mit CodeCatalyst.

2. Stellen Sie sicher, dass Ihr Repository NuGet.org als Upstream-Verbindung hinzugefügt hat. Sie können überprüfen, welche Upstream-Quellen hinzugefügt wurden, oder NuGet.org als Upstream-Quelle hinzufügen, indem Sie den Anweisungen unter folgen Hinzufügen eines Upstream-Repositorys und das NuGet Store-Repository auswählen.

Pakete veröffentlichen NuGet auf CodeCatalyst

Sobald Sie NuGet mit konfiguriert haben, können Sie nuget oder verwenden CodeCatalyst, um Paketversionen in Repositorys dotnet zu CodeCatalyst veröffentlichen.

Um eine Paketversion in ein CodeCatalyst Repository zu übertragen, führen Sie den folgenden Befehl mit dem vollständigen Pfad zu Ihrer .nupkg Datei und dem Quellnamen für Ihr CodeCatalyst Repository in Ihrer NuGet Konfigurationsdatei aus.

Um ein Paket zu veröffentlichen mit dotnet

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

Um ein Paket zu veröffentlichen mit nuget

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