Rozšířené rozhraní API pro verzi Preview YAML a konfigurace nadřazeného zdroje pro univerzální balíčky

V tomto sprintu zavádíme nový koncový bod rozhraní API, který umožňuje načíst finalizované tělo YAML. S radostí také oznamujeme, že v této verzi přidáváme možnost konfigurovat váš upstreamový zdroj pro univerzální balíčky.

Podrobnosti najdete v seznamu funkcí níže.

Funkce

Azure Boards

• Typ systémových pracovních položek pro backlogy a panely
• Událost protokolování auditu
• Zvýšení limitu úložiště aplikací Azure Boards na GitHubu (privátní verze Preview)
• Přizpůsobení stavu pracovní položky při sloučení žádosti o přijetí změn (privátní verze Preview)

Azure Pipelines

• Oznámení týkající se imagí Pipelines
• Vylepšené načítání protokolů agenta
• Možnost připojit svazky kontejnerů jen pro čtení
• Detailní kontrola nad spuštěním/zastavením kontejneru
• Rozbalení balíčků úloh pro jednotlivé kroky
• Vylepšené zabezpečení verzí na základě omezení rozsahu přístupových tokenů
• Vylepšení rozhraní API pro YAML ve verzi Preview

Azure Artifacts

• Konfigurace upstreamových zdrojů pro univerzální balíčky
• Dostupnost rozhraní REST API pro aktualizaci verze balíčků pro balíčky Mavenu

Azure Boards

Typ systémových pracovních položek pro backlogy a panely

Spustili jsme privátní verzi Preview funkce, která umožňuje přidat typ systémové pracovní položky do zvolené úrovně backlogu. V minulosti byly tyto typy pracovních položek k dispozici pouze z dotazů.

Zpracovat	Typ pracovní položky
Agilita	Problém
Scrum	Překážka
CMMI	Žádost o změnu
	Problém
	Přehled
	Riziko

S radostí oznamujeme, že tato funkce je teď mimo verzi Preview a obecně dostupná pro všechny organizace. Přidání typu systémové pracovní položky na úroveň backlogu je jednoduché. Stačí přejít do vlastního procesu a kliknout na kartu Úrovně backlogu. Vyberte požadovanou úroveň backlogu (příklad: Backlog požadavků) a zvolte možnost upravit. Pak přidejte typ pracovní položky.

Událost protokolování auditu

Do protokolů auditu jsme přidali novou událost, která zákazníkům pomůže lépe sledovat změny související s procesy. Událost se zaprotokoluje při každé změně hodnot v rozevíracím seznamu. Změny polí rozevíracího seznamu jsou obvykle nejběžnějšími změnami provedenými v procesu. Díky této nové události můžou správci organizace lépe sledovat, kdy a kdo v těchto polích provedl změny.

Zvýšení limitu úložiště aplikací Azure Boards na GitHubu (privátní verze Preview)

Pokud používáte aplikaci Azure Boards z marketplace GitHubu, existuje limit 100 úložišť GitHub, ke kterému se můžete připojit.  Stává se to blokátorem pro velké organizace, které můžou mít více než 100 úložišť. V tomto sprintu jsme změnili způsob, jakým se Azure Boards připojuje k úložišti GitHub, aby podporovalo více než 100. Pokud aktuálně dosáhnete limitu 100 úložiště, dejte nám vědět a můžeme funkci povolit, aby tento limit zvýšil a odblokuje vás. Pošlete nám prosím e-mail přímo s názvem vaší organizace (dev.azure.com/{organization}).

Přizpůsobení stavu pracovní položky při sloučení žádosti o přijetí změn (privátní verze Preview)

Ne všechny pracovní postupy jsou stejné. Někteří zákazníci chtějí po dokončení žádosti o přijetí změn zavřít související pracovní položky. Ostatní chtějí nastavit pracovní položky do jiného stavu, aby se před zavřením ověřily. Měli bychom povolit obojí.

Počínaje sprintem 174 máme novou funkci, která umožňuje nastavit pracovní položky do požadovaného stavu při sloučení a dokončení žádosti o přijetí změn. Provedeme to tak, že zkontrolujeme popis žádosti o přijetí změn a vyhledáme hodnotu stavu následovanou #mention pracovních položek. V tomto příkladu nastavujeme dva uživatelské scénáře na Vyřešeno a zavíráme dva úkoly.

Tato funkce už dlouho přichází a jsme rádi, že uvidíte, co si myslíte. Abychom mohli začít, pouze kontrolujeme popis žádosti o přijetí změn a nezahrnuje žádné změny uživatelského rozhraní. Před dalšími investicemi jsme chtěli získat vaši zpětnou vazbu.

