如何在 docker-compose 文件中用 `depends_on` 替换 `links`？

Question

docker compose documentation 指定 links 已弃用，应替换为 depends_on。我不知道具体是怎么做的。

这是具有 3 个服务的应用程序的工作 docker-compose 文件（带有 links 指令）：

• 一个 nginx 反向代理
• 一个 nodejs 应用程序
• 一个php api

---

version: "3.1"

services:

  nginx:
    image: nginx:alpine
    ports:
      - "8000:80"
    volumes:
      - ./php/content:/srv/www/content
      - ./static:/srv/www/static
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
    links:
      - php:php-app
      - nodejs:nodejs-app

  nodejs:
    image: node:alpine
    environment: 
      NODE_ENV: production
    working_dir: /home/app
    restart: always
    volumes:
      - ./nodejs:/home/app
    links:
      - php:php-app
    command: ["node", "index"]

  php:
    image: php:apache
    volumes:
      - ./php:/var/www/html

---

相关nginxdefault.conf：

server {
  listen 80;
  root /srv/www;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;

  location / {
    try_files $uri @nodejs;  
  }

  location /api {
    rewrite ^([^.\?]*[^/])$ $1/ break;
    proxy_pass http://php-app:80;
  }

  location @nodejs {
    proxy_pass http://nodejs-app:8080;
  }
}

---

links 指令将 docker 服务名称的别名设置为 nginx 配置中的 proxy_pass 名称。

如何在不修改 nginx 配置（并保留别名）的情况下用 depends_on 替换 docker-compose 文件中的 links 指令？

Answer 1

docker compose 文档指定 links 已弃用，应替换为 depends_on。

它没有。文档只说，

links也和depends_on一样表达服务之间的依赖关系，所以它们决定了服务启动的顺序。

我看不出这是如何得出结论的，您应该使用depends_on 而不是links。相反，它说，如果您需要在另一个容器中运行某个容器中的某些内容，您应该使用depends_on，而不是links。 （比如你command-指定在php容器中运行迁移，需要等待postgres容器）。

另一方面，links 有一个警告说

除非您绝对需要继续使用它，否则我们建议您使用用户定义的网络来促进两个容器之间的通信，而不是使用--link。

在这种情况下，--link for docker cli 与 links in docker-compose.yml 相同。

现在，重点是，如果您将容器放在一个网络上，则不需要任何进一步的特殊规范。除非您另外指定，否则默认网络驱动程序为 bridge。因此，如果您按以下方式指定 docker-compose.yml，您应该将所有容器都放在一个网络上并自动相互感知。

version: "3.1"

services:
  nginx:
    image: nginx:alpine
    ports:
      - "8000:80"
    volumes:
      - ./php/content:/srv/www/content
      - ./static:/srv/www/static
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
  nodejs:
    image: node:alpine
    environment: 
      NODE_ENV: production
    working_dir: /home/app
    restart: always
    volumes:
      - ./nodejs:/home/app
    command: ["node", "index"]
  php:
    image: php:apache
    volumes:
      - ./php:/var/www/html

在这种情况下，nginx 应该可以使用

location / {
    try_files $uri nodejs;
}

和

location /api {
    rewrite ^([^.\?]*[^/])$ $1/ break;
    proxy_pass http://php:80;
}