Připojení do informačních kanálů Azure Artifacts (NuGet.exe)

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Azure Artifacts umožňuje vývojářům publikovat a stahovat balíčky NuGet z různých zdrojů, včetně informačních kanálů a veřejných registrů. Privátní informační kanály Azure Artifacts můžete použít ke sdílení balíčků soukromě s týmem nebo konkrétními uživateli. Kromě toho můžete vytvářet veřejné informační kanály, aby byly balíčky veřejně přístupné, takže je můžete veřejně sdílet s kýmkoli na internetu. Tento článek vás provede připojením k informačnímu kanálu Azure Artifacts.

Požadavky

Nastavení projektu

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

  3. Vyberte Připojení k informačnímu kanálu a potom na levém panelu vyberte NuGet.exe.

  4. Pokud používáte Azure Artifacts s NuGet.exe poprvé, ujistěte se, že jste nainstalovali požadované součásti, jinak je nainstalujte výběrem možnosti Získat nástroje v pravém horním rohu.

  5. Přidejte do projektu soubor nuget.config, umístěte ho do stejné složky jako soubor csproj nebo sln a vložte do něj zadaný fragment kódu. Fragment kódu by měl být strukturovaný takto:

    • Informační kanál s oborem projektu:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • Informační kanál s oborem organizace:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

  3. Vyberte Připojení k informačnímu kanálu a pak v levém navigačním podokně vyberte NuGet.exe.

  4. Postupujte podle pokynů v části Nastavení projektu a připojte se k informačnímu kanálu.

  1. Přihlaste se k serveru Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak svůj informační kanál.

  3. Vyberte Připojení k informačnímu kanálu a pak v levém navigačním podokně vyberte NuGet.

  4. Postupujte podle pokynů pro přidání zdrojové adresy URL balíčku do souboru nuget.config .

Důležité

Zprostředkovatel přihlašovacích údajů Azure Artifacts vyžaduje NuGet 4.8.0.5385 nebo vyšší.

Pro zajištění optimálního výkonu azure Artifacts doporučuje používat verzi NuGet nebo novější, 5.5.x protože obsahuje zásadní opravy chyb souvisejících se zrušením a vypršením časových limitů.

Nastavení starší verze projektu

Pokud používáte starší verzi NuGetu, připojte se ke svému informačnímu kanálu podle následujících pokynů:

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

  2. Vyberte Artefakty a pak v rozevírací nabídce vyberte svůj informační kanál.

  3. Vyberte Připojení k informačnímu kanálu a potom na levém panelu vyberte NuGet.exe.

  4. Zkopírujte zdrojovou adresu URL a nahraďte /v3/index.json ji ./v2 Aktualizovaná zdrojová adresa URL by měla vypadat přibližně takto:

    • Informační kanál s oborem projektu:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
    • Informační kanál s oborem organizace:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
      
  5. Vytvořte osobní přístupový token a ujistěte se, že ho nastavíte na správnou organizaci, ke které chcete získat přístup, a vyberte jeden z následujících oborů: Balení (čtení), Balení (čtení a zápis) nebo Balení (čtení, zápis a správa).

  6. Spuštěním následujícího příkazu v okně příkazového řádku přidejte zdroj informačního kanálu do souboru nuget.config :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. Pokud je vaše organizace připojená k Microsoft Entra ID, musíte se nejdřív ověřit pomocí přihlašovacích údajů AD a pak pomocí příkazu setapikey přidat svůj osobní přístupový token:

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
    
    nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>