Pokud se chcete zúčastnit privátní verze Preview , pošlete nám e-mail přímo. Nezapomeňte zahrnout vaši organizaci (dev.azure.com/{organization}).

Azure Pipelines

Oznámení týkající se imagí Pipelines

Poznámka:

Image Azure Pipelines se průběžně aktualizují, aby uživatelům poskytovaly co nejlepší prostředí. Tyto rutinní aktualizace jsou převážně zaměřeny na řešení chyb nebo zastaralého softwaru. Často to nebude mít žádný vliv na vaše kanály, ale to není vždy případ. Váš kanál může mít vliv, pokud přebírá závislost na kusu softwaru, který byl na imagi odebrán nebo aktualizován.

Další informace o nadcházejících aktualizacích imagí windows, Linuxu a macOS najdete v následujících oznámeních:

• Okno 2016
• Windows 2019
• Ubuntu 16.04
• Ubuntu 18.04
• Ubuntu 20.04
• macOS 10.15

Pokud chcete zobrazit poznámky k verzi pro nadcházející (předběžnou verzi) a nasazené změny, přihlaste se k odběru následujících poznámek k verzi:

• Zpráva k vydání verze

Vylepšené načítání protokolů agenta

Když agent přestane komunikovat se serverem Azure Pipelines, úloha, která byla spuštěná, se zruší. Pokud jste se dívali na protokoly konzoly streamování, možná jste získali nějaké povědomí o tom, co agent byl v pořádku, než přestal reagovat. Pokud jste ale ne, nebo pokud jste stránku aktualizovali, byly tyto protokoly konzoly pryč. Pokud v této verzi agent přestane reagovat, než odešle úplné protokoly, ponecháme protokoly konzoly jako další nejlepší věc. Protokoly konzoly jsou omezené na 1 000 znaků na řádek a můžou být někdy neúplné, ale jsou mnohem užitečnější než zobrazení nic! Zkoumání těchto protokolů vám může pomoct při řešení potíží s vlastními kanály a určitě pomůže našim technikům podpory při řešení potíží.

Možnost připojit svazky kontejnerů jen pro čtení

Při spuštění úlohy kontejneru ve službě Azure Pipelines se jako svazky mapuje několik svazků obsahujících pracovní prostor, úlohy a další materiály. Tyto svazky mají výchozí přístup pro čtení a zápis. Pokud chcete zvýšit zabezpečení, můžete svazky připojit jen pro čtení změnou specifikace kontejneru v YAML. Každý klíč v části mountReadOnly lze nastavit jen true pro čtení (výchozí hodnota je false).

resources:
  containers:
    - container: example
      image: ubuntu:18.04
      mountReadOnly:
        externals: true
        tasks: true
        tools: true
        work: false

Detailní kontrola nad spuštěním/zastavením kontejneru

Obecně doporučujeme, abyste službě Azure Pipelines umožnili spravovat životní cyklus kontejnerů úloh a služeb. V některých neobvyklých scénářích ale můžete chtít spustit a zastavit je sami. V této verzi jsme tuto funkci vytvořili do úlohy Dockeru.

Tady je ukázkový kanál s využitím nové funkce:

resources:
  containers:
    - container: builder
      image: ubuntu:18.04
steps:
  - script: echo "I can run inside the container (it starts by default)"
    target:
      container: builder
  - task: Docker@2
    inputs:
      command: stop
      container: builder
# if any step tried to run in the container here, it would fail

Zahrneme také seznam kontejnerů do proměnné Agent.ContainerMappingkanálu . Můžete ho použít, pokud chcete například zkontrolovat seznam kontejnerů ve skriptu. Obsahuje řetězecifikovaný objekt JSON, který mapuje název prostředku (tvůrce z výše uvedeného příkladu) na ID kontejneru, které agent spravuje.

Rozbalení balíčků úloh pro jednotlivé kroky

Když agent spustí úlohu, nejprve stáhne všechny sady úloh vyžadované kroky úlohy. Za normálních okolností pro výkon rozbalí úkoly jednou za každou úlohu, i když je úkol použit v několika krocích. Pokud máte obavy o nedůvěryhodný kód, který mění rozbalený obsah, můžete trochu odměnit výkon tím, že agent rozbalí úlohu při každém použití. Pokud chcete tento režim povolit, předejte --alwaysextracttask při konfiguraci agenta.

Vylepšené zabezpečení verzí na základě omezení rozsahu přístupových tokenů

Na základě naší iniciativy pro vylepšení nastavení zabezpečení pro Azure Pipelines teď podporujeme omezení rozsahu přístupových tokenů pro vydané verze.

