如何通过配置文件而非Web UI配置Portainer堆栈，解决重启失联问题

我用Portainer监控Docker Compose堆栈：当存储在GitHub仓库的docker-compose.yml文件变更时，Portainer每5分钟自动拉取新镜像版本并重启堆栈，当前流程运行正常。但存在两个问题：

1. 重启Portainer容器后，其他堆栈仍正常运行，但Portainer会遗忘这些堆栈是由它管理的，失去与GitHub仓库的关联，不再监控文件变更。
2. 目前只能通过Web UI手动配置上述监控规则，希望通过配置文件（比如Portainer自身的docker-compose.yml挂载配置、容器内挂载配置文件）或CLI命令实现代码化配置，达成基础设施即代码的目标（所有被管理的堆栈已基于docker-compose.yml）。

一、修复Portainer重启后丢失堆栈关联的问题 #

Portainer的核心配置（包括堆栈关联、监控规则等）默认存储在容器内部的/data目录下，重启容器时若未持久化该目录，所有配置会丢失。解决方法是启动Portainer时挂载持久化卷到/data路径：

使用Docker命令启动时挂载卷 #

docker run -d -p 9000:9000 -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest

使用Docker Compose启动时挂载卷 #

在Portainer的docker-compose.yml中添加卷配置：

version: '3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    ports:
      - "9000:9000"
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
volumes:
  portainer_data:

挂载后重启Portainer，所有配置（包括堆栈与GitHub的关联、监控规则）都会保留。

二、代码化配置Portainer（实现基础设施即代码） #

Portainer支持通过CLI、API或初始化脚本实现自动化配置，以下是具体方案：

1. 使用Portainer CLI工具 #

官方CLI工具可直接通过命令行创建、管理堆栈及监控规则：

• 登录Portainer实例：

portainer-cli login --host http://your-portainer-ip:9000 --username admin --password your-password

• 创建关联GitHub仓库的自动更新堆栈：

portainer-cli stack create \
  --name your-stack-name \
  --repository-url https://github.com/your-username/your-repo.git \
  --repository-ref main \
  --repository-path path/to/docker-compose.yml \
  --auto-update \
  --auto-update-interval 300 \
  --endpoint-id 1

2. 使用Portainer API #

通过HTTP API可将配置集成到CI/CD流程中，完全自动化操作：

• 先获取认证Token：

curl -X POST http://your-portainer-ip:9000/api/auth \
  -H "Content-Type: application/json" \
  -d '{"Username":"admin","Password":"your-password"}'

• 用返回的jwtToken创建带自动更新的堆栈：

curl -X POST http://your-portainer-ip:9000/api/stacks \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "Name": "your-stack-name",
    "Type": 2,
    "RepositoryURL": "https://github.com/your-username/your-repo.git",
    "RepositoryReferenceName": "main",
    "RepositoryPath": "path/to/docker-compose.yml",
    "AutoUpdate": true,
    "AutoUpdateInterval": 300,
    "EndpointID": 1
  }'

3. 使用Portainer初始化脚本 #

Portainer启动时会自动执行/data/init目录下的脚本，可通过挂载脚本实现初始化配置：

• 创建初始化脚本init-stacks.sh，添加等待Portainer启动的逻辑及配置命令：

#!/bin/bash
until curl -s http://localhost:9000/api/auth > /dev/null; do
  sleep 5
done
# 此处添加登录、创建堆栈的CLI或API命令

• 在Docker Compose中挂载脚本：

version: '3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    ports:
      - "9000:9000"
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
      - ./init-stacks.sh:/data/init/init-stacks.sh
volumes:
  portainer_data:

内容的提问来源于stack exchange，提问作者Sebastian Sommerfeld