< Předchozí | Další >

8. lekce: Týmová sestavení Jazz Team Build

Tento oddíl se zabývá uživatelským rozhraním produktu Jazz Team Build z perspektivy vývojáře, který je spotřebitelem toho, co sestavení Rational Team Concert poskytuje. Budete však muset provést jisté nastavení, které by za normálních okolností zajistil váš administrátor sestavení nebo plánovač verzí. Zajistit, aby sestavení Jazz Team Build vytvářelo to, co váš projekt vyžaduje, může zahrnovat poměrně rozsáhlé úpravy a přizpůsobení skriptů sestavení podle potřeb vašeho projektu. Sestavení Jazz Team Build naštěstí zprovoznění velmi usnadňuje, takže uvidíte, jak pracuje, jako kdyby pracoval pro váš tým.
Sestavení Jazz Team Build je základní součástí produktu Rational Team Concert. Sám o sobě nesestavuje nic, ale poskytuje infrastrukturu pro načtení práce vašeho týmu z úložiště produktu Rational Team Concert, zpřístupnění vašich skriptů sestavení a doručení výsledků zpět produktu Rational Team Concert. Vy, jako uživatel produktu Rational Team Concert a odběratel sestavení, můžete monitorovat spuštěná sestavení a mít přístup k výsledkům. Od počátku produktu Rational Team Concert bylo sestavení Jazz Team Build používáno k sestavování samotného produktu Rational Team Concert.
Jak sestavení Jazz Team Build funguje? Podívejme se na to v širším kontextu:
  1. Definovat rozvrh: Určité sestavení pracuje podle vámi definovaného rozvrhu. Vzpomeňte si, že v sekci o řízení zdrojů produktu Rational Team Concert se uvádí, že tým sdílí svou vývojářskou práci v jednom či více proudech týmu.
  2. Zkontrolovat změny: Když je čas spustit pro tým sestavení, sestavení Jazz Team Build zkontroluje, zda nedošlo k nějakým změnám v obsahu proudů týmu, a přijme tyto změny, označované jako sady změn, do svého vlastního pracovního prostoru sestavení, aby měl aktuální kopii proudů.
  3. Načíst obsah úložiště a spustit sestavení: Sestavení potom načte obsah pracovního prostoru sestavení do systému souborů, kde vaše skripty sestavení provedou sestavení.
  4. Publikovat artefakty do úložiště: Artefakty sestavení jsou publikovány do úložiště produktu Rational Team Concert, kde k nim mají přístup uživatelé.
  5. Odeslat oznámení, že je sestavení dokončeno: Stav všech sestavení je vykazován v reálném řase a na dokončení sestavení jste automaticky upozorněni.
Sestavení Jazz Team Build obsahuje sestavovací stroj Jazz Build Engine a sadu nástrojů sestavení platformy Jazz. Jejich instalace a zprovoznění jsou velmi snadné. Klient Jazz vám umožňuje provést následující úlohy:
  • Definujte skript sestavení (tady Klient Jazz Eclipse vykoná většinu práce).
  • Definujte definici sestavení, která identifikuje váš skript sestavení.
  • Definujte sestavovací stroj, který má spustit definované sestavení.
  • Spusťte sestavovací stroj, který bude odpovídat na žádosti o sestavení, spusťte sestavení a publikujte výsledky.
To vám umožní požádat o sestavení, zkontrolovat výsledky a prozkoumat uživatelské rozhraní sestavení, jako byste byli vývojářem a odběratelem toho, co sestavení Jazz Team Build vytváří.
Poznámka: Kroky nastavení jsou poněkud delší. Pokud chcete, můžete je teď pozastavit a vrátit se k nim později. Pokud se rozhodnete neprovádět nastavení sestavení, měli byste si přečíst následující sekci nazvanou Prohlídka uživatelského rozhraní sestavení Jazz Team Build. Zde se dozvíte, jak můžete požadovat sestavení a kontrolovat jejich výsledky.

Nastavení pracovního prostoru Eclipse pro člena týmu sestavení

V tomto výukovém programu je člen týmu sestavení, kterého jste vytvořili v dřívější lekci, vyhrazeným uživatelem sestavení. Nastavte a zkonfigurujte pro člena týmu sestavení nový pracovní prostor Eclipse.
Nastavení a konfigurace nového pracovního prostoru Eclipse pro člena týmu sestavení:
  1. Přepněte na nový pracovní prostor Eclipse.
  2. Vytvořte připojení úložiště.
  3. Připojte se k oblasti projektu Prelude.
Další informace viz téma 2. lekce: Připojení. Po dokončení nastavení by váš pohled Artefakty týmu měl vypadat takto:

Pracovní prostor Eclipse člena týmu sestavení

Vytvoření skriptu sestavení

