配置并使用 nuget 或 dotnet CLI - Amazon CodeCatalyst
使用 CodeCatalyst 配置 NuGet使用 NuGet 程序包通过 CodeCatalyst 使用 NuGet.org 中的 NuGet 程序包发布 NuGet 程序包

Amazon CodeCatalyst 不再向新客户开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 如何从 CodeCatalyst 迁移。

配置并使用 nuget 或 dotnet CLI

您可以使用 NuGet 和 dotnet 等 CLI 工具来发布和使用 CodeCatalyst 中的程序包。本文档提供有关配置 CLI 工具以及使用这些工具来发布或使用程序包的信息。

使用 CodeCatalyst 配置 NuGet

要使用 CodeCatalyst 配置 NuGet，请将存储库端点和个人访问令牌添加到您的 NuGet 配置文件中，以允许 nuget 或 dotnet 连接到您的 CodeCatalyst 程序包存储库。

使用 CodeCatalyst 程序包存储库配置 NuGet

  1. 通过访问 https://codecatalyst.aws/ 打开 CodeCatalyst 控制台。

  2. 在项目的概述页面上，选择程序包。

  3. 从程序包存储库列表中，选择您的程序包存储库。

  4. 选择连接到存储库。

  5. 在连接到存储库对话框中，从程序包管理器客户端列表中选择 NuGet 或 dotnet。

  6. 您将需要个人访问令牌（PAT）才能使用 CodeCatalyst 对 NuGet 进行身份验证。如果您已有一个 PAT，则可以使用它。如果没有 PAT，您可以在此处创建一个。

    1. 选择创建令牌。

    2. 选择复制以复制您的 PAT。

      警告

      关闭此对话框后，您将无法再次查看或复制您的 PAT。

  7. 配置 nuget 或 dotnet 以使用存储库的 NuGet 端点和 CodeCatalyst PAT。替换以下值。

    注意

    如果通过控制台指令进行复制，则以下值将进行更新且不应更改。

    • 将 username 替换为您的 CodeCatalyst 用户名。

    • 将 PAT 替换为您的 CodeCatalyst PAT。

    • 将 space_name 替换为您的 CodeCatalyst 空间名称。

    • 将 proj_name 替换为您的 CodeCatalyst 项目名称。

    • 将 repo_name 替换为您的 CodeCatalyst 程序包存储库名称。

    1. 对于 nuget，请使用 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. 对于 dotnet，请使用 dotnet nuget add source 命令。

      Linux 和 macOS 用户：由于在非 Windows 平台上不支持加密，因此您必须在以下命令中添加 --store-password-in-clear-text 标志。请注意，这会将您的密码以纯文本形式存储在配置文件中。

      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

使用 CodeCatalyst 配置 NuGet 后，您可以使用 NuGet 程序包（存储在 CodeCatalyst 存储库或其某个上游存储库中）并向 CodeCatalyst 存储库发布 NuGet 程序包。

使用 CodeCatalyst 存储库中的 NuGet 程序包

使用 CodeCatalyst 配置 NuGet 后，您可以使用存储在 CodeCatalyst 存储库或其某个上游存储库中的 NuGet 程序包。

要通过 nuget 或 dotnet 使用 CodeCatalyst 存储库或其某个上游存储库中的程序包版本，请运行以下命令。将 packageName 替换为要使用的程序包的名称，将 packageSourceName 替换为 NuGet 配置文件中的 CodeCatalyst 程序包存储库的源名称，它应为存储库名称。

使用 dotnet 安装程序包

dotnet add packageName --source packageSourceName

使用 nuget 安装程序包

nuget install packageName --source packageSourceName

有关更多信息，请参阅 Microsoft 文档中的使用 nuget CLI 管理程序包或使用 dotnet CLI 安装和管理程序包。

您可以通过 CodeCatalyst 存储库使用来自 NuGet.org 的 NuGet 程序包，方法是为存储库配置与 NuGet.org 的上游连接。从 NuGet.org 使用的程序包会被摄取并存储在您的 CodeCatalyst 存储库中。

使用来自 NuGet.org 的程序包

  1. 如果尚未执行此操作，请按照使用 CodeCatalyst 配置 NuGet 中的步骤操作，使用 CodeCatalyst 程序包存储库配置 NuGet 程序包管理器。

  2. 确保您的存储库已将 NuGet.org 添加为上游连接。您可以按照添加上游存储库中的说明操作并选择 NuGet 存储存储库来检查添加了哪些上游来源或将 Nuget.org 添加为上游来源。

将 NuGet 程序包发布到 CodeCatalyst

使用 CodeCatalyst 配置 NuGet 后，您可以使用 nuget 或 dotnet 将程序包版本发布到 CodeCatalyst 存储库。

要将程序包版本推送到 CodeCatalyst 存储库，请运行以下命令，使用 .nupkg 文件的完整路径和 NuGet 配置文件中 CodeCatalyst 存储库的源名称。

使用 dotnet 发布程序包

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

使用 nuget 发布程序包

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