Deploy With Docker Compose

Are you tired of hearing how "simple" it is to deploy apps with Docker Compose, because your experience is more one of frustration? Have you read countless blog posts and forum threads that promised to teach you how to deploy apps with Docker Compose, only for one or more essential steps to be missing, outdated, or broken?

Some years back, I was in exactly this position. In my quest to deploy apps that I'd developed locally with Docker Compose, I’d read the documentation along with countless blog posts, yet was left more frustrated than anything else.

So, I decided to sit down and figure out the simplest approach to deploying apps with Docker Compose and then to document my findings. This free book is the result of what I learned.

Please correct the following error(s):
  • {{ error }}

I'll email you with tips, tricks, and things worth knowing about Docker and the wider Docker ecosystem. You can unsubscribe at any time. Here's the privacy policy.

Why Get The Book?

I can think of a number of reasons to get the book, but here are some of the best:

  • You don’t want to spend the countless hours — or have them to spare — that I spent, working out the essentials of deploying applications with Docker Compose yourself.
  • You're keen to build your application and get it deployed, as you, like so many other developers, have a constant stream of requests for new features, and for fixes to existing features that you need to get finished.
  • You don’t see yourself as a DevOps person, so you’d prefer to stick to what you know.
  • You like to know the essentials of deploying with Docker Compose and the related commands and files, so that you’re not completely dependent on your DevOps team or sys admins.

But more specifically, here’s why you should get the book, because you want:

  • To learn a logical and intuitive, 6-step process you can use to deploy your applications to production; a process that is repeatable and applicable to a broad range of applications.
  • To know the commands and files involved, so that you can learn about the myriad of others at some time in the future.
  • A deployment process that you can test before you use it to deploy to production.
  • A solid and practical foundation of how to deploy with Docker Compose, that you can learn and apply quickly, yet you can build on, as and when you need to later on.
  • To learn some extra knowledge about developing with Docker Compose, such as how to run your unit tests and debug your applications when their running inside containers, regardless of whether those containers are running on a local or remote host.
  • And quite a bit more…

What You'll Learn

1. The Essential Terminology

Before you dive into creating a local development environment using Docker Compose, you'll learn some essential terminology that you need to be aware of, terms such as Image, Container, and Registry.

2. How to Install Docker Compose

Now that you know some of the key terminology, it's time to install Docker Compose and the related tools that you'll need to follow along with the book. In this chapter, you'll learn how to do that on the three major operating systems: Linux, macOS, and Microsoft Windows.

3. How to Build a Local Development Environment using Docker Compose

In this chapter, you're going to get your hands dirty with Docker Compose by learning how to build a development environment which serves as the basis for production (or any other environment).

You're going to learn the essentials of Dockerfiles and Docker Compose files (docker-compose.yml) to build a 3-service configuration that can run an application on your local development machine. On top of that, you're going to learn the essential Docker and Docker Compose commands for starting and stopping containers and testing that they're running properly.

4. How to Perform Basic Docker Compose Debugging

Now that you've learned how to create a basic setup with Docker Compose, you're going to learn how to do basic container debugging. If things go wrong, you need to know how to figure out what’s going wrong and why.

With that knowledge, you can either fix the problem or ask someone for help if you’re unable to fix it on your own. So in this chapter, you're going to learn the docker commands to debug containers.

5. How to Run Tests and Debug Apps When They're Run Using Docker Compose

Docker and Docker Compose make it pretty trivial to build local development environments. But what about running tests and debugging applications running inside containers, versus on your local development machine?

How do you run unit, functional, acceptance, and other types of tests when the code and runtime are inside Docker containers, not on your local machine? How do you do step-through debugging?

In this chapter, I'll show you how to augment the configuration which we've built so far, to do both. Specifically, I'll show you how to run tests using PHPUnit and Codeception and to do step-through debugging using PhpStorm. In future editions of the book, I may expand this chapter to include other languages, such as Java or Python.

6. How to Deploy Apps to Production Using Docker Compose and a Handful of Docker Commands

In the final chapter of the book, you'll learn how to build Dockerfiles and Docker Compose files to deploy applications to a remote environment. You'll also learn some of the things that you need to consider when deploying containers to remote environments, versus on your local development machine.

You’ll also learn about building, tagging, and pushing Docker images to image registries, and how to create Docker contexts so that you can work with multiple remote Docker daemons. It won't make you a DevOps guru or Systems Administrator — but you'll be that much less reliant on them!

FAQ

Why is the book free?

It might seem a little too good to be true, that a professional book on Docker is free. But, I can assure you that it is, and that there is nothing shady going on. The book is free for several reasons:

  • I use Docker on a regular basis and have gained so much by doing so.
  • I see many others struggling as I did, when I first started using Docker. I want to help them avoid the mistakes that I made and come up to speed with Docker quicker and easier than I did. Consequently, I see a huge need for a book like this and believe that they will help become as comfortable using Docker as I am.
  • I want to give back to the community that helped me learn Docker over the last number of years.
  • Finally, the book is a thank you to everyone who has bought my books or taken my premium courses.

While I've spent over 200 hours on Deploy With Docker Compose so far, enough people enjoy my teaching style and continue learning with one of my books or premium courses. So, it all works out for all of us in the end!

That said, you can support the project, if you'd like; I'd be very grateful if you do.

Do I get future updates of the book?

It might seem a little too good to be true, that a professional book on Docker is free. But, I can assure you that it is, and that there is nothing shady going on. The book is free for several reasons:

What version of Docker Engine and Docker Compose was the book written for?

It was written around Docker Engine 20.10.11.

What format does the book come in?

Currently, the book is only available in PDF. However, I'm planning to make it available in ePub as well in the next few months. And, don't worry, there's no DRM to worry about. The book comes DRM free.

I've lost my download link. What do I do?

Email me at matthew@matthewsetter.com, with your details, and I'll get that fixed up for you.

Who's the Author?

Hi, I'm Matthew Setter. I've been developing web-based applications since 1996 and developing with PHP since version 3 — way back in 1999 before it even had OOP support. I've been involved in building all kinds of PHP-based applications in Australia, the United Kingdom, and Germany. I'm also a PHP editor in the Twilio Voices team.

I regularly share what I know and am continuing to learn about PHP and web development more broadly on my blog. I'm also the author of Mezzio Essentials, and Mezzio: Getting Started.

Photo of Matthew Setter (@settermjd), author of Mezzio Essentials