Configuração e uso da CLI nuget ou dotnet - Amazon CodeCatalyst
Configuração do NuGet com o CodeCatalystConsumir pacotes NuGetConsumir pacotes do NuGet do NuGet.org por meio do CodeCatalystPublicar pacotes NuGet

O Amazon CodeCatalyst não está mais disponível para novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Como migrar do CodeCatalyst.

Configuração e uso da CLI nuget ou dotnet

Você pode usar ferramentas de CLI como NuGet e dotnet para publicar e consumir pacotes do CodeCatalyst. Este documento fornece informações sobre como configurar as ferramentas de CLI e usá-las para publicar ou consumir pacotes.

Configuração do NuGet com o CodeCatalyst

Para configurar o NuGet com o CodeCatalyst, adicione um endpoint do repositório e um token de acesso pessoal ao arquivo de configuração do NuGet para permitir que nuget ou dotnet conecte-se ao repositório de pacotes do CodeCatalyst.

Para configurar o NuGet com o repositório de pacotes do CodeCatalyst

  1. Abra o console do CodeCatalyst em https://codecatalyst.aws/.

  2. Na página de visão geral do projeto, selecione Pacotes.

  3. Escolha seu repositório de pacotes na lista de repositórios de pacotes.

  4. Selecione Conectar ao repositório.

  5. Na caixa de diálogo Conectar ao repositório, selecione NuGet ou dotnet na lista de clientes do gerenciador de pacotes.

  6. Você precisará de um token de acesso pessoal (PAT) para a autenticação do NuGet com o CodeCatalyst. Se você já tiver um, pode usá-lo. Caso contrário, você pode criar um aqui.

    1. Selecione Criar token.

    2. Para copiar o PAT, selecione Copiar.

      Atenção

      Você não poderá ver ou copiar seu PAT novamente depois de fechar a caixa de diálogo.

  7. Configure nuget ou dotnet para usar o endpoint NuGet e o PAT do CodeCatalyst do seu repositório. Substitua os valores a seguir.

    nota

    Se estiver copiando as instruções do console, os valores a seguir devem ser atualizados para você e não devem ser alterados.

    • Substitua nome de usuário pelo seu nome de usuário do CodeCatalyst.

    • Substitua o PAT pelo seu PAT do CodeCatalyst.

    • Substitua space_name pelo nome do espaço do CodeCatalyst.

    • Substitua proj_name pelo nome do projeto do CodeCatalyst.

    • Substitua repo_name pelo nome do seu repositório de pacotes do CodeCatalyst.

    1. Para nuget, use o 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. Para dotnet, use o comando dotnet nuget add source.

      Usuários de Linux e macOS: como a criptografia não é compatível com plataformas que não sejam Windows, você deve adicionar o sinalizador --store-password-in-clear-text ao comando a seguir. Observe que isso armazenará sua senha como texto simples no arquivo de configuração.

      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

Depois de configurar o NuGet com o CodeCatalyst, você pode consumir pacotes do NuGet armazenados no repositório do CodeCatalyst ou em um de seus repositórios upstream e publicar pacotes do NuGet no repositório do CodeCatalyst.

Consumo de pacotes do NuGet em um repositório do CodeCatalyst

Depois de configurar o NuGet com o CodeCatalyst, você pode consumir pacotes do NuGet armazenados no repositório do CodeCatalyst ou em um de seus repositórios upstream.

Para consumir uma versão de pacote de um repositório do CodeCatalyst ou de um dos repositórios upstream com nuget ou dotnet, execute o comando a seguir. Substitua packageName pelo nome do pacote que você deseja consumir e packageSourceName pelo nome de origem do repositório de pacotes do CodeCatalyst no arquivo de configuração do NuGet, que deve ser o nome do repositório.

Para instalar um pacote com dotnet

dotnet add packageName --source packageSourceName

Para instalar um pacote com nuget

nuget install packageName --source packageSourceName

Para ter mais informações, consulte Gerenciar pacotes usando a CLI nuget ou Instalar e gerenciar pacotes usando a CLI dotnet na documentação da Microsoft.

Você pode consumir pacotes NuGet em NuGet.org por meio de um repositório do CodeCatalyst configurando o repositório com uma conexão upstream com NuGet.org. Os pacotes consumidos em NuGet.org são ingeridos e armazenados no repositório do CodeCatalyst.

Para consumir pacotes do NuGet.org

  1. Se você ainda não tiver feito isso, configure o gerenciador de pacotes do NuGet com seu repositório de pacotes do CodeCatalyst seguindo as etapas em Configuração do NuGet com o CodeCatalyst.

  2. Certifique-se de que seu repositório tenha adicionado o NuGet.org como uma conexão upstream. Você pode verificar quais fontes upstream foram adicionadas ou adicionar o NuGet.org como uma fonte upstream seguindo as instruções em Adição de um repositório upstream e escolhendo o repositório do armazenamento NuGet.

Publicação de pacotes do NuGet no CodeCatalyst

Depois de configurar o NuGet com o CodeCatalyst, você pode usar o nuget ou o dotnet para publicar versões de pacotes nos repositórios do CodeCatalyst.

Para enviar uma versão do pacote para um repositório do CodeCatalyst, execute o comando a seguir com o caminho completo do arquivo .nupkg e o nome de origem do repositório do CodeCatalyst no arquivo de configuração do NuGet.

Para publicar um pacote com dotnet

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

Para publicar um pacote com nuget

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