docker-compose 容器因为依赖关系自启动失败问题（harbor 问题案例）

傷城~ 2022-12-23 06:57 203阅读 0赞

## 问题描述 ##

harbor 由多个容器各司其职来完成整个工作的，每个容器启动有顺序要求，官方通过 `docker-compose.yml` 文件对容器进行编排，使用 `depends_on` 定义依赖关系决定了容器的启动顺序。常规来说，正常使用 `docker-compose` 来启动容器不会存在任何问题，各个容器服务都能正常启动并运行。

但是，我还是喜欢说但是……

我们看到 harbor 的 docker-compose.yml 中为所有容器都配置了 `restart: always`，这表示所有的容器在意外关闭后都会自动重启，比如 docker 重启或服务器重启。

然而……

docker 本身对容器的启动是不区分顺序的，也就是你可以认为 `depends_on` 是 `docker-compose` 独有的功能。当我们服务器重启后，docker 会将设定 `restart: always` 的容器启动（不分先后顺序）。而我们实际的业务需要又会因为启动顺序问题导致一些容器启动失败，这样就出现了我们的 harbor 在服务器重启后可能出现部分容器启动失败的问题。

那么，如何解决这个问题呢？

解铃还须系铃人，还是要通过 `docker-compose` 来解决这个问题。

## 解决方案 ##

写一个系统服务（将 harbor 配置为 systemd 的 service），将 `docker-compose up -d` 纳入启动命令中，将 `docker-compose down` 纳入停止命令中，这样将服务配置为随系统启动即可。

添加配置文件 `/usr/lib/systemd/system/harbor.service`，内容如下：

[Unit]
    Description=Harbor
    After=docker.service systemd-networkd.service systemd-resolved.service
    Requires=docker.service
    Documentation=http://github.com/vmware/harbor
    
    [Service]
    Type=simple
    Restart=on-failure
    RestartSec=5
    ExecStart=/usr/local/bin/docker-compose -f {
       { harbor_install_path }}/harbor/docker-compose.yml up
    ExecStop=/usr/local/bin/docker-compose -f {
       { harbor_install_path }}/harbor/docker-compose.yml down
    
    [Install]
    WantedBy=multi-user.target

> 其中 `{ { harbor_install_path }}` 为我们 harbor 的安装目录，请注意修改为实际路径。  
> docker-compose 也是绝对路径，可以通过命令 `which docker-compose` 查看。

设置服务为随系统自启，然后启动服务

# 设置开机自启
    sudo systemctl enable harbor
    # 启动服务
    sudo systemctl start harbor

> 注意：命令 `sudo systemctl stop harbor` 请结合自己实际情况使用，我们上面配置的 stop 使用的是 down 命令，如果你需要 stop 请注意修改 ExecStop 最后的参数为 stop，下面是关于 docker-compose 几个常用参数的解释，请结合自己实际需求选用：
> 
>  *  down：Stop and remove containers, networks, images, and volumes
>  *  stop：Stop services
>  *  start：Start services
>  *  restart：Restart services

最后，大胆的重启你的服务器验证一下结果吧，服务一定会全部 UP。

--------------------

（END）