dotnet nuget push

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet nuget push - Pusht een pakket naar de server en publiceert het.

Synopsis

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

Beschrijving

Met de dotnet nuget push opdracht wordt een pakket naar de server gepusht en gepubliceerd. De pushopdracht maakt gebruik van server- en referentiegegevens in het NuGet-configuratiebestand of de keten van configuratiebestanden van het systeem. Zie NuGet-gedrag configureren voor meer informatie over configuratiebestanden. De standaardconfiguratie van NuGet wordt verkregen door %AppData%\NuGet\NuGet.config (Windows) of $HOME/.nuget/NuGet/NuGet.Config (Linux/macOS) te laden en vervolgens eennuget.config of .nuget\nuget.config te laden vanaf de hoofdmap van het station en eindigt in de huidige map.

Met de opdracht wordt een bestaand pakket gepusht. Er wordt geen pakket gemaakt. Gebruik dotnet packom een pakket te maken.

Argumenten

  • ROOT

    Hiermee geeft u het bestandspad naar het pakket dat moet worden gepusht.

Opties

  • -d|--disable-buffering

    Hiermee wordt buffering uitgeschakeld bij het pushen naar een HTTP(S)-server om het geheugengebruik te verminderen.

  • --force-english-output

    Hiermee dwingt u af dat de toepassing wordt uitgevoerd met behulp van een invariante, Engelse cultuur.

  • -?|-h|--help

    Hiermee wordt een beschrijving weergegeven van het gebruik van de opdracht.

  • --interactive

    Hiermee staat u toe dat de opdracht stopt en wacht op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien. Beschikbaar sinds .NET Core 3.0 SDK.

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

    De API-sleutel voor de server.

  • -n|--no-symbols

    Pusht geen symbolen (zelfs niet als deze aanwezig zijn).

  • --no-service-endpoint

    'api/v2/package' wordt niet toegevoegd aan de bron-URL.

  • -s|--source <SOURCE>

    Hiermee geeft u de server-URL op. NuGet identificeert een UNC- of lokale mapbron en kopieert het bestand daarheen in plaats van het te pushen met behulp van HTTP.

    Belangrijk

    Vanaf NuGet 3.4.2 is dit een verplichte parameter, tenzij het NuGet-configuratiebestand een DefaultPushSource waarde opgeeft. Zie NuGet-gedrag configureren voor meer informatie.

  • --skip-duplicate

    Bij het pushen van meerdere pakketten naar een HTTP(S)-server, wordt een 409-conflictreactie behandeld als een waarschuwing, zodat andere pushes kunnen worden voortgezet.

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

    De API-sleutel voor de symboolserver.

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

    Hiermee geeft u de symboolserver-URL op.

  • -t|--timeout <TIMEOUT>

    Hiermee geeft u de time-out voor het pushen naar een server in seconden. De standaardwaarde is 300 seconden (5 minuten). Als u 0 opgeeft, wordt de standaardwaarde toegepast.

Voorbeelden

  • Push foo.nupkg naar de standaardpushbron die is opgegeven in het NuGet-configuratiebestand, met behulp van een API-sleutel:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a
    
  • Push foo.nupkg naar de officiële NuGet-server, waarbij u een API-sleutel opgeeft:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://api.nuget.org/v3/index.json
    
  • Push foo.nupkg naar de aangepaste pushbron https://customsource, waarbij u een API-sleutel opgeeft:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/
    
  • Push foo.nupkg naar de standaardpushbron die is opgegeven in het NuGet-configuratiebestand:

    dotnet nuget push foo.nupkg
    
  • Push foo.symbols.nupkg naar de standaardbron voor symbolen:

    dotnet nuget push foo.symbols.nupkg
    
  • Push foo.nupkg naar de standaardpushbron die is opgegeven in het NuGet-configuratiebestand, met een time-out van 360 seconden:

    dotnet nuget push foo.nupkg --timeout 360
    
  • Push alle .nupkg-bestanden in de huidige map naar de standaard pushbron die is opgegeven in het NuGet-configuratiebestand:

    dotnet nuget push "*.nupkg"
    

    Notitie

    Als deze opdracht niet werkt, kan dit worden veroorzaakt door een fout in oudere versies van de SDK (.NET Core 2.1 SDK en eerdere versies). U kunt dit oplossen door uw SDK-versie te upgraden of in plaats daarvan de volgende opdracht uit te voeren: dotnet nuget push "**/*.nupkg"

    Notitie

    De aanhalingstekens zijn vereist voor shells zoals bash die bestand globbing uitvoeren. Zie NuGet/Home#4393 voor meer informatie.

  • Push alle .nupkg-bestanden naar de standaard pushbron die is opgegeven in het NuGet-configuratiebestand, zelfs als een 409 Conflict-antwoord wordt geretourneerd door een HTTP(S)-server:

    dotnet nuget push "*.nupkg" --skip-duplicate
    
  • Push alle .nupkg-bestanden in de huidige map naar een lokale feedmap:

    dotnet nuget push "*.nupkg" -s c:\mydir
    
  • Zie de pushdocumentatie van Azure Artifacts voor pushen naar Azure Artifacts.

    Met deze opdracht worden pakketten niet opgeslagen in een hiërarchische mappenstructuur, wat wordt aanbevolen om de prestaties te optimaliseren. Zie Lokale feeds voor meer informatie.