Docker 初心者向け：最初のイメージから本番デプロイまで

spinny:~/writing $ vim docker-containers-complete-guide.md

1~
2Docker はソフトウェアの構築、配布、実行の方法を変えました。「自分のマシンでは動く」の代わりに、Docker はアプリケーションがどこでも同じように動作することを保証します - あなたのノートパソコン、同僚のマシン、CI/CD、そして本番環境で。このガイドでは、ゼロから実際のアプリケーションのデプロイまでを解説します。
3~
4## Docker とは？
5~
6Docker は、アプリケーションとそのすべての依存関係を**コンテナ**と呼ばれる標準化されたユニットにパッケージングするプラットフォームです。コンテナは、ホスト OS のカーネルを共有しながらも、独自のファイルシステム、ネットワーク、プロセス空間を持つ、隔離された軽量なプロセスです。
7~
8```mermaid
9graph TD
10    subgraph "Traditional Deployment"
11        A1[App 1] --> OS1[Guest OS]
12        A2[App 2] --> OS2[Guest OS]
13        OS1 --> HV[Hypervisor]
14        OS2 --> HV
15        HV --> HW1[Hardware]
16    end
17~
18    subgraph "Docker Deployment"
19        B1[App 1] --> D1[Container]
20        B2[App 2] --> D2[Container]
21        D1 --> DE[Docker Engine]
22        D2 --> DE
23        DE --> HW2[Hardware]
24    end
25```
26~
27### コンテナ vs 仮想マシン
28~
29| 項目 | コンテナ | 仮想マシン |
30|------|----------|-----------|
31| **起動** | 秒単位 | 分単位 |
32| **サイズ** | MB 単位 | GB 単位 |
33| **OS** | ホストカーネルを共有 | 完全なゲスト OS |
34| **分離** | プロセスレベル | ハードウェアレベル |
35| **パフォーマンス** | ほぼネイティブ | ハイパーバイザーのオーバーヘッド |
36| **密度** | ホストあたり数百 | ホストあたり数十 |
37~
38## Docker のインストール
39~
40```bash
41# macOS
42brew install --cask docker
43~
44# Ubuntu/Debian
45curl -fsSL https://get.docker.com | sh
46sudo usermod -aG docker $USER
47~
48# Verify installation
49docker --version
50docker run hello-world
51```
52~
53## コアコンセプト
54~
55### イメージ
56~
57イメージは、コンテナを作成するための命令を含む読み取り専用のテンプレートです。アプリケーションとその環境のスナップショットと考えてください。
58~
59```bash
60# Pull an image from Docker Hub
61docker pull node:20-alpine
62~
63# List local images
64docker images
65~
66# Remove an image
67docker rmi node:20-alpine
68```
69~
70### コンテナ
71~
72コンテナはイメージの実行中のインスタンスです。コンテナの作成、起動、停止、削除ができます。
73~
74```bash
75# Run a container
76docker run -d --name my-app -p 3000:3000 node:20-alpine
77~
78# List running containers
79docker ps
80~
81# List all containers (including stopped)
82docker ps -a
83~
84# Stop a container
85docker stop my-app
86~
87# Remove a container
88docker rm my-app
89~
90# View logs
91docker logs my-app
92~
93# Execute a command inside a running container
94docker exec -it my-app sh
95```
96~
97## Dockerfile の書き方
98~
99Dockerfile は、イメージを構築するための命令が書かれたテキストファイルです。各命令がレイヤーを作成します。
100~
101### Node.js アプリの基本的な Dockerfile
102~
103```dockerfile
104# Use an official Node.js runtime as base image
105FROM node:20-alpine
106~
107# Set working directory
108WORKDIR /app
109~
110# Copy package files first (better caching)
111COPY package.json package-lock.json ./
112~
113# Install dependencies
114RUN npm ci --only=production
115~
116# Copy application code
117COPY . .
118~
119# Expose the port the app runs on
120EXPOSE 3000
121~
122# Command to run the application
123CMD ["node", "server.js"]
124```
125~
126### ビルドと実行
127~
128```bash
129# Build the image
130docker build -t my-node-app .
131~
132# Run the container
133docker run -d -p 3000:3000 my-node-app
134~
135# Visit http://localhost:3000
136```
137~
138## マルチステージビルド
139~
140マルチステージビルドは、ビルド環境をランタイムから分離することで、本番イメージを小さく保ちます。
141~
142```dockerfile
143# Stage 1: Build
144FROM node:20-alpine AS builder
145WORKDIR /app
146COPY package.json package-lock.json ./
147RUN npm ci
148COPY . .
149RUN npm run build
150~
151# Stage 2: Production
152FROM node:20-alpine AS runner
153WORKDIR /app
154COPY --from=builder /app/dist ./dist
155COPY --from=builder /app/node_modules ./node_modules
156COPY --from=builder /app/package.json ./
157EXPOSE 3000
158CMD ["node", "dist/server.js"]
159```
160~
161これにより、コンパイル済みの出力と本番依存関係のみを含むイメージが生成されます - ソースコード、開発依存関係、ビルドツールは含まれません。
162~
163### Next.js のマルチステージ例
164~
165```dockerfile
166FROM node:20-alpine AS deps
167WORKDIR /app
168COPY package.json package-lock.json ./
169RUN npm ci
170~
171FROM node:20-alpine AS builder
172WORKDIR /app
173COPY --from=deps /app/node_modules ./node_modules
174COPY . .
175RUN npm run build
176~
177FROM node:20-alpine AS runner
178WORKDIR /app
179ENV NODE_ENV=production
180COPY --from=builder /app/public ./public
181COPY --from=builder /app/.next/standalone ./
182COPY --from=builder /app/.next/static ./.next/static
183EXPOSE 3000
184CMD ["node", "server.js"]
185```
186~
187## ボリューム：永続データ
188~
189デフォルトでは、コンテナ内のデータはコンテナが削除されると失われます。ボリュームがこの問題を解決します。
190~
191```bash
192# Create a named volume
193docker volume create my-data
194~
195# Run with a volume
196docker run -d -v my-data:/app/data my-app
197~
198# Bind mount (map host directory to container)
199docker run -d -v $(pwd)/data:/app/data my-app
200~
201# List volumes
202docker volume ls
203```
204~
205## ネットワーキング
206~
207Docker は、コンテナが通信するための隔離されたネットワークを作成します。
208~
209```bash
210# Create a custom network
211docker network create my-network
212~
213# Run containers on the same network
214docker run -d --name api --network my-network my-api
215docker run -d --name db --network my-network postgres:16
216~
217# Containers can reach each other by name
218# From "api" container: postgres://db:5432
219```
220~
221```mermaid
222graph LR
223    subgraph "my-network"
224        API[api container\nport 3000] -- "db:5432" --> DB[db container\nport 5432]
225    end
226    User -- "localhost:3000" --> API
227```
228~
229## Docker Compose
230~
231Docker Compose を使えば、単一の YAML ファイルでマルチコンテナアプリケーションを定義して実行できます。
232~
233### docker-compose.yml
234~
235```yaml
236services:
237  api:
238    build: ./api
239    ports:
240      - "3000:3000"
241    environment:
242      - DATABASE_URL=postgres://user:pass@db:5432/mydb
243    depends_on:
244      - db
245~
246  db:
247    image: postgres:16-alpine
248    environment:
249      - POSTGRES_USER=user
250      - POSTGRES_PASSWORD=pass
251      - POSTGRES_DB=mydb
252    volumes:
253      - pgdata:/var/lib/postgresql/data
254    ports:
255      - "5432:5432"
256~
257  redis:
258    image: redis:7-alpine
259    ports:
260      - "6379:6379"
261~
262volumes:
263  pgdata:
264```
265~
266### コマンド
267~
268```bash
269# Start all services
270docker compose up -d
271~
272# View logs
273docker compose logs -f
274~
275# Stop all services
276docker compose down
277~
278# Rebuild and restart
279docker compose up -d --build
280~
281# Scale a service
282docker compose up -d --scale api=3
283```
284~
285## .dockerignore
286~
287`.gitignore` と同様に、このファイルは不要なファイルがイメージにコピーされるのを防ぎます。
288~
289```plaintext
290node_modules
291.git
292.env
293*.md
294.next
295dist
296coverage
297```
298~
299## 本番環境のベストプラクティス
300~
301### 1. 小さなベースイメージを使う
302~
303```dockerfile
304# Bad: 1GB+
305FROM node:20
306~
307# Good: ~180MB
308FROM node:20-alpine
309```
310~
311### 2. Root で実行しない
312~
313```dockerfile
314FROM node:20-alpine
315RUN addgroup -S app && adduser -S app -G app
316USER app
317WORKDIR /home/app
318COPY --chown=app:app . .
319```
320~
321### 3. 特定のイメージタグを使う
322~
323```dockerfile
324# Bad: can change unexpectedly
325FROM node:latest
326~
327# Good: pinned version
328FROM node:20.11-alpine3.19
329```
330~
331### 4. ビルドキャッシュを活用する
332~
333Dockerfile の命令を、変更頻度の低いものから高いものの順に並べましょう：
334~
335```dockerfile
336FROM node:20-alpine
337WORKDIR /app
338~
339# These change rarely - cached
340COPY package.json package-lock.json ./
341RUN npm ci --only=production
342~
343# This changes often - not cached
344COPY . .
345```
346~
347### 5. ヘルスチェック
348~
349```dockerfile
350HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
351  CMD wget -qO- http://localhost:3000/health || exit 1
352```
353~
354### 6. 環境変数を使う
355~
356```dockerfile
357ENV NODE_ENV=production
358ENV PORT=3000
359```
360~
361## よく使う Docker コマンド早見表
362~
363```bash
364# Images
365docker build -t name:tag .        # Build image
366docker images                      # List images
367docker rmi image_name              # Remove image
368docker image prune                 # Remove unused images
369~
370# Containers
371docker run -d -p 3000:3000 image   # Run detached
372docker ps                          # List running
373docker stop container_name         # Stop
374docker rm container_name           # Remove
375docker logs -f container_name      # Follow logs
376docker exec -it container sh       # Shell into container
377~
378# Compose
379docker compose up -d               # Start services
380docker compose down                # Stop services
381docker compose logs -f             # Follow all logs
382docker compose ps                  # List services
383~
384# Cleanup
385docker system prune -a             # Remove everything unused
386```
387~
388## Docker から Kubernetes へ
389~
390Docker は個々のコンテナを管理します。複数のサーバーにわたって数百のコンテナをオーケストレーションする必要がある場合、Kubernetes が必要です。Docker と Kubernetes は補完的な関係にあります：
391~
3921. **Docker**：コンテナを構築して実行する
3932. **Kubernetes**：コンテナを大規模にオーケストレーションする（スケジューリング、スケーリング、自動修復）
394~
395次のステップに興味がある方は、Kubernetes 入門の記事をご覧ください。
396~
397## まとめ
398~
399Docker は現代の開発者にとって基本的なスキルです。環境の不整合を解消し、デプロイを簡素化し、Kubernetes によるコンテナオーケストレーションの基盤となります。シンプルな Dockerfile から始めて、マルチサービスアプリには Docker Compose に移行し、成長に合わせてマルチステージビルドとセキュリティのベストプラクティスを導入しましょう。
400~
401Docker を学ぶ最良の方法は、すでに取り組んでいるプロジェクトをコンテナ化することです。今日から始めましょう。
402~

