Casual Developers Notes

初級・中級のエンジニアやデザイナー向けに技術情報と英語学習情報を提供中。エンジニアもデザイナーも技術と英語を身に着けて海外に飛び立とう！

You are here: Home / 技術 Tips & Tutorials / GitHubとDockerHubを連携してDockerイメージを自動ビルドする方法(Automated Build)

By Leave a Comment

GitHubとDockerHubを連携してDockerイメージを自動ビルドする方法(Automated Build)

GitHubとDockerHubを連携してDockerイメージを自動ビルドする方法(Automated Build)

Dockerを使ったアプリケーションが商用でも使われている昨今において、Dockerイメージを簡単に自動ビルドしたいという需要は高いです。さまざまなCIツール上からでもできるのですが、今回はDockerHubが提供しているAutomated Buildで実現する方法を紹介します。

はじめに

DockerHubにはAutomated Buildという機能があります。この機能を利用することで、GitHub上のリポジトリにPushするだけで、Dockerイメージを自動的にビルドすることができます。

それでは、やっていきましょう。

DockerHubでAutomated Buildを設定する

前提

  • GitHubのアカウントが作成してある
  • GitHub上でテスト用のリポジトリが作成してある(今回は例として「temporary_test」という名前で進めます)
  • DockerHubのアカウントが作成してある

DockerHubとGitHubと連携する

まずはAutomated Buildを実行できるようにするために、DockerHubからGitHubを連携させます。

DockerHubにログインし、「Create -> Create Automated Build」をクリックします。

NewImage

「Link Account」をクリックします。

NewImage

リンクできるGitホスティングサービスはGitHubとBitbucketがありますが、今回はGitHubを選択します。

NewImage

「Select」をクリックします。

NewImage

「Authorize docker」をクリックして、GitHubとDockerHubを連携します。

NewImage

GitHubのパスワードを入力して、「Confirm password」をクリックします。

NewImage

GitHubとDockerHubの連携が完了しました。

NewImage

DockerHubでAutomated Buildを作成する

それでは、Automated Buildを作成していきましょう。

「Create -> Create Automated Build」をクリックします。

NewImage

GitHubの「Create Auto-build」を選択します。

NewImage

今回テスト用にGitHub上に用意した「temporary_test」リポジトリを選択します。

NewImage

今回はデフォルトの設定で、「Create」をクリックします。この設定では、GitHub上のtemporary_testリポジトリのmasterブランチにPushするとDockerHub上でDockerイメージのビルドが自動的に行われます。

NewImage

Automated Buildが作成されました。

NewImage

「Build Details」にはまだビルドが無い状態です。

NewImage

GitHubにDockerfileをPushする

それでは設定したAutomated Buildが動くことを確認しましょう。

GitHubでテスト用に用意したtemporary_testリポジトリをクローンして、Dockerfileを追加し、GitHubにPushします。{your-github-account}は自分のDockerHubアカウントを指定してください。

$ git clone https://github.com/{your-github-account}/temporary_test.git
$ cd temporary_test
$ touch Dockerfile
$ echo "FROM nginx" > Dockerfile
$ cat Dockerfile
FROM nginx
$ git add .
$ git commit -m 'Add Dockerfile'
$ git push origin master

すると、DockerHub上でGitHubのPushをトリガーに、自動的にDockerイメージのビルドが実行されます。

NewImage

「Status」が「Success」になればビルドが完了です。

NewImage

自動ビルドされたDockerイメージの動作確認

最後に、自動ビルドされたイメージが動くことを確認しましょう。

DockerHubのtemporary_testのイメージをPullして実行してみましょう。{your-dockerhub-account}は自分のDockerHubアカウントを指定してください。

$ docker pull {your-dockerhub-account}/temporary_test:latest
$ docker images
REPOSITORY                                                      TAG                  IMAGE ID            CREATED             SIZE
{your-dockerhub-account}/temporary_test                                          latest               cd568529388a        17 hours ago        109MB
$ docker run -itd --rm --name web -p 8080:80 {your-dockerhub-account}/temporary_test:latest
$ docker container ls
CONTAINER ID        IMAGE                           COMMAND                  CREATED             STATUS              PORTS                  NAMES
371256aef1dc        {your-dockerhub-account}/temporary_test:latest   "nginx -g 'daemon of…"   15 seconds ago      Up 15 seconds       0.0.0.0:8080->80/tcp   web

ブラウザで「localhost:8080」を開いてみましょう。

NewImage

Nginxが正しく起動していることがわかります。正しく動いていますね。

おまけ(Webhook)

今回は行いませんでしたが、DockerHubの「Webhooks」タブからWebhookを設定できます。

NewImage

これを利用することで、Dockerイメージが自動ビルドされたタイミングで他のサービスに通知して連携できます。

最後に

いかがでしたか？これでGitHubにPushするだけでDockerHub上でDockerイメージを自動ビルドできるようになったと思います。とても便利ですね。では。

環境

  • git: git version 2.19.0
  • docker: Docker version 18.06.1-ce, build e68fc7a
The following two tabs change content below.
Keid
Twitter のプロフィール

Keid

カナダを拠点に活躍する（予定の）フルスタックWebデベロッパー。 大学でコンピュータサイエンスを真面目に学び、日本の大手IT企業に就職後、日本のIT業界のスピードの遅さに落胆し、海外への挑戦を決意。海外に行きたくても英語ができなかっため、フィリピン留学およびカナダ留学を経て強制的に英語を上達させた。このブログでは海外に挑戦したいエンジニアやデザイナーに少しでも有益な情報を提供していきたいと思う。（写真は旅行先のラスベガス）

関連記事