Aktivace vydání verze ze sestavení

Vytvoření vydané verze automaticky při vytvoření aplikace pomocí Team Foundation Build.Můžete určit, kterou fází má proces vydání verze začít.Chcete-li aktivovat vydání verze ze sestavení, je třeba nakonfigurovat proces sestavení a cestu k vydané verzi.

Pokud jste dosud nevytvořili cestu k vydané verzi, proveďte to zde.

Jestliže jste zatím nenastavili ani systém sestavení, proveďte to nyní.

Konfigurace procesu sestavení

1. Pokud nemáte oprávnění k úpravám definic sestavení, požádejte o ně.

2. Z Průzkumníka týmových projektů sady Visual Studio se připojte k týmovému projektu, na kterém chcete pracovat (klávesnice: Ctrl+0, C).

3. Na stránce Sestavení (klávesnice: Ctrl+0, B) vytvořte nebo upravte definici sestavení.

4. Na kartě zpracování definici sestavení zvolte konfiguraci, kterou chcete použít pro tuto verzi (například: ladění a vydání).Nastavte verze sestavení k True.Vyberte konkrétní fáze, kterou chcete aktivovat pro verzi nebo ponechejte toto pole prázdné, pokud chcete začít s první fázi.

   

   Pokud se část Vydaná verze nezobrazí, postupujte takto:

   • D: Používám výchozí šablonu. Kterou šablonu procesu sestavení mám použít v nástroji Release Management a jak ji přidám k TFS?

   • D: Používám inovační šablonu. Kterou šablonu procesu sestavení mám použít v nástroji Release Management?

   • Q: Používám vlastní šablonu procesu sestavení. Jak přidám logiku pracovního postupu, aby se aktivovalo vydání verze?

   Pokud s konfiguračními soubory používáte součásti, které v závislosti na cílovém prostředí vyžadují různé hodnoty, můžete konfigurační soubor tokenizovat.

5. Zadejte případná další nastavení, která proces sestavení vyžaduje, a poté definici sestavení uložte.

Konfigurace šablony vydané verze

1. Pokud jste dosud nenainstalovali na server sestavení klienta Release Management Client for Visual Studio 2013 proveďte to nyní.Nakonfigurujte klienta Release Management tak, aby se připojoval k serveru Release Management.

   Jakmile nainstalujete klienta na server sestavení, restartujte služby sestavení.Můžete to provést z Konzole pro správu serveru Team Foundation Server.

2. V šabloně vydané verze zvolte definici sestavení, u které jste nastavili aktivaci sestavení, a zaškrtněte políčko, jímž povolíte, aby proces sestavení aktivoval vydání verze.

   

   Jestliže se výběr nástroje Definice sestavení nezobrazí, je třeba přidat do klienta Release Management připojení k TFS.(Připojení přidáte v části Správa na kartě Spravovat TFS.)

   Po aktivaci pokračuje vydání verze dalšími kroky podle fáze, která byla vybrána.Jestliže pro tuto fázi nenastavíte kroky Přijetí a Nasazení na Automatizováno, vydání verze nebude zahájeno.Tyto kroky je třeba v cestě k vydané verzi označit jako automatické.

Dotazy a odpovědi

D: Používám výchozí šablonu.Kterou šablonu procesu sestavení mám použít v nástroji Release Management a jak ji přidám k TFS?

O: Pokud používáte výchozí šablonu, stačí jen nahradit ji odpovídající šablonou procesu vydání verze.

1. Pokud nemáte oprávnění k tomu, abyste mohli přispívat soubory nebo upravovat definice sestavení, požádejte o ně.

2. Z Průzkumníka týmových projektů sady Visual Studio se připojte k týmovému projektu, na kterém chcete pracovat (klávesnice: Ctrl+0, C).

3. Ve složce Jednotka:\Program Files (x86)\ Microsoft Visual Studio 12.0\ReleaseManagement\bin vyhledejte požadovanou šablonu.Šablonu můžete do tohoto adresáře také stáhnout ze souboru ZIP, který je připojen k tomuto příspěvku blogu.

   • TFS 2013

     • TFVC: ReleaseTfvcTemplate.12.xaml.

     • Git: ReleaseGitTemplate.12.xaml

   • TFS 2012: ReleaseDefaultTemplate.11.1.xaml

   • TFS 2010: ReleaseDefaultTemplate.xaml

4. Přidejte šablonu do správy verzí.Šablonu je vhodné umístit do složky BuildProcessTemplates daného týmového projektu.

   • TFVC: přidejte soubory do serveru

   • Git: Správa souborů ve vývojářském počítači

5. Na stránce Sestavení (klávesnice: Ctrl+0, B) vytvořte nebo upravte definici sestavení.