NORMAL · docker-containers-complete-guide.md [readonly]402 lines · :q to close

2Docker はソフトウェアの構築、配布、実行の方法を変えました。「自分のマシンでは動く」の代わりに、Docker はアプリケーションがどこでも同じように動作することを保証します - あなたのノートパソコン、同僚のマシン、CI/CD、そして本番環境で。このガイドでは、ゼロから実際のアプリケーションのデプロイまでを解説します。

4## Docker とは？

6Docker は、アプリケーションとそのすべての依存関係を**コンテナ**と呼ばれる標準化されたユニットにパッケージングするプラットフォームです。コンテナは、ホスト OS のカーネルを共有しながらも、独自のファイルシステム、ネットワーク、プロセス空間を持つ、隔離された軽量なプロセスです。

8```mermaid

9graph TD

10 subgraph "Traditional Deployment"

11 A1[App 1] --> OS1[Guest OS]

12 A2[App 2] --> OS2[Guest OS]

13 OS1 --> HV[Hypervisor]

14 OS2 --> HV

15 HV --> HW1[Hardware]

16 end

17~

18 subgraph "Docker Deployment"

19 B1[App 1] --> D1[Container]

20 B2[App 2] --> D2[Container]

21 D1 --> DE[Docker Engine]

22 D2 --> DE

23 DE --> HW2[Hardware]

24 end

25```

