■ はじめに

　Docker をなんとなく使っていて
ちゃんと基本的なことを理解していなく
いきあたりばったりだったので、
図書館で本（補足１）を借りた。

　その中で、Go言語を使ったサンプルが出ていたので
参考にして、現状にあうように書き換えたりとかした
チュートリアル（Hello world）的なことをやってみる。

補足１：借りた本について

Docker/Kubernetes 実践コンテナ開発入門

作者:山田明憲
技術評論社

Amazon

補足２：Python だったら

* 以下のサイトがよさげ。

https://www.ogis-ri.co.jp/otc/hiroba/technical/docker/part2.html

【０】目的
　１）全体の流れ
　２）フォルダ構成
　３）独自アプリ（Go言語）のサンプル
　４）動作確認環境
【１】Dockerfile 作成
　１）サンプル
　２）説明
【２】Dockerコマンドでデプロイ
　０）コマンド例
　１）説明 - docker image -
　２）説明 - docker container -

【０】目的

簡単な独自アプリ（今回は、Go言語）を作成し、
それをDockerを使って、デプロイし、アクセスする

１）全体の流れ

* Docker で アプリをデプロイする際には、
　大きく以下のような手順にすればいい。

[1] 対象アプリの用意

* 今回はGo言語のアプリ。
* 後述「３）独自アプリ（Go言語）のサンプル」参照。

[2] Dockerfile 作成

* 後述「【１】Dockerfile 作成」参照。

[3] Dockerコマンドによるデプロイ

* 後述「【２】Dockerコマンドでデプロイ」参照。

２）フォルダ構成

+ main.go ... 独自アプリ（Go言語）
+ Dockerfile ... Dockerfile

３）独自アプリ（Go言語）のサンプル

main.go

package main

import (
    "fmt"
    "log"
    "net/http"
)

func main() {
    // Register simple function for Hello world!
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        log.Println("Received")
        fmt.Fprintf(w, "Hello World!!")
    })
    log.Println("Start server")
    http.ListenAndServe(":8080", nil)

    // Start the web server
    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal("ListenAndServe:", err)
    }
}

４）動作確認環境

* 以下の関連記事で紹介した「katacoda」を使ってもいいかも。

学習用クラウドサービス～ katacoda ～
https://dk521123.hatenablog.com/entry/2021/07/15/211044

【１】Dockerfile 作成

* アプリに沿ったDockerfile を作成する。

１）サンプル

Dockerfile

FROM golang:1.17.6

RUN mkdir /hello_world
COPY main.go /hello_world

CMD ["go", "run", "/hello_world/main.go"]

２）説明

* Dockerfile 内の「FROM」「RUN」などを
　「インストラクション（命令）」と呼ぶ
* 下記以外のインストラクションについては、以下の関連記事を参照のこと。

https://dk521123.hatenablog.com/entry/2020/04/14/000000

a) FROM

* ベースとなるイメージ
 => 「FROM golang:1.17.6」なので、
　　Go言語 v1.17.6のイメージをベースにしている

b) RUN

* docker build 時に実行するコマンド
 => 「RUN mkdir /hello_world」なので、
　　ディレクトリ名「hello_world」を作成

c) COPY

* ホストからコンテナへのファイルコピー
 => 「COPY main.go /hello_world」なので、
　　ホストにある「main.go（独自Go言語アプリ）」を
　　コンテナ内のディレクトリ名「hello_world」配下にコピー

d) CMD

* docker run 時に実行するコマンド
 => 「CMD ["go", "run", "/hello_world/main.go"]」なので、
　　コンテナ内の「/hello_world/main.go」をgoコマンドで
　　実行する

【２】Dockerコマンドでデプロイ

* 大きな流れとしては、
１）DockerファイルからDockerイメージを作成
２）作成したDockerイメージから新しいコンテナを実行

０）コマンド例

# １）DockerファイルからDockerイメージを作成
docker image build -t hello/world:latest .

# 作成したDockerイメージを確認
docker image ls

# ２）作成したDockerイメージから新しいコンテナを実行
docker container run -d -p 9000:8080 hello/world:latest

# 作成したDockerコンテナを確認
docker container ls

# 独自アプリにアクセスする
curl http://localhost:9000

１）説明 - docker image -

* 使用した docker コマンドのDocker イメージについて、解説をしていく

[1] docker image build

* Dockerfile からイメージをビルドする
* 「-t」は「--tag」で、書式 'name:tag' により
　名前および任意のタグを指定する
 => 「-t hello/world:latest」なので
　　名前「hello/world」でタグ「latest」

https://matsuand.github.io/docs.docker.jp.onthefly/engine/reference/commandline/image_build/

[2] docker image

* Dockerイメージを管理

https://matsuand.github.io/docs.docker.jp.onthefly/engine/reference/commandline/image/

２）説明 - docker container -

* 使用した docker コマンドのDocker コンテナについて、解説をしていく

[1] docker container run

* 新しいコンテナを実行
* 旧コマンド「docker run」と同じ

https://matsuand.github.io/docs.docker.jp.onthefly/engine/reference/commandline/container_run

[2] docker container ls

* コンテナ一覧の表示
* 旧コマンド「docker ps」と同じ

https://matsuand.github.io/docs.docker.jp.onthefly/engine/reference/commandline/container_ls/

参考文献

https://www.tohoho-web.com/docker/dockerfile.html
https://qiita.com/zembutsu/items/6e1ad18f0d548ce6c266

プログラムの超個人的なメモ

Memo for Programming.

【Docker】Docker ～ GO言語～