export commands still outdated
olifre opened this issue · comments
The export commands (now named image.export
) are still outdated.
For example, in:
http://singularity.lbl.gov/docs-export
I find that the recommended way to compress images would be:
singularity export container.img | gzip -9 > container.img.gz
Apart from the fact that "export" is not even a supported command anymore (and I think the Release Notes did not even mention the rename? That's ugly, that's a backwards incompatible change, please announce that!), if I run:
singularity image.export container.img | gzip -9 > container.img.gz
on a SquashFS-container the result will commonly be a larger container.img.gz file, which is then also actually a "tar.gz" file.
hey @olifre ! I updated the docs to specify image.export, and you are right about the larger file! I'll add a note that this command is typically intended for the older format.
Is this fix suitable? If you have a suggestion for a better description, definitely go for it!
Is this fix suitable? If you have a suggestion for a better description, definitely go for it!
I believe it's good!
I think I would still change the last command, though, to read:
singularity image.export container.img | gzip -9 > container.img.tar.gz
to clarify that the resulting file actually is a compressed tarball (maybe the drop the .img
part also for that, but that's a matter of taste).
done! Should render in 30 seconds to a minute. Depending on if the Github robots are having an afternoon snack.
@olifre if this looks ok now feel free to close the issue.
Yep, let's close that :-)