Chcete-li vytvořit skript sestavení:
Ujistěte se, že máte definováno připojení úložiště a jste připojeni.
  1. V pohledu Průzkumník balíků klepněte pravým tlačítkem myši na projekt; potom klepněte na volbu Exportovat.
  2. V Průvodci exportem na stránce Výběr pod položkou Obecné vyberte položku Soubory sestavení Ant a klepněte na volbu Další.
  3. Na stránce Export zkontrolujte, zda je vybrán váš projekt a zaškrtnuta všechna políčka, a klepněte na tlačítko Dokončit.
Do vašeho projektu je přidán soubor build.xml. Tento soubor používá skriptovací jazyk Ant. Tento skript zkompiluje váš projekt a vyprodukuje soubory tříd platformy Java™. Povšimněte si, že to je identifikováno jako odchozí změna.

build.xml přidaný do souboru Průzkumník balíků

Upozornění: Ještě nedoručovat skript Ant.

Vytvoření vyhrazeného pracovního prostoru úložiště

Můžete vytvořit vyhrazený pracovní prostor úložiště, který bude využívat definice sestavení Jazz pro váš projekt. Sestavovací stroj Jazz Build Engine, který je připojen k úložišti platformy Jazz pomocí předem přiřazeného identifikátoru uživatele, během sestavení používá tento pracovní prostor úložiště k identifikaci obsahu, který má být sestaven. Nejdříve přijme veškeré příchozí změny z proudu týmu a potom načte obsah pracovního prostoru sestavení do lokálního systému souborů ke zpracování.
Vytvoření vyhrazeného pracovního prostoru úložiště sestavení:
  1. V pohledu Artefakty týmu klepněte pravým tlačítkem myši na volbu Mé pracovní prostory úložiště; potom klepněte na volbu Nový > Pracovní prostor úložiště.
  2. V průvodci Nový pracovní prostor úložiště na stránce Vybrat proud klepněte na přepínač Tok s proudem a v podokně pod ním vyberte volbu Proud týmu 1 (Tým 1).
  3. Klepněte na tlačítko Další.
  4. Na stránce Nový pracovní prostor úložiště zadejte Pracovní prostor sestavení týmu 1 jako název pracovního prostoru sestavení a klepněte na tlačítko Další.
  5. Na stránce Přístupové oprávnění pro čtení se ujistěte, že je vybrána položka Veřejné, a potom klepněte na tlačítko Další.
  6. Na stránce Komponenty k přidání potvrďte, že je vybrána komponenta proudu a zrušte zaškrtnutí pole Načíst po vytvoření pracovní prostor úložiště.
  7. Klepněte na tlačítko Dokončit. Ve vašem pohledu se zobrazí pracovní prostor úložiště sestavení.

    Pracovní prostor úložiště sestavení přidaný do pohledu Mé pracovní prostory úložiště

Vytvoření definice sestavení a sestavovacího stroje

Pro svůj projekt můžete vytvořit definici sestavení Jazz. Definice sestavení je konfigurována, aby používala nový pracovní prostor sestavení, takže když je sestavení spuštěno, může před zahájením sestavení přijmout případné změny z proudu týmu.
Chcete-li vytvořit definici sestavení:
  1. V pohledu Artefakty týmu rozbalte složku projektu.
  2. Klepněte pravým tlačítkem myši na volbu Sestavení; potom klepněte na volbu Nová definice sestavení.
  3. V Průvodci novou definicí sestavení na stránce Nová definice sestavení přijměte výchozí nastavení a klepněte na tlačítko Další.
  4. Na stránce Všeobecné informace v podokně Dostupné šablony sestavení vyberte položku Ant – Jazz Build Engine a klepněte na tlačítko Další.
  5. Na stránce Před sestavením vyberte volbu řízení zdrojů Jazz a klepněte na tlačítko Další.
  6. Na stránce Po sestavení přijměte výchozí nastavení a klepněte na tlačítko Další.
  7. Na stránce Doplňující konfigurace zkontrolujte, zda jsou vybrány všechny volby, a klepněte na volbu Dokončit. Otevře se Editor definic sestavení.
  8. Vytvořte pro definici sestavení sestavovací stroj:
    1. V podokně Podporující sestavovací stroje klepněte na volbu Vytvořit stroj.
    2. V dialogovém okně Vytvořit sestavovací stroj v poli ID stroje zadejte PreludeBuildEngine.
    3. Klepněte na tlačítko OK.
  9. Klepněte na kartu Řízení zdrojů Jazz editoru Definice sestavení.
  10. V podokně Volby stažení do pole Přenosový adresář zadejte fetched.
  11. Chcete-li určit pracovní prostor sestavení, postupujte takto:
    1. V podokně pracovní prostor sestavení klepněte na volbu Vybrat.
    2. V dialogovém okně Vybrat proud nebo pracovní prostor v podokně Odpovídající položky vyberte položku Pracovní prostor sestavení týmu 1 a klepněte na tlačítko OK.
  12. Klepněte na kartu Ant.
  13. Do pole Soubor sestavení zadejte následující cestu: fetched/název_projektu/build.xml, kde název_projektu je název projektu Java. V rámci tohoto výukového programu použijeme projekt HelloWorld (Ahoj světe).
  14. Do pole Domovský adresář Java zadejte cestu k souboru vašeho kompilátoru jazyka Java. Například C:\Program Files\IBM\TeamConcert\jdk.
  15. Klepněte na tlačítko Uložit.