6. Na kartě Proces zvolte možnost Nová a vyberte šablonu, která se má použít pro soubor procesu sestavení.(Měla by se zobrazit možnost vybrat procházením šablonu, kterou jste právě přidali.)

Q: Používám vlastní šablonu procesu sestavení.Jak přidám logiku pracovního postupu, aby se aktivovalo vydání verze?

O: Do vlastní šablony procesu sestavení přidejte části, které zajistí logiku pracovního postupu.Soubor fragmentů s těmito částmi si můžete stáhnout zde.Pomocí fragmentů kódu přidejte do šablony procesu sestavení následující argumenty: ConfigurationsToRelease, ReleaseBuild, ReleaseTargetStage, DropBuild.

Šablonu procesu sestavení uložte.Pokud používáte správu verzí Team Foundation, vraťte do ní šablonu se změnami.Pokud používáte úložiště Git, šablonu procesu sestavení potvrďte a vložte do projektu.

D: Používám inovační šablonu.Kterou šablonu procesu sestavení mám použít v nástroji Release Management?

O: Potřebný postup naleznete zde.

D: Mohu součásti své aplikace nasadit do jiných počítačů?

O:: Ano, vytvořte součásti pomocí klienta Release Management a přidejte je do šablony vydané verze.

Poté lze součásti přidat k sestavení.

Jakmile se zobrazí okno Součásti, dvakrát klikněte na součást, kterou chcete přidat.

U každé součásti, kterou chcete přidat, je třeba nastavit volbu Sestavováno s aplikací nebo Sestavováno externě.

Znak '\' v poli Odkládací adresář sestavení určuje, že sestavení je umístěno v kořenovém adresáři odkládací složky.

D: Jaké nástroje lze použít k nasazení součásti?

O: Pro každou definovanou součást můžete vybrat požadovaný nástroj na kartě Nasazení.Podrobnější informace o jednotlivých nástrojích naleznete zde.

Argumenty nahraďte konkrétními informacemi pro nasazení této součásti.

Chcete-li použít vlastní nástroj, nejprve ho přidejte na stránce inventáře a potom ho vyberte na kartě Nasazení.

Ověřte, že všechny soubory, na které váš příkaz odkazuje, budou v okamžiku nasazení k dispozici v umístění balíčku.

D: Proč nebylo zahájeno vydání verze?

Mohlo dojít k některému z následujících problémů:

• Nakonfigurovali jste sestavení pro aktivaci vydání verze (Sestavení pro vydání = True) a nezaškrtli jste v šabloně vydané verze políčko Může aktivovat vydání verze ze sestavení?.Toto nastavení vede k selhání sestavení, takže se vydání verze nezahájí.

• Nastavili jste, že šablona vydané verze má použít definici sestavení, u které není nastavena aktivace vydání verze (Sestavení pro vydání = False) nebo která neobsahuje správnou logiku vydání.

• Šablona vydané verze obsahuje nějakou součást, která je nakonfigurována pro nezávislé sestavení.

• Jestliže pro fázi, která se má z vydané verze aktivovat, nenastavíte kroky Přijetí a Nasazení na Automatizováno, vydání verze nebude zahájeno.Tyto kroky je pro tuto cestu k vydané verzi třeba nastavit jako automatické.

• Nenainstalovali jste v počítači se serverem Team Foundation Build klienta Release Management.

• Čas potřebný k dokončení nasazení je delší než 10 minut.Hodnotu přiřazenou v poli Časový limit nasazení aktivovaný serverem TFS můžete změnit na stránce Nastavení na kartě Správa.

D: Jak mám zacházet s konfiguračními soubory, které vyžadují různé hodnoty podle cílového prostředí?

O: Použijte tokenizované konfigurační soubory.

Pro každý konfigurační soubor v řešení, který vyžaduje v různých prostředích různé hodnoty, vytvořte jeho tokenizovanou verzi.

Pokud řešení například obsahuje soubor s označením web.config, vytvořte jeho kopii a označte ji web.config.token.Soubor web.config se tak nezmění a použije se při místním spouštění aplikace.Soubor web.config.token pak namísto skutečných hodnot obsahuje tokeny.

Pokud soubor web.config obsahuje například následující řádek:

<add key="SMTPHostServer" value="mysmtp.myserver.domain"/>

bude soubor web.config.token obsahovat následující řádek, kde SMTPHostServer je token:

<add key="SMTPHostServer" value="SMTPHostServer"/>

Udržujte synchronizaci místních a tokenizovaných souborů.

D: Jak lze určit, které soubory se mají projít a nahradit v nich tokeny proměnnými?

O: U každé definované součásti můžete na kartě Proměnné konfigurace zadat filtr přípon souborů.

Agent nasazení zadaný pro danou součást pak pomocí porovnávání vzorů zkontroluje sadu souborů, kde je třeba nahradit tokeny proměnnými.Více přípon souborů oddělte středníky (;).