Docker イメージを作る

サーバーアプリケーションを作る

コードを書く

naro_serverというディレクトリを作り、その中でコードを書いてください。第 1 部でやったように、 Go を使って下の条件を満たすサーバーアプリケーションを作ってください。

• /greetingへの GET リクエストに、環境変数 GREETING_MESSAGEの値を返す。
• 起動するポートを環境変数PORTで指定できる。

go modコマンドで外部ライブラリを管理しましょう。

https://go.dev/ref/mod

go mod init naro_server
go mod tidy

答え

package main

import (
	"log"
	"net/http"
	"os"

	"github.com/labstack/echo/v4"
)

func main() {
	port, ok := os.LookupEnv("PORT")
	if !ok {
		log.Fatal("failed to get env PORT")
	}

	e := echo.New()

	e.GET("/greeting", greetingHandler)

	e.Logger.Fatal(e.Start(":" + port))
}

func greetingHandler(c echo.Context) error {
	greeting, ok := os.LookupEnv("GREETING_MESSAGE")
	if !ok {
		return echo.NewHTTPError(http.StatusInternalServerError, "failed to get env GREETING_MESSAGE")
	}

	return c.String(http.StatusOK, greeting)
}

ビルドして実行する

今まではgo runコマンドでプログラムを実行していましたが、Go ではgo buildコマンドでコンパイルして実行ファイルを生成し、そのファイルを用いてプログラムを実行できます。

go build -o server

上のコマンドを実行するとserverというファイルが生成され、./serverで実行できます。

GREETING_MESSAGE="こんにちは" PORT="8080" ./server

実行前に環境変数を設定しています。

localhost:8080/greetingにアクセスすると、メッセージを確認できます。

メッセージとポート番号を「こんにちは」と 8080 から変えてビルド・実行し、ページにアクセスした様子のスクリーンショットを講習会用チャンネルに投稿しましょう。

Dockerfileを書く

Dockerfile を書くと自分で必要な機能がそろったコンテナを立てることができます。

1. 基本となるベースイメージを探してFROMで指定する。
2. 必要なパッケージを入れる。
3. 必要な処理を書く。
4. 起動設定を書く。

の順番で書いていきます。ベースイメージはできるだけ Docker Hub のオフィシャルイメージを使いましょう。2 から 4 を何度か試しながら修正していきます。

ただ、アプリケーションを動かすだけであれば一度書いた Dockerfile を使いまわすことも可能なので、テンプレートを探してきてそれを使っても構いません。

以下が Go のプログラムを動かすための最小の Dockerfile です。

# Go のベースイメージを指定
FROM golang:1.20.5-alpine

# コマンドを実行するコンテナ内のディレクトリをworkに指定
WORKDIR /work

# ローカルのカレントディレクトリをコンテナのカレントディレクトリ(work)にコピー
COPY . .

# Go のプログラムをビルド
RUN go build -o app

# ビルドしたものを実行
ENTRYPOINT ./app

naro_server ディレクトリ内にDockerfileというファイルを作り、上のコードを書きましょう。

VSCode であれば、Docker という拡張機能を入れると Dockerfile を書くのを手助けしてくれます。

詳しい Dockerfile の記法については、このページを読んでください。 https://docs.docker.jp/engine/reference/builder.html

Dockerイメージをビルドする

書いた Dockerfile を使って、イメージを作ることができます。これをイメージのビルドと言います。

docker build -t naro_server .

-tオプションでイメージに名前を付けています。

docker imagesでイメージ一覧を確認しましょう。naro_serverというイメージが作成されているはずです。

docker buildについて https://docs.docker.jp/engine/reference/commandline/build.html

コンテナを起動する

最後に先ほど作った naro_server イメージから Docker コンテナを起動しましょう。

docker run -p "127.0.0.1:3000:8080" -e GREETING_MESSAGE=こんにちは -e PORT=8080 naro_server

このコマンドを実行した後、localhost:3000/greeting にアクセスすると、アプリケーションが動いていることを確認できます。

-pオプション

{ホスト側ポート}:{コンテナ側ポート}と書いて、コンテナ内のどのポートをホスト側のポートに公開するか指定します。127.0.0.1はlocalhostと同じ意味です。ホストとコンテナで指定したポートがパイプでつながれるイメージです。これによって、ホスト側からコンテナ内のアプリケーションへアクセスできるようになります。指定しない場合はアクセスできません。

-eオプション

-e {環境変数名}={値}の形で環境変数を指定できます。今回はアプリケーションの動作に必要なGREETING_MESSAGEとPORTを指定しています。

他にも様々なオプションがあります。docker help buildで確認してみましょう。

コンテナ側の側ポートを 8080 以外にして実行し、アクセスした様子をスクリーンショットに撮って講習会用チャンネルに投稿しましょう。

答え

-pと-eの両方を変える必要があります。

docker run -p "127.0.0.1:3000:8081" -e GREETING_MESSAGE=こんにちは -e PORT=8081 naro_server

コンテナを止める際にはdocker stop {docker ps で調べたコンテナidか名前}を実行してください。