Procedure consigliate per Azure Artifacts

servizi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts offre ai team un'unica posizione in cui pubblicare, archiviare, condividere e utilizzare pacchetti. Man mano che aumenta il numero di feed, pacchetti e consumer, alcune decisioni iniziali possono rendere la gestione dei pacchetti semplice o più difficile da gestire. Questo articolo raccoglie le procedure consigliate che aiutano a rendere prevedibile il ripristino dei pacchetti, a rilasciare i pacchetti con maggiore controllo e a gestire i feed più facilmente nel tempo.

Linee guida di base

  • Usare un feed in ogni file di configurazione client e abilitare le origini upstream in tale feed quando sono necessari registri pubblici o origini interne aggiuntive. Questo approccio mantiene i file di configurazione più semplici e consente al feed di fornire un comportamento di ripristino più prevedibile. Per altre informazioni, vedere Che cosa sono le origini upstream?

  • Considerare le visualizzazioni dei feed come canali di rilascio. Pubblicare nuove versioni in @local, convalidarle e quindi alzare di livello le versioni pronte per un uso più ampio in @prerelease o @release. Questo approccio consente di separare le versioni dei pacchetti che vengono ancora valutate dalle versioni pronte per la condivisione con più consumer. Per altre informazioni, vedere Che cosa sono le visualizzazioni feed?

  • Configura con attenzione le autorizzazioni del feed. Decidere chi può pubblicare pacchetti, chi può salvare i pacchetti da origini upstream e chi può utilizzare i pacchetti dalle visualizzazioni condivise. Confini chiari tra i ruoli aiutano a proteggere il feed e a ridurre le modifiche accidentali. Per altre informazioni, vedere Ruoli e autorizzazioni del feed.

  • Abilitare i criteri di conservazione prima che le versioni precedenti del pacchetto inizino ad accumularsi. Le versioni precedenti possono accumularsi rapidamente, soprattutto nei feed attivi. I criteri di conservazione consentono di controllare la crescita dell'archiviazione e ridurre il lavoro necessario per mantenere i feed gestibili. Per altre informazioni, vedere Eliminare automaticamente i pacchetti con i criteri di conservazione.

Procedure consigliate per gli editori di pacchetti

Le procedure consigliate seguenti consentono di garantire coerenza, sicurezza e un'esperienza utente fluida. Di seguito sono riportati alcuni consigli chiave per la pubblicazione di pacchetti con Azure Artifacts:

Nota

Per pubblicare pacchetti in un feed, è necessario essere un Editore di Feed (Collaboratore) o superiore. Per altri dettagli, vedere Ruoli e autorizzazioni del feed .

  • Usare un singolo feed per ogni repository:

    Un feed è un costrutto aziendale che può ospitare più tipi di pacchetto. Anche se un progetto può usare più feed, in genere è preferibile mantenere un repository connesso a un feed primario per ridurre i conflitti e semplificare la gestione dei pacchetti. Se hai bisogno di pacchetti da feed aggiuntivi o registri pubblici, usa le origini upstream invece di aggiungere più feed direttamente a ogni configurazione del client.

  • Pubblicare automaticamente i pacchetti appena creati:

    L'automazione della pubblicazione di nuovi pacchetti consente di garantire che le versioni più recenti siano disponibili per il team o i consumer di destinazione senza intervento manuale. Quando si pubblica un pacchetto, Azure Artifacts lo aggiunge alla @local visualizzazione del feed. Consulta Che cosa sono le visualizzazioni feed? per altri dettagli.

  • Abilitare i criteri di conservazione per pulire automaticamente le versioni precedenti dei pacchetti:

    Nel corso del tempo, le versioni precedenti dei pacchetti possono accumularsi, utilizzare lo spazio di archiviazione e rendere i feed più difficili da gestire. I criteri di conservazione consentono di rimuovere automaticamente le versioni precedenti dei pacchetti mantenendo al tempo stesso un numero specificato di versioni recenti. Questo processo consente di controllare la crescita dell'archiviazione e mantenere i feed più facili da gestire. Per altri dettagli, vedere Eliminare automaticamente i pacchetti con i criteri di conservazione .

  • Usare le visualizzazioni dei feed per rilasciare i pacchetti:

    Le viste del feed consentono di condividere con gli utenti un sottoinsieme delle versioni dei pacchetti. Ad esempio, è possibile alzare di livello un pacchetto a @prerelease per gli early adopter e quindi promuoverlo a @release quando è pronto per un uso più ampio. I pacchetti promossi in una vista sono esenti dai criteri di conservazione. Consulta Che cosa sono le visualizzazioni feed? per altri dettagli.

  • Verificare le autorizzazioni di accesso appropriate per le visualizzazioni:

    Se i pacchetti sono usati da team esterni o in più organizzazioni, assicuratevi che le viste @release e @prerelease abbiano impostazioni di visibilità appropriate. Per ulteriori dettagli, vedere le impostazioni delle visualizzazioni del feed di in.

Procedure consigliate per i consumer di pacchetti

Quando si utilizzano i pacchetti, si mira a rendere prevedibili i ripristini e renderli chiari da dove provengono i pacchetti.

  • Usa un feed nella configurazione del client:

    Per consentire al feed di fornire un ripristino deterministico, assicurarsi che la configurazione client faccia riferimento a un solo feed con origini upstream abilitate. Questo approccio consente di semplificare i file di configurazione e di ridurre la probabilità di risultati imprevisti della risoluzione dei pacchetti. Per altre informazioni, vedere Che cosa sono le origini upstream?

  • Usare le origini upstream per i pacchetti esterni:

    Se si usano pacchetti da feed esterni o registri pubblici, ad esempio NuGet.org o npmjs.com, usare origini upstream anziché aggiungerle separatamente a ogni configurazione client. Questo approccio offre al team un modo coerente per ripristinare le dipendenze interne ed esterne tramite lo stesso feed. Per altre informazioni, vedere Che cosa sono le origini upstream? e Configurare le origini upstream.

    Nota

    Per salvare i pacchetti da origini upstream, è necessario essere un Lettore di Feed e Upstream (Collaboratore) o superiore. Per altri dettagli, vedere Ruoli e autorizzazioni del feed .

  • Ordinate deliberatamente le sorgenti upstream:

    Il feed controlla le origini upstream in sequenza e restituisce il pacchetto dalla prima origine che lo contiene. Se si utilizzano più fonti upstream, ordinarle in modo che il feed risolva i pacchetti dalla fonte desiderata. Questo ordinamento è importante soprattutto quando si usa una combinazione di registri pubblici e feed interni o quando l'organizzazione ripubblica i pacchetti open source personalizzati internamente. Per altre informazioni, vedere Ordinare intenzionalmente le origini upstream e l'ordine di ricerca.

  • Usa le viste del feed per controllare ciò che i consumer vedono:

    Se il team promuove le versioni convalidate dei pacchetti tramite visualizzazioni feed, usare tali visualizzazioni per condividere solo le versioni del pacchetto destinate a un determinato gruppo di destinatari. Ad esempio, è possibile mantenere i pacchetti appena pubblicati in @local, condividere le build di anteprima tramite @prerelease e condividere i pacchetti approvati tramite @release.

  • Usare il localizzatore di feed per le origini di più organizzazioni nello stesso tenant:

    Se le origini si trovano nello stesso tenant Microsoft Entra ma non fanno parte della propria organizzazione, utilizzare il localizzatore di feed. La sintassi è azure-feed://<organization>/<projectName>/<feed>@<view>.

Contenuto correlato

  • Last updated on