Naar de hoofdinhoud

Gepatchte upstream-images

Deze functie is beschikbaar zodra ze is uitgebracht. De changelog vermeldt de datum.

Sommige upstream-images hebben bekende kwetsbaarheden en nog geen release met een oplossing. Als je vanaf zo’n basis bouwt en de kwetsbare pakketten in je eigen lagen patcht, weigert de image-gate voor het ophalen van je organisatie de ongepatchte basis nog steeds wanneer je build die via de dependency proxy ophaalt, omdat die basis op zichzelf de bevindingen heeft.

Met een lijst van gepatchte basisimages in je repository mag die ene build die ene basis ophalen. Alleen het oordeel over bekende kwetsbaarheden (CVE’s) van de basis wordt doorgeschoven, en in plaats daarvan beoordeelt dezelfde gate het image dat je build ervan maakt, op zijn eigen bevindingen. Wat je uitlevert moet nog steeds schoon zijn.

Wanneer je het gebruikt

Gebruik een lijst van gepatchte basisimages als dit allemaal klopt:

  • de blokkeeractie voor images van je organisatie is block_pull, zodat het ophalen van een image met bevindingen op of boven je blokkeerdrempel wordt geweigerd;
  • een build van je haalt een upstream-basisimage op via de dependency proxy, en die basis heeft zulke bevindingen;
  • er is geen nieuwere upstream-tag of rebuild die ze oplost (de bevinding zegt Upstream-image, geen nieuwere gecorrigeerde tag; zie Nieuwere tags voor upstream-images);
  • je build lost de bevindingen op in zijn eigen lagen, en dezelfde run pusht het resultaat naar het containerregister van je organisatie op frem.sh.

Als een nieuwere upstream-tag de bevindingen oplost, stap daar dan op over. Als je een risico accepteert zonder het te patchen, is dat een uitzondering, geen gepatchte basis.

Onder warn of none wordt niets geweigerd, dus valt er niets door te schuiven en heeft de lijst geen effect.

Het dreigingsmodel

Een lijst die een image langs een beveiligingsgate laat, is zelf een doelwit. Elke regel hieronder sluit één manier af om er misbruik van te maken.

  • Alleen gelezen van de standaardbranch. fremforge leest .fremforge/patched-bases.json op de head van de standaardbranch van de repository, nooit van de branch of commit waarop de job draait. Een pull request die een entry toevoegt of verruimt, verandert niets totdat hij door je eigen branchbescherming en review is gegaan en gemerged is. Bescherm de standaardbranch en vereis review van .fremforge/, net als voor workflowbestanden.
  • Exacte digests, nooit tags. Een entry noemt manifestdigests, geen tag. Een tag kan upstream naar andere inhoud worden verplaatst; een digest is de inhoud. Alleen een pull waarvan het geleverde manifest hasht naar een opgegeven digest komt overeen.
  • Benoemde jobs van deze repository. Een entry noemt het workflowbestand en de job die de basis mag ophalen, en alleen jobs van de repository waarin de lijst staat. fremforge herkent de job aan zijn eigen gegevens over de lopende job, niet aan iets wat de workflow of de client zegt. Een pull door een persoon, een registry-robot, een persoonlijk toegangstoken of een job van een andere repository wordt beoordeeld zoals voorheen.
  • Geen pull requests, geen forks. Alleen runs voor push, schedule en workflow_dispatch op een toegestane branch kunnen doorschuiven. Een pull-request-run, een merge-group-run of een run vanuit een fork doet dat nooit, zodat code die niet is gereviewd de ongepatchte basis niet kan ophalen.
  • Alleen je eigen organisatie. De lijst schuift pulls door in de dependency proxy van zijn eigen organisatie, door zijn eigen jobs. Hij kan niets doorschuiven voor een andere organisatie, welke digest of naam die organisatie ook gebruikt.
  • De uitvoer wordt beoordeeld. De entry noemt het image dat je build maakt. Dat image staat in je eigen register, waar dezelfde image-gates het bij elke pull beoordelen: met block_pull wordt een uitvoer die nog bevindingen op of boven je drempel heeft geweigerd, zoals elk ander image.
  • De uitvoer moet aankomen. Op elke doorgeschoven pull moet binnen 6 uur een push volgen van de output-image van de entry, vanuit dezelfde run, naar het register van je organisatie op frem.sh. Een job die zonder die push slaagt, schort de entry voor de repository meteen op, en drie mislukte of onvoltooide jobs op rij doen dat ook: zie De push van de uitvoer wordt gecontroleerd.
  • Faalt dicht. Een onbekende sleutel, of één ongeldige entry, maakt de hele lijst ongeldig. Een lijst die niet valideert, schuift niets door; hij wordt nooit half toegepast.
  • Geen datums. Een entry heeft geen vervaldatum, omdat het geen uitzondering is: hij verplaatst het oordeel van de invoer naar de uitvoer. Zodra upstream een gerepareerde basis publiceert, pin je de nieuwe digest. De oude entry komt dan met niets meer overeen dat je ophaalt, en je kunt hem verwijderen.