Každá úloha spuštěná ve verzích získá přístupový token. Přístupový token používají úlohy a vaše skripty k volání zpět do Azure DevOps. Pomocí přístupového tokenu například získáme zdrojový kód, stáhneme artefakty, nahrajeme protokoly, výsledky testů nebo provedeme volání REST do Azure DevOps. Pro každou úlohu se vygeneruje nový přístupový token a po dokončení úlohy vyprší jeho platnost.

S touto aktualizací vycházíme z vylepšení zabezpečení kanálu omezením rozsahu přístupových tokenů a rozšířením stejného rozsahu na klasické verze.

Tato funkce bude ve výchozím nastavení zapnutá pro nové projekty a organizace. Pro stávající organizace ho musíte povolit v Nastavení Kanálů > organizace Nastavení>. > Omezte rozsah autorizace úlohy na aktuální projekt pro kanály verze. Další informace najdete zde.

Vylepšení rozhraní API pro YAML ve verzi Preview

Před několika sprinty jsme představili možnost zobrazit náhled kompletního YAML kanálu bez jeho spuštění. V této aktualizaci jsme vytvořili vyhrazenou novou adresu URL pro funkci preview. Teď můžete POST načíst https://dev.azure.com/{org}/{project}/_apis/pipelines/{pipelineId}/preview finalizované tělo YAML. Toto nové rozhraní API přebírá stejné parametry jako řazení do fronty spuštění, ale už nevyžaduje oprávnění Sestavení fronty.

Azure Artifacts

Konfigurace upstreamových zdrojů pro univerzální balíčky

Teď můžete nakonfigurovat informační kanály Azure Artifacts tak, aby automaticky stahovali univerzální balíčky z upstreamových zdrojů na vyžádání.

Dříve jste ve svém informačním kanálu mohli nakonfigurovat upstreamové zdroje pro balíčky NuGet, Python, Maven a npm, ale ne pro univerzální balíčky. Důvodem byl rozdíl v technologii úložiště používané pro univerzální balíčky, které podporují mnohem větší balíčky než jiné podporované typy balíčků.

Nyní můžete nakonfigurovat upstreamové zdroje pro univerzální balíčky stejným způsobem jako pro ostatní typy balíčků; otevřete nastavení informačního kanálu, klikněte na Upstreamové zdroje ->Přidat nadřazený zdroj –> a zvolte typ zdroje, který je pro vás správný. Univerzální balíčky (UPack) se zobrazí jako nová možnost v dalším zobrazení (viz obrázek níže). Další informace najdete v dokumentaci ke konfiguraci upstreamových zdrojů.

Všimněte si, že univerzální balíčky v upstreamových zdrojích jsou podporovány pouze mezi informačními kanály ve stejné organizaci DevOps.

Dostupnost rozhraní REST API pro aktualizaci verze balíčků pro balíčky Mavenu

K aktualizaci verzí balíčků Maven teď můžete použít rozhraní REST API aktualizace balíčku Azure Artifacts. Dříve můžete pomocí rozhraní REST API aktualizovat verze balíčků pro NuGet, Maven, npm a univerzální balíčky, ale ne balíčky Maven.

Chcete-li aktualizovat balíčky Maven, použijte příkaz HTTP PATCH následujícím způsobem.

PATCH https://pkgs.dev.azure.com/{organization}/{project?}/\_apis/packaging/feeds/{feedId}/maven/groups/{groupId}/artifacts/{artifactId}/versions/{packageVersion}?api-version=5.1-preview.1

Můžete nastavit následující:

Parametry identifikátoru URI

Název	In	Povinní účastníci	Typ	Popis
artifactId	path	TRUE	string	ID artefaktu balíčku
feed	path	TRUE	string	Název nebo ID informačního kanálu
groupId	path	TRUE	string	ID skupiny balíčku
organization	path	TRUE	string	Název organizace Azure DevOps
version	path	TRUE	string	Verze balíčku
projekt	path		string	ID projektu nebo název projektu
verze-api	query	TRUE	string	Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na 5.1-preview.1.

Text požadavku

Název	Typ	Popis
zobrazení	JsonPatchOperation	Zobrazení, do kterého se přidá verze balíčku

Další informace najdete v dokumentaci k rozhraní REST API při aktualizaci.

Další kroky

Poznámka:

Tyto funkce se budou zavádět během následujících dvou až tří týdnů.

Přejděte na Azure DevOps a podívejte se na ně.

Přechod na Azure DevOps

Jak poskytnout zpětnou vazbu

Rádi bychom slyšeli, co si o těchto funkcích myslíte. Pomocí nabídky nápovědy můžete nahlásit problém nebo poskytnout návrh.

Můžete také získat rady a své otázky zodpovězené komunitou ve službě Stack Overflow.

Díky,

Aaron Hallberg