如何通过Ansible的docker_network模块为已有Docker容器指定IP添加网络？

可以实现，不需要依赖docker_container模块，以下是两种直接可行的方案：

方案1：使用Shell模块调用Docker CLI（最直接） #

利用docker network connect命令的--ip参数，直接为容器指定目标网络的静态IP并完成连接。

步骤1：先创建支持静态IP的自定义网络（如果未创建） #

- name: 创建带IPAM配置的自定义网络
  docker_network:
    name: network_nextcloud
    ipam_config:
      - subnet: 172.18.0.0/24
        gateway: 172.18.0.1
  when: OPENLDAP_MAP_WITH_NEXTCLOUD == "yes"

步骤2：为容器指定IP并连接到网络 #

- name: 检查容器是否已连接到目标网络
  shell: docker inspect -f '{{range .NetworkSettings.Networks}}{{.Name}} {{end}}' openldap_app | grep -q network_nextcloud
  register: container_connected
  ignore_errors: yes
  changed_when: false

- name: 为容器指定IP并连接到网络
  shell: docker network connect --ip 172.18.0.10 network_nextcloud openldap_app
  when: OPENLDAP_MAP_WITH_NEXTCLOUD == "yes" and container_connected.rc != 0

方案2：利用docker_network模块+预分配IP池（间接方式） #

如果希望尽量使用Ansible的Docker模块而非直接调用CLI，可以先创建带有静态IP池的网络，再通过docker_network模块连接容器，同时确保容器分配到预期IP（需提前规划IP池避免冲突）。

- name: 创建带静态IP池的自定义网络
  docker_network:
    name: network_nextcloud
    ipam_config:
      - subnet: 172.18.0.0/24
        gateway: 172.18.0.1
        iprange: 172.18.0.10/32  # 预分配单个IP给目标容器
  when: OPENLDAP_MAP_WITH_NEXTCLOUD == "yes"

- name: 将容器连接到网络（自动分配预定义IP）
  docker_network:
    name: network_nextcloud
    connected:
      - openldap_app
    appends: yes
  when: OPENLDAP_MAP_WITH_NEXTCLOUD == "yes"

关键注意事项 #

• 仅自定义Docker网络支持静态IP分配，默认bridge网络不支持此功能
• 指定的IP必须在目标网络的子网范围内，且未被其他容器或服务占用
• 若容器已连接到目标网络，重复执行docker network connect会报错，建议添加前置检查逻辑

内容的提问来源于stack exchange，提问作者Bartholome SIMPSON