containers...-apply-diff(1)

📦
version 1.63.0 · 3 versions
, in ubuntu resolute, ubuntu stonking

✨ containers-storage-apply-diff — the manual page ✨

okay so bestie, welcome to the containers...-apply-diff(1) page, from the General Commands Manual section 🎀 buckle up, it's short but it's important.

💖 NAME 💖

containers-storage-apply-diff — literally just: apply a layer diff to a layer. that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

containers-storage apply-diff [options [...]] layerNameOrID
[referenceLayerNameOrID]

so you're giving it a layer (by name or ID, queen's choice 👑), and optionally a reference layer too. options go wherever, we're flexible. 💅

✨ DESCRIPTION ✨

okay so picture this: when a layer is first created, it contains no changes relative to its parent layer. blank slate. clean girl aesthetic. 🌈

so how do you get stuff into it? two ways, bestie:

  • mount the layer read-write and modify its contents directly, or
  • add (or remove) contents by applying a layer diff.

and what even is a layer diff, you ask? it's a (possibly compressed) tar archive with extra information living in its headers. you can make one by running containers-storage diff or something equivalent. that's it, that's the girl. 🍓

lowkey important: layer diffs are not typically applied manually. more often they get applied by a tool that's importing an entire image — like skopeo. so if you're out here hand-applying diffs, you're kinda doing the most 🙈 (which, honestly? respect.)

💅 OPTIONS 💅

  • -f, --file filename — tells it the name of the file the diff should be read from. and if you don't use this option? it reads the diff from standard input. stdin girlies rise up 🫶

🔥 EXAMPLE 🔥

here's the moment, the icon, the legend:

containers-storage apply-diff -f 71841c97e320d6cde.tar.gz layer1

that's it. that's the whole thing. ate. 💖

👑 SEE ALSO 👑

go read your sisters, they're all iconic:

and that's the page, bestie!! 🌟 this was containers...-apply-diff(1) (general commands manual energy, we love her) and it's dated August 2016 — vintage but still serving. go apply some diffs, stay hydrated, and remember: when in doubt, it's probably skopeo doing it for you 💜✨🧚

📦 where this page comes from