DEV Community: Sven Hoffmann

Automate Building & Pushing Docker Containers Using GitHub Actions

Sven Hoffmann — Thu, 20 Jun 2019 13:32:45 +0000

Welcome to my second article! It took a while, but I hope you will enjoy this one.

You might think, "Docker containers? What are those?" My apologies, but I won't explain what containers are in this article. That said, I was thinking about writing a beginner friendly series about containers and serverless computing. So if you would be interested in such a thing, please let me know!

Today I'm gonna walk you through on how to automatically build and push containers defined in your GitHub repository to your Docker Hub account using GitHub Actions.

Using this method, you can keep your Docker Hub images in sync with your repository. Every time you push to the repository, the container will be built and pushed to the Docker Hub.

Let's bake a cake

To make this all a bit easier to follow, we're going to pretend we are reading a recipe. I will first list all the ingredients (requirements) and then I will explain the process using more detailed steps.

Ingredients

(Also known as requirements.)

You will need:

A GitHub account that has access to GitHub Actions (you can request access here)
A repository that has access to GitHub Actions
A valid Dockerfile in your repository
A Docker Hub account

Let's automate!

Got all the ingredients? Awesome!
Let's use GitHub Actions to automate building and pushing your container to Docker Hub.

First, navigate to your repository and click on Actions at the top.
You'll end up in an interface similar to this one. Create a new workflow file.

We'll create a workflow that runs when someone pushes something to the repository.

Drag the blue connector down and add the 'Docker Registry' action.

This action will log you in to the Docker Hub using the DOCKER_USERNAME and DOCKER_PASSWORD secrets. Add your username and password as a secret. Be careful! Don't add them as an environment variable, otherwise they will be visible!

Next up, add another action below the 'Docker Registry' action. This time we will use the 'GitHub Actions for Docker' action. Using this action you are able to run Docker commands like you would in your terminal.
The command you want to run needs to go into the args field. The action will automatically put docker in front of your command, so make sure you don't.

Let's pretend we would build and push our container in the terminal for a second.

Before we are able to push the container we need to build it first. To do this we would use the command docker build -t [username]/[container name] [path to Dockerfile]
For my example repository this would be: docker run build -t svenzo/actions-docker-hub-demo src. If your Dockerfile is in the root of the repository, you can put a . (dot) instead of the folder path.

The second command we would run is the push command: docker push [username]/[container name]. Once again, for my example repository this will be as follows: docker push svenzo/actions-docker-hub-demo.

To make these commands work in the args field we need to remove the first docker in front of the command, and combine both commands using &&. You will end up with something like this: build -t [username]/[container name] [path to Dockerfile] && docker push [username]/[container name].
For my example repository this will be: build -t svenzo/actions-docker-hub-demo src && docker push svenzo/actions-docker-hub-demo.

Finally, commit the workflow file using the menu at the top right.

If you wait a few seconds and navigate to the Actions tab, you will see your actions running. If everything goes well, the container in your repository will be pushed to your Docker Hub account. If something went wrong, you will be able to look into the logs to check what went wrong.

You can navigate to your Docker Hub account and see the container image GitHub Actions pushed for you.

Final thoughts

Hey, did you enjoy reading this article? I hope you found this tutorial useful. Please let me know what you think in the comments. Additionally, I was thinking on writing a beginner friendly series of articles on the subject of 'containers and serverless'. Would you be interested? Please let me know as well!

Anyways, here's a song you might like.

See you soon, and take care ✌
~ Sven

Attribution

Banner image background by Kyle Ryan on Unsplash
GitHub icon made by Icomoon from Flaticon
Docker icon made by Icons8

Thanks for reading! Leave a like ❤ or a comment 🖊 if you want to. And most importantly; don't give up if GitHub Actions isn't working like you'd want to!

Why I Struggled with Creating an Account Here and Why I Did It

Sven Hoffmann — Thu, 07 Feb 2019 23:08:37 +0000

Today I'll be telling you the story of my struggles with creating an account here. 'What struggles', you ask? Well... let me tell you.

The technical struggle

Chapter 1: Commuting

When I found out a friend posted some pretty cool posts on this site I thought; 'Wow! I want to like those posts to support them!'.

I was on my mobile device at the time, commuting home. So I went to 'dev.to' on my mobile device and pressed the 'Log in via GitHub' button.

And..!

Nothing happened.
I was unable to log in via GitHub.

The 'Log in via Twitter' button did work, by the way. But at the time I didn't know you could log in using both methods. Since I don't use Twitter often I'd rather log in with GitHub.

'It must be because of my mobile browser', I thought, 'let's try again at home'.

Chapter 2: At home

So at home, I tried again. With multiple browsers. Without any success.

I was lost.
I wasn't sure what to do.
And I just wanted to like some posts. ❤

Without any motivation left, I went to bed.

The following day I was still kinda bummed out I couldn't create an account. But I was determined again. I was gonna like those posts!

So I logged in using Twitter.
And it worked!

And I was happy. On the other hand, I was still kind of frustrated the GitHub login button didn't work. At all.

Satisfied after liking those posts I wanted to like, I went and explored the site some more.

This is when I saw it.
I saw the solution.

Chapter 3: The solution (kind of)

In the settings screen, I saw that you could link your GitHub account as well. And... this button actually worked!

I was happy. This way, I could log in using both methods!

To this day I still wonder why the 'Log in using GitHub' button is broken for signing up. Am I the only one facing this problem?

The personal struggle

I had a personal struggle with creating an account as well.

Committing

No, not the git kind. I was scared that if I made an account here, I'd have to commit to commenting and writing all the time. And that can be quite scary! It's not always easy either, with English being my second language. Then again, the best way to practice is just to get out there and get feedback. So, I did. And now we're here.

But I made it

In the end, I did create a profile! And if everything goes well, this will be my first post. I hope I can share some of my knowledge with you all, or at least entertain you with my posts. 😃

Being part of a community

One of the big reasons I went through all that trouble to create an account is that I don't feel like I'm part of the 'developer community' at times. This is not true of course, but perhaps if I partake more in the community it will feel less alien to me. Being a lurker is fine, but I hope this helps to ground me.

A friend inspired me

A friend of mine has an account here as well. I saw that they posted some awesome articles! I wondered if I could share some of my experiences as well.
I realised the only way I'd find out is by just diving straight in and trying it out myself.

My story

That's my story so far. What's yours? I'd love to know your reasons for signing up. Did you have any struggles as well? Or did you find it easy to start? Let me know!

Anyways, here's a song you might like.

See you soon, and take care ✌
~ Sven

Attribution

Cactus picture by Scott Webb on Unsplash
Sunrise picture by OC Gonzalez on Unsplash
Shout out to @maniflames for being awesome.

Thanks for reading! Leave a like ❤ or a comment 🖊 if you want to. And most importantly; don't give up if creating an account doesn't work!