dotnet nuget push

  • Artykuł
  • Czas czytania: 3 min

Ten artykuł dotyczy: ✔️ .NET Core 3.1 SDK i nowsze wersje

Nazwa

dotnet nuget push — Wypycha pakiet na serwer i publikuje go.

Streszczenie

dotnet nuget push [<ROOT>] [-d|--disable-buffering] [--force-english-output]
    [--interactive] [-k|--api-key <API_KEY>] [-n|--no-symbols]
    [--no-service-endpoint] [-s|--source <SOURCE>] [--skip-duplicate]
    [-sk|--symbol-api-key <API_KEY>] [-ss|--symbol-source <SOURCE>]
    [-t|--timeout <TIMEOUT>]

dotnet nuget push -h|--help

Opis

Polecenie dotnet nuget push wypycha pakiet na serwer i publikuje go. Polecenie wypychania używa szczegółów serwera i poświadczeń znajdujących się w pliku konfiguracji systemu NuGet lub łańcuchu plików konfiguracji. Aby uzyskać więcej informacji na temat plików konfiguracji, zobacz Konfigurowanie zachowania NuGet. Domyślna konfiguracja NuGet jest uzyskiwana przez załadowanie pliku %AppData%\NuGet\NuGet.config (Windows) lub $HOME/.nuget/NuGet/NuGet.Config (Linux/macOS), a następnie załadowanie dowolnych nuget.config lub nuget\nuget.config rozpoczynających się od katalogu głównego dysku i kończącego się w bieżącym katalogu.

Polecenie wypycha istniejący pakiet. Nie tworzy pakietu. Aby utworzyć pakiet, użyj polecenia dotnet pack.

Argumenty

  • ROOT

    Określa ścieżkę pliku do pakietu do wypchnięcia.

Opcje

  • -d|--disable-buffering

    Wyłącza buforowanie podczas wypychania do serwera HTTP w celu zmniejszenia użycia pamięci.

  • --force-english-output

    Wymusza uruchamianie aplikacji przy użyciu niezmiennej kultury opartej na języku angielskim.

  • -?|-h|--help

    Wyświetla opis sposobu używania polecenia .

  • --interactive

    Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania. Dostępne od zestawu .NET Core 3.0 SDK.

  • -k|--api-key <API_KEY>

    Klucz interfejsu API serwera.

  • -n|--no-symbols

    Nie wypycha symboli (nawet jeśli są obecne).

  • --no-service-endpoint

    Nie dołącza elementu "api/v2/package" do źródłowego adresu URL.

  • -s|--source <SOURCE>

    Określa adres URL serwera. NuGet identyfikuje źródło UNC lub folder lokalny i po prostu kopiuje tam plik zamiast wypychać go przy użyciu protokołu HTTP.

    Ważne

    Począwszy od NuGet 3.4.2, jest to obowiązkowy parametr, chyba że NuGet pliku konfiguracji określa DefaultPushSource wartość. Aby uzyskać więcej informacji, zobacz Konfigurowanie zachowania NuGet.

  • --skip-duplicate

    Podczas wypychania wielu pakietów do serwera HTTP traktuje dowolną odpowiedź powodującą konflikt 409 jako ostrzeżenie, dzięki czemu wypychanie może kontynuować.

  • -sk|--symbol-api-key <API_KEY>

    Klucz interfejsu API serwera symboli.

  • -ss|--symbol-source <SOURCE>

    Określa adres URL serwera symboli.

  • -t|--timeout <TIMEOUT>

    Określa limit czasu wypychania do serwera w sekundach. Wartość domyślna to 300 sekund (5 minut). Określenie wartości 0 stosuje wartość domyślną.

Przykłady

  • Wypchnij plik foo.nupkg do domyślnego źródła wypychania określonego w pliku konfiguracji NuGet przy użyciu klucza interfejsu API:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

  • Wypchnij plik foo.nupkg do oficjalnego serwera NuGet, określając klucz interfejsu API:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://api.nuget.org/v3/index.json
    • Wypchnij plik foo.nupkg do niestandardowego źródła https://customsourcewypychania , określając klucz interfejsu API:
    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/

  • Wypchnij plik foo.nupkg do domyślnego źródła wypychania określonego w pliku konfiguracji NuGet:

    dotnet nuget push foo.nupkg

  • Wypchnij plik foo.symbols.nupkg do źródła symboli domyślnych:

    dotnet nuget push foo.symbols.nupkg

  • Wypchnij plik foo.nupkg do domyślnego źródła wypychania określonego w pliku konfiguracji NuGet z limitem czasu 360 sekund:

    dotnet nuget push foo.nupkg --timeout 360

  • Wypchnij wszystkie pliki nupkg w bieżącym katalogu do domyślnego źródła wypychania określonego w pliku konfiguracji NuGet:

    dotnet nuget push "*.nupkg"

    Uwaga

    Jeśli to polecenie nie działa, może to być spowodowane usterką, która istniała w starszych wersjach zestawu SDK (zestaw SDK platformy .NET Core 2.1 i starsze wersje). Aby rozwiązać ten problem, uaktualnij wersję zestawu SDK lub uruchom następujące polecenie: dotnet nuget push "**/*.nupkg"

    Uwaga

    Cudzysłowy otaczające są wymagane dla powłok, takich jak powłoka bash, która wykonuje globbing pliku. Aby uzyskać więcej informacji, zobacz NuGet/Home#4393.

  • Wypchnij wszystkie pliki nupkg do domyślnego źródła wypychania określonego w pliku konfiguracji NuGet, nawet jeśli odpowiedź powodująca konflikt 409 jest zwracana przez serwer HTTP(S):

    dotnet nuget push "*.nupkg" --skip-duplicate

  • Wypchnij wszystkie pliki nupkg w bieżącym katalogu do lokalnego katalogu kanału informacyjnego:

    dotnet nuget push "*.nupkg" -s c:\mydir

    To polecenie nie przechowuje pakietów w strukturze folderów hierarchicznych, co jest zalecane do optymalizacji wydajności. Aby uzyskać więcej informacji, zobacz Lokalne źródła danych.