Voorbeeld

.fremforge/patched-bases.json in de repository acme/base-images:

{
  "version": 1,
  "bases": [
    {
      "id": "nginx-1-27-patched",
      "image": "docker.io/library/nginx",
      "digests": [
        "sha256:847ed4ff646e27c4141ccda2134c861d71c53d97c8e17c4717aeb0a97371eba6",
        "sha256:416c19e2f2f06ad4ea5fac5768a4ef9ecef4a56f1457a6cd0cb4e4ce1e03f32f"
      ],
      "pullers": [
        { "repo": "acme/base-images", "workflow": "build.yaml", "job": "build" },
        { "repo": "acme/base-images", "workflow": "nightly.yaml", "job": "rebuild (amd64)" }
      ],
      "refs": ["refs/heads/main"],
      "events": ["push", "schedule", "workflow_dispatch"],
      "output": { "image": "nginx-patched" },
      "reason": "Upstream has no release with the fixed OpenSSL yet; our Dockerfile upgrades the affected packages in its own layer.",
      "approved_by": "Platform security team, change review",
      "confirmed": "2026-11-12, platform security team"
    }
  ]
}

De build pint de basis op digest, via de dependency proxy, en logt in met het eigen token van de job:

FROM frem.sh/acme/dependency-proxy/docker.io/library/nginx@sha256:847ed4ff646e27c4141ccda2134c861d71c53d97c8e17c4717aeb0a97371eba6
RUN apt-get update && apt-get install -y --only-upgrade openssl libssl3 && rm -rf /var/lib/apt/lists/*
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: echo "$GITHUB_TOKEN" | docker login frem.sh -u x --password-stdin
      - run: docker build -t frem.sh/acme/nginx-patched:1.27 . && docker push frem.sh/acme/nginx-patched:1.27

Veldenoverzicht

Het hoogste niveau bevat version (moet 1 zijn) en bases, en mag $schema bevatten. Elke andere sleutel maakt het bestand ongeldig.

VeldVerplichtBetekenis
idjaEen korte naam in kleine letters voor de entry, uniek in het bestand: letters, cijfers, ., _ en -, 2 tot 64 tekens, beginnend met een letter of cijfer. Hij wordt vastgelegd in de auditgebeurtenis.
imagejaHet upstream-image zoals de dependency proxy het noemt: registryhost en pad, zoals docker.io/library/nginx of ghcr.io/example/server. Geen tag, geen digest, en niet het pad frem.sh/<org>/dependency-proxy/.... Een Docker Hub-image heeft zijn volledige naam nodig (docker.io/library/nginx, niet nginx).
digestsja1 tot 32 manifestdigests, sha256: gevolgd door 64 hexadecimale tekens in kleine letters. Geef de multi-architectuurindex en de platformmanifesten op die je build ophaalt.
pullersja1 tot 20 jobs die de basis mogen ophalen, elk { "repo", "workflow", "job" }. repo moet deze repository zijn, <owner>/<repo>. workflow is de bestandsnaam van de workflow onder .forgejo/workflows/, zoals build.yaml, zonder de map. job is de naam van de job zoals Forgejo die in de run toont: zijn name: als hij die heeft, anders zijn sleutel; een matrixjob met zijn achtervoegsel, zoals rebuild (amd64). Moet exact overeenkomen.
refsnee1 tot 10 branches waarop de job mag draaien, als volledige refs: refs/heads/main. Geen tags en geen wildcards. Standaard: de standaardbranch van de repository.
eventsneeDe events die de run mag hebben: elk van push, schedule en workflow_dispatch. Standaard: alle drie.
output.imagejaHet image dat je build maakt, in het eigen register van je organisatie, als de naam onder je organisatie: nginx-patched voor frem.sh/acme/nginx-patched. Geen host, geen tag, geen digest, en geen dependency-proxy-image.
reasonjaWaarom de basis wordt gepatcht in plaats van vervangen, 20 tot 2.000 tekens.
approved_byjaWie de entry heeft gereviewd, tot 200 tekens.
confirmedneeEen notitie die de entry opnieuw bevestigt, 1 tot 200 tekens, bijvoorbeeld een datum en wie hem controleerde. Hij verandert niets aan waarmee de entry overeenkomt. Door hem in te stellen of te wijzigen hef je een opschorting op.

Grenzen: het bestand is maximaal 64 KiB en bevat maximaal 50 entries.

Wat wordt doorgeschoven en wat niet

Doorgeschoven: alleen het oordeel over bekende kwetsbaarheden (CVE’s) van de image-gate voor het ophalen, en alleen voor een pull die aan al deze voorwaarden voldoet:

  • een opgegeven digest van het opgegeven image;
  • opgehaald via de dependency proxy van je organisatie;
  • door een opgegeven job van dezelfde repository, in dezelfde organisatie, geauthenticeerd met het eigen token van die job;
  • in een run op een toegestane branch, voor een toegestaan event.

Zo’n pull wordt geleverd. In plaats daarvan beoordeelt de normale CVE-gate van het register de output-image die in de entry staat.

Niet doorgeschoven:

  • de malwarecontroles: geïnfecteerde lagen, kwaadaardige pakketten in het image en lagen die niet gescand konden worden, worden geweigerd zoals voorheen;
  • de controle van de imagehandtekening en je pakketbeleid;
  • pull-request-runs, merge-group-runs en runs vanuit forks;
  • andere repository’s, andere jobs en andere organisaties, en pulls die niet door een job worden gedaan;
  • een digest die niet is opgegeven, ook dezelfde tag nadat die upstream is verplaatst.

Je bestaande CVE-uitzonderingen, je blokkeerdrempel en je blokkeeractie (block_pull, warn of none) blijven ongewijzigd.

De push van de uitvoer wordt gecontroleerd

Een doorschuiving is een belofte: de run die de ongepatchte basis ophaalde, bouwt het gepatchte image en pusht het. fremforge controleert die belofte voor elke doorgeschoven pull.

  • De klok start bij de pull. De eerste doorgeschoven pull van een entry in een run start een venster van 6 uur. Latere pulls van dezelfde entry in dezelfde run starten het niet opnieuw.
  • Dezelfde run. Een job van de run die de basis ophaalde, moet de uitvoer pushen, ingelogd met zijn eigen token. Elke job van die run telt. Een push door een andere run, ook een latere run van dezelfde workflow, of door een persoon, een persoonlijk toegangstoken of een registry-robot telt niet.
  • De output-image van de entry, in je register. De push moet een geaccepteerde push van frem.sh/<org>/<output.image> naar het eigen register van je organisatie zijn, met een willekeurige tag. Een push naar een ander register, naar een andere organisatie of onder een andere imagenaam telt niet.
  • Binnen 6 uur. fremforge controleert om de paar minuten, zodat een ontbrekende push kort na afloop van de 6 uur wordt gevonden.

Is de push niet aangekomen, dan beslist de uitkomst van de job die de basis ophaalde, zoals Forgejo die op het 6-uursmoment vastlegt. Het gaat om de uitkomst van de job, niet van de run; haalden meerdere jobs van de run de basis voor de entry op, dan telt het als geslaagd als een van hen slaagde.

  • De job is geslaagd. De entry wordt voor de repository meteen opgeschort. Een job die goed afliep zonder zijn uitvoer te leveren, is precies wat deze controle moet vangen.
  • De job is mislukt, geannuleerd of overgeslagen, of was niet klaar. De entry wordt niet opgeschort. De ontbrekende push wordt vastgelegd als de auditgebeurtenis image_cve.patched_base_output_skipped en geteld. Een job die op het 6-uursmoment nog loopt, of die Forgejo niet meer kent, telt als niet klaar.
  • Drie op rij. Het derde zulke geval voor dezelfde entry in dezelfde repository, zonder geverifieerde push ertussen, schort de entry op.
  • Een geverifieerde push zet de telling terug op nul, en het opheffen van een opschorting ook.

Als een entry is opgeschort

Wat er gebeurt. De entry schuift voor die repository niets meer door. Een pull die de entry anders zou doorschuiven, wordt geweigerd met 403 DENIED en een eigen reden, patched_base_suspended, zodat je hem kunt onderscheiden van een gewone CVE-weigering:

  • het antwoord bevat de header X-Fremforge-Refusal-Reason: patched_base_suspended;
  • de body noemt de entry, wanneer hij werd opgeschort en hoe je hem opnieuw bevestigt (hieronder);
  • het toegangslog van de registry legt de pull vast als blocked met de decision_reason image_cve:patched_base_suspended, die de console toont als Geblokkeerd: opgegeven gepatchte basis opgeschort (de output-image is niet gepusht).
HTTP/1.1 403 Forbidden
Content-Type: application/json
X-Fremforge-Refusal-Reason: patched_base_suspended
{
  "errors": [
    {
      "code": "DENIED",
      "message": "Pull blocked: patched base \"nginx-1-27-patched\" in .fremforge/patched-bases.json is suspended for this repository (an earlier run that pulled it did not push its output image), so its 3 high/critical finding(s) are judged as usual. To re-confirm it, change the entry on the default branch, e.g. its `confirmed` note.",
      "detail": {
        "reason": "patched_base_suspended",
        "entry": "nginx-1-27-patched",
        "suspended_at": "2026-11-12T16:05:12.000Z",
        "reconfirm": "change the entry on the default branch, e.g. its `confirmed` note",
        "finding_count": 3,
        "block_severity": "high",
        "admin_url": "https://frem.sh/acme/_admin/code-security/images"
      }
    }
  ]
}

detail.finding_count en detail.block_severity zijn de bevindingen van de basis en je drempel; admin_url is de pagina met image-bevindingen van je organisatie. De andere entries in de lijst blijven werken. Een opschorting verloopt niet, en een latere push heft hem niet op.

Hoe je het hoort. fremforge schrijft de auditgebeurtenis image_cve.patched_base_suspended, die ook je SIEM-stroom bereikt, en stuurt de beveiligingsgebeurtenis security.policy.violation, met "policy": "patched_base" in details, naar elke webhookbestemming die erop is geabonneerd. Er gaat geen e-mail uit. Wil je van een opschorting horen, abonneer dan een bestemming van de webhooks voor beveiligingsmeldingen op security.policy.violation, of houd het auditlog in de gaten.

{
  "event": "security.policy.violation",
  "event_id": "9a1e5c7b3d2f4a6c8e0b1d3f5a7c9e2b",
  "occurred_at": "2026-11-12T16:05:12.000Z",
  "org": "acme",
  "severity": "high",
  "title": "Patched base nginx-1-27-patched suspended: run 48213 did not push acme/nginx-patched within 6 h",
  "repository": "acme/base-images",
  "source": "registry",
  "correlation_key": "patched-base:acme/base-images:nginx-1-27-patched",
  "console_url": "https://frem.sh/acme/_admin/code-security/images",
  "details": {
    "policy": "patched_base",
    "audit_event_id": "1f3b5d7f-2a4c-4e6a-8c0e-2b4d6f8a0c1e",
    "org": "acme",
    "repo": "acme/base-images",
    "run_id": 48213,
    "run_number": 112,
    "entry": "nginx-1-27-patched",
    "output_image": "acme/nginx-patched",
    "deferred_at": "2026-11-12T10:01:37.000Z",
    "deferral_event_id": "7c9e1a3b-5d7f-4b2d-9f1a-3c5e7a9b1d3f",
    "window_hours": 6,
    "cause": "success_without_push",
    "outcome": "success"
  }
}

title noemt de run bij zijn run_id; details.run_number geeft zijn pagina, /<owner>/<repo>/actions/runs/<run_number>. correlation_key is hetzelfde voor elke opschorting van dezelfde entry in dezelfde repository.

Zo hef je hem op.

  1. Zoek uit waarom de push niet aankwam (zie Fouten die een entry opschorten), en herstel de workflow.
  2. Wijzig de entry op de standaardbranch, via je gewone review. Om hem te wijzigen zonder te veranderen waarmee hij overeenkomt, stel je zijn notitie confirmed in of wijzig je die, bijvoorbeeld "confirmed": "2026-11-12, push fixed in build.yaml".
  3. Start de build opnieuw. Bij zijn eerste pull van de basis leest fremforge de entry aan de kop van de standaardbranch, ziet dat hij verschilt van de entry die werd opgeschort, heft de opschorting op en schrijft de auditgebeurtenis image_cve.patched_base_reconfirmed. Die pull wordt weer doorgeschoven, en de push van zijn uitvoer wordt gecontroleerd zoals elke andere.

Alleen een wijziging van wat de entry zegt, telt: elk van zijn velden, confirmed inbegrepen. Het bestand opnieuw opmaken, sleutels, entries, digests of pullers in een andere volgorde zetten, en commits aan andere entries of andere bestanden laten de entry zoals hij was, zodat hij opgeschort blijft. Een wijziging op een andere branch of in een open pull request telt pas als die is gemerged.

Controleren of het werkte

Elke doorgeschoven pull laat twee sporen na.

In het toegangslog van de registry is de pull allowed, en zijn decision_reason bevat image_cve:deferred_patch_input:

curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/access-log?decision=allowed&since=2026-11-01" \
  | jq '.. | objects | select((.decision_reason? // "") | test("image_cve:deferred_patch_input"))'

In het auditlog, en van daaruit in je SIEM-stroom, is elke doorgeschoven pull de gebeurtenis image_cve.deferred_patch_input. De velden:

VeldBetekenis
org, repoJe organisatie en de repository waarvan de job de basis ophaalde
run_id, run_number, job_idDe run en de job; run_number is de pagina van de run, /<owner>/<repo>/actions/runs/<run_number>
workflow, jobHet workflowbestand en de jobnaam die met de entry overeenkwamen
image, digestHet geproxyde image en de digest die werd geleverd
output_imageDe output-image waarnaar het oordeel werd doorgeschoven, <org>/<name>
entryDe id van de entry die overeenkwam
list_path, list_commit.fremforge/patched-bases.json en de commit op de standaardbranch waarop het werd gelezen
entry_hashEen hash van de entry zoals hij werd gelezen. Een opschorting wordt alleen opgeheven als die verandert
curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/audit?since=2026-11-01T00:00:00Z" \
  | jq '.. | objects | select(.action? == "image_cve.deferred_patch_input")'

Beide hebben een token met audit:read nodig. Als de pull met 403 DENIED werd geweigerd en geen van beide sporen bestaat, is de pull niet doorgeschoven: zie de fouten hieronder.

Als de controle van de uitvoer mislukt

Een ontbrekende push die de entry niet opschort, een opschorting en de wijziging die hem opheft, laten elk een auditgebeurtenis achter. De ontbrekende push die een entry na twee eerdere opschort, laat zowel zijn gebeurtenis image_cve.patched_base_output_skipped als de opschorting achter.

image_cve.patched_base_output_skipped, geschreven als een job die niet slaagde ook niet pushte:

VeldBetekenis
org, repoJe organisatie en de repository waarvan de job de basis ophaalde
entryDe id van de entry
run_id, run_numberDe run die de basis ophaalde en de uitvoer niet pushte
output_imageDe output-image die niet werd gepusht, <org>/<name>
outcomeDe uitkomst van de job: failure, cancelled, skipped, unfinished of unknown
consecutive_non_success, suspends_atHet hoeveelste zulke geval op rij dit is voor de entry, en het aantal dat hem opschort, 3
deferral_event_idDe id van de gebeurtenis image_cve.deferred_patch_input die de klok startte

image_cve.patched_base_suspended, geschreven als de entry wordt opgeschort:

VeldBetekenis
org, repoJe organisatie en de repository waarvoor de entry is opgeschort
entryDe id van de opgeschorte entry
run_id, run_numberDe run die de basis ophaalde en de uitvoer niet pushte
output_imageDe output-image die niet werd gepusht, <org>/<name>
deferred_at, deferral_event_idWanneer de doorgeschoven pull plaatsvond die de klok startte, en de id van zijn gebeurtenis image_cve.deferred_patch_input
window_hoursHet venster, 6
causesuccess_without_push (de job slaagde zonder te pushen) of non_success_x3 (de derde ontbrekende push op rij)
outcomeDe uitkomst van de job zoals hierboven, of success
consecutive_non_successAlleen bij non_success_x3: het aantal, 3

image_cve.patched_base_reconfirmed, geschreven bij de eerste pull nadat de entry is gewijzigd:

VeldBetekenis
org, repoJe organisatie en de repository waarvoor de opschorting is opgeheven
entryDe id van de entry
list_commitDe commit op de standaardbranch waarop de gewijzigde entry werd gelezen
suspended_at, suspended_run_idWanneer de entry werd opgeschort, en de run_id van de run die dat veroorzaakte
entry_hashDe hash van de entry zoals hij nu luidt
curl -sS -H "Authorization: Bearer $FFP_TOKEN" \
  "https://frem.sh/_app/api/v1/orgs/acme/audit?since=2026-11-01T00:00:00Z" \
  | jq '.. | objects | select(.action? | IN("image_cve.patched_base_output_skipped", "image_cve.patched_base_suspended", "image_cve.patched_base_reconfirmed"))'

De afleveringen van security.policy.violation staan in de afleverlog van elke bestemming, GET /orgs/{org}/webhooks/deliveries?destination_id={id}.

Veelgemaakte fouten

Een pull die niet wordt doorgeschoven, wordt precies zo geweigerd als voorheen; er is geen aparte foutmelding voor. De uitzondering is een pull van een opgeschorte entry, die de reden patched_base_suspended draagt. Controleer eerst dit:

  • De lijst staat nog niet op de standaardbranch. De pull-request-run die hem toevoegt, kan hem niet gebruiken, en geen enkele run kan dat totdat de wijziging gemerged is.
  • De run is een pull request. Een pull-request-run of een merge-group-run schuift nooit door, ook niet nadat de lijst gemerged is. Bouw het image bij push, schedule of workflow_dispatch.
  • Een tag in plaats van een digest. "image": "docker.io/library/nginx:1.27" of een tag in digests maakt de hele lijst ongeldig. Zet de digests in digests, en pin de basis op digest in je Dockerfile, zodat een nieuwe push van de tag upstream niet kan veranderen wat je ophaalt.
  • Een digest die niet degene is die wordt geleverd. Een multi-architectuurtag wordt eerst als index geleverd, daarna als platformmanifest. Geef beide digests op, anders wordt de pull van degene die je weglaat geweigerd.
  • Een onbekende sleutel, of één foute entry. Een verkeerd gespeld veld ("digest" in plaats van "digests"), een extra veld zoals "expires", of één entry die niet valideert, maakt de hele lijst ongeldig, en er wordt voor geen enkele entry iets doorgeschoven.
  • De verkeerde jobnaam. job is de naam die Forgejo voor de job in de run toont: zijn name: als hij die heeft, niet zijn sleutel; een matrixjob met zijn achtervoegsel.
  • Een pad in workflow. Schrijf build.yaml, niet .forgejo/workflows/build.yaml.
  • Een korte branchnaam in refs. Schrijf refs/heads/main, niet main.
  • Een andere repository in pullers. Een lijst dekt alleen de jobs van zijn eigen repository. Wil je een andere repository dezelfde basis laten ophalen, zet dan een lijst in die repository.
  • De verkeerde inloggegevens. De job moet bij frem.sh inloggen met zijn eigen token (GITHUB_TOKEN). Een persoonlijk toegangstoken of een registry-robot is geen job, dus hun pulls worden niet doorgeschoven.
  • De basis rechtstreeks van upstream opgehaald. Alleen pulls via frem.sh/<org>/dependency-proxy/... worden doorgeschoven.

Fouten die een entry opschorten

Wordt een pull geweigerd met patched_base_suspended, zoek dan de gebeurtenis image_cve.patched_base_suspended in het auditlog: de cause en het run_number ervan zeggen welke regel gold en welke run hem veroorzaakte. Deze fouten laten de controle van de uitvoer mislukken:

  • De uitvoer gepusht vanuit een andere run. Bouwen in de ene workflow en pushen vanuit een andere, of het image achteraf met de hand pushen, telt niet. Push vanuit de run die de basis ophaalde.
  • De uitvoer gepusht naar een ander register. Een push naar Docker Hub, naar een ander register of naar een andere organisatie op frem.sh telt niet. Push naar frem.sh/<org>/<output.image>.
  • Een andere imagenaam. Voor "output": { "image": "nginx-patched" } telt een push van nginx-patched-amd64 niet. De tag doet er niet toe; de naam wel.
  • De push met andere inloggegevens. Een persoonlijk toegangstoken of een registry-robot in de pushstap draagt de run niet mee. Log ook voor de push in met het eigen token van de job (GITHUB_TOKEN).
  • Een job die slaagt zonder te pushen. Een pushstap die door een if:-voorwaarde wordt overgeslagen, of die mislukt onder continue-on-error, laat de job geslaagd en de uitvoer ongepusht. Dat schort de entry meteen op.
  • Een opgegeven workflow die nooit pusht. Een geplande scan- of testworkflow in pullers waarvan de job de basis ophaalt, slaagt en de uitvoer niet pusht, schort de entry op bij zijn eerste run. Geef alleen workflows op waarvan de runs de uitvoer pushen.
  • Een build die na de pull steeds mislukt. Eén mislukte, geannuleerde of onvoltooide job wordt vastgelegd, maar schort niet op; de derde op rij voor dezelfde entry, zonder geverifieerde push ertussen, schort hem op. Herstel de build voordat hij een derde keer mislukt.
  • Een push later dan 6 uur. Een lange build die meer dan 6 uur na zijn eerste pull van de basis pusht, is te laat; een job die op dat moment nog loopt, telt als niet klaar. Haal de basis kort voor de push op.
  • Alleen confirmed gewijzigd. De entry opnieuw bevestigen zonder de oorzaak te herstellen heft de opschorting op, maar dezelfde fout schort de entry weer op.

Zie ook

  • Imagescanning: de bevindingen, de blokkeerdrempel en de image-gate voor het ophalen.
  • Dependency-proxy: upstream-images ophalen via je organisatie.
  • Uitzonderingen: een risico accepteren dat je niet patcht, met een vervaldatum en een tweede goedkeurder.
  • Branchbescherming: de review waar een wijziging aan de lijst doorheen gaat.