Docker 化你的開源項目

引言

在我開源的 藍眼云盤 (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 — 從入門到實踐

Docker實戰(zhàn) - 將golang工程部署到docker

原文發(fā)布于藍眼博客 https://blog.eyeblue.cn/home/article/510f9316-9ca1-40fe-b1b3-5285505a527d

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末匾灶,一起剝皮案震驚了整個濱河市棱烂,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌粘昨,老刑警劉巖垢啼,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異张肾,居然都是意外死亡芭析,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進店門吞瞪,熙熙樓的掌柜王于貴愁眉苦臉地迎上來馁启,“玉大人,你說我怎么就攤上這事」吒恚” “怎么了翠勉?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長霉颠。 經(jīng)常有香客問我对碌,道長,這世上最難降的妖魔是什么蒿偎? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任朽们,我火速辦了婚禮,結果婚禮上诉位,老公的妹妹穿的比我還像新娘骑脱。我一直安慰自己,他們只是感情好苍糠,可當我...
    茶點故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布叁丧。 她就那樣靜靜地躺著,像睡著了一般岳瞭。 火紅的嫁衣襯著肌膚如雪拥娄。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天寝优,我揣著相機與錄音条舔,去河邊找鬼枫耳。 笑死乏矾,一個胖子當著我的面吹牛,可吹牛的內容都是我干的迁杨。 我是一名探鬼主播钻心,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼铅协!你這毒婦竟也來了捷沸?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤狐史,失蹤者是張志新(化名)和其女友劉穎痒给,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體骏全,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡苍柏,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了姜贡。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片试吁。...
    茶點故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖楼咳,靈堂內的尸體忽然破棺而出熄捍,到底是詐尸還是另有隱情烛恤,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布余耽,位于F島的核電站缚柏,受9級特大地震影響,放射性物質發(fā)生泄漏碟贾。R本人自食惡果不足惜船惨,卻給世界環(huán)境...
    茶點故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望缕陕。 院中可真熱鬧粱锐,春花似錦、人聲如沸扛邑。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽蔬崩。三九已至恶座,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間沥阳,已是汗流浹背跨琳。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留桐罕,地道東北人脉让。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓,卻偏偏與公主長得像功炮,于是被迫代替她去往敵國和親溅潜。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內容

  • Docker — 云時代的程序分發(fā)方式 要說最近一年云計算業(yè)界有什么大事件薪伏?Google Compute Engi...
    ahohoho閱讀 15,530評論 15 147
  • 0. 前言 docker是什么滚澜?docker是用GO語言開發(fā)的應用容器引擎,基于容器化嫁怀,沙箱機制的應用部署技術设捐。可...
    sessionboy閱讀 3,851評論 2 49
  • 一 塘淑、什么是 Docker Docker 最初是 dotCloud 公司創(chuàng)始人 Solomon Hykes 在法國...
    Blazzer閱讀 3,133評論 0 13
  • 是結束萝招,也是開始...... 西藏之行結束的那天下午,我獨自一人在拉薩火車站坐上了回京的火車朴爬。 天漸漸黑了下來即寒。窗...
    君君1001閱讀 883評論 21 31
  • 你說三亞又降溫了 我這里不 因為一直都冷 我戴上帽子和手套 冷從縫隙里鉆 在我身上取暖 有人說為啥冬天人就喜歡賴床...
    覺知之光閱讀 91評論 1 2