引言
在我開源的 藍眼云盤 (https://github.com/eyebluecn/tank) 中有 網(wǎng)友建議 道使用docker并且push到DockerHub上缤苫,這樣子就可以一行代碼直接安裝藍眼云盤了速兔。這個提議非常好,因此本篇文章就記錄下藍眼云盤docker化的整個詳細過程活玲。在閱讀這篇文章之前涣狗,讀者需要具有Docker基礎,我推薦閱讀 《Docker — 從入門到實踐》 舒憾。
目標
- 熟悉docker和docker-compose的基本操作
- 熟悉將 golang 工程部署到docker的整個流程
- 能夠在docker中快速啟動藍眼云盤镀钓,訪問 http://server-ip:6010 可以看到首頁內容
環(huán)境
1. 宿主機環(huán)境
$ cat /etc/redhat-release
CentOS Linux release 7.4.1708 (Core)
宿主機不要求和我完全一致,其他版本的Linux也行镀迂,甚至Mac Os, Windows 丁溅,只要能安裝docker都行。
2. docker
$ docker version
Client:
Version: 18.01.0-ce
API version: 1.35
Go version: go1.9.2
Git commit: 03596f5
Built: Wed Jan 10 20:07:19 2018
OS/Arch: linux/amd64
Experimental: false
Orchestrator: swarm
Server:
Engine:
Version: 18.01.0-ce
API version: 1.35 (minimum version 1.12)
Go version: go1.9.2
Git commit: 03596f5
Built: Wed Jan 10 20:10:58 2018
OS/Arch: linux/amd64
Experimental: false
docker 盡量使用最新版本
構建Docker鏡像
1. 準備源代碼
clone 項目 Github后端tank地址 到本地探遵。
# 可以根據(jù)自己的實際情況窟赏,決定項目放置的位置
$ mkdir -p /data/group/golang/
$ cd /data/group/golang/
# clone 藍眼云盤項目
$ git clone https://github.com/eyebluecn/tank.git
$ cd tank
2. 制作Dockerfile文件
我們需要從源代碼開始編譯整個項目妓柜,Dockerfile文件描述整個構建的過程。
在tank根目錄下創(chuàng)建文件Dockerfile
涯穷。
在clone下來的藍眼云盤項目中棍掐,Dockerfile
已經(jīng)存在了,你可以直接閱讀Dockerfile
中的內容拷况,或者刪除這個文件重新創(chuàng)建作煌,以作學習練習使用。
Dockerfile
的內容如下:
# 使用1.9的golang作為母鏡像
FROM golang:1.9
# 維護者信息赚瘦,也就是作者的姓名和郵箱
MAINTAINER eyeblue "eyebluecn@126.com"
# 指定工作目錄就是 tank粟誓。工作目錄指的就是以后 每層構建的當前目錄 。
WORKDIR $GOPATH/src/tank
# 將tank項目下的所有文件移動到golang鏡像中去
COPY . $GOPATH/src/tank
# 這里為了維持docker無狀態(tài)性蚤告,準備數(shù)據(jù)卷作為日志目錄和上傳文件目錄
VOLUME /data/log
VOLUME /data/matter
# 通過環(huán)境變量的方式努酸,為應用指定日志目錄和上傳文件目錄服爷。
ENV TANK_LOG_PATH=/data/log TANK_MATTER_PATH=/data/matter
# golang.org庫國內無法下載杜恰,這里從我準備的github中clone
# github.com的庫可以直接通過`go get`命令下載
# `go install tank`是對項目進行打包
# `cp`是將項目需要的html等文件移動到可執(zhí)行文件的目錄下。
RUN git clone https://github.com/eyebluecn/golang.org.git $GOPATH/src/golang.org \
&& go get github.com/disintegration/imaging \
&& go get github.com/json-iterator/go \
&& go get github.com/go-sql-driver/mysql \
&& go get github.com/jinzhu/gorm \
&& go get github.com/nu7hatch/gouuid \
&& go install tank \
&& cp -r $GOPATH/src/tank/build/* $GOPATH/bin
# 聲明運行時容器提供服務端口仍源,這只是一個聲明心褐。默認是6010端口
EXPOSE 6010
# tank作為執(zhí)行文件 啟動這個容器就會去執(zhí)行 `/go/bin/tank`
ENTRYPOINT ["/go/bin/tank"]
3. 開始構建docker鏡像
首先保證當前目錄是Dockerfile
所在的目錄,然后執(zhí)行以下指令即可開始構建:
$ docker build -t eyeblue/tank:1.0.2 .
其中eyeblue
是我的 Docker Hub
ID笼踩,tank
是鏡像名逗爹,1.0.2
是我當前構建的鏡像版本。
注意最后的小點.
不要遺漏了嚎于。
如果構建成功掘而,會看到以下提示
Successfully built 3cc1bf6757af
Successfully tagged eyeblue/tank:1.0.2
4. 推送到遠程
只有當我們把自己構建的鏡像push到Docker Hub后,別人才能很方便的下載于购,一行命令執(zhí)行我們的應用袍睡。如果你對Docker Hub注冊,或者命令行登錄不熟悉肋僧,請參考這篇文章:《Docker Hub》
推送到遠程的指令如下:
$ docker push eyeblue/tank:1.0.2
如果命令執(zhí)行成功斑胜,你將看到以下提示
The push refers to repository [docker.io/eyeblue/tank]
62f3bd4ed81c: Pushed
b417ac3c9fc9: Pushed
2a7192ac3426: Pushed
b7600cc31df2: Mounted from library/golang
690bf254e66f: Mounted from library/golang
23c5addd579d: Mounted from library/golang
af1e37edd79f: Mounted from library/golang
b31411566900: Mounted from library/golang
06f4de5fefea: Mounted from library/golang
851f3e348c69: Mounted from library/golang
e27a10675c56: Mounted from library/golang
1.0.2: digest: sha256:7ba3c6b95ab5fef022342543fbb7cff5bf8b61c2ae2795900c83ba616da32375 size: 2635
運行項目
1. docker-compose 安裝
我們的藍眼云盤項目在運行的時候依賴mysql
數(shù)據(jù)庫,在docker中運行一個鏡像依賴另一個鏡像的時候就要使用到docker-compose
嫌吠。首先進入docker-compose
的下載頁 止潘。找到一個穩(wěn)定版本的安裝腳本,在命令行中執(zhí)行便可辫诅。
$ curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
$ chmod +x /usr/local/bin/docker-compose
2. 編寫docker-compose.yml
docker-compose.yml
描述了鏡像啟動的數(shù)據(jù)卷凭戴,環(huán)境變量,啟動方式炕矮,依賴項等簇宽。運行藍眼云盤的docker-compose.yuml
如下:
#docker-compose版本勋篓,這里的3不要動
version: "3"
services:
# 數(shù)據(jù)庫的鏡像信息
# 使用mysql:5.7的鏡像
db:
image: mysql:5.7
volumes:
# 數(shù)據(jù)庫文件存放在宿主機的`~/data/mysql`位置,如果宿主機目錄不存在魏割,則會自動創(chuàng)建
- ~/data/mysql:/var/lib/mysql
# 如果啟動失敗譬嚣,則總是會重啟。因為鏡像有依賴的情況钞它,不停重啟可以保證依賴項啟動成功后自己再運行
restart: always
environment:
# 指定root密碼為`tank123`拜银,并且創(chuàng)建一個新數(shù)據(jù)庫`tank`,同時用戶名和密碼為`tank` `tank123`
MYSQL_ROOT_PASSWORD: tank123
MYSQL_DATABASE: tank
MYSQL_USER: tank
MYSQL_PASSWORD: tank123
# 藍眼云盤的鏡像信息
# 依賴 mysql:5.7 的鏡像
tank:
image: eyeblue/tank:1.0.2
depends_on:
- db
ports:
# 端口映射關系遭垛,宿主機端口:鏡像端口
- "6010:6010"
# 如果啟動失敗尼桶,則總是會重啟。因為鏡像有依賴的情況锯仪,不停重啟可以保證依賴項啟動成功后自己再運行
restart: always
environment:
# mysql的端口
TANK_MYSQL_PORT: 3306
# Mysql的主機泵督,和services的第一個節(jié)點一致。
TANK_MYSQL_HOST: db
# 數(shù)據(jù)庫
TANK_MYSQL_SCHEMA: tank
# 數(shù)據(jù)庫的用戶名
TANK_MYSQL_USERNAME: tank
# 數(shù)據(jù)庫的密碼
TANK_MYSQL_PASSWORD: tank123
# 超級管理員的昵稱庶喜。只能是英文或數(shù)字
TANK_ADMIN_USERNAME: admin
# 超級管理員郵箱小腊,作為登錄賬號
TANK_ADMIN_EMAIL: admin@tank.eyeblue.cn
# 超級管理員密碼,作為登錄密碼
TANK_ADMIN_PASSWORD: 123456
volumes:
# 日志文件存放在宿主機的`~/data/tank/log`位置久窟,如果宿主機目錄不存在秩冈,則會自動創(chuàng)建
- ~/data/tank/log:/data/log
# 上傳文件存放在宿主機的`~/data/tank/matter`位置,如果宿主機目錄不存在斥扛,則會自動創(chuàng)建
- ~/data/tank/matter:/data/matter
3. 運行項目
首先保證當前目錄是docker-compose.yml
所在的目錄入问,然后執(zhí)行以下指令即可運行藍眼云盤:
$ docker-compose up -d
4. 驗證
由于數(shù)據(jù)庫啟動需要一定的時間,因此大約20s后稀颁,打開瀏覽器訪問http://127.0.0.1:6010
芬失,如果看到以下界面則表示運行成功。
[圖片上傳失敗...(image-a9a12-1517293121825)]
5. 停止項目
方法一:使用以下命令來停止藍眼云盤
$ docker-compose stop
方法二:當然你也可以用停止容器的方式來停止藍眼云盤
$ docker container ls
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
f5f64735fc53 eyeblue/tank:1.0.2 "/go/bin/tank" 20 minutes ago Up 13 seconds 0.0.0.0:6010->6010/tcp tank_tank_1
3a859cad3e7e mysql:5.7 "docker-entrypoint.s…" 20 minutes ago Up 14 seconds 3306/tcp tank_db_1
$ docker container stop f5
$ docker container stop 3a
參考文章
Docker實戰(zhàn) - 將golang工程部署到docker
原文發(fā)布于藍眼博客 https://blog.eyeblue.cn/home/article/510f9316-9ca1-40fe-b1b3-5285505a527d