Viewing as everyone topics and scenes not meant for you are faded or hidden

pkgproxy map

How pkgproxy caches packages for apt, snapd, Go, Docker and LXD, one narrated deck per topic. Pick any place, follow the roads at the end of each deck, and switch perspective at the top to see what applies to you. The written documentation is at zygoon.pl/pkgproxy; to run pkgproxy in GitHub Actions jobs, see setup-pkgproxy.

Journeys

Learning paths through several decks, in order. Pick one to see its route on the map.

START HERE CORE · the path every proxy engine shares APT SNAP GO MODULES DOCKER LXD FILES SETUP AND THE COMMAND LINE RUNNING PKGPROXY OPERATIONS INSIDE PKGPROXY · for contributors Why pkgproxyone cache for every client⚑ A requestclient to cache and back⚑ One listenerTCP or socket · dispatch⚑ Fetch oncefills · joining requests⚑ The storekeys · commit · forever⚑ Immutable or notforever or revalidated⚑ Stalled upstreamsidle, not total, time⚑ Offline modeserve what is cached⚑ A forward proxyAcquire::http::Proxy⚑ Cache keysarchive id · hash checks⚑ pool and distsforever · rechecked⚑ HTTPS sourcesa blind CONNECT tunnel⚑ Snap Store relaysnaps · assertions⚑ Go module proxyGOPROXY · sumdb⚑ Registry mirrorDocker Hub images⚑ LXD imagessimplestreams mirrors⚑ Build containerssnapcraft · rockcraft⚑ Files by checksumcloud images · https too⚑ pkgproxyctl setupone client at a time⚑ pkgproxyctlstats · cache · offline⚑ The setup pagefor remote machines⚑ In a containerthe OCI image · docker⚑ On Kubernetesthe charm · the rock⚑ Juju machinesthe charm · the snap⚑ Settingsflags · env · snap set⚑ Statisticsstats API · cache page⚑ The cache pagelive map · dashboard⚑ The access logone line · one outcome⚑ pkgproxy for CIrunners · VMs · containers⚑ Hosted CI runnersGitHub · GitLab.com · in the job⚑ Upstream statusbanner · pages · checks⚑ Two tiersupstream-pkgproxy⚑ The source treepackages · conventions⚑ A request in codegateway · transport⚑ internal/filltable · tailing · users⚑ Store and keysinterface · keys · index⚑ The proxy engines' packagesgomod · revalidate⚑ Cache page codecacheusage · events⚑ Translationserrors · guides · logs⚑ How it is testedunit · synctest · spread⚑
point at a topic to read what it covers · ⚑ visited 0 of 0 · dashed: no slides yet · audience: users administrators CI operators contributors

Click a place to enter it. Inside a topic you see only its exits; m brings the whole map back. space plays, ← → step.

All 40 decks as a list (readable without JavaScript)

START HERE

CORE · the path every proxy engine shares

APT

SNAP

GO MODULES

DOCKER

LXD

FILES

SETUP AND THE COMMAND LINE

RUNNING PKGPROXY

OPERATIONS

INSIDE PKGPROXY · for contributors

1 / 1

Roads from here