26~

27### コンテナ vs 仮想マシン

28~

29| 項目 | コンテナ | 仮想マシン |

30|------|----------|-----------|

31| **起動** | 秒単位 | 分単位 |

32| **サイズ** | MB 単位 | GB 単位 |

33| **OS** | ホストカーネルを共有 | 完全なゲスト OS |

34| **分離** | プロセスレベル | ハードウェアレベル |

35| **パフォーマンス** | ほぼネイティブ | ハイパーバイザーのオーバーヘッド |

36| **密度** | ホストあたり数百 | ホストあたり数十 |

37~

38## Docker のインストール

39~

40```bash

41# macOS

42brew install --cask docker

43~

44# Ubuntu/Debian

45curl -fsSL https://get.docker.com | sh

46sudo usermod -aG docker $USER

47~

48# Verify installation

49docker --version

50docker run hello-world

51```

52~

53## コアコンセプト

54~

55### イメージ

56~

57イメージは、コンテナを作成するための命令を含む読み取り専用のテンプレートです。アプリケーションとその環境のスナップショットと考えてください。

58~

59```bash

60# Pull an image from Docker Hub

61docker pull node:20-alpine

62~

63# List local images

64docker images

65~

66# Remove an image

67docker rmi node:20-alpine

68```

69~

70### コンテナ

71~

72コンテナはイメージの実行中のインスタンスです。コンテナの作成、起動、停止、削除ができます。

73~

74```bash

75# Run a container

76docker run -d --name my-app -p 3000:3000 node:20-alpine

77~

78# List running containers

79docker ps

80~

81# List all containers (including stopped)

82docker ps -a

83~

84# Stop a container

85docker stop my-app

86~

87# Remove a container

88docker rm my-app

89~

90# View logs

91docker logs my-app

92~

93# Execute a command inside a running container

94docker exec -it my-app sh

95```

96~

97## Dockerfile の書き方

98~

99Dockerfile は、イメージを構築するための命令が書かれたテキストファイルです。各命令がレイヤーを作成します。

100~

101### Node.js アプリの基本的な Dockerfile

102~

103```dockerfile

104# Use an official Node.js runtime as base image

105FROM node:20-alpine

106~

107# Set working directory

108WORKDIR /app

109~

110# Copy package files first (better caching)

111COPY package.json package-lock.json ./

112~

113# Install dependencies

114RUN npm ci --only=production

115~

116# Copy application code

117COPY . .

118~

119# Expose the port the app runs on

120EXPOSE 3000

121~

122# Command to run the application

123CMD ["node", "server.js"]

124```

125~

126### ビルドと実行

127~

128```bash

129# Build the image

130docker build -t my-node-app .

131~

132# Run the container

133docker run -d -p 3000:3000 my-node-app

134~

135# Visit http://localhost:3000

136```

137~

138## マルチステージビルド

139~

140マルチステージビルドは、ビルド環境をランタイムから分離することで、本番イメージを小さく保ちます。

141~

142```dockerfile

143# Stage 1: Build

144FROM node:20-alpine AS builder

145WORKDIR /app

146COPY package.json package-lock.json ./

147RUN npm ci

148COPY . .

149RUN npm run build

150~

151# Stage 2: Production

152FROM node:20-alpine AS runner

153WORKDIR /app

154COPY --from=builder /app/dist ./dist

155COPY --from=builder /app/node_modules ./node_modules

156COPY --from=builder /app/package.json ./

157EXPOSE 3000

158CMD ["node", "dist/server.js"]

159```

160~

161これにより、コンパイル済みの出力と本番依存関係のみを含むイメージが生成されます - ソースコード、開発依存関係、ビルドツールは含まれません。

162~

163### Next.js のマルチステージ例

164~

165```dockerfile

166FROM node:20-alpine AS deps

167WORKDIR /app

168COPY package.json package-lock.json ./

169RUN npm ci

170~

171FROM node:20-alpine AS builder

172WORKDIR /app

173COPY --from=deps /app/node_modules ./node_modules

174COPY . .

175RUN npm run build

176~

177FROM node:20-alpine AS runner

178WORKDIR /app

179ENV NODE_ENV=production

180COPY --from=builder /app/public ./public

181COPY --from=builder /app/.next/standalone ./

182COPY --from=builder /app/.next/static ./.next/static

183EXPOSE 3000

184CMD ["node", "server.js"]

185```

186~

187## ボリューム：永続データ

188~

189デフォルトでは、コンテナ内のデータはコンテナが削除されると失われます。ボリュームがこの問題を解決します。

190~

191```bash

192# Create a named volume

193docker volume create my-data

194~

195# Run with a volume

196docker run -d -v my-data:/app/data my-app

197~

198# Bind mount (map host directory to container)

199docker run -d -v $(pwd)/data:/app/data my-app

200~

201# List volumes

202docker volume ls

203```

204~

205## ネットワーキング

206~

207Docker は、コンテナが通信するための隔離されたネットワークを作成します。

208~

209```bash

210# Create a custom network

211docker network create my-network

212~

213# Run containers on the same network

214docker run -d --name api --network my-network my-api

215docker run -d --name db --network my-network postgres:16

216~

217# Containers can reach each other by name

218# From "api" container: postgres://db:5432

219```

220~

221```mermaid

222graph LR

223 subgraph "my-network"

224 API[api container\nport 3000] -- "db:5432" --> DB[db container\nport 5432]

225 end

226 User -- "localhost:3000" --> API

227```

228~

229## Docker Compose

230~

231Docker Compose を使えば、単一の YAML ファイルでマルチコンテナアプリケーションを定義して実行できます。

232~

233### docker-compose.yml

234~

235```yaml

236services:

237 api:

238 build: ./api

239 ports:

240 - "3000:3000"

241 environment:

242 - DATABASE_URL=postgres://user:pass@db:5432/mydb

243 depends_on:

244 - db

245~

246 db:

247 image: postgres:16-alpine

248 environment:

249 - POSTGRES_USER=user

250 - POSTGRES_PASSWORD=pass

251 - POSTGRES_DB=mydb

252 volumes:

253 - pgdata:/var/lib/postgresql/data

254 ports:

255 - "5432:5432"

256~

257 redis:

258 image: redis:7-alpine

259 ports:

260 - "6379:6379"

261~

262volumes:

263 pgdata:

264```

