vault/swiftmail 镜像文档

概述

vault/swiftmail 是一个用于与 OpenStack Swift 服务集成的应用镜像，提供 HTTP 接口接收文件，并基于配置的 OpenStack 认证信息与 Swift 存储服务进行交互，适用于需要通过 HTTP 协议处理文件并与 Swift 存储集成的场景。

核心功能与特性

• 提供 HTTP 接口（默认监听 5000 端口）接收文件上传请求
• 支持通过环境变量配置 OpenStack Swift 认证参数
• 支持后台模式运行，适合服务化部署

使用场景

适用于需要将文件通过 HTTP 接口上传并存储到 OpenStack Swift 的业务场景，如日志文件归档、邮件附件存储、应用数据备份等需与 Swift 存储服务交互的场景。

使用方法与配置说明

环境变量配置

使用该镜像需配置以下必要环境变量，用于 OpenStack Swift 认证：

部署命令

通过 docker run 命令部署容器：

bash
docker run --name swiftmail -d \
  -e OS_TENANT_ID=<your-openstack-tenant-id> \
  -e OS_USERNAME=<your-openstack-username> \
  -e OS_PASSWORD=<your-openstack-password> \
  -e OS_AUTH_URL=<your-openstack-auth-url> \
  vault/swiftmail

参数说明：

• --name swiftmail: 指定容器名称为 swiftmail
• -d: 后台运行容器
• -e: 设置环境变量，需将 <> 占位符替换为实际 OpenStack 认证信息

服务测试

容器部署后，可通过以下 curl 命令测试服务是否正常工作：

bash
curl -v -f -X POST -F file=@testmail.txt [***]

其中 testmail.txt 为本地测试文件，该命令会将文件通过 HTTP POST 请求发送至容器的 5000 端口接口，服务将基于配置的 OpenStack 信息与 Swift 进行交互。