niko
bd6ed5c2c2
CI Gitea Reports Main / Config load (push) Successful in 17s
CI Main / Config load (push) Successful in 20s
CI Gitea Reports Main / Latest version (push) Successful in 17s
CI Main / Latest versio (push) Successful in 19s
ci-helm-build-push Helm push 0.2.0
CI Gitea Reports Main / Build & Push Helm chart (push) Successful in 33s
gitops/gitea-ci-library/gitea-reports GitOps: gitea-reports 0.2.0
CI Gitea Reports Main / GitOps (push) Successful in 33s
CI Gitea Reports Main / Report Summary (push) Successful in 3s
CI Main / Bats tests (push) Failing after 1m16s
CI Main / Cucumber tests (push) Failing after 1m22s
CI Main / Build & Push Docker (push) Has been skipped
CI Main / GitOps (push) Has been skipped
CI Main / Move provider version tag (push) Has been skipped
CI Main / Report Summary (push) Successful in 3s
Co-authored-by: moilanik <niko.moilanen@tietoevry.com> Reviewed-on: #48
44 lines
1.5 KiB
Markdown
44 lines
1.5 KiB
Markdown
# Implementation Notes
|
|
|
|
Teknisiä huomioita git-pages 0.9.1:n käyttäytymisestä, joita ei ole ilmeistä
|
|
dokumentaatiosta.
|
|
|
|
## Storage v2 (Protobuf manifest)
|
|
|
|
Git-pages 0.9.1 käyttää v2-arkkitehtuuria. Kaikki sisältö on pakattu
|
|
Protobuf-manifestiin (`site/{host}/.index`), ei flat-FS:nä. Tästä seuraa:
|
|
|
|
- Tiedostoja ei voi etsiä tai poistaa `find`/`rm`-komennoilla
|
|
- `.git-pages/manifest.json` listaa kaikki tiedostot (ProtoJSON)
|
|
- `.git-pages/archive.tar` antaa koko sisällön (saattaa truncata HTTP/2:ssa)
|
|
|
|
## Host-header
|
|
|
|
Git-pages valitsee sivuston Host-headerin perusteella. Ilman oikeaa Hostia
|
|
palauttaa 404.
|
|
|
|
- Ulkoiset requestit: Traefik välittää alkuperäisen Hostin automaattisesti
|
|
- Sidecar/localhost: `-H "Host: ci-reports.helm-dev.keskikuja.site"`
|
|
|
|
## PATCH ja directory-entryt
|
|
|
|
Jos PATCH-tar sisältää directory-entryn (tyyppi directory, tar typeflag '5'),
|
|
se **korvaa** koko hakemiston dokumentaation mukaan. Tar saa sisältää vain
|
|
file- ja symlink-entryjä, jotta PATCH toimii odotetusti.
|
|
|
|
## Whiteout — tiedostojen poisto
|
|
|
|
Ainoa tapa poistaa tiedostoja ilman koko sivuston PUT-korvausta:
|
|
|
|
- Tarissa character device entry (`CHRTYPE`, tar typeflag '4')
|
|
- `devmajor=0`, `devminor=0`
|
|
- PATCH:ataan sivuston juureen
|
|
|
|
## .init — ensimmäinen julkaisu
|
|
|
|
Ensimmäinen julkaisu vaatii PUTin, joka luo `.index`-tiedoston. Tämän jälkeen
|
|
PATCH riittää.
|
|
|
|
Helm-chartin post-install -job hoitaa tämän automaattisesti:
|
|
consumerien publish-scriptien ei tarvitse tuntea asennuksen tilaa.
|