Najlepsze rozwiązania dotyczące usługi Azure Artifacts

Usługi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts zapewnia zespołom jedno miejsce do publikowania, przechowywania, udostępniania i korzystania z pakietów. W miarę wzrostu liczby źródeł, pakietów i odbiorców kilka wczesnych decyzji może sprawić, że zarządzanie pakietami będzie albo łatwe, albo trudniejsze w utrzymaniu. Ten artykuł przedstawia praktyki, które pomagają zachować przewidywalność procesu przywracania pakietów, udostępniać pakiety wydań z większą kontrolą oraz łatwiej zarządzać źródłami pakietów z upływem czasu.

Podstawowe wskazówki

  • Użyj jednego źródła w każdym pliku konfiguracji klienta i włącz źródła nadrzędne w danym źródle, gdy potrzebujesz również publicznych rejestrów lub dodatkowych źródeł wewnętrznych. Takie podejście upraszcza pliki konfiguracji i pomaga źródłu zapewnić bardziej przewidywalny przebieg przywracania. Aby uzyskać więcej informacji, zobacz Co to są źródła nadrzędne?

  • Traktuj widoki kanałów informacyjnych jako kanały wydania. Opublikuj nowe wersje do @local, zweryfikuj je tam, a następnie promuj wersje gotowe do szerszego użycia do @prerelease lub @release. Takie podejście ułatwia oddzielenie wersji pakietów, które są nadal oceniane z wersji, które są gotowe do udostępniania większej liczby użytkowników. Aby uzyskać więcej informacji, zobacz Co to są widoki kanału informacyjnego?

  • Konfiguruj uprawnienia kanału informacyjnego celowo. Zdecyduj, kto może publikować pakiety, kto może zapisywać pakiety z nadrzędnych źródeł i kto może korzystać z pakietów z udostępnionych widoków. Jasny podział ról pomaga chronić kanał aktualności i ograniczyć przypadkowe zmiany. Aby uzyskać więcej informacji, zobacz Role i uprawnienia w usłudze Feed.

  • Włącz zasady przechowywania przed rozpoczęciem gromadzenia starych wersji pakietów. Starsze wersje mogą szybko się gromadzić, zwłaszcza w aktywnych kanałach. Zasady przechowywania pomagają kontrolować wzrost ilości przechowywanych danych i zmniejszać nakład pracy potrzebny do utrzymania kanałów informacyjnych w sposób umożliwiający łatwe zarządzanie. Aby uzyskać więcej informacji, zobacz Automatyczne usuwanie pakietów przy użyciu zasad przechowywania.

Najlepsze rozwiązania dotyczące wydawców pakietów

Poniższe najlepsze rozwiązania pomagają zapewnić spójność, bezpieczeństwo i bezproblemowe środowisko użytkownika. Poniżej przedstawiono najważniejsze zalecenia dotyczące publikowania pakietów za pomocą usługi Azure Artifacts:

Notatka

Aby publikować pakiety w kanale, musisz być wydawcą kanału informacyjnego (współtwórcą) lub mieć wyższą rangę. Aby uzyskać więcej informacji, zobacz Role i uprawnienia kanału informacyjnego .

  • Użyj pojedynczego kanału danych dla repozytorium:

    Kanał informacyjny to konstrukcja organizacyjna, która może hostować wiele typów pakietów. Chociaż projekt może używać wielu źródeł danych, zwykle lepiej jest zachować repozytorium połączone z jednym podstawowym źródłem danych, aby zmniejszyć konflikty i uprościć zarządzanie pakietami. Jeśli potrzebujesz pakietów z dodatkowych źródeł danych lub publicznych rejestrów, użyj źródeł nadrzędnych zamiast dodawać wiele kanałów informacyjnych bezpośrednio do każdej konfiguracji klienta.

  • Automatycznie publikuj nowo utworzone pakiety:

    Automatyzacja publikacji nowych pakietów pomaga zapewnić, że najnowsze wersje są dostępne dla zespołu lub odbiorców docelowych bez ręcznej interwencji. Podczas publikowania pakietu Azure Artifacts dodaje go do @local widoku kanału informacyjnego. Zobacz Co to są widoki kanału informacyjnego?, aby uzyskać więcej informacji.

  • Włącz zasady przechowywania, aby automatycznie czyścić stare wersje pakietów:

    Z czasem stare wersje pakietów mogą się gromadzić, zajmować miejsce na dysku i utrudniać zarządzanie źródłami. Zasady przechowywania umożliwiają automatyczne usuwanie starszych wersji pakietów przy zachowaniu określonej liczby ostatnich wersji. Ten proces pomaga kontrolować przyrost zajętości pamięci i ułatwia utrzymanie kanałów. Aby uzyskać więcej informacji, zobacz Automatyczne usuwanie pakietów przy użyciu zasad przechowywania .

  • Używanie widoków kanału do wydawania pakietów:

    Widoki kanału informacyjnego umożliwiają udostępnianie podzbioru wersji pakietów użytkownikom. Na przykład możesz przenieść pakiet do @prerelease dla wczesnych użytkowników, a następnie przenieść go do @release, gdy będzie gotowy do szerszego użycia. Pakiety promowane do widoku nie podlegają zasadom przechowywania. Zobacz Co to są widoki kanału informacyjnego?, aby uzyskać więcej informacji.

  • Upewnij się, że odpowiednie uprawnienia dostępu do widoków:

    Jeśli Twoje pakiety są wykorzystywane przez zespoły zewnętrzne lub w różnych organizacjach, upewnij się, że widoki @release i @prerelease mają odpowiednie ustawienia widoczności. Aby uzyskać więcej informacji, zobacz ustawienia widoków kanału informacyjnego .

