Avhengighetenes helse
Avhengighetenes helse flagger pakker repositoryene dine låser som ikke er sårbare, men som likevel er et problem. En bot for versjonsoppdateringer ser dem ikke, fordi den følger et pakkenavn.
| Type | Hva det betyr | Hvor signalet kommer fra |
|---|---|---|
| Flyttet | Prosjektet fortsatte under en annen pakke mens den du låser stoppet. fremforge flagger bare en flytting når en etterfølger er navngitt (Renovates erstatning, en pakke fra samme kilderepository som installerer samme kommando, eller den eneste pakken fra det repositoryet på siste hovedversjon) og den gamle pakken har stoppet: repositoryet er på en hovedversjon pakken aldri fikk, den har ikke hatt en ny versjon på 30 dager mens repositoryet fortsatte, eller repositoryet er arkivert. Et omdøpt eller omdirigert repository er i seg selv ingen flytting | fremforge sammenligner pakken med kilderepositoryet på GitHub |
| Utfaset | Registeret merker pakken som utfaset | Registerets egen merking og melding |
| Forlatt | Ingen ny versjon på 12 måneder, og prosjektet viser at det har stoppet: repositoryet er arkivert eller deaktivert, har ikke hatt en commit på 24 måneder eller skriver at det ikke vedlikeholdes, er utfaset eller søker vedlikeholdere | Hostet Renovates versjonsdatoer og kilderepositoryet på GitHub |
| Stillestående | Ingen ny versjon på 12 måneder, men ingenting tyder på at prosjektet har stoppet (eller det finnes ikke noe kilderepository å sjekke). Bare til informasjon | Hostet Renovates versjonsdatoer |
Funnene står under Sikkerhet › Funn › Avhengigheter › Helse. Hvert funn sier med vanlige ord hva som har skjedd, for eksempel «Siste stabile versjon 1.19.5 28. okt. Prosjektet er nå på 2.2.6 under navnet @opencode/cli.». Når fremforge ser hvilken pakke som tok over, foreslår funnet den med installasjonskommandoen. De står også under typen Avhengighetenes helse i Funn › Alle.
Avhengighetenes helse krever i dag hostet Renovate: funn vises bare for repositoryer som er med i Versjonsoppdateringer, fordi sjekkene kjører ved hver kjøring av Versjonsoppdateringer. Slå på Versjonsoppdateringer for et repository for å se avhengighetenes helse.
Stillestående funn er bare til informasjon: de har sitt eget filter i fanen Helse, telles ikke under Alle eller i Funn › Alle, og sendes aldri på e-post, til webhooks eller til SIEM-en din.
Avvise et funn
Avvis et funn med en begrunnelse og eventuelt en sluttdato, på samme måte som andre avhengighetsfunn. Krever organisasjonen din godkjenning av avvisninger, går den til Unntak. Et avvist funn kommer tilbake når sluttdatoen passerer, og du kan åpne det igjen under Avviste.
Varsler
Nye og gjenåpnede funn kommer med i den daglige varseloppsummeringen. E-post om avhengighetenes helse er slått på som standard for organisasjonene du eier, og av der du er medlem. Du får én e-post per organisasjon per dag, kl. 07.00 København-tid og bare når det er et nytt eller gjenåpnet funn, og den daglige oppsummeringen lenker dit i stedet for å gjenta det. Vil du ikke ha den, følger du lenken nederst i en av e-postene, eller slår av E-post om avhengighetenes helse i varslingsinnstillingene dine: Da er den av for alle organisasjoner. Slår du den på der, får du den også for organisasjonene der du er medlem; e-posten til et medlem viser antall funn, ikke selve funnene.
Grensen for forlatte pakker
12 måneder som standard. For ett repository setter du abandonmentThreshold i renovate.json, for eksempel "abandonmentThreshold": "24 months". Med null slår du av sjekken der. En pakke over grensen er bare forlatt med et ekstra signal fra kilderepositoryet (arkivert eller deaktivert, ingen commit på standardgrenen på 24 måneder, eller en melding i beskrivelsen eller øverst i README om at den ikke vedlikeholdes); ellers er den stillestående. En nyere versjon innenfor grensen, av hvilken som helst versjon, betyr at pakken er ingen av delene. Når pakken gir ut en ny versjon, fjerner fremforge et funn om en forlatt eller stillestående pakke senest én time etter at versjonen er registrert.
Fortell fremforge hvor en pakke kommer fra
For å oppdage en flytting trenger fremforge pakkens kilderepository. Den ser tre steder, i denne rekkefølgen:
- pakkens metadata i registeret (for npm feltet
repository); .fremforge/dependency-sources.jsoni repositoryet ditt;- en
packageRules-regel medsourceUrli Renovate-konfigurasjonen din, når regelen nevner pakken direkte imatchPackageNamesellermatchDepNames. fremforge leser den første JSON-konfigurasjonsfilen den finner på standardgrenen (renovate.json,.renovaterc.json,.renovatercellerrenovate.jsonunder.github/,.gitea/eller.forgejo/); en.json5-konfigurasjon leses ikke til dette.
Noen pakker oppgir ikke noe repository i det hele tatt. List 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 er navnet slik manifestet ditt låser det. ecosystem er valgfritt; bruk det når samme navn finnes i to registre (npm, pypi). repo er eier/navn på github.com eller en github.com-URL. fremforge leser filen ved neste kjøring. En linje som ikke kan leses, hoppes over; resten teller fortsatt. Filen leses opptil 1 MiB og 1 000 linjer.
Sjekkene av flyttede og forlatte pakker leser kilderepositoryet på github.com; flyttesjekken dekker npm- og PyPI-pakker. Når et repository publiserer tagger i stedet for GitHub-versjoner, eller den nyeste versjonen er over 180 dager gammel, teller den nyeste taggen som siste versjon. Hver kjøring sjekker høyst 40 pakker, først de som aldri er sjekket og de som er sjekket for lengst siden, og et resultat gjenbrukes i 7 dager, så de første sjekkene av et stort repository fordeles over noen kjøringer. fremforge søker bare etter erstatningen for en flyttet pakke på npm. For en utfaset pakke kommer forslaget fra Renovates egne erstatningsregler, som også dekker andre økosystemer.