Configuración y uso de la CLI de nuget o dotnet - Amazon CodeCatalyst

Amazon CodeCatalyst ya no está disponible para nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cómo migrar de CodeCatalyst.

Configuración y uso de la CLI de nuget o dotnet

Puede usar herramientas CLI, como NuGet y dotnet, para publicar y consumir paquetes desde CodeCatalyst. Este documento proporciona información sobre la configuración de las herramientas CLI y su uso para publicar o consumir paquetes.

Configuración de NuGet con CodeCatalyst

Para configurar NuGet con CodeCatalyst, añada un punto de conexión de repositorio y un token de acceso personal a su archivo de configuración de NuGet para permitir que nuget o dotnet se conecten a su repositorio de paquetes de CodeCatalyst.

Configuración de NuGet al repositorio de paquetes de CodeCatalyst
  1. Abra la consola de CodeCatalyst en https://codecatalyst.aws/.

  2. En la página de información general del proyecto, seleccione Paquetes.

  3. Elija su repositorio de paquetes de la lista de repositorios de paquetes.

  4. Seleccione Establecer conexión con el repositorio.

  5. En el cuadro de diálogo Establecer conexión con el repositorio, elija NuGet o dotnet en la lista de clientes del administrador de paquetes.

  6. Necesitará un token de acceso personal (PAT) para autenticar NuGet con CodeCatalyst. Si ya tiene uno, puede utilizarlo. De lo contrario, puede crear uno aquí.

    1. Seleccione Crear token.

    2. Seleccione Copiar para copiar el PAT.

      aviso

      Después de cerrar el cuadro de diálogo, no podrá volver a ver ni copiar el PAT.

  7. Configure nuget o dotnet para usar el punto de conexión de NuGet del repositorio y el PAT de CodeCatalyst. Reemplace los siguientes valores.

    nota

    Si va a copiar las instrucciones de la consola, los siguientes valores deben actualizarse automáticamente y no deben cambiarse.

    • Sustituya username por su nombre de usuario en CodeCatalyst.

    • Sustituya PAT por su PAT en CodeCatalyst.

    • Sustituya space_name por el nombre de su espacio de CodeCatalyst.

    • Sustituya proj_name por el nombre de su proyecto de CodeCatalyst.

    • Sustituya repo_name por el nombre de su repositorio de paquetes de CodeCatalyst.

    1. En nuget, utilice el comando nuget sources add:

      nuget sources add -name "repo_name" -Source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -username "username" -password "PAT"
    2. En dotnet, utilice el comando dotnet nuget add source:

      Usuarios de Linux y macOS: dado que el cifrado no se admite en plataformas que no sean Windows, debe añadir la marca --store-password-in-clear-text al siguiente comando. Tenga en cuenta que esto almacenará la contraseña como texto sin formato en el archivo de configuración.

      dotnet nuget add source "https://packages.region.codecatalyst.aws/nuget/space_name/proj_name/repo_name/v3/index.json" -n "proj_name/repo_name" -u "username" -p "PAT" --store-password-in-clear-text

Cuando haya configurado NuGet con CodeCatalyst, podrá consumir los paquetes NuGet almacenados en su repositorio de CodeCatalyst, o en uno de sus repositorios ascendentes, y publicar los paquetes NuGet en su repositorio de CodeCatalyst.

Consumición de paquetes NuGet desde un repositorio de CodeCatalyst

Una vez que haya configurado NuGet con CodeCatalyst, puede consumir los paquetes NuGet que estén almacenados en su repositorio de CodeCatalyst o en uno de sus repositorios ascendentes.

Para consumir una versión de paquete desde un repositorio de CodeCatalyst o desde uno de sus repositorios ascendentes con nuget o dotnet, ejecute el siguiente comando. Sustituya packageName por el nombre del paquete que desea consumir y packageSourceName por el nombre del origen del repositorio de paquetes de CodeCatalyst en el archivo de configuración de NuGet, que debería ser el nombre del repositorio.

Instalación de un paquete con dotnet

dotnet add packageName --source packageSourceName

Instalación de un paquete con nuget

nuget install packageName --source packageSourceName

Para obtener más información, consulte Manage packages using the nuget CLI o Install and manage packages using the dotnet CLI en la documentación de Microsoft.

Puede consumir paquetes NuGet desde NuGet.org a través de un repositorio de CodeCatalyst configurando el repositorio con una conexión ascendente a NuGet.org. Los paquetes consumidos desde NuGet.org se ingieren y almacenan en el repositorio de CodeCatalyst.

Consumición de paquetes desde NuGet.org
  1. Si aún no lo ha hecho, configure el administrador de paquetes de NuGet con el repositorio de paquetes de CodeCatalyst siguiendo los pasos indicados en Configuración de NuGet con CodeCatalyst.

  2. Compruebe que su repositorio haya añadido NuGet.org como conexión ascendente. Puede comprobar qué orígenes ascendentes se añaden, o añadir NuGet.org como origen ascendente, siguiendo las instrucciones de Adición de un repositorio ascendente y seleccionando el repositorio de la tienda de NuGet.

Publicación de paquetes NuGet en CodeCatalyst

Una vez que haya configurado NuGet con CodeCatalyst, puede usar nuget o dotnet para publicar versiones de paquetes en los repositorios de CodeCatalyst.

Para enviar una versión de paquete a un repositorio de CodeCatalyst, ejecute el siguiente comando con la ruta completa a su archivo .nupkg y el nombre del origen de su repositorio de CodeCatalyst en su archivo de configuración de NuGet.

Publicación de un paquete con dotnet

dotnet nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName

Publicación de un paquete con nuget

nuget push path/to/nupkg/SamplePackage.1.0.0.nupkg --source packageSourceName