（最終更新月：2023年9月）
✔当記事は次のような疑問をお持ちの方々へ向けて書きました：
「DockerとGitをどのように一緒に使うのか？」
「Docker内でGitを使う手順を知りたい」
「DockerとGitの実際の使用例を見てみたい」
✔当記事を通じて得られる知識
- DockerとGitの連携の基本概念
- Docker内でGitを活用する方法とその手順
- DockerとGitの具体的な使用例
当記事ではDockerとGitの基本的な連携方法から、具体的な手順や使用例まで、わかりやすく具体的な内容で説明しています。
ぜひ最後までご覧ください。
筆者プロフィール
【現職】プロダクトマネージャー
【副業】ブログ（月間20万PV）/YouTube/Web・アプリ制作
「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。現在はプロダクトマネージャーとして、さまざまな関係者の間に入り奮闘してます。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。
【当ブログで紹介しているサイト】
✔人に見せても恥ずかしくないコードを書こう
「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。
- 見るからにきれいなコードの書き方
- コードの分割方法
- 変数や関数の命名規則
エンジニアのスタンダートとすべき基準を一から解説しています。
何回も読むのに値する本なので、ぜひ手にとって読んでみてください。
DockerとGitの基本
こちらでは、Docker・Gitそれぞれの基本についてお伝えしていきます。
- Dockerとは？
- Gitとは？
Dockerとは？
Dockerとは、アプリケーションとその依存関係をひとつの「コンテナ」としてパッケージ化する技術です。
その主な利点は、異なる環境でも同じように動作すること。
WindowsやMac、Linuxなど、さまざまなOSで使えるのが特徴です。
インストールがまだの方は以下の記事を参考に、自身の環境にDockerを用意しましょう。
Gitの深層と設定
Gitは、分散バージョン管理システムで、コードの変更履歴を追跡します。
複数人での作業はもちろん、個人による開発で、よく使われるツールです。
例えばGitにより、以下のようなことが達成できます。
- コードの変更履歴を閲覧できる
- コードを過去の履歴時の状態に戻せる
- バグの修正や新規の機能開発など、別作業を同時におこなえる
長期に渡る開発には、必須の仕組みだといえるでしょう。
Dockerをより深く理解しよう
こちらでは、Dockerをより深く理解するための情報をお伝えしていきます。
主に以下の内容です。
- Dockerfileとは
- docker-compose.ymlでできること
- .devcontainer/devcontainer.jsonの秘密
Dockerfileの行間を読む
Dockerfileは、Dockerイメージを作成するための指示書です。
以下は一般的なDockerfileの例です。
FROM ubuntu:20.04
RUN apt-get update && apt-get install -y python3
CMD ["python3", "-m", "http.server", "8000"]このDockerfileにより、以下のようなイメージが作れます。
- Ubuntu 20.04をベースにPython3をインストールする
- PythonのHTTPサーバをポート8000で起動する
docker-compose.ymlの理制
docker-compose.ymlは、複数のコンテナの管理と連携を助けるファイルです。
各コンテナはServicesというブロック内に「web」「db」などの名前で設定されます。
以下は「web」というサービス名のコンテナを起動する例です。
version: '3'
services:
web:
build: .
ports:
- "8000:8000"現在のディレクトリにあるDockerfileを使用してwebサービスをビルド。
ホストの8000番ポートとコンテナの8000番ポートをマッピングします。
.devcontainer/devcontainer.jsonの秘密
devcontainer.jsonは、VS CodeのRemote – Containers拡張機能で使用される設定ファイルのこと。
開発環境をコンテナ内に構築する際の設定を記述します。
{
"name": "Python 3",
"build": {
"dockerfile": "Dockerfile",
"context": ".."
},
"runArgs": ["-p", "8000:8000"],
"settings": {
"terminal.integrated.shell.linux": "/bin/bash"
}
}実戦準備：DockerとGitの連携
こちらでは、実戦準備についてお伝えしていきます。
- Dockerコンテナ内のGitの操縦
- DockerイメージとGitリポジトリの連携
Dockerコンテナ内のGitの操縦
Dockerコンテナ内でGitを使用する場合、まずGitをインストールする必要があります。
FROM ubuntu:20.04
RUN apt-get update && apt-get install -y git上記のDockerfileは、Ubuntu 20.04をベースにGitをインストールするものです。
コンテナ内でGitを使用することで、コードの変更を容易にトラックできます。
DockerイメージとGitリポジトリの連携
DockerイメージとGitリポジトリを連携させることで、イメージのバージョンとコードのバージョンを一致させられます。
例えばDocker HubとGitHub Actionsを使用して、新しいコードがプッシュされるたびに自動的にイメージをビルド・プッシュする設定が可能です。
name: Build and Push Docker Image
on:
push:
branches:
- main
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Login to Docker Hub
uses: docker/login-action@v1
with:
username: ${{ secrets.DOCKER_HUB_USERNAME }}
password: ${{ secrets.DOCKER_HUB_PASSWORD }}
- name: Build and push Docker image
run: |
docker build -t your_dockerhub_username/your_repository_name:${{ github.sha }} .
docker push your_dockerhub_username/your_repository_name:${{ github.sha }}テンプレートのクローンから開発環境を整える手順
こちらでは、テンプレートのクローンから開発環境を整える手順についてお伝えしていきます。
- テンプレートのクローン
- 開発環境の整備
テンプレートのクローン
Gitを使用してテンプレートをクローンすることで、開発を迅速に開始できます。
以下は一般的なクローンの手順です。
git clone https://github.com/your-repository/template.git
cd templateこのコマンドで、指定したリポジトリのテンプレートをローカルマシンにクローンし、そのディレクトリに移動します。
開発環境の整備
クローンしたテンプレートを基に、開発環境を整える必要があります。
Dockerを使用している場合、以下のコマンドで環境を構築可能です。
docker-compose up -dこれにより、docker-compose.ymlに基づいてコンテナが起動し、開発環境が整います。
さらなる成長：バーナスヒントとテクニック
こちらでは、「さらなる成長」についてお伝えしていきます。
- DockerとGitのベストプラクティス
- よく遭遇するエラーとその対処法
DockerとGitのベストプラクティス
DockerとGitを効果的に使用するためのベストプラクティスは多数存在します。
- Docker：イメージのサイズを小さく保つためにマルチステージビルドを活用する
- Git：コミットメッセージを明確にすることで履歴の追跡を容易にする
よく遭遇するエラーとその対処法
DockerやGitを使用する際には、さまざまなエラーに遭遇することがあります。
よくあるエラーの例としては、以下のようなものです。
port is already allocated
指定したポートが既に使用されている場合に発生します。
使用中のポートを確認し、別のポートを指定することで解決してください。
まとめ
当記事では、DockerとGitの連携についてお伝えしてきました。
この知識は、開発プロジェクトを効率的に進め、プロフェッショナルな結果を生む力となります。
いろいろと試しながら、自分なりのやり方を構築するのも良いでしょう。
ぜひ当記事を参考にしなら、よりやりやすい方法を見つけてください。