Gå til hovedindhold

Afhængigheders tilstand

Afhængigheders tilstand markerer pakker, som dine repositories fastlåser, og som ikke er sårbare, men alligevel et problem. En bot til versionsopdateringer kan ikke se dem, fordi den følger et pakkenavn.

TypeHvad det betyderHvor signalet kommer fra
FlyttetProjektet fortsatte under en anden pakke, mens den, du fastlåser, stoppede. fremforge markerer kun en flytning, når en efterfølger er navngivet (Renovates erstatning, en pakke fra samme kilde-repository, der installerer samme kommando, eller den eneste pakke fra det repository på dets seneste hovedversion), og den gamle pakke er stoppet: dens repository er på en hovedversion, pakken aldrig fik, den har ikke haft en udgivelse i 30 dage, mens repositoryet blev ved, eller repositoryet er arkiveret. Et omdøbt eller omdirigeret repository er ikke i sig selv en flytningfremforge sammenligner pakken med dens kilde-repository på GitHub
UdfasetRegistret markerer pakken som udfasetRegistrets egen markering og besked
ForladtIngen udgivelse i 12 måneder, og projektet viser, at det er stoppet: dets repository er arkiveret eller deaktiveret, har ikke haft en commit i 24 måneder eller skriver, at det ikke vedligeholdes, er udfaset eller søger vedligeholdereHostet Renovates udgivelsesdatoer og kilde-repositoryet på GitHub
StilleståendeIngen udgivelse i 12 måneder, men intet tyder på, at projektet er stoppet (eller der er intet kilde-repository at tjekke). Kun til orienteringHostet Renovates udgivelsesdatoer

Fundene står under Sikkerhed › Fund › Afhængigheder › Tilstand. Hvert fund siger med almindelige ord, hvad der er sket, for eksempel “Seneste stabile udgivelse 1.19.5 den 28. okt. Projektet er nu på 2.2.6 under navnet @opencode/cli.”. Når fremforge kan se, hvilken pakke der afløste den, foreslår fundet den og viser installationskommandoen. Fundene står også under typen Afhængigheders tilstand i Fund › Alle.

Afhængigheders tilstand kræver i dag hostet Renovate: fund vises kun for repositories, der er med i Versionsopdateringer, fordi tjekkene kører ved hver kørsel af Versionsopdateringer. Slå Versionsopdateringer til for et repository for at se dets afhængigheders tilstand.

Stillestående fund er kun til orientering: de har deres eget filter i fanen Tilstand, tælles ikke med under Alle eller i Fund › Alle og sendes aldrig med e-mail, til webhooks eller til din SIEM.

Afvis et fund

Afvis et fund med en begrundelse og eventuelt en slutdato, på samme måde som andre fund i afhængigheder. Kræver din organisation godkendelse af afvisninger, går afvisningen til Undtagelser. Et afvist fund kommer tilbage, når slutdatoen passerer, og du kan genåbne det under Afviste.

Notifikationer

Nye og genåbnede fund kommer med i den daglige oversigt over varsler. E-mail om afhængigheders tilstand er slået til som standard for de organisationer, du ejer, og fra, hvor du er medlem. Du får én e-mail pr. organisation pr. dag, kl. 07.00 dansk tid og kun når der er et nyt eller genåbnet fund, og den daglige oversigt henviser til den i stedet for at gentage den. Vil du ikke have den, så følg linket nederst i en af e-mailene, eller slå E-mail om afhængigheders tilstand fra i dine notifikationsindstillinger: Så er den fra for alle organisationer. Slår du den til der, får du den også for de organisationer, hvor du er medlem; et medlems e-mail viser antallet af fund, ikke selve fundene.

Grænsen for forladte pakker

12 måneder som standard. Vil du ændre den for ét repository, så sæt abandonmentThreshold i dets renovate.json, for eksempel "abandonmentThreshold": "24 months". Sæt den til null for at slå tjekket fra der. En pakke over grænsen er kun forladt med et ekstra signal fra dens kilde-repository (arkiveret eller deaktiveret, ingen commit på standardgrenen i 24 måneder eller en besked om, at den ikke vedligeholdes, i beskrivelsen eller øverst i README); ellers er den stillestående. En nyere udgivelse inden for grænsen, af en hvilken som helst version, betyder, at pakken er ingen af delene. Når pakken udgiver en ny version, fjerner fremforge et fund om en forladt eller stillestående pakke senest en time efter, at udgivelsen er registreret.

Fortæl fremforge, hvor en pakke kommer fra

For at opdage en flytning skal fremforge kende pakkens kilde-repository. Den kigger tre steder, i denne rækkefølge:

  1. pakkens metadata i registret (for npm feltet repository);
  2. .fremforge/dependency-sources.json i dit repository;
  3. en packageRules-regel med sourceUrl i din Renovate-konfiguration, når reglen nævner pakken direkte i matchPackageNames eller matchDepNames. fremforge læser den første JSON-konfigurationsfil, den finder på standardgrenen (renovate.json, .renovaterc.json, .renovaterc eller renovate.json under .github/, .gitea/ eller .forgejo/); en .json5-konfiguration læses ikke til dette.

Nogle pakker oplyser slet ikke noget repository. Angiv 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, som dit manifest fastlåser det. ecosystem er valgfrit; brug det, når samme navn findes i to registre (npm, pypi). repo er ejer/navn på github.com eller en github.com-URL. fremforge læser filen ved næste kørsel. En linje, der ikke kan læses, springes over, og resten tæller stadig. Filen læses op til 1 MiB og 1.000 linjer.

Tjek for flytning og forladte pakker læser kilde-repositoryet på github.com; tjek for flytning dækker npm- og PyPI-pakker. Når et repository udgiver tags i stedet for GitHub-udgivelser, eller dets nyeste udgivelse er over 180 dage gammel, tæller dets nyeste tag som seneste version. Hver kørsel tjekker højst 40 pakker, først dem, der aldrig er tjekket, og dem, der er tjekket længst tid siden, og et resultat genbruges i 7 dage, så de første tjek af et stort repository fordeles over nogle kørsler. fremforge søger kun efter erstatningen for en flyttet pakke på npm. For en udfaset pakke kommer forslaget fra Renovates egne erstatningsregler, som også dækker andre økosystemer.