Nastavení je dokončeno! Pokud se podíváte do pohledu Artefakty týmu, uvidíte, že je tam uvedena definice sestavení a sestavovací stroj.

Definice sestavení a sestavovací stroj v pohledu Artefakty týmu

Doručení skriptu sestavení

Než spustíte sestavovací stroj pro spuštění našich sestavení, vzpomeňte si, že do proudu nebyl doručen skript sestavení (build.xml) z vašeho projektu Hello Prelude. Bez něj sestavovací stroj Jazz Build Engine nebude mít potřebné pokyny k provedení sestavení. Pojďte tuto změnu nyní doručit.
  1. V pohledu Nevyřízené změny pod položkou Výchozí komponenta klepněte pravým tlačítkem myši na položku Nevyřešené a vyberte volbu Vrátit a dodat.

    Pohled Nevyřízené změny

  2. V Průvodci vrácením a doručením v podokně Komentáře k sadě změn zadejte komentář a klepněte na tlačítko Další.
  3. V podokně Přidružit pracovní položku vyberte existující pracovní položku a klepněte na tlačítko Dokončit.
Nyní je skript sestavení v proudu. Až bude sestavení spuštěno, bude tento skript k dispozici.

Spuštění sestavovacího stroje

Spusťte sestavovací stroj, aby byl připraven ke spuštění sestavení.
Poznámka: Když spustíte sestavovací stroj, můžete pomocí argumentu příkazového řádku -vm určit sadu JDK, kterou obsahuje Klient Jazz, abyste zajistili, že se bude používat správná sada JDK.

Chcete-li spustit sestavovací stroj:
  1. Z příkazového řádku přejděte do adresáře instalační_adresář/buildsystem/buildengine/eclipse, kde instalační_adresář je instalační adresář sady nástrojů Build System Toolkit.
  2. Zadejte jbe -vm instalační_adresář_klienta/jazz/client/eclipse/jdk/bin/java -repository URL_úložiště -userId build –pass heslo -engineId PreludeBuildEngine. Kde:
    • instalační_adresář_klienta je adresář, kde je nainstalován Klient Jazz
    • URL_úložiště je adresa URL úložiště. Například http://localhost:9080/jazz/.
    • Heslo je heslo uživatele pro sestavení.
    V tomto výukovém programu je identifikátorem uživatele build a identifikátorem sestavovacího stroje PreludeBuildEngine.
Stroj se spustí a na konzole vypadá asi takto (mohou se zobrazit i jiné zprávy):
2009-06-11 16:08:47 Running build loop...
2009-06-11 16:08:47 Waiting for request...

Hodnota -sleepTime 1 (sekunda) zajistí, že budou žádosti o sestavení zpracovány okamžitě.

Sestavovací stroj čeká na práci. Je čas spustit sestavení.

Prohlídka uživatelského rozhraní sestavení Jazz Team Build

Informace o úlohách sestavení, které lze provádět se sestavením Jazz Team Build.

Klient Jazz vám umožňuje provádět následující úlohy sestavení:

Podívejme se teď na jednotlivé úlohy.

Požádání o sestavení

O sestavení můžete požádat z pohledu Artefakty týmu. Také můžete změnit vlastnosti sestavení nebo požádat o osobní sestavení, které se neodrazí na stavu definice sestavení a které se spustí ve vámi určeném pracovním prostoru.
Žádost o sestavení:
  1. V pohledu Artefakty týmu rozbalte složku projektu.
  2. Rozbalte složku Sestavení a vyhledejte název sestavení v seznamu.
  3. Klepněte pravým tlačítkem myši na položku Sestavení týmu 1 a vyberte volbu Požádat o sestavení.
    1. Volitelné: Chcete-li požádat o osobní sestavení, které nemá vliv na stav definice sestavení a které se spustí ve vámi zadaném pracovním prostoru úložiště, v podokně Volby sestavení vyberte volbu Osobní sestavení. V případě potřeby aktualizujte pole Pracovní prostor úložiště a Pravidla zavedení komponent.
  4. V dialogovém okně Požádat o sestavení klepněte na tlačítko Odeslat.
