diff options
| author | Daniel J Walsh <dwalsh@redhat.com> | 2018-12-24 08:42:40 -0500 |
|---|---|---|
| committer | Daniel J Walsh <dwalsh@redhat.com> | 2018-12-30 08:08:13 -0500 |
| commit | ad36345fde0913a098b64d0c628f562134d1675b (patch) | |
| tree | e87a117fa185f8d7402cbecc06dfbeb75320c7b9 /docs | |
| parent | 1aa55edda50df507c7fa8a2a50b67d7fd65a4ef5 (diff) | |
| download | podman-ad36345fde0913a098b64d0c628f562134d1675b.tar.gz podman-ad36345fde0913a098b64d0c628f562134d1675b.tar.bz2 podman-ad36345fde0913a098b64d0c628f562134d1675b.zip | |
Add troubleshooting for sparse files
A common failure with people building container images is the
creation of large sparse files, particularly useradd creating
the lastlog file.
This PR Documents the failures.
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/podman-build.1.md | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/docs/podman-build.1.md b/docs/podman-build.1.md index f887d68cd..76e16b42c 100644 --- a/docs/podman-build.1.md +++ b/docs/podman-build.1.md @@ -614,8 +614,16 @@ $ podman build -f dev/Dockerfile https://10.10.10.1/podman/context.tar.gz registries.conf is the configuration file which specifies which container registries should be consulted when completing image names which do not include a registry or domain portion. +## Troubleshooting + +If you are using a useradd command within a Dockerfile with a large UID/GID, it will create a large sparse file `/var/log/lastlog`. This can cause the build to hang forever. Go language does not support sparse files correctly, which can lead to some huge files being created in your container image. + +### Solution + +If you are using `useradd` within your build script, you should pass the `--no-log-init or -l` option to the `useradd` command. This option tells useradd to stop creating the lastlog file. + ## SEE ALSO -podman(1), buildah(1), containers-registries.conf(5) +podman(1), buildah(1), containers-registries.conf(5), useradd(8) ## HISTORY May 2018, Minor revisions added by Joe Doss <joe@solidadmin.com> |