apptainer / apptainer-admindocs

Other
2 stars 15 forks source link

Show how to use apptainer from the lima host #141

Closed afbjorklund closed 11 months ago

afbjorklund commented 11 months ago

Description of the Pull Request (PR):

While it is possible to shell into the virtual machine, it is also possible to call apptainer.lima on the host.

This makes it easier to interact with the local files, and to copy the resulting SIF files to another location.

While Lima commands are shown for the Mac, they also work the same way on a host running Linux.

You can use brew to install it also on Linux, or you can use the package manager to install limactl...

This fixes or addresses the following GitHub issues:

Follow up to PR:

afbjorklund commented 11 months ago

If we wanted to make the Lima installation more like the previous Vagrant installation, we could mention some more details. Like for instance what operating system is used, or the commands used to install the Apptainer software?

1) Ubuntu 22.04 LTS

2) apt (Apptainer PPA)

Perhaps also mention how to increase the size of the virtual machine, by default it is using 4 vCPU and 4 GiB RAM. And a 100 GiB disk image which is created small and grows automatically, and probably should be enough for most users.

EDIT: Documented here: https://github.com/lima-vm/lima/blob/master/examples/default.yaml

# CPUs
# 🟢 Builtin default: min(4, host CPU cores)
cpus: null

# Memory size
# 🟢 Builtin default: min("4GiB", half of host memory)
memory: null

# Disk size
# 🟢 Builtin default: "100GiB"
disk: null
afbjorklund commented 11 months ago

It would probably be a good idea to keep the installation page focused on installation (only).

https://apptainer.org/docs/admin/main/installation.html

And then add a Lima version of the rest of the use documentation page, with the commands:

https://apptainer.org/docs/user/main/quick_start.html


So will remove the details from this PR, and make another PR to another repository nearby :-)

https://github.com/apptainer/apptainer-userdocs

EDIT: Opened a new PR, without the "how to access from host" but with the details mentioned: