Docker实践2：用Docker搭建hg-server
最后更新于：2022-04-01 06:43:25
如果有人已经将hg server的image做好了，那么我还要自己作吗？答案是拿来用吧。
#### 一、安装
用hg为关键词搜索，得出以下结果：
~~~
$ docker search hg
NAME DESCRIPTION STARS OFFICIAL AUTOMATED
hgomez/gatling 1 [OK]
v7soft/hgdns 0 [OK]
hg8496/gridvis-service 0 [OK]
hgomez/di-centos6-myjenkins-lts 0 [OK]
jrandall/hgi-project 0 [OK]
hgomez/di-centos6-myartifactory 0 [OK]
hgomez/di-centos6-myjenkins 0 [OK]
hgomez/di-centos6-mynexus 0 [OK]
hgomez/di-centos6-myarchiva 0 [OK]
hg8496/piwigo 0 [OK]
hg8496/apache 0 [OK]
hgomez/di-centos6-mygitblit 0 [OK]
hgomez/di-centos6-mygitbucket 0 [OK]
jyotisingh/ubuntu-hg 0
hg8496/dokuwiki 0 [OK]
hg8496/owncloud 0 [OK]
misshie/ucsc-blat-hg19 0 [OK]
ussie/hg-exec adds mercurial to ubuntu:14.04. 0
misshie/ucsc-blat-hg38 0 [OK]
hg8496/gridvis-pc 0 [OK]
Test. Automated builds for this repo are b... 0 [OK]
hg8496/rsync 0 [OK]
secondbit/hgbundler 0
uotbw/hgamer3d Docker image for hgamer3d, see www.hgamer3... 0
hgomez/di-centos6-base 0 [OK]
~~~
hgweb貌似不错的选择，在github上的主页是https://github.com/amclain/docker-hgweb 。
将其pull下来，在漫长的等待中我也在思考着如何启动它。
主页上提供了它的Dockerfile，通过它我们就可以了解这个image是如果构造的。先来说说什么是Dockerfile。
#### 二、Dockerfile
它是用户创建自定义镜像的文件。它通常分为四部分：基础镜像信息，维护者信息，镜像操作指令和容器启动时的指令。
~~~
#基础系统信息，基于ubuntu 14.04构建的
FROM ubuntu:14.04
MAINTAINER Alex McLain
RUN apt-get -qq update
#安装apache、hg、php5
RUN apt-get -y install apache2 apache2-utils curl mercurial php5 php5-cli php5-mcrypt
# TODO: Remove
#是的，vim确实很大，不安装为好
RUN apt-get -y install vim
RUN echo "colorscheme delek" > ~/.vimrc
# Configure hgweb
ADD hg/add.php /etc/default/hgweb/hg/
ADD hg/hgweb.config /etc/default/hgweb/hg/
ADD hg/hgweb.cgi /etc/default/hgweb/hg/
ADD hg/hgusers /etc/default/hgweb/hg/
# Configure Apache
ADD apache/hg.conf /etc/default/hgweb/apache/
RUN rm /etc/apache2/sites-enabled/*
RUN a2enmod rewrite && a2enmod cgi
ADD load-default-scripts /bin/
RUN chmod u+x /bin/load-default-scripts
#创建一个挂载点，本机或其他容器可以将其挂载。启动时用-v参数进行挂载
VOLUME /var/hg
VOLUME /etc/apache2/sites-available
#暴露的端口号，启动时要通过-p参数指定
EXPOSE 80
#启动时执行的命令
CMD load-default-scripts && service apache2 start && /bin/bash
~~~
#### 三、启动
有了上述的背景，我们知道启动时要做两件事：指定端口号、挂载本地目录。
比如还是使用端口号80，那么只需用 -p 80:80即可。
比如本机目录hg-repos用来做hg repo的放置目录，只需 -v /home/linc/hg-repos:/var/hg/repos 挂载即可。
另外，我们还要将其启动在后台（Daemonized），加上-d参数。
完整启动命令如下：
` docker run -idt -p 80:80 -v /home/linc/hg-repos:/var/hg/repos amclain/hgweb `
#### 四、与后台容器交互
**1.attach方法**
docker 自带attach命令，但此命令的不方便之处在于，多个窗口（同时attach此容器）会同步显示操作，并且当一个窗口exit时，所有窗口都会退出，后台运行的容器也停止了。
~~~
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
b22cc1880b7a amclain/hgweb:latest "/bin/sh -c 'load-de 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp high_almeida
$ docker attach b22cc1880b7a
root@b22cc1880b7a:/#
~~~
**2.nsenter**
此工具需要从源码安装：
~~~
$ cd /tmp; curl https://www.kernel.org/pub/linux/utils/util-linux/v2.24/util-linux-2.24.tar.gz | tar -zxf-; cd util-linux-2.24;
$ ./configure --without-ncurses
$ make nsenter && sudo cp nsenter /usr/local/bin
~~~
直接用nsenter命令交互很繁琐，然后有人写了配置文件放到bashrc中，就可以方便的使用了。
~~~
#docker
export DOCKER_HOST=tcp://localhost:4243
alias docker-pid="sudo docker inspect --format '{{.State.Pid}}'"
alias docker-ip="sudo docker inspect --format '{{ .NetworkSettings.IPAddress }}'"
#the implementation refs from https://github.com/jpetazzo/nsenter/blob/master/docker-enter
function docker-enter() {
if [ -e $(dirname "$0")/nsenter ]; then
# with boot2docker, nsenter is not in the PATH but it is in the same folder
NSENTER=$(dirname "$0")/nsenter
else
NSENTER=nsenter
fi
[ -z "$NSENTER" ] && echo "WARN Cannot find nsenter" && return
if [ -z "$1" ]; then
echo "Usage: `basename "$0"` CONTAINER [COMMAND [ARG]...]"
echo ""
echo "Enters the Docker CONTAINER and executes the specified COMMAND."
echo "If COMMAND is not specified, runs an interactive shell in CONTAINER."
else
PID=$(sudo docker inspect --format "{{.State.Pid}}" "$1")
if [ -z "$PID" ]; then
echo "WARN Cannot find the given container"
return
fi
shift
OPTS="--target $PID --mount --uts --ipc --net --pid"
if [ -z "$1" ]; then
# No command given.
# Use su to clear all host environment variables except for TERM,
# initialize the environment variables HOME, SHELL, USER, LOGNAME, PATH,
# and start a login shell.
#sudo $NSENTER "$OPTS" su - root
sudo $NSENTER --target $PID --mount --uts --ipc --net --pid su - root
else
# Use env to clear all host environment variables.
sudo $NSENTER --target $PID --mount --uts --ipc --net --pid env -i $@
fi
fi
}
~~~
其中有两个alias和一个function，使用docker-enter会很容易于容器交互并没有attach中的副作用。如下：
~~~
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
beb178cd9335 amclain/hgweb:latest "/bin/sh -c 'load-de 11 seconds ago Up 10 seconds 0.0.0.0:80->80/tcp stoic_yonath
$ docker-enter beb178cd9335
root@beb178cd9335:~# ls
root@beb178cd9335:~# pwd
/root
~~~
#### 五、快速启动hg-server
咱也写个alias放子bashrc中，如下：
` alias docker-load-hg-server="sudo docker run -idt -p 80:80 -v /home/linc/hg-repos:/var/hg/repos amclain/hgweb" `
启动它：
~~~
$ docker-load-hg-server
[sudo] password for linc:
beb178cd933502970fd12d9a4babecef5475a52d85a207066c665b4a620c5a62
~~~
**改进**
对于文件的挂载，其实直接挂镜像的/var/hg更好，这样里面的几个配置文件如hgusers hgweb.cgi hgweb.config，我们可以直接进行配置。
~~~
sudo docker run -idt -p 80:80 -v /home/linc/hg-repos:/var/hg amclain/hgweb
~~~