Publicera universella paket från Azure Artifacts-feeds

Azure DevOps-tjänster

Med universella paket kan du lagra många typer av filer och paketinnehåll utöver format som NuGet, npm och Python paket. Du kan publicera dem direkt från kommandoraden med hjälp av Azure CLI. Ett universellt paket kan vara upp till 4 TiB och måste innehålla ett namn och en version. Den här artikeln visar hur du publicerar ett universellt paket till din Azure Artifacts feed.

Förutsättningar

Produkt Krav
Azure DevOps – En Azure DevOps -organisation.
– Ett Azure DevOps-projekt.
– Installera Azure CLI.
– Installera Azure DevOps-tillägget version 0.14.0 eller senare.

Installera Azure DevOps-tillägget

Med Azure DevOps-tillägget för Azure CLI kan du hantera Azure DevOps tjänster från kommandoraden. Innan du installerar den kontrollerar du att du har Azure CLI version 2.10.1 eller senare installerad.

  1. Om du vill installera Azure DevOps-tillägget kör du:

    az extension add --name azure-devops
    
  2. Om du vill uppdatera en befintlig installation till den senaste versionen kör du:

    az extension update --name azure-devops
    

Skapa en feed

Innan du kan publicera ett universellt paket behöver du en feed att publicera den till. En feed är en container som lagrar och organiserar dina paket, och du kan styra vem som kan komma åt dem. Använd följande steg för att skapa ett flöde för ditt projekt eller din organisation.

  1. Logga in på din Azure DevOps-organisation och gå till projektet.

  2. Välj Artefakteroch välj sedan Skapa feed.

  3. Ange ett namn för feeden.

  4. Välj ett synlighetsalternativ för att styra vem som kan visa dina paket.

  5. Välj Inkludera paket från vanliga offentliga källor om du vill att flödet även ska hämta paket från offentliga källor som nuget.org eller npmjs.com.

  6. För Omfång väljer du om flödet endast gäller för projektet eller för hela organisationen.

  7. Välj Skapa när du är klar.

    Skärmbild som visar hur du skapar en ny feed i Azure DevOps Services.

Publicera universella paket

När du har skapat feeden är du redo att publicera ett universellt paket till det. Varje paket som du publicerar behöver ett namn och ett versionsnummer, och båda måste följa specifika namngivningsregler:

  • Paketnamnet måste skrivas med gemener, börja och sluta med en bokstav eller siffra och får endast innehålla bokstäver, siffror och bindestreck som inte följer direkt på varandra (-), understreck (_) eller punkter (.).
  • Paketversionen måste också skrivas med gemener och får inte innehålla byggmetadata, vilket indikeras av suffixet +. Mer information finns i semantisk versionshantering.
  1. Kör något av följande kommandon för att publicera ditt universella paket, beroende på om ditt flöde är begränsat till ett projekt eller till din organisation:

    • projektomfattande flöde:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      
    • feed med organisationsomfattning:

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      

Not

Om paketet innehåller ett exceptionellt stort antal filer (100 000 eller mer) kan publiceringen misslyckas. I det här fallet paketera filerna i ett ZIP- eller TAR-arkiv för att minska antalet filer.

Visa publicerade paket

När du har publicerat paketet kan du bekräfta att det är tillgängligt i feeden.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Artefakteroch välj sedan din feed från rullgardinsmenyn. Om publiceringen har slutförts bör paketet vara tillgängligt i feeden.

    Skärmbild som visar det nyligen publicerade universella paketet.