Process
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache
JSON-LD · diagram · in graph fhir-harness.jsonld ·
| name | An IG site, built from the AST on its cache branch |
|---|---|
| summary | How an IG repository's own site is published, and how the AST it is built from is kept current (skill ig-build-pipeline §"The AST cache lifecycle"). |
| description | How an IG repository's own site is published, and how the AST it is built from is kept current (skill ig-build-pipeline §"The AST cache lifecycle").
THE RULE. An IG site is built from the IG Publisher AST read from the IG repository's cache branch cat/fhir-harness/fhir-ast/<package id>, never from Publisher HTML. The publish refuses an AST that is not valid for the commit it publishes (ig-cache.sh restore then verify). A later commit that changes no IG input (sushi-config.yaml, ig.ini, input/) does not make the AST stale.
THE REFRESH. The cache is written by ONE thing: fhir-harness's reusable workflow .github/workflows/ig-ast-refresh.yml, which an IG repository's Site publish calls as its first job (ast; template templates/ig-repo-site/site-publish.yml). It runs the Publisher through the AST exporter on a GitHub runner (Java, 10 GB heap, tx.fhir.org). It seeds the branch only from a commit on the default branch whose inputs equal the tip's.
A valid AST is a cache, not a release: every page drawn from it carries the provisional mark (ig-ast-delta). |
| enforcement | advisory |
| sourcePath | processes/content/ig-ast-cache.bpmn |
| sourceUrl | https://github.com/litlfred/fhir-harness/blob/main/processes/content/ig-ast-cache.bpmn |
| depiction | https://litlfred.github.io/folio-assistant/assets/img/workflows/ig-ast-cache.svg |
| startNode | IG site publish wanted https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Start_Publish |
| nodeCount | 11 |
| flowCount | 11 |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | IG site publish wanted https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Start_Publish |
| to | Restore and judge the cached AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | Restore and judge the cached AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore |
| to | AST valid for this commit? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| name | yes |
|---|---|
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
| from | AST valid for this commit? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid |
| to | Build and publish the site from the AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_BuildSite |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| name | no — refused: stale, cannot tell, miss |
|---|---|
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
| from | AST valid for this commit? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Valid |
| to | Dispatch AST refresh https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Dispatch |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | Build and publish the site from the AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_BuildSite |
| to | Review the site's size https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_SizeReview |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | Review the site's size https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_SizeReview |
| to | Site published from the AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/End_Published |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | Dispatch AST refresh https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Dispatch |
| to | Build the IG with the AST exporter https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Export |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
|---|---|
| from | Build the IG with the AST exporter https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Export |
| to | On the default branch, with its inputs? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| name | yes |
|---|---|
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
| from | On the default branch, with its inputs? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable |
| to | Seed the cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Seed |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| name | publish again |
|---|---|
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
| from | Seed the cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Seed |
| to | Restore and judge the cached AST https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/Task_Restore |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| name | no |
|---|---|
| partOf | An IG site, built from the AST on its cache branch https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache |
| from | On the default branch, with its inputs? https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/GW_Seedable |
| to | AST kept as a run artifact; cache unchanged https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgAstCache/node/End_NotSeeded |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |