兩種方式Docker和Docker Compose部署web項目,相對於Go語言里說,不管是使用docker部署還是直接伺服器部署都相當方便,比python要簡單很多。 1、Dockerfile結構解析 From 我們正在使用基礎鏡像golang:alpine來創建我們的鏡像。這和我們要創建的鏡像一 ...
兩種方式Docker和Docker Compose部署web項目,相對於Go語言里說,不管是使用docker部署還是直接伺服器部署都相當方便,比python要簡單很多。
1、Dockerfile結構解析
From
我們正在使用基礎鏡像golang:alpine
來創建我們的鏡像。這和我們要創建的鏡像一樣是一個我們能夠訪問的存儲在Docker倉庫的基礎鏡像。這個鏡像運行的是alpine Linux發行版,該發行版的大小很小並且內置了Go,非常適合我們的用例。有大量公開可用的Docker鏡像,請查看https://hub.docker.com/_/golang
Env
用來設置我們編譯階段需要用的環境變數。
WORKDIR,COPY,RUN
WORKDIR:切換工作目錄
COPY:把文件夾/文件複製到容器中
RUN:用於執行後面跟著的命令行命令,對於Go是把代碼編譯成可執行的二進位文件
註:Dockerfile 的指令(RUN)每執行一次都會在 docker 上新建一層。所以過多無意義的層,會造成鏡像膨脹過大。
例如:
FROM centos
RUN yum -y install wget
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-6.2.6.tar.gz"
RUN tar -xvf redis.tar.gz
以上執行會創建 3 層鏡像。可簡化為以下格式:
FROM centos
RUN yum -y install wget \
&& wget -O redis.tar.gz "http://download.redis.io/releases/redis-6.2.6.tar.gz" \
&& tar -xvf redis.tar.gz
如上,以 && 符號連接命令,這樣執行後,只會創建 1 層鏡像。
EXPORT,CMD
聲明服務埠,因為應用程式監聽的是這個埠並通過這個埠對外提供服務。並且還定義了在運行鏡像的時候預設執行的命令CMD ["/dist/app"]
。CMD指令指定的程式可被docker run命令行參數中指定要運行的程式覆蓋掉。
註:如果 Dockerfile 中如果存在多個 CMD 指令,僅最後一個生效。
2、Docker的Golang Web項目部署方式
示例項目的代碼地址
項目中的tracer就是go部署的示例文件,需要在根目錄tracer目錄下創建配置文件夾config,在congif下創建配置文件config.ini,裡面缺少的配置文件詳細我粘貼在下麵,將下麵的配置粘貼到文件config.ini中:
註:host.docker.internal這個是用在本地Docker容器部署後訪問本機的地址,也就是說使用Docker跑起項目後,需要關聯mysql資料庫和redis,而mysql和redis是安裝在本的地並沒有創建對應的Docker容器,所以需要使用host.docker.internal來訪問,127.0.0.1是不能訪問到的,host.docker.internal這個方法在Go中有版本限制,某些較低版本不可用。
[server]
AppMode = debug
HttpPort = :8000
JwtKey = 123qwe456asd789zxc
[database]
Db = mysql
DbHost = host.docker.internal
; DbHost = 127.0.0.1
DbPort = 3306
DbUser = root
DbPassWord = 1234
DbName = tracer
[redis]
Rdb = redis
RdbHost = host.docker.internal
; RdbHost = 127.0.0.1
RdbPort = 6379
RdbUser =
DdbPassWord =
RdbName = 0
RdbPoolSize = 100
目錄結構:(註:Dockerfile、wait-for-it.sh、docker-compose.yml文件自己創建到根目錄tracer下)
.
├── Dockerfile
├── app
│ ├── blog
│ │ ├── blog.go
│ │ └── routers.go
│ └── user
│ ├── mode.go
│ ├── router.go
│ └── views.go
├── build
├── config
│ └── config.ini
├── dao
│ ├── db
│ │ └── user.go
│ └── redis
│ └── rdb.go
├── docker-compose.yml
├── go.mod
├── go.sum
├── init.sql
├── log
│ ├── log
├── main.go
├── middleware
│ ├── cors.go
│ ├── jwt.go
│ └── logger.go
├── model
│ ├── db.go
│ ├── price_policy.go
│ ├── rdb.go
│ └── user.go
├── routers.go
├── tmp
│ ├── build-errors.log
│ └── main
├── utils
│ ├── errmsg
│ │ └── errmsg.go
│ ├── settings.go
│ ├── sms
│ │ ├── Tcaptcha.go
│ │ └── sms.go
│ └── tool.go
└── wait-for-it.sh
Dockerfile配置,分階段構建
Go程式編譯後得到的是一個可執行的二進位文件,所以在最終的鏡像中是不需要Go編譯器的,也就是說只需要運行一個二進位文件即可。所以可以通過僅保留二進位文件來減小鏡像的大小,而是現在這種方式的技術稱為多階段構建技術,這就意味著可以通過多個步驟構建鏡像。
把COPY靜態文件的步驟放在上層,把COPY二進位可執行文件放在下層,爭取多使用緩存。
FROM golang:alpine AS builder
# 為我們的鏡像設置必要的環境變數
ENV GO111MODULE=on \
CGO_ENABLED=0 \
GOOS=linux \
GOARCH=amd64
# 移動到工作目錄:/build
WORKDIR /build
# 複製項目中的 go.mod 和 go.sum文件並下載依賴信息
COPY go.mod .
COPY go.sum .
RUN go mod download
# 將代碼複製到容器中
COPY . .
# 將我們的代碼編譯成二進位可執行文件 tracer
RUN go build -o tracer .
# 創建一個小鏡像
FROM scratch
# 靜態文件
COPY ./log /log
COPY ./config /config
# 當出現static文件或者template文件的時候需要配置
# COPY ./static /static
# COPY ./template /template
# 從builder鏡像中把/dist/tracer 拷貝到當前目錄
COPY --from=builder /build/tracer /
# 需要運行的命令
ENTRYPOINT ["/tracer", "config/config.ini"]
3、關聯其他容器
上面示例使用的方式是Docker+本地的mysql和本地的redis環境,關聯其他容器後使用的是Docker的鏡像環境
容器別名mysql8019
;root
用戶密碼為1234
;掛載容器中的/var/lib/mysql
到本地的/Users/user/docker/mysql
目錄;內部服務埠為3306,映射到外部的13306埠。
1.創建容器映射本地並運行
關聯mysql
# mysql
docker run --name mysql8019 -p 13306:3306 -e MYSQL_ROOT_PASSWORD=1234 -v /Users/user/docker/mysql:/var/lib/mysql -d mysql:8.0.19
創建好後使用命令測試進入Docker容器中的Mysql:mysql -uroot -p1234 -h 127.0.0.1 -P13306
示例:
user@C02FP58GML7H ~ % mysql -uroot -p1234 -h 127.0.0.1 -P13306
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.0.19 MySQL Community Server - GPL
Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
關聯redis
docker運行的每個容器都是隔離的,redis預設不允許外部連接,因此想要部署在docker容器內的應用連接上redis,需要修改redis預設配置,這裡我們以配置文件運行redis即可,也就是掛載本地的配置文件到docker容器。
配置文件需要去下載一份redis的壓縮包解壓後提取或複製redis.conf文件或者內容放到一個位置,此位置是用來專門掛載配置文件的。redis下載地址下載redis發行版,版本選擇與容器內的相匹配即可。
博主本人是在mac本地是安裝了redis的,所以偷懶直接引用了本地redis裡面的配置文件進行掛載。這裡預設使用root為用戶名,密碼為空,不輸入即可。
# redis
docker run --name redis626 -p 16379:6379 -v /Users/user/redis-6.2.6/redis.conf:/etc/redis/redis.conf -v /Users/user/docker/data:/data --restart=always -d redis:6.2.6 redis-server --appendonly yes
創建好後使用命令測試進入Docker容器中的Redis:./redis-cli -c -h 127.0.0.1 -p 16379
示例:(註:我沒有配置環境變數,所以需要先切換到redis的目錄下去使用本地的redis-cli)
user@C02FP58GML7H src % cd /Users/user/redis-6.2.6/src
user@C02FP58GML7H src % ./redis-cli -c -h 127.0.0.1 -p 16379
127.0.0.1:16379>
2.修改配置中的host為鏡像別名,重新構建鏡像
配置信息:
[server]
AppMode = debug
HttpPort = :8000
JwtKey = 123qwe456asd789zxc
[database]
Db = mysql
; DbHost = host.docker.internal
; DbHost = 127.0.0.1
DbHost = mysql8019
DbPort = 3306
DbUser = root
DbPassWord = 1234
DbName = tracer
[redis]
Rdb = redis
; RdbHost = host.docker.internal
; RdbHost = 127.0.0.1
RdbHost = redis626
RdbPort = 6379
RdbUser =
DdbPassWord =
RdbName = 0
RdbPoolSize = 100
構建鏡像命令:docker build . -t tracer_containers
運行容器命令:docker run --link=mysql8019:mysql8019 --link=redis626:redis626 -p 8888:8000 tracer_containers
註:運行tracer_containers
容器的時候需要使用--link
的方式與上面的mysql8019
容器和redis626
容器關聯起來,還有若顯示redis無法連接修改映射的配置文件中的bind=0.0.0.0即可
4、Docker Compose模式
除了使用--link的方式來關聯兩個容器之外,還可以使用Docker Compose定義和運行多個容器。
Compose:是用於定義和運行多容器 Docker 應用程式的工具。通過 Compose,可以使用 YML 文件來配置應用程式需要的所有服務。然後只要使用一個命令,就可以從 YML 文件配置中創建並啟動所有服務。
使用Compose的三步過程:
- 使用Dockerfile定義你的應用環境以便可以在任何地方複製。
- 定義組成應用程式的服務,docker-compose.yml以便它們可以在隔離的環境中一起運行。
- 執行docker-compose up命令來啟動並運行整個應用程式。
示例項目:需要三個容器分別運行mysql
、redis
和tracer_containers
,這裡需要修改redis映射的配置,bind 127.0.0.1 -::1
修改為:bind 0.0.0.0 -::1
,由於我這個是redis6.2.6版本,其他版本就把127.0.0.1
換成0.0.0.0
即可,否則無法訪問redis。
註:depends_on欄位僅能保證web服務啟動時,mysql服務處於Running狀態而不是Ready狀態,所以tracer_containers需要等待mysql啟動後再啟動,因此需要添加一個wait-for-it.sh
腳本文件,檢測mysql服務是否處於Ready狀態也就是mysql是否已經啟動完畢。Docker官網給出的wait-for-it.sh文件地址
docker-compose.yml文件配置
# yaml 配置
version: "3.7"
services:
mysql8019:
image: mysql:8.0.19
restart: "always"
ports:
- 13306:3306
command: "--default-authentication-plugin=mysql_native_password --init-file /data/application/init.sql"
# 賬號密碼
environment:
MYSQL_ROOT_PASSWORD: "1234"
MYSQL_DATABASE: "tracer"
MYSQL_PASSWORD: "1234"
# 文件夾以及文件映射
volumes:
- ./init.sql:/data/application/init.sql
redis626:
# 鏡像版本號
image: redis:6.2.6
# 埠號
ports:
- 16379:6379
# 失敗後總是重啟
restart: "always"
# 以配置文件的方式啟動 redis.conf
command: "redis-server /etc/redis/redis.conf --appendonly yes"
# 文件夾以及文件映射
volumes:
- /Users/user/docker/data:/data
- /Users/user/redis-6.2.6/redis.conf:/etc/redis/redis.conf
tracer_containers:
build: .
restart: "always"
# command: sh -c "./wait-for-it.sh mysql8019:3306 -- ./tracer ./config/config.ini" # shell腳本方式啟動
command: ["/wait-for-it.sh", "mysql8019:3306", "--", "/tracer", "config/config.ini"]
# 依賴啟動項
depends_on:
- mysql8019
- redis626
ports:
- 8888:8000
DockerFile文件修改
FROM golang:alpine AS builder
# 為我們的鏡像設置必要的環境變數
ENV GO111MODULE=on \
CGO_ENABLED=0 \
GOOS=linux \
GOARCH=amd64
# 移動到工作目錄:/build
WORKDIR /build
# 複製項目中的 go.mod 和 go.sum文件並下載依賴信息
COPY go.mod .
COPY go.sum .
RUN go mod download
# 將代碼複製到容器中
COPY . .
# 將我們的代碼編譯成二進位可執行文件 tracer
RUN go build -o tracer .
# 創建一個小鏡像
FROM debian:stretch-slim
# 靜態文件
COPY ./wait-for-it.sh /
COPY ./log /log
COPY ./config /config
# 從builder鏡像中把/dist/tracer 拷貝到當前目錄
COPY --from=builder /build/tracer /
RUN chmod 755 wait-for-it.sh
# 需要運行的命令(註釋掉下麵這一行)
# ENTRYPOINT ["/tracer", "config/config.ini"]
執行命令:docker-compose up(docker-compose up -d是後臺運行)
運行成功後的部分結果(docker-compose up):
tracer_containers_1 | wait-for-it.sh: mysql8019:3306 is available after 10 seconds
tracer_containers_1 | redis626:6379 0 100
tracer_containers_1 | [GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
tracer_containers_1 | - using env: export GIN_MODE=release
tracer_containers_1 | - using code: gin.SetMode(gin.ReleaseMode)
tracer_containers_1 |
tracer_containers_1 | [GIN-debug] POST /api/user/sms --> tracer/app/user.sendSms (3 handlers)
tracer_containers_1 | [GIN-debug] POST /api/user/register --> tracer/app/user.registerHandler (3 handlers)
tracer_containers_1 | [GIN-debug] POST /api/user/login --> tracer/app/user.loginHandler (3 handlers)
tracer_containers_1 | [GIN-debug] POST /api/user/login_sms --> tracer/app/user.loginSmsHandler (3 handlers)
tracer_containers_1 | [GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
tracer_containers_1 | Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
tracer_containers_1 | [GIN-debug] Listening and serving HTTP on :8000
後臺運行啟動結果(docker-compose up -d):
user@C02FP58GML7H tracer % docker-compose up -d
Creating network "tracer_default" with the default driver
Creating tracer_redis626_1 ... done
Creating tracer_mysql8019_1 ... done
Creating tracer_tracer_containers_1 ... done