podbag Blog

Releases, engineering notes, benchmarks and hands-on training from the people who build podbag.

Podbag Training · Manage a volume with the CLI and GUI

by The podbag team · on in TrainingPermalink

Create a volume in the CLI, inspect and remove it in Podbag Desktop, and watch your progress update.

Download the lab module

What is a volume?

A volume stores files separately from a container. Here, app-a saves note.txt in the my-api volume. After app-a is removed, a new container, app-b, mounts the same volume and reads the file. Deleting the volume itself removes its files.

Install the module

Use a compatible build of Desktop and the CLI. Select Install module at the top of Training, choose the downloaded file, and confirm. You can also run this command from your download folder.

Terminal
podbag lab install cli-gui-volumes.podbag

Follow your progress in Desktop

Expand Training in the sidebar and select the installed volume module. The module shows completed, current, and pending steps. Select Open web guide to return to this page.

Start the practice session

Copy the command from the current step and run it in your terminal. Keep this page open and continue when the terminal shows volume-lab $.

Terminal
podbag lab start volume-basics
The volume module shows the start command and the practice steps

Create a volume in the CLI

Type this command at the volume-lab prompt.

Terminal
podbag volume create my-api
podbag volume ls
podbag volume ls · my-api

Inspect it in the GUI

After a volume appears, Training shows the GUI inspection task in progress.

Practice volumes · my-api

In Practice volumes, select my-api to inspect its name and storage path.

my-api · Mountpoint

Delete it in the GUI

Select Remove for my-api. Check the name in the dialog and confirm.

Delete it in the GUI · my-api

After deletion the list is empty. Return to the same practice shell.

Empty Practice volumes list after deletion

Verify removal in the CLI

List the volumes again in the practice shell.

Terminal
podbag volume ls
End the session · In progress

End the session

When the shell reports Verified, type exit to clean up the temporary store. Training marks the module complete.

Terminal
exit
Verified · exit
Training marks the volume module complete

Uninstall the module

Run this command outside the practice shell to remove the module and its completion record. You can reinstall the downloaded file.

Terminal
podbag lab remove volume-basics
Uninstall the module · Module removed.