Sdílet prostřednictvím


Sestavení úložišť TFVC

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

Důležité

TFVC je podporován pouze klasickými kanály a nepodporuje YAML.

Zvolte úložiště, které chcete sestavit.

Při úpravách kanálu, který používá úložiště TFVC, máte následující možnosti.

  • Clean
  • Zadání místní cesty
  • Zdroje popisků

Název úložiště

Název úložiště TFVC.

Mapování (pracovní prostor)

Zahrňte do hodnoty typu Mapování pouze složky, které kanál buildu vyžaduje. Pokud podsložka mapované složky obsahuje soubory, které kanál buildu nevyžaduje, namapujte ji na hodnotu typu Cloak.

Ujistěte se, že mapujete všechny složky obsahující soubory, které kanál buildu vyžaduje. Pokud například přidáte další projekt, budete možná muset do pracovního prostoru přidat další mapování.

Nezakrývejte složky, které nepotřebujete. Ve výchozím nastavení se v pracovním prostoru mapuje kořenová složka projektu. Tato konfigurace vede k tomu, že agent sestavení stáhne všechny soubory ve složce správy verzí projektu. Pokud tato složka obsahuje velké množství dat, může vaše sestavení ztratit systémové prostředky sestavení a zpomalit kanál buildu stažením velkých objemů dat, která nevyžadují.

Při odebírání projektů vyhledejte mapování, která můžete z pracovního prostoru odebrat.

Pokud se jedná o sestavení CI, ve většině případů byste měli zajistit, aby tato mapování odpovídala nastavení filtru triggeru CI na kartě Aktivační události.

Další informace o tom, jak optimalizovat pracovní prostor TFVC, najdete v tématu Optimalizace pracovního prostoru.

Vyčištění místního úložiště v agentu

Před spuštěním sestavení můžete provádět různé formy čištění pracovního adresáře agenta v místním prostředí.

Obecně platí, že pokud chcete dosáhnout rychlejšího výkonu agentů v místním prostředí, nevyčistíte úložiště. Pokud chcete dosáhnout nejlepšího výkonu, ujistěte se, že vytváříte také přírůstkově tím, že zakážete jakoukoli možnost vyčistit úlohu nebo nástroj, který používáte k sestavení.

Pokud potřebujete vyčistit úložiště (například předejít problémům způsobeným zbytkovými soubory z předchozího buildu), máte níže uvedené možnosti.

Poznámka:

Čištění není relevantní, pokud používáte agenta hostovaného Microsoftem, protože pokaždé získáte nového agenta.

Pokud chcete úložiště vyčistit, vyberte true a pak vyberte jednu z následujících možností:

  • Zdroje: Kanál buildu provede vrácení změn zpět a boduje aktuální pracovní prostor v části $(Build.SourcesDirectory).

  • Zdroje a výstupní adresář: Stejná operace jako výše uvedená možnost Zdroje plus: Odstraní a znovu vytvoří $(Build.BinariesDirectory).

  • Adresář zdrojů: Odstraní a znovu vytvoří $(Build.SourcesDirectory).

  • Všechny adresáře sestavení: Odstraní a znovu vytvoří $(Agent.BuildDirectory).

Triggery CI

Pokud chcete, aby se sestavení spustilo pokaždé, když někdo zkontroluje kód, vyberte Povolit kontinuální integraci na kartě Aktivační události .

Aktivační událost CI.

Dávkové změny

Toto políčko zaškrtněte, pokud máte mnoho členů týmu, kteří často nahrávají změny a chcete snížit počet spuštěných sestavení. Pokud vyberete tuto možnost, když je sestavení spuštěné, systém počká, dokud se sestavení nedokončí, a pak zařadí další sestavení všech změn, které ještě nebyly sestaveny.

Změny můžete dávkovat a sestavovat je společně.

Filtry cest

Vyberte cesty správy verzí, které chcete zahrnout a vyloučit. Ve většině případů byste měli zajistit, aby tyto filtry byly konzistentní s mapováním TFVC. Filtry cest můžete použít ke snížení sady souborů, které chcete aktivovat sestavení.

Tipy:

  • Cesty se vždy zadají vzhledem ke kořenovému adresáři pracovního prostoru.
  • Pokud nenastavíte filtry cest, kořenová složka pracovního prostoru se implicitně zahrne do výchozího nastavení.
  • Pokud cestu vyloučíte, nemůžete ji zahrnout ani v případě, že ji opravíte k hlubší složce. Pokud například vyloučíte /tools , můžete zahrnout /tools/trigger-runs-on-these
  • Pořadífiltrůch

Vrácení se změnami

S využitím ověřovaného vrácení se změnami se můžete chránit před změnami způsobujícími chyby.

Ve výchozím nastavení je vybraná možnost Používat mapování pracovních prostorů pro filtry. Sestavení se aktivuje při každém vrácení se změnami v cestě zadané v mapování zdroje.

V opačném případě můžete zaškrtnutí tohoto políčka zrušit a zadat cesty v triggeru.

Jak to ovlivňuje vaše vývojáře

Když se vývojáři pokusí o vrácení se změnami, zobrazí se jim výzva k sestavení změn.

Výzva k vrácení se změnami

Systém pak vytvoří sadu odložených odložených klíčů a sestaví ji.

Poznámka:

Pokud se zobrazí například chyba The shelveset _Build_95;Build\6bc8a077-3f27-4936-82e6-415fbd53ba07 could not be found for check-in, zkontrolujte obor autorizace úlohy limitu na aktuální nastavení kanálů bez verze a ujistěte se, že není povolený.

Podrobnosti o vrátném prostředí vrácení se změnami najdete v tématu Vrácení se změnami do složky, která je řízena vrátným kanálem buildu vrácení se změnami.

Možnost spuštění sestavení CI

Ve výchozím nastavení se sestavení CI nespustí po dokončení vrátných vrácení se změnami a změny se změnami se změnami.

Pokud ale chcete, aby se buildy CI spouštěly po vráteném vrácení se změnami, zaškrtněte políčko Spustit triggery CI pro potvrzené změny. Když to uděláte, kanál buildu nepřidá do popisu sady změn ***NO_CI* . V důsledku toho se spustí sestavení CI ovlivněná vrácením se změnami.

Několik dalších věcí, které je potřeba vědět

  • Ujistěte se, že do mapování pracovních prostorů jsou zahrnuté také složky, které do triggeru zahrnete.
  • Hradené buildy můžete spouštět buď na agentu hostovaném Microsoftem, nebo na agentu v místním prostředí.

Často kladené dotazy

Při spuštění kanálu se zobrazí následující chyba:

The shelveset <xyz> could not be found for check-in

  • Je obor autorizace úlohy nastavený na kolekci? Úložiště TFVC se obvykle šíří mezi projekty ve vaší kolekci. Možná čtete nebo zapisujete do složky, ke které se dostanete jenom v případech, kdy je oborem celá kolekce. Můžete to nastavit v nastavení organizace nebo v nastavení projektu na kartě Kanály .

Při spuštění kanálu se zobrazí následující chyba:

The underlying connection was closed: An unexpected error occurred on a receive. ##[error]Exit code 100 returned from process: file name 'tf', arguments 'vc workspace /new /location:local /permission:Public

  • Obvykle se jedná o občasnou chybu způsobenou technickými problémy služby. Znovu spusťte kanál.

Co je bodné?

Bodovací nástroj je power tool TFVC, který zajišťuje správu zdrojového kódu na serveru a místní disk je shodný. Viz Microsoft Visual Studio Team Foundation Server 2015 Power Tools.