如何在Ansible docker_service中配置容器开机自启（树莓派场景）

我之前在树莓派上用Ansible的docker_service模块时，也踩过这个容器重启的坑！确实，docker_container模块有直接的restart_policy参数，但docker_service因为基于Docker Compose，得用Compose的语法来配置自启——文档里没明确说这点，很容易让人困惑。

核心解决方案：在definition里添加Compose风格的重启策略 #

docker_service的definition字段完全兼容Docker Compose的配置语法，所以你只需要给每个需要自启的服务加上restart字段就行，和你用docker_container的restart_policy: always效果一致。比如这样配置：

- name: 启动带依赖的容器服务
  docker_service:
    project_name: rpi_app_stack
    definition:
      version: '3'
      services:
        # 前端服务，依赖后端API
        frontend:
          image: my-rpi-frontend:latest
          restart: always  # 配置开机自启
          ports:
            - "80:80"
          depends_on:
            - backend
        # 后端API服务，依赖数据库
        backend:
          image: my-rpi-backend:latest
          restart: always
          environment:
            DB_HOST: db
          depends_on:
            - db
        # 数据库服务
        db:
          image: postgres:15-alpine
          restart: always
          volumes:
            - db_data:/var/lib/postgresql/data
      volumes:
        db_data:
    state: present

这里的restart字段支持所有Docker Compose的重启策略：

• always：无论容器因何停止，都会自动重启（包括系统重启）
• unless-stopped：系统重启时会自动启动，除非你手动停止过该容器
• on-failure：只有容器因错误退出时才重启

额外检查：确保Docker服务本身开机自启 #

如果树莓派重启后Docker服务都没起来，那容器肯定也启动不了。可以加个Ansible任务确保Docker服务自启：

- name: 确保Docker服务开机自启并运行
  service:
    name: docker
    enabled: yes
    state: started

为什么之前配置没生效？ #

大概率是没意识到docker_service直接复用Compose的配置项，文档里可能只强调了模块特有的参数，没明确说明兼容Compose的所有服务配置。用上面的方法配置后，容器不仅能保留依赖关系，还能在树莓派断电恢复后自动启动。

内容的提问来源于stack exchange，提问作者Jéan