Verze PVS-Studio 7.04 se shoduje s verzí pluginu Warnings Next Generation 6.0.0 pro Jenkins. Tento plugin právě v této verzi přidal podporu pro statický analyzátor PVS-Studio. Plugin vizualizuje data o varováních kompilátoru nebo jiných analytických nástrojích v Jenkins. V tomto článku podrobně popíšeme, jak nainstalovat a nastavit tento plugin pro použití s PVS-Studio, a také popíšeme většinu jeho funkcí.
Instalace pluginu Warnings Next Generation v Jenkins
Defaultně se Jenkins nachází na adrese . Na hlavní stránce Jenkins v levém horním rohu vybereme možnost „Spravovat Jenkins“:
Dále vybereme možnost „Spravovat pluginy“, otevřeme záložku „Dostupné“:
V pravém horním rohu do pole filtru zadáme „Warnings Next Generation“:
Najdeme plugin v seznamu, zaškrtneme ho vlevo a klikneme na „Instalovat bez restartu“:
Otevře se stránka instalace pluginů. Na ní uvidíme výsledky instalace pluginu:
Vytvoření nové úlohy v Jenkins
Nyní vytvoříme úlohu s volnou konfigurací. Na hlavní stránce Jenkins vybereme „Nová položka“. Zadejme název projektu (například WTM) a vyberme „Freestyle project“.
Klikneme na „OK“, po čemž se otevře stránka nastavení úlohy. Dole na této stránce v části „Akce po sestavení“ otevřeme seznam „Přidat akci po sestavení“. V seznamu vybereme „Zaznamenat varování kompilátoru a výsledky statické analýzy“:
V rozbalovacím seznamu pole „Nástroj“ vybereme „PVS-Studio“, poté klikneme na tlačítko pro uložení. Na stránce úlohy klikneme na „Sestavit nyní“, aby se vytvořil adresář ve workspace v Jenkins pro naši úlohu:
Získání výsledků sestavení projektu
Dnes jsem na trendech Github narazil na projekt dotnetcore/WTM. Stáhl jsem ho z Githubu, nahrál do adresáře pro sestavení WTM v Jenkins a analyzoval jsem ho ve Visual Studiu pomocí analyzátoru PVS-Studio. Podrobné informace o používání PVS-Studio ve Visual Studiu jsou uvedeny v článku s názvem: .
Spustil jsem sestavení projektu v Jenkins několikrát. Výsledkem je, že vpravo nahoře na stránce úlohy WTM v Jenkins se objevil graf a vlevo se objevila položka menu PVS-Studio Warnings:
Po kliknutí na graf nebo tuto položku menu se otevře stránka s vizualizací zprávy analyzátoru PVS-Studio pluginem Warnings Next Generation:
Stránka s výsledky
Na stránce nahoře jsou umístěny dvě koláčové grafy. Vpravo od grafů je okno s grafy. Dole se nachází tabulka.
Na levém koláčovém diagramu je zobrazena proporce varování různých úrovní nebezpečí, na pravém diagramu pak proporce nových, neopravovaných a opravených varování. Jsou zde tři grafiky. Výběr zobrazovaného grafu se provádí pomocí šipek vlevo a vpravo. První dva grafy zobrazují stejné informace jako diagramy, a třetí ukazuje změnu počtu varování.
Jako body grafů můžete zvolit sestavení nebo dny.
Je také možné zúžit a rozšířit časový interval grafu, abyste viděli data za určité období:
Grafy určitých metrik můžete skrýt kliknutím na název metriky v legendě grafu:
Graf po skrytí metriky „Normal“:
Dole je tabulka, která zobrazuje data zprávy analyzátoru. Kliknutím na sektor koláčového diagramu dojde k filtrování tabulky:
V tabulce je několik záložek pro filtrování dat. V tomto příkladu je dostupné filtrování podle namespace, souboru, kategorie (název varování). V tabulce si můžete zvolit, kolik varování se má zobrazit na jednu stránku (10, 25, 50, 100):
Je možné filtrovat data podle řetězce zadaného do pole „Search“. Příklad filtrování podle slova „Base“:
Na záložce „Issues“ se při kliknutí na plusko na začátku řádku tabulky zobrazí krátký popis varování:
V krátkém popisu je odkaz na stránku s podrobnými informacemi o tomto varování.
Kliknutím na hodnoty ve sloupcích „Package“, „Category“, „Type“, „Severity“ dojde k filtrování dat tabulky podle vybrané hodnoty. Filtrování podle kategorie:
Ve sloupci „Age“ je zobrazeno, kolik sestavení přežilo toto varování. Kliknutím na hodnotu ve sloupci „Age“ se otevře stránka sestavení, ve které se toto varování poprvé objevilo.
Kliknutím na hodnotu ve sloupci „File“ se otevře zdrojový kód souboru na řádku s kódem, který vyvolal varování. Pokud soubor není přítomen ve složce sestavení nebo byl přesunut po vytvoření zprávy, otevření zdrojového kódu souboru nebude možné.
Závěr
Warnings Next Generation se ukázal jako velmi užitečný nástroj pro vizualizaci dat v Jenkins. Doufáme, že podpora PVS-Studio tímto pluginem velmi pomůže těm, kteří již používají PVS-Studio, a také přiláká pozornost k statické analýze ostatních uživatelů Jenkins. A pokud se jako statický analyzátor rozhodnete pro PVS-Studio, budeme velmi rádi. Zveme naši nástroj.
Pokud chcete sdílet tento článek s anglicky mluvícím publikem, prosím, použijte odkaz na překlad: Valery Komarov. .
Zdroj: habr.com