Sestavovací stroj zpracuje žádost o sestavení. Tento proces můžete pozorovat v příkazovém okně, kde jste spustili sestavovací stroj.

Pokud sestavení neproběhlo správně, prozkoumejte soubor protokolu publikovaný ve výsledku sestavení.

Zobrazení výsledků sestavení

Otevřeme výsledek sestavení a uvidíme, co se stalo.
Editor výsledků sestavení obsahuje karty Přehled, Protokoly a Vlastnosti. V závislosti na tom, čím do výsledku sestavení přispívá skript sestavení, si můžete zobrazit další karty. Pokud například skript sestavení přispívá výsledky kompilace a soubory ke stažení, editor výsledků sestavení bude obsahovat karty Kompilace a Ke stažení.

Dokončili jste tyto úlohy:

  1. Odeslali jste žádost o sestavení. Mohla být iniciována automaticky podle předdefinovaného rozvrhu.
  2. Sestavovací stroj Jazz Build Engine žádost přijal spolu s definicí sestavení.
  3. Sestavovací stroj Jazz Build Engine s použitím pracovního prostoru sestavení konfigurovaného v definici sestavení (Pracovní prostor sestavení týmu 1) provedl operaci accept (přijmout), aby aktualizoval pracovní prostor sestavení z proudu. V prvním sestavení se tím do pracovního prostoru sestavení dostal nově vytvořený skript sestavení (build.xml), který je pro spuštění sestavení nezbytný.
  4. Aktualizovaný obsah pracovního prostoru sestavení byl načten do systému souborů s použitím adresáře nazvaného fetched v definici sestavení.
  5. Je zavolán skript sestavení určený v definici sestavení. Náš skript zkompiloval projekt HelloWorld a vytvořil soubory tříd Java. Propracovanější skript mohl vytvořit soubor JAR a publikovat jej zpět na platformě Jazz.
  6. Po dokončení skriptu jsou protokol sestavení a všechny ostatní publikované výsledky uloženy v rámci úložiště Jazz.
  7. Týmu je oznámeno, že bylo sestavení dokončeno.

Editor výsledků sestavení

Několik věcí, které může editor výsledků sestavení nabídnout:

Prozkoumání protokolu sestavení

Pojďme se podívat na protokol sestavení, abychom viděli, zda náš nový skript sestavení fungoval.
  1. Přejděte na podokno Protokoly. Podívejme se, co sestavení udělalo.

    Stránka Protokoly

  2. Vyberte soubor protokolu a klepněte na volbu Otevřít. Zde uvidíte nejrelevantnější aktivity, k nimž došlo.

    Ukázkový protokol sestavení

    Nyní již sami vidíte, jak platforma Jazz vám i vašemu týmu zviditelní informace pro sestavení.

Monitorování stavu sestavení

Stav sestavení lze zjistit pasivně nebo aktivně. Pasivní informace o sestavení jsou poskytovány dvěma způsoby: v pohledu Team Central v sekci Sestavení a ve výstrahách sestavení, které se vám krátce zobrazují na obrazovce.

Když jsou sestavení dokončena, je sekce Sestavení pohledu Team Central aktualizována pomocí stavu dokončených sestavení pro týmy, jejichž jste členem.

U vybraného sestavení v tomto pohledu vidíte výsledky sestavení nebo žádost o nové sestavení.

Úprava četnosti aktualizace stavu:

Nalezení dostupných sestavení

Dostupná sestavení, stav spuštěných sestavení a sestavení čekající ve frontě na spuštění vidíte v pohledu Sestavení, který je dostupný pomocí kontextové nabídky Zobrazit výsledky sestavení ze složky Sestavení v pohledu Artefakty týmu.

Položka nabídky Zobrazit výsledky sestavení

Obsah pohledu lze řadit výběrem sloupce. Existuje celá řada zajímavých akcí v kontextové nabídce. Sestavení můžete porovnat s proudem, z něhož bylo sestaveno, nebo z nějakého sestavení vytvořit nový proud (užitečné pro vytvoření nové kódové základny z ověřené kódové základny).

Pohled Výsledky sestavení

Výsledky sestavení zobrazíte také, když ve svém webovém panelu dashboard Jazz definujete viewlet sestavení:

Výsledky sestavení webového panelu dashboard Jazz

Vývojový tým Jazz upravoval svůj proces sestavení už dlouho. Editor výsledků sestavení platformy Jazz má další karty pojmenované Kompilace, JUnit, Ke stažení a Externí odkazy. Následuje snímek obrazovky ze sestavení platformy Jazz, abyste mohli ocenit jeho potenciál.

Ukázkové upravené výsledky sestavení

Kontrolní bod lekce

V této lekci jste se seznámili se základy funkčnosti sestavení Jazz Team Build.
< Předchozí | Další >

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu