dotnet nuget push

Artículo
10/09/2021
2 minutos para leer

Este artículo se aplica a: ✔️ SDK de .NET Core 2.x y versiones posteriores

NOMBRE

dotnet nuget push: inserta un paquete en el servidor y lo publica.

Sinopsis

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

Descripción

El comando dotnet nuget push inserta un paquete en el servidor y lo publica. El comando push usa los detalles del servidor y de las credenciales encontrados en el archivo de configuración NuGet del sistema o en la cadena de archivos de configuración. Para más información sobre los archivos de configuración, consulte Configuring NuGet Behavior (Configuración del comportamiento de NuGet). La configuración predeterminada de NuGet se obtiene mediante la carga de %AppData%\NuGet\NuGet.config (Windows) o $HOME/.nuget/NuGet/NuGet.Config (Linux/macOS), y luego la carga de cualquier archivo nuget.config o .nuget\nuget.config comenzando desde la raíz de la unidad y finalizando en el directorio actual.

El comando inserta un paquete existente. No crea un paquete. Para crear un paquete, use dotnet pack.

Argumentos

ROOT

Especifica la ruta de acceso al archivo en la que se debe insertar el paquete.

Opciones

-d|--disable-buffering

Deshabilita el almacenamiento en búfer al realizar inserciones en un servidor HTTP(S) para reducir el uso de memoria.
--force-english-output

Fuerza la ejecución de la aplicación mediante una referencia cultural en inglés invariable.

-?|-h|--help

Imprime una descripción de cómo usar el comando.

--interactive

Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación. Disponible desde el SDK de .NET Core 3.0.

-k|--api-key <API_KEY>

La clave de API para el servidor.
-n|--no-symbols

No inserta símbolos (incluso si está presente).
--no-service-endpoint

No agrega "api/v2/paquete" a la dirección URL de origen. Opción disponible desde el SDK de .NET Core 2.1.
-s|--source <SOURCE>

Especifica la dirección URL del servidor. NuGet identifica un origen de carpeta local o UNC y simplemente copia el archivo allí, en lugar de insertarlo mediante HTTP.

Importante

A partir de NuGet 3.4.2, se trata de un parámetro obligatorio, a menos que el archivo de configuración de NuGet especifique un valor DefaultPushSource. Para más información, vea Configuring NuGet behavior (Configuración del comportamiento de NuGet).
--skip-duplicate

Al insertar varios paquetes en un servidor HTTP(S), trata cualquier respuesta de conflicto 409 como una advertencia para que la inserción pueda continuar. Disponible a partir del SDK de .NET Core 3.1.
-sk|--symbol-api-key <API_KEY>

La clave de API para el servidor de símbolos.
-ss|--symbol-source <SOURCE>

Especifica la dirección URL del servidor de símbolos.
-t|--timeout <TIMEOUT>

Especifica el tiempo de espera para la inserción en un servidor en segundos. El valor predeterminado es 300 segundos (5 minutos). Si se especifica 0 se aplica el valor predeterminado.

Ejemplos

Inserte foo.nupkg en el origen de inserción predeterminado especificado en el archivo de configuración de NuGet, mediante una clave de API:
```
dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a
```

Inserte foo.nupkg en el servidor de NuGet oficial y especifique una clave de API:

dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://api.nuget.org/v3/index.json

Inserta foo.nupkg en el origen de inserción personalizado https://customsource, y especifica una clave de API:

dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/

Inserte foo.nupkg en el origen de inserción predeterminado especificado en el archivo de configuración de NuGet:
```
dotnet nuget push foo.nupkg
```
Inserte foo.symbols.nupkp en el origen de símbolos predeterminado:
```
dotnet nuget push foo.symbols.nupkg
```
Inserte foo.nupkg en el origen de inserción predeterminado especificado en el archivo de configuración de NuGet, con un tiempo de espera de 360 segundos:
```
dotnet nuget push foo.nupkg --timeout 360
```
Inserte todos los archivos .nupkg del directorio actual en el origen de inserción predeterminado especificado en el archivo de configuración de NuGet:
```
dotnet nuget push "*.nupkg"
```
Nota

Si este comando no funciona, es posible que se deba a un error presente en versiones anteriores del SDK (SDK de .NET Core 2.1 y versiones anteriores). Para solucionar este problema, actualice la versión de su SDK o ejecute el siguiente comando en su lugar: dotnet nuget push "**/*.nupkg"

Nota

Las comillas de inclusión son necesarias para los shells como bash que usan comodines de archivo. Para obtener más información, vea NuGet/Home#4393.
Inserte todos los archivos .nupkg en el origen de inserción predeterminado especificado en el archivo de configuración de NuGet, incluso si un servidor HTTP(S) devuelve una respuesta de conflicto 409:
```
dotnet nuget push "*.nupkg" --skip-duplicate
```
Inserte todos los archivos .nupkg del directorio actual en un directorio de fuente local:
```
dotnet nuget push "*.nupkg" -s c:\mydir
```
Este comando no almacena paquetes en una estructura de carpetas jerárquica, lo que se recomienda para optimizar el rendimiento. Para obtener más información, vea Fuentes locales.