概要
docker-compose 可以方便組合多個(gè) docker 容器服務(wù), 但是, 當(dāng)容器服務(wù)之間存在依賴(lài)關(guān)系時(shí), docker-compose 并不能保證服務(wù)的啟動(dòng)順序.
docker-compose 中的 depends_on 配置是容器的啟動(dòng)順序, 并不是容器中服務(wù)的啟動(dòng)順序.
問(wèn)題重現(xiàn)
首先, 我們構(gòu)造一個(gè)示例, 來(lái)演示 docker-compose 帶來(lái)的問(wèn)題. docker-compose.yml 文件如下:
version: '2'
services:
web:
image: ubuntu:14.04
depends_on:
- web
command: nc -z database 3306
database:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 5;
echo "sleep over";
nc -lk 0.0.0.0 3306;
'
啟動(dòng)后, 可以發(fā)現(xiàn), 確實(shí)是先啟動(dòng) database, 后啟動(dòng) web, 但是 database 中的服務(wù)是在大約 5 秒后才完成的, 所以導(dǎo)致 web 的啟動(dòng)失敗.
$ docker-compose up
Creating tmp_database_1 ... done
Creating tmp_database_1 ...
Creating tmp_web_1 ... done
Attaching to tmp_database_1, tmp_web_1
tmp_web_1 exited with code 1
database_1 | sleep over
問(wèn)題解決方式 1.0
修改 web 的啟動(dòng)腳本, 等待 database 的端口通了之后再啟動(dòng)服務(wù)
version: '2'
services:
web:
image: ubuntu:14.04
depends_on:
- database
command: >
/bin/bash -c '
while ! nc -z database 3306;
do
echo "wait for database";
sleep 1;
done;
echo "database is ready!";
echo "start web service here";
'
database:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 5;
echo "sleep over";
nc -lk 0.0.0.0 3306;
'
再次啟動(dòng),
$ docker-compose up
Creating tmp_database_1 ... done
Creating tmp_database_1 ...
Creating tmp_web_1 ... done
Attaching to tmp_database_1, tmp_web_1
web_1 | wait for database
web_1 | wait for database
web_1 | wait for database
web_1 | wait for database
web_1 | wait for database
database_1 | sleep over
web_1 | database is ready!
web_1 | start web service here
tmp_web_1 exited with code 0
web 會(huì)在 database 啟動(dòng)完成, 端口通了之后才啟動(dòng).
問(wèn)題解決方式 2.0
上面的解決方式雖然能夠解決問(wèn)題, 但是在 yaml 中直接插入腳本不好維護(hù), 也容易出錯(cuò). 如果有多個(gè)依賴(lài), 或者多層依賴(lài)的時(shí)候, 復(fù)雜度會(huì)直線上升.
所以, 要封裝一個(gè) entrypoint.sh 腳本, 可以接受啟動(dòng)命令, 以及需要等待的服務(wù)和端口. 腳本內(nèi)容如下:
#!/bin/bash
#set -x
#******************************************************************************
# @file : entrypoint.sh
# @author : wangyubin
# @date : 2018-08- 1 10:18:43
#
# @brief : entry point for manage service start order
# history : init
#******************************************************************************
: ${SLEEP_SECOND:=2}
wait_for() {
echo Waiting for $1 to listen on $2...
while ! nc -z $1 $2; do echo waiting...; sleep $SLEEP_SECOND; done
}
declare DEPENDS
declare CMD
while getopts "d:c:" arg
do
case $arg in
d)
DEPENDS=$OPTARG
;;
c)
CMD=$OPTARG
;;
?)
echo "unkonw argument"
exit 1
;;
esac
done
for var in ${DEPENDS//,/ }
do
host=${var%:*}
port=${var#*:}
wait_for $host $port
done
eval $CMD
這個(gè)腳本有 2 個(gè)參數(shù), -d 需要等待的服務(wù)和端口, -c 等待的服務(wù)和端口啟動(dòng)之后, 自己的啟動(dòng)命令
修改 docker-compose.yml, 使用 entrypoint.sh 腳本來(lái)控制啟動(dòng)順序.
version: '2'
services:
web:
image: ubuntu:14.04
depends_on:
- database
volumes:
- "./entrypoint.sh:/entrypoint.sh"
entrypoint: /entrypoint.sh -d database:3306 -c 'echo "start web service here"';
database:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 5;
echo "sleep over";
nc -lk 0.0.0.0 3306;
'
實(shí)際使用中, 也可以將 entrypoint.sh 打包到發(fā)布的鏡像之中, 不用通過(guò) volumes 配置來(lái)加載 entrypoint.sh 腳本.
測(cè)試結(jié)果如下:
$ docker-compose up
Starting tmp_database_1 ... done
Starting tmp_web_1 ... done
Attaching to tmp_database_1, tmp_web_1
web_1 | Waiting for database to listen on 3306...
web_1 | waiting...
web_1 | waiting...
web_1 | waiting...
database_1 | sleep over
web_1 | start web service here
tmp_web_1 exited with code 0
補(bǔ)充
依賴(lài)多個(gè)服務(wù)和端口
使用上面的 entrypoint.sh 腳本, 也可以依賴(lài)多個(gè)服務(wù)和端口, -d 參數(shù)后面的多個(gè)服務(wù)和端口用逗號(hào)(,)隔開(kāi).
version: '2'
services:
web:
image: ubuntu:14.04
depends_on:
- mysql
- postgresql
volumes:
- "./entrypoint.sh:/entrypoint.sh"
entrypoint: /entrypoint.sh -d mysql:3306,postgresql:5432 -c 'echo "start web service here"';
mysql:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 4;
echo "sleep over";
nc -lk 0.0.0.0 3306;
'
postgresql:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 8;
echo "sleep over";
nc -lk 0.0.0.0 5432;
'
執(zhí)行的效果可以自行嘗試.
嘗試間隔的配置
每次嘗試連接的等待時(shí)間可以通過(guò) 環(huán)境變量 SLEEP_SECOND 來(lái)配置, 默認(rèn) 2 秒 下面的配置等待時(shí)間設(shè)置為 4 秒, 就會(huì)每隔 4 秒才去嘗試 mysql 服務(wù)時(shí)候可連接.
version: '2'
services:
web:
image: ubuntu:14.04
environment:
SLEEP_SECOND: 4
depends_on:
- mysql
volumes:
- "./entrypoint.sh:/entrypoint.sh"
entrypoint: /entrypoint.sh -d mysql:3306 'echo "start web service here"';
mysql:
image: ubuntu:14.04
command: >
/bin/bash -c '
sleep 4;
echo "sleep over";
nc -lk 0.0.0.0 3306;
'
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。