Beroendens hälsa
Beroendens hälsa flaggar paket som dina repositoryn låser och som inte är sårbara men ändå ett problem. En bot för versionsuppdateringar ser dem inte, eftersom den följer ett paketnamn.
| Typ | Vad det betyder | Var signalen kommer ifrån |
|---|---|---|
| Flyttad | Projektet fortsatte under ett annat paket medan det du låser stannade. fremforge flaggar en flytt bara när en efterföljare är namngiven (Renovates ersättare, ett paket från samma källrepository som installerar samma kommando, eller det enda paketet från det repositoryt på dess senaste huvudversion) och det gamla paketet har stannat: dess repository är på en huvudversion som paketet aldrig fick, det har inte haft en version på 30 dagar medan repositoryt fortsatte, eller repositoryt är arkiverat. Ett omdöpt eller omdirigerat repository är i sig ingen flytt | fremforge jämför paketet med dess källrepository på GitHub |
| Utfasad | Registret markerar paketet som utfasat | Registrets egen markering och meddelande |
| Övergiven | Ingen version på 12 månader, och projektet visar att det har slutat: dess repository är arkiverat eller inaktiverat, har inte haft en commit på 24 månader eller skriver att det inte underhålls, är utfasat eller söker underhållare | Hostad Renovates versionsdatum och källrepositoryt på GitHub |
| Stillastående | Ingen version på 12 månader, men inget tyder på att projektet har slutat (eller det finns inget källrepository att kontrollera). Bara information | Hostad Renovates versionsdatum |
Fynden finns under Säkerhet › Fynd › Beroenden › Hälsa. Varje fynd säger med vanliga ord vad som har hänt, till exempel “Senaste stabila version 1.19.5 den 28 okt. Projektet är nu på 2.2.6 under namnet @opencode/cli.”. När fremforge kan se vilket paket som ersatte det föreslår fyndet det paketet med installationskommandot. De finns också under typen Beroendens hälsa i Fynd › Alla.
Beroendens hälsa kräver i dag hostad Renovate: fynd visas bara för repositoryn som är med i Versionsuppdateringar, eftersom kontrollerna körs vid varje körning av Versionsuppdateringar. Slå på Versionsuppdateringar för ett repository för att se dess beroendens hälsa.
Stillastående fynd är bara information: de har ett eget filter på fliken Hälsa, räknas inte under Alla eller i Fynd › Alla och skickas aldrig med mejl, till webhooks eller till din SIEM.
Avfärda ett fynd
Avfärda ett fynd med en motivering och eventuellt ett slutdatum, på samma sätt som andra beroendefynd. Kräver din organisation godkännande för avfärdanden går det till Undantag. Ett avfärdat fynd kommer tillbaka när slutdatumet passerar, och du kan öppna det igen under Avfärdade.
Aviseringar
Nya och återöppnade fynd kommer med i den dagliga sammanfattningen av varningar. Mejl om beroendens hälsa är på som standard för de organisationer du äger och av där du är medlem. Du får ett mejl per organisation och dag, kl. 07.00 Köpenhamnstid och bara när det finns ett nytt eller återöppnat fynd, och den dagliga sammanfattningen hänvisar dit i stället för att upprepa det. Vill du inte ha det följer du länken längst ned i ett av mejlen, eller stänger av Mejl om beroendens hälsa i dina aviseringsinställningar: Då är det av för alla organisationer. Slår du på det där får du det även för de organisationer där du är medlem; mejlet till en medlem anger antalet fynd, inte själva fynden.
Gränsen för övergivna paket
12 månader som standard. För ett enskilt repository anger du abandonmentThreshold i dess renovate.json, till exempel "abandonmentThreshold": "24 months". Med null stänger du av kontrollen där. Ett paket över gränsen är övergivet bara med en andra signal från dess källrepository (arkiverat eller inaktiverat, ingen commit på standardgrenen på 24 månader, eller ett meddelande i beskrivningen eller överst i README om att det inte underhålls); annars är det stillastående. En nyare version inom gränsen, av vilken version som helst, betyder att paketet inte är något av dem. När paketet ger ut en ny version tar fremforge bort ett fynd om ett övergivet eller stillastående paket senast en timme efter att versionen har registrerats.
Tala om för fremforge var ett paket kommer ifrån
För att upptäcka en flytt behöver fremforge paketets källrepository. Det letar på tre ställen, i den här ordningen:
- paketets metadata i registret (för npm fältet
repository); .fremforge/dependency-sources.jsoni ditt repository;- en
packageRules-regel medsourceUrli din Renovate-konfiguration, när regeln nämner paketet ordagrant imatchPackageNamesellermatchDepNames. fremforge läser den första JSON-konfigurationsfil den hittar på standardgrenen (renovate.json,.renovaterc.json,.renovatercellerrenovate.jsonunder.github/,.gitea/eller.forgejo/); en.json5-konfiguration läses inte för detta.
En del paket anger inget repository alls. Lista dem i .fremforge/dependency-sources.json på standardgrenen:
{
"sources": [
{ "package": "opencode-ai", "ecosystem": "npm", "repo": "anomalyco/opencode" },
{ "package": "internal-tool", "repo": "https://github.com/example/internal-tool" }
]
}package är namnet som ditt manifest låser det. ecosystem är valfritt; använd det när samma namn finns i två register (npm, pypi). repo är ägare/namn på github.com eller en github.com-URL. fremforge läser filen vid nästa körning. En rad som inte går att läsa hoppas över; resten räknas ändå. Filen läses upp till 1 MiB och 1 000 rader.
Kontrollerna av flyttade och övergivna paket läser källrepositoryt på github.com; flyttkontrollen täcker npm- och PyPI-paket. När ett repository publicerar taggar i stället för GitHub-versioner, eller dess nyaste version är äldre än 180 dagar, räknas dess nyaste tagg som senaste version. Varje körning kontrollerar högst 40 paket, först de som aldrig kontrollerats och de som kontrollerades längst sedan, och ett resultat återanvänds i 7 dagar, så de första kontrollerna av ett stort repository sprids över några körningar. fremforge söker ersättaren för ett flyttat paket bara på npm. För ett utfasat paket kommer förslaget från Renovates egna ersättningsregler, som också täcker andra ekosystem.