Megosztás a következőn keresztül:


dotnet nuget push (feltöltés parancsa)

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 push a 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

  • ROOT

    Megadja a leküldéses csomag elérési útját.

Beállítások

  • --allow-insecure-connections

    Lehetővé teszi a HTTP-forrásokba való leküldést (nem biztonságos).

  • -d|--disable-buffering

    Letiltja a pufferelést HTTP(S) kiszolgálóra való leküldéskor a memóriahasználat csökkentése érdekében.

  • --force-english-output

    Kényszeríti az alkalmazást, hogy invariáns, angol nyelvű kultúrával fusson.

  • -?|-h|--help

    A parancs használatának leírását nyomtatja ki.

  • --interactive

    Lehető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-symbols

    Nem küld le szimbólumokat (akkor sem, ha jelen van).

  • --no-service-endpoint

    Nem 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-duplicate

    Ha 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.

  • --configfile

    A 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-c4f3e8ef9b3a
    
  • A 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.json
    
  • A 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.nupkg
    
  • A foo.symbols.nupkg leküldése az alapértelmezett szimbólumforrásra:

    dotnet nuget push foo.symbols.nupkg
    
  • A 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 360
    
  • Az 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-duplicate
    
  • Az 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:\mydir
    
  • Az Azure Artifactsbe való leküldésről az Azure Artifacts leküldéses dokumentációjában olvashat.