265~

266### コマンド

267~

268```bash

269# Start all services

270docker compose up -d

271~

272# View logs

273docker compose logs -f

274~

275# Stop all services

276docker compose down

277~

278# Rebuild and restart

279docker compose up -d --build

280~

281# Scale a service

282docker compose up -d --scale api=3

283```

284~

285## .dockerignore

286~

287`.gitignore` と同様に、このファイルは不要なファイルがイメージにコピーされるのを防ぎます。

288~

289```plaintext

290node_modules

291.git

292.env

293*.md

294.next

295dist

296coverage

297```

298~

299## 本番環境のベストプラクティス

300~

301### 1. 小さなベースイメージを使う

302~

303```dockerfile

304# Bad: 1GB+

305FROM node:20

306~

307# Good: ~180MB

308FROM node:20-alpine

309```

310~

311### 2. Root で実行しない

312~

313```dockerfile

314FROM node:20-alpine

315RUN addgroup -S app && adduser -S app -G app

316USER app

317WORKDIR /home/app

318COPY --chown=app:app . .

319```

320~

321### 3. 特定のイメージタグを使う

322~

323```dockerfile

324# Bad: can change unexpectedly

325FROM node:latest

326~

327# Good: pinned version

328FROM node:20.11-alpine3.19

329```

330~

331### 4. ビルドキャッシュを活用する

332~

333Dockerfile の命令を、変更頻度の低いものから高いものの順に並べましょう：

334~

335```dockerfile

336FROM node:20-alpine

337WORKDIR /app

338~

339# These change rarely - cached

340COPY package.json package-lock.json ./

341RUN npm ci --only=production

342~

343# This changes often - not cached

344COPY . .

345```

346~

347### 5. ヘルスチェック

348~

349```dockerfile

350HEALTHCHECK --interval=30s --timeout=3s --retries=3 \

351 CMD wget -qO- http://localhost:3000/health || exit 1

352```

353~

354### 6. 環境変数を使う

355~

356```dockerfile

357ENV NODE_ENV=production

358ENV PORT=3000

359```

360~

361## よく使う Docker コマンド早見表

362~

363```bash

364# Images

365docker build -t name:tag . # Build image

366docker images # List images

367docker rmi image_name # Remove image

368docker image prune # Remove unused images

369~

370# Containers

371docker run -d -p 3000:3000 image # Run detached

372docker ps # List running

373docker stop container_name # Stop

374docker rm container_name # Remove

375docker logs -f container_name # Follow logs

376docker exec -it container sh # Shell into container

377~

378# Compose

379docker compose up -d # Start services

380docker compose down # Stop services

381docker compose logs -f # Follow all logs

382docker compose ps # List services

383~

384# Cleanup

385docker system prune -a # Remove everything unused

386```

387~

388## Docker から Kubernetes へ

389~

390Docker は個々のコンテナを管理します。複数のサーバーにわたって数百のコンテナをオーケストレーションする必要がある場合、Kubernetes が必要です。Docker と Kubernetes は補完的な関係にあります：

391~

3921. **Docker**：コンテナを構築して実行する

3932. **Kubernetes**：コンテナを大規模にオーケストレーションする（スケジューリング、スケーリング、自動修復）

394~

395次のステップに興味がある方は、Kubernetes 入門の記事をご覧ください。

396~

397## まとめ

398~

399Docker は現代の開発者にとって基本的なスキルです。環境の不整合を解消し、デプロイを簡素化し、Kubernetes によるコンテナオーケストレーションの基盤となります。シンプルな Dockerfile から始めて、マルチサービスアプリには Docker Compose に移行し、成長に合わせてマルチステージビルドとセキュリティのベストプラクティスを導入しましょう。

400~

401Docker を学ぶ最良の方法は、すでに取り組んでいるプロジェクトをコンテナ化することです。今日から始めましょう。

402~