Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók
Név
dotnet nuget push – Leküldi a csomagot a kiszolgálóra, és közzéteszi azt.
Áttekintés
dotnet nuget push [<ROOT>] [--allow-insecure-connections] [-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>]
[--configfile <FILE>]
dotnet nuget push -h|--help
Leírás
A dotnet nuget push parancs leküld egy csomagot a kiszolgálóra, és közzéteszi azt. A leküldéses parancs a rendszer NuGet-konfigurációs fájljában vagy konfigurációs fájlláncában található kiszolgálói és hitelesítő adatokat használja. A konfigurációs fájlokról további információt a NuGet-viselkedés konfigurálása című témakörben talál. A NuGet alapértelmezett konfigurációját a rendszer a%AppData%\NuGet\NuGet.config (Windows) vagy a $HOME/.nuget/NuGet/NuGet.Config (Linux/macOS) betöltésével szerzi be, majd betölti az összesnuget.config vagy .nuget\nuget.config a meghajtó gyökerétől kezdve az aktuális könyvtárig.
A parancs leküld egy meglévő csomagot. Nem hoz létre csomagot. Csomag létrehozásához használja dotnet packa következőt: .
Hierarchikus mappastruktúra
Ez a parancs hierarchikus mappastruktúrában tárolhatja a csomagokat, ami a teljesítmény optimalizálásához ajánlott. A csomagokat hierarchikus mappastruktúrában tárolja, amikor egy helyi mappában (hírcsatornában) teszi közzé a csomagokat, például nuget add ha már van legalább egy csomag a hírcsatornában, amely hierarchikus mappastruktúrában található. Ha a hírcsatorna már rendelkezik hierarchikus, strukturált mappacsomagokkal, dotnet nuget push akkor ezt a struktúrát tiszteletben tartja. Ha tehát a NuGet CLI helyett a .NET CLI használatával szeretne közzétenni egy helyi hírcsatornában:
- Az első csomag közzététele előtt lépjen a globális csomagok mappájába a%userprofile%.nuget\packages címen, és válassza ki a csomagazonosító gyökérmappáját. Bármely olyan csomag lehet, amely nem része egy keretrendszernek, például .NET standard vagy ASP.NET.
- Másolja a kijelölt csomagmappát a helyi hírcsatorna gyökérmappájába.
- A csomag a helyi hírcsatornában való közzétételére használható
dotnet nuget push. - Most már törölheti a korábban másolt mappát, és szabadon közzéteheti
dotnet nuget pusha helyi hírcsatornában.
Másik lehetőségként használja a NuGet CLI-t az első csomaghoz, majd a többit is használhatja dotnet nuget push . További információ: Helyi hírcsatornák.
Érvek
ROOTMegadja a leküldéses csomag elérési útját.
Beállítások
--allow-insecure-connectionsLehetővé teszi a HTTP-forrásokba való leküldést (nem biztonságos).
-d|--disable-bufferingLetiltja a pufferelést HTTP(S) kiszolgálóra való leküldéskor a memóriahasználat csökkentése érdekében.
--force-english-outputKényszeríti az alkalmazást, hogy invariáns, angol nyelvű kultúrával fusson.
-
-?|-h|--helpA parancs használatának leírását nyomtatja ki.
-
--interactiveLehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.
-k|--api-key <API_KEY>A kiszolgáló API-kulcsa.
-n|--no-symbolsNem küld le szimbólumokat (akkor sem, ha jelen van).
--no-service-endpointNem fűzi hozzá az "api/v2/package" fájlt a forrás URL-címéhez.
-s|--source <SOURCE>Megadja a kiszolgáló URL-címét. A NuGet azonosítja az UNC vagy a helyi mappaforrást, és egyszerűen átmásolja a fájlt ahelyett, hogy HTTP-t használva küldi el.
Fontos
A NuGet 3.4.2-től kezdődően ez egy kötelező paraméter, kivéve, ha a NuGet konfigurációs fájl megad egy
DefaultPushSourceértéket. További információ: A NuGet viselkedésének konfigurálása.--skip-duplicateHa több csomagot küld egy HTTP(S) kiszolgálóra, figyelmeztetésként kezeli a 409 ütközési választ, hogy a többi leküldés folytatódjon.
-sk|--symbol-api-key <API_KEY>A szimbólumkiszolgáló API-kulcsa.
-ss|--symbol-source <SOURCE>Megadja a szimbólumkiszolgáló URL-címét.
-t|--timeout <TIMEOUT>A kiszolgálóra való leküldés időtúllépését adja meg másodpercek alatt. Alapértelmezés szerint 300 másodperc (5 perc). A 0 megadása az alapértelmezett értéket alkalmazza.
--configfileA használni kívánt NuGet-konfigurációs fájl (nuget.config). Ha meg van adva, a rendszer csak a fájlból származó beállításokat használja. Ha nincs megadva, a rendszer az aktuális könyvtárból származó konfigurációs fájlok hierarchiáját használja. További információ: Common NuGet Configurations.
Példák
A Foo.nupkg leküldése a NuGet konfigurációs fájlban megadott alapértelmezett leküldési forrásba API-kulccsal:
dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3aA foo.nupkg leküldése a hivatalos NuGet-kiszolgálóra egy API-kulcs megadásával:
dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://api.nuget.org/v3/index.jsonA foo.nupkg leküldése az egyéni leküldéses forrásba
https://customsourceegy API-kulcs megadásával:dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/A foo.nupkg leküldése a NuGet konfigurációs fájlban megadott alapértelmezett leküldési forrásra:
dotnet nuget push foo.nupkgA foo.symbols.nupkg leküldése az alapértelmezett szimbólumforrásra:
dotnet nuget push foo.symbols.nupkgA foo.nupkg leküldése a NuGet konfigurációs fájlban megadott alapértelmezett leküldési forrásra 360 másodperces időtúllépéssel:
dotnet nuget push foo.nupkg --timeout 360Az aktuális könyvtár összes .nupkg fájljának leküldése a NuGet konfigurációs fájlban megadott alapértelmezett leküldési forrásba:
dotnet nuget push "*.nupkg"Az összes .nupkg fájl leküldése a NuGet konfigurációs fájlban megadott alapértelmezett leküldési forrásba akkor is, ha egy HTTP(S) kiszolgáló 409 ütközési választ ad vissza:
dotnet nuget push "*.nupkg" --skip-duplicateAz aktuális könyvtár összes .nupkg fájljának leküldése egy helyi hírcsatornakönyvtárba:
dotnet nuget push "*.nupkg" -s c:\mydirAz Azure Artifactsbe való leküldésről az Azure Artifacts leküldéses dokumentációjában olvashat.