Configurando e usando o nuget ou dotnet CLI

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

Sumário

• Configurando com NuGet CodeCatalyst
• Consumindo NuGet pacotes de um CodeCatalyst repositório
• Consumindo NuGet pacotes de NuGet .org por meio de CodeCatalyst
• Publicando NuGet pacotes em CodeCatalyst

Configurando com NuGet CodeCatalyst

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

Para configurar NuGet com seu repositório de CodeCatalyst pacotes

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

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

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

4. Escolha Conectar ao repositório.

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

6. Você precisará de um token de acesso pessoal (PAT) para se NuGet autenticar CodeCatalyst. Se você já tem um, você pode usá-lo. Caso contrário, você pode criar um aqui.

   1. Escolha Criar token.

   2. Escolha Copiar para copiar seuPAT.

      Atenção

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

7. Configure nuget ou dotnet use o NuGet endpoint do seu repositório e. CodeCatalyst PAT 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.

   • Substituir username com seu nome CodeCatalyst de usuário.

   • Substituir PAT com o seu CodeCatalyst PAT.

   • Substituir space_name com o nome CodeCatalyst do seu espaço.

   • Substituir proj_name com o nome CodeCatalyst do seu projeto.

   • Substituir repo_name com o nome CodeCatalyst do repositório do seu pacote.

   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 é suportada em plataformas que não sejam Windows, você deve adicionar o --store-password-in-clear-text sinalizador ao comando a seguir. Observe que isso armazenará sua senha como texto simples em seu 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 NuGet com CodeCatalyst, você pode consumir NuGet pacotes armazenados em seu CodeCatalyst repositório ou em um de seus repositórios upstream e publicar NuGet pacotes em seu repositório. CodeCatalyst

Consumindo NuGet pacotes de um CodeCatalyst repositório

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

Para consumir uma versão de pacote de um CodeCatalyst repositório ou de um de seus repositórios upstream com nuget ou dotnet, execute o comando a seguir. Substituir packageName com o nome do pacote que você deseja consumir e packageSourceName com o nome da fonte do repositório de CodeCatalyst pacotes no arquivo de NuGet configuração, 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 obter mais informações, consulte Gerenciar pacotes usando o nuget CLI ou Instalar e gerenciar pacotes usando o dotnet na documentação CLI da Microsoft.

Consumindo NuGet pacotes de NuGet .org por meio de CodeCatalyst

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

Para consumir pacotes do NuGet domínio.org

1. Se você ainda não o fez, configure seu gerenciador de NuGet pacotes com seu repositório de CodeCatalyst pacotes seguindo as etapas emConfigurando com NuGet CodeCatalyst.

2. Certifique-se de que seu repositório tenha adicionado 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 Adicionar um repositório upstream e escolhendo o repositório da loja. NuGet

Publicando NuGet pacotes em CodeCatalyst

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

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

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