lyrasis/archivesspace

Docker ArchivesSpace

镜像概述和主要用途

Docker ArchivesSpace镜像用于在Docker环境中便捷部署和运行ArchivesSpace档案管理系统。该镜像简化了ArchivesSpace的安装配置流程，支持多种数据库模式和自定义配置，适用于快速搭建档案管理平台。

核心功能和特性

• 支持开箱即用的演示数据库，无需额外配置即可运行
• 兼容MySQL数据库，可连接Docker内部或外部MySQL实例
• 暴露多个服务端口（8080、8081、8089、8090），满足不同服务需求
• 支持挂载自定义配置文件和插件目录，实现个性化系统设置
• 提供本地构建选项，可从源码构建定制化镜像

使用场景和适用范围

适用于档案机构、图书馆、博物馆等需要部署ArchivesSpace系统的组织，特别适合开发测试环境搭建、功能演示以及需要灵活配置的生产环境。

使用方法和配置说明

更新镜像

从Docker仓库更新最新镜像：

bash
docker pull mysql
docker pull lyrasis/archivesspace  # 获取最新版本

使用演示数据库

后台模式运行

bash
docker run --name archivesspace -d \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  lyrasis/archivesspace

前台模式运行

bash
docker run --name archivesspace -it \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  lyrasis/archivesspace

前台模式并进入容器

bash
docker run --name archivesspace -it \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  lyrasis/archivesspace /bin/bash

使用MySQL数据库

启动MySQL容器

bash
docker run -d \
  -p 3306:3306 \
  --name mysql \
  -e MYSQL_ROOT_PASSWORD=123456 \
  -e MYSQL_DATABASE=archivesspace \
  -e MYSQL_USER=archivesspace \
  -e MYSQL_PASSWORD=archivesspace \
  mysql:5.6 --innodb_buffer_pool_size=4G --innodb_buffer_pool_instances=4

链接MySQL容器运行（前台模式）

bash
docker run --name archivesspace -it \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  -e ARCHIVESSPACE_DB_TYPE=mysql \
  --link mysql:db \
  lyrasis/archivesspace

挂载配置和插件运行

bash
docker run --name archivesspace -it \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  -e ARCHIVESSPACE_DB_TYPE=mysql \
  -v $(pwd)/config:/archivesspace/config \
  -v $(pwd)/plugins:/archivesspace/plugins \
  --link mysql:db \
  lyrasis/archivesspace

配置文件设置：在挂载的config/config.rb中需包含以下数据库连接配置：

ruby
AppConfig[:db_url] = "jdbc:mysql://#{ENV['DB_PORT_3306_TCP_ADDR']}:3306/#{ENV['ARCHIVESSPACE_DB_NAME']}?user=#{ENV['ARCHIVESSPACE_DB_USER']}&password=#{ENV['ARCHIVESSPACE_DB_PASS']}&useUnicode=true&characterEncoding=UTF-8"

使用外部MySQL实例（不使用--link）

bash
docker run --name archivesspace -it \
  --net=host \
  -e ARCHIVESSPACE_DB_TYPE=mysql \
  -e ARCHIVESSPACE_DB_HOST_TYPE=external \
  -v $(pwd)/config:/archivesspace/config \
  -v $(pwd)/plugins:/archivesspace/plugins \
  lyrasis/archivesspace

注：需确保$(pwd)/config/config.rb文件存在并正确配置外部MySQL连接信息。

本地构建

从源码构建镜像：

bash
docker build --no-cache=true -t archivesspace:latest latest/
docker run --name archivesspace -it \
  -p 8080:8080 \
  -p 8081:8081 \
  -p 8089:8089 \
  -p 8090:8090 \
  archivesspace:latest

许可证

本项目基于MIT许可证开源。