Gezondheid van afhankelijkheden
Gezondheid van afhankelijkheden meldt pakketten die je repositories vastpinnen en die niet kwetsbaar zijn, maar toch een probleem. Een bot voor versie-updates ziet ze niet, want die volgt een pakketnaam.
| Soort | Wat het betekent | Waar het signaal vandaan komt |
|---|---|---|
| Verhuisd | Het project ging verder onder een ander pakket terwijl het vastgepinde stopte. fremforge meldt alleen een verhuizing als er een opvolger genoemd is (de vervanging van Renovate, een pakket uit dezelfde bronrepository dat dezelfde opdracht installeert, of het enige pakket van die repository op de nieuwste hoofdversie) en het oude pakket gestopt is: de repository is op een hoofdversie die het pakket nooit kreeg, het had 30 dagen geen release terwijl de repository doorging, of de repository is gearchiveerd. Een hernoemde of omgeleide repository is op zich geen verhuizing | fremforge vergelijkt het pakket met zijn bronrepository op GitHub |
| Verouderd | Het register markeert het pakket als verouderd | De eigen markering en melding van het register |
| Verlaten | 12 maanden geen release, en het project laat zien dat het gestopt is: de repository is gearchiveerd of uitgeschakeld, had 24 maanden geen commit, of meldt dat het niet meer wordt onderhouden, verouderd is of maintainers zoekt | De releasedatums van gehoste Renovate, en de bronrepository op GitHub |
| Stilgevallen | 12 maanden geen release, maar niets wijst erop dat het project gestopt is (of er is geen bronrepository om te controleren). Alleen ter informatie | De releasedatums van gehoste Renovate |
De bevindingen staan onder Beveiliging › Bevindingen › Afhankelijkheden › Gezondheid. Elke bevinding zegt in gewone woorden wat er is gebeurd, bijvoorbeeld “Laatste stabiele release 1.19.5 op 28 okt. Het project is nu bij 2.2.6, onder de naam @opencode/cli.”. Weet fremforge welk pakket het verving, dan stelt de bevinding dat voor met de installatieopdracht. Ze staan ook onder het type Gezondheid van afhankelijkheden in Bevindingen › Alle.
Gezondheid van afhankelijkheden vraagt nu gehoste Renovate: bevindingen verschijnen alleen voor repositories die meedoen met Versie-updates, omdat de controles bij elke run van Versie-updates draaien. Zet Versie-updates aan voor een repository om de gezondheid van zijn afhankelijkheden te zien.
Stilgevallen bevindingen zijn alleen ter informatie: ze hebben een eigen filter op het tabblad Gezondheid, tellen niet mee onder Alle of in Bevindingen › Alle, en worden nooit gemaild, naar webhooks of naar je SIEM gestuurd.
Een bevinding negeren
Negeer een bevinding met een reden en eventueel een einddatum, net als andere bevindingen in afhankelijkheden. Vraagt je organisatie goedkeuring voor negeren, dan gaat het naar Uitzonderingen. Een genegeerde bevinding komt terug als de einddatum verstrijkt, en je kunt hem heropenen onder Genegeerd.
Meldingen
Nieuwe en heropende bevindingen staan in het dagelijkse meldingsoverzicht. E-mail over de gezondheid van afhankelijkheden staat standaard aan voor de organisaties waarvan je eigenaar bent, en uit waar je lid bent. Je krijgt één e-mail per organisatie per dag, om 07:00 uur Kopenhaagse tijd en alleen als er een nieuwe of heropende bevinding is, en het dagelijkse overzicht verwijst ernaar in plaats van het te herhalen. Wil je hem niet, volg dan de link onderaan een van deze e-mails, of zet E-mail over de gezondheid van afhankelijkheden uit in je meldingsinstellingen: dan blijft hij voor elke organisatie uit. Zet je hem daar aan, dan krijg je hem ook voor de organisaties waar je lid bent; de e-mail aan een lid noemt het aantal bevindingen, niet de bevindingen zelf.
De drempel voor verlaten pakketten
Standaard 12 maanden. Voor één repository zet je abandonmentThreshold in de renovate.json, bijvoorbeeld "abandonmentThreshold": "24 months". Met null zet je de controle daar uit. Een pakket over de drempel is alleen verlaten met een tweede signaal van de bronrepository (gearchiveerd of uitgeschakeld, 24 maanden geen commit op de standaardbranch, of een melding in de beschrijving of bovenaan de README dat het niet meer wordt onderhouden); anders is het stilgevallen. Een nieuwere release binnen de drempel, van welke versie ook, betekent dat het geen van beide is. Brengt het pakket een nieuwe release uit, dan haalt fremforge een bevinding als verlaten of stilgevallen weg binnen een uur nadat het die release heeft vastgelegd.
fremforge vertellen waar een pakket vandaan komt
Om een verhuizing te zien heeft fremforge de bronrepository van het pakket nodig. Het kijkt op drie plekken, in deze volgorde:
- de registermetadata van het pakket (bij npm het veld
repository); .fremforge/dependency-sources.jsonin je repository;- een
packageRules-regel metsourceUrlin je Renovate-configuratie, als de regel het pakket letterlijk noemt inmatchPackageNamesofmatchDepNames. fremforge leest het eerste JSON-configuratiebestand dat het op de standaardbranch vindt (renovate.json,.renovaterc.json,.renovaterc, ofrenovate.jsononder.github/,.gitea/of.forgejo/); een.json5-configuratie wordt hiervoor niet gelezen.
Sommige pakketten noemen helemaal geen repository. Zet ze in .fremforge/dependency-sources.json op de standaardbranch:
{
"sources": [
{ "package": "opencode-ai", "ecosystem": "npm", "repo": "anomalyco/opencode" },
{ "package": "internal-tool", "repo": "https://github.com/example/internal-tool" }
]
}package is de naam zoals je manifest hem vastpint. ecosystem is optioneel; gebruik het als dezelfde naam in twee registers bestaat (npm, pypi). repo is eigenaar/naam op github.com of een github.com-URL. fremforge leest het bestand bij de volgende run. Een regel die niet te lezen is, wordt overgeslagen; de rest telt nog. Het bestand wordt gelezen tot 1 MiB en 1.000 regels.
De controles op verhuizing en verlaten pakketten lezen de bronrepository op github.com; de verhuiscontrole dekt npm- en PyPI-pakketten. Publiceert een repository tags in plaats van GitHub-releases, of is de nieuwste release ouder dan 180 dagen, dan telt de nieuwste tag als nieuwste versie. Elke run controleert hoogstens 40 pakketten, eerst de nooit gecontroleerde en de langst niet gecontroleerde, en een resultaat wordt 7 dagen hergebruikt, dus de eerste controles van een grote repository worden over een paar runs verdeeld. fremforge zoekt de vervanging van een verhuisd pakket alleen op npm. Voor een verouderd pakket komt het voorstel uit de vervangingsregels van Renovate, die ook andere ecosystemen dekken.