. With the rise of Docker came a new focus for engineers: optimizing the build to reach the smallest image size possible A couple of options are available: : A can consist of multiple steps, each having a different Docker base image. Each step can copy files from any of the previous build steps. Only the last one will receive a tag; the others will be left untagged. Multi-stage builds Dockerfile This approach separates one or more build steps and a run step. On the JVM, it means that the first step includes compiling and packaging, based on a JDK, and the second step comprises running, based on a JRE. : The smaller the base image, the smaller the resulting image. Choosing the smallest base image size In this post, I'm going to focus on the second point - choosing the smallest base image size. Minimal base images Three approaches are available for base images: From Scratch You can use Docker’s reserved, minimal image, , as a starting point for building containers. Using the "image" signals to the build process that you want the next command in the to be the first filesystem layer in your image. scratch scratch Dockerfile While appears in Docker’s repository on the hub, you can’t pull it, run it, or tag any image with the name . Instead, you can refer to it in your . For example, to create a minimal container using scratch: scratch scratch Dockerfile -- Create a simple parent image using scratch FROM scratch
COPY hello /
CMD ["/hello"] is the smallest possible parent image. It works well if the final image is independent of any system tool. scratch Apline Alpine Linux is a tiny distribution based on , , and . It's designed to be secure small. For example, the 3.17 Docker image is only 3.22 MB. musl BusyBox OpenRC and On the flip side, I already encountered issues because of Alpine's usage of instead of the more widespread . Just last week, I heard about , which is meant to solve this exact issue. The tag is 8.4 MB. It's twice bigger as Alpine but is still very respectable compared to regular Linux distros, , Red Hat's 75.41 MB. musl glibc Alpaquita Linux stream-glibc-230404 e.g. Distroless Last but far from least comes Distroless. Since this post focuses on Distroless, I'll dive into it in a dedicated section. Distroless I first learned about Distroless because it was the default option in 's . Jib is a Maven plugin to create Docker containers without dependency on Docker. Note that the default has changed now. Google Jib Distroless has its own GitHub project: "Distroless" images contain only your application and its runtime dependencies. They do not contain package managers, shells or any other programs you would expect to find in a standard Linux distribution. [...] Restricting what's in your runtime container to precisely what's necessary for your app is a best practice employed by Google and other tech giants that have used containers in production for many years. It improves the signal to noise of scanners (e.g. CVE) and reduces the burden of establishing provenance to just what you need. -- "Distroless" Container Images The statement above hints at what Distroless is and why you should use it. Just like , Distroless is a misleading term. The most important fact is that Distroless provides neither a package manager nor a . For this reason, the size of a Distroless image is limited. Serverless shell Also, Distroless images are considered more secure: the attack surface is reduced compared to other regular images, and they lack package managers and shells - common attack vectors. Note that some articles this benefit. dispute Distroless images come with four standardized tags: latest : the image doesn't run as , so it's more secure nonroot root : the image contains a shell for debugging purposes debug debug-nonroot Distroless debugging I love the idea of Distroless, but it has a big issue. Something happens during development and sometimes during production, and one needs to log into the container to understand the problem. In general, one uses or to run a shell: it's then possible to run commands from inside the running container. However, Distroless images don't offer a shell . Hence, one needs to run every command from outside; it could be a better developer experience. docker exec kubect exec interactively by design During development, one can switch the base image to a one. Then, you rebuild and run again, and then solve the problem. Yet, you must remember to roll back to the non- base image. The more issues you encounter, the more chances you'll finally ship a image to production. debug debug debug Worse, you cannot do the same trick in production at all. Kubernetes to the rescue At the latest JavaLand conference, I attended a talk by my good friend . In the talk, he made me aware of the command, introduced in Kubernetes 1.25: Matthias Häussler kubectl debug Ephemeral containers are useful for interactive troubleshooting when is insufficient because a container has crashed or a container image doesn't include debugging utilities, such as with distroless images. kubectl exec You can use the debug command to add ephemeral containers to a running Pod. kubectl -- Debugging with an ephemeral debug container Let's see how it works by running a Distroless container: kubectl run node --image=gcr.io/distroless/nodejs18-debian11:latest --command -- /nodejs/bin/node -e "while(true) { console.log('hello') }" The container starts an infinite loop. We can check the logs with the expected results: NodeJS kubectl logs node hello
hello
hello
hello Imagine that we need to check what is happening inside the container. kubectl exec -it node -- sh Because the container has no shell, the following error happens: OCI runtime exec failed: exec failed: unable to start container process: exec: "sh": executable file not found in $PATH: unknown
command terminated with exit code 126 We can use use magic to achieve it anyway: kubectl debug kubectl debug -it \
              --image=bash \      #1
              --target=node \     #2
              node                #3 Image to attach. As we want a shell, we are using bash Name of the container to attach to For some reason I don't understand, we must repeat it The result is precisely what we expect: Targeting container "node". If you don't see processes from this container it may be because the container runtime doesn't support this feature.
Defaulting debug container name to debugger-tkkdf.
If you don't see a command prompt, try pressing enter.
bash-5.2# We can now use the shell to type whatever command we want: ps The result confirms that we "share" the same container: PID   USER     TIME  COMMAND
    1 root     12:18 /nodejs/bin/node -e while(true) { console.log('hello') }
   27 root      0:00 bash
   33 root      0:00 ps After we finish the session, we can reattach it to the container by following the instructions: bash-5.2# Session ended, the ephemeral container will not be restarted but may be reattached using 'kubectl attach node -c debugger-tkkdf -i -t' if it is still running Conclusion Distroless images are an exciting solution to reduce your image's size and improve its security. They achieve these advantages by providing neither a package manager nor a shell. The lack of a shell is a huge issue when one needs to debug what happens inside a container. The new command offers a clean way to fix this issue by attaching an external container that shares the same context as the original one. Danke nochmal dafür, Matthias ! kubectl debug Originally published at on April 16th, 2023 A Java Geek

Leveraging the Richness of HTTP Status Codes

Grow Your Audience With Rel=canonical

Read all my posts!

Mastering Distroless: A Guide to Building Secure and Efficient Docker Images

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

10 Essential Java Libraries - How Essential Are They Really?

The Noonification: Go and Protocol Buffers (Quick Tutorial) (10/15/2023)

3 Tips for Effective Kubernetes Application Troubleshooting

3 Top Tools for Implementing Kubernetes Observability

53 Stories To Learn About Containerization

A Beginner's Guide to AWS Containers - Part 1

10 Essential Java Libraries - How Essential Are They Really?

The Noonification: Go and Protocol Buffers (Quick Tutorial) (10/15/2023)

3 Tips for Effective Kubernetes Application Troubleshooting

3 Top Tools for Implementing Kubernetes Observability

53 Stories To Learn About Containerization

A Beginner's Guide to AWS Containers - Part 1

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps