Inspecting your container build results

In previous chapters, we discussed in detail the container build process and learned how to create custom images using Dockerfiles/Containerfiles or Buildah-native commands. We also illustrated how the second approach helps achieve a greater degree of control of the build workflow.

This section helps provide some best practices to inspect the build results and understand potentially related issues.

Troubleshooting builds from Dockerfiles

When using Podman or Buildah to run a build based on a Dockerfile/Containerfile, the build process prints all the instructions' outputs and related errors on the terminal stdout. For all RUN instructions, errors generated from the executed commands are propagated and printed for debugging purposes.

Let's now try to test some potential build issues. This is not an exhaustive list of errors; the purpose is to provide a method to analyze the root cause.

The first example shows a minimal...