Najlepsze rozwiązania dla użytkowników pakietów

Korzystając z pakietów, należy zadbać o to, aby proces ich przywracania był przewidywalny, oraz jasno określić, skąd pakiety pochodzą.

  • Użyj jednego kanału informacyjnego w konfiguracji klienta:

    Aby ułatwić kanałowi informacyjnemu zapewnienie przywracania deterministycznego, upewnij się, że konfiguracja klienta odwołuje się tylko do jednego kanału informacyjnego z włączonymi źródłami nadrzędnymi. Takie podejście upraszcza pliki konfiguracji i zmniejsza prawdopodobieństwo wystąpienia nieoczekiwanych rezultatów rozstrzygania pakietów. Aby uzyskać więcej informacji, zobacz Co to są źródła nadrzędne?

  • Użyj źródeł nadrzędnych dla pakietów zewnętrznych:

    Jeśli używasz pakietów z zewnętrznych źródeł danych lub publicznych rejestrów, takich jak NuGet.org lub npmjs.com, użyj źródeł nadrzędnych zamiast dodawać te źródła oddzielnie do każdej konfiguracji klienta. Takie podejście zapewnia zespołowi jeden spójny sposób przywracania zarówno zależności wewnętrznych, jak i zewnętrznych za pośrednictwem tego samego źródła danych. Aby uzyskać więcej informacji, zobacz Co to są źródła nadrzędne? i Konfigurowanie nadrzędnych źródeł.

    Notatka

    Aby zapisywać pakiety ze źródeł nadrzędnych, musisz być użytkownikiem , Zarządzającym źródłami (Współpracownikiem) lub wyższej rangi. Aby uzyskać więcej informacji, zobacz Role i uprawnienia kanału informacyjnego .

  • Celowo porządkowaj źródła nadrzędne:

    Źródło danych sprawdza źródła nadrzędne sekwencyjnie i zwraca pakiet z pierwszego źródła, które go zawiera. Jeśli używasz wielu źródeł nadrzędnych, ustaw ich kolejność tak, aby źródło danych pobierało pakiety z zamierzonego źródła. Ta kolejność ma największe znaczenie w przypadku używania kombinacji publicznych rejestrów i wewnętrznych źródeł danych lub ponownego publikowania niestandardowych pakietów open source wewnętrznie. Aby uzyskać więcej informacji, zobacz artykuły Celowo ustaw kolejność źródeł nadrzędnych i Kolejność wyszukiwania.

  • Użyj widoków kanału do kontrolowania tego, co widzą odbiorcy:

    Jeśli twój zespół promuje zweryfikowane wersje pakietów za pośrednictwem widoków kanałów informacyjnych, użyj tych widoków, aby udostępniać tylko wersje pakietów przeznaczone dla danej grupy odbiorców. Można na przykład przechowywać nowo opublikowane pakiety w @local, udostępniać kompilacje w wersji zapoznawczej za pośrednictwem @prerelease oraz udostępniać zatwierdzone pakiety za pośrednictwem @release.

  • Użyj lokalizatora źródeł danych dla źródeł z innych organizacji w obrębie tej samej dzierżawy:

    Jeśli źródła znajdują się w tym samym dzierżawcy Microsoft Entra, ale nie należą do Twojej organizacji, użyj lokalizatora źródła danych. Składnia jest azure-feed://<organization>/<projectName>/<feed>@<view>.