edirom/mermeid

MerMEId

https://img.shields.io/github/license/edirom/MerMEId](https://github.com/Edirom/MerMEId/blob/develop/LICENSE) https://img.shields.io/github/release/edirom/MerMEId.svg](https://github.com/Edirom/MerMEId/releases) https://img.shields.io/docker/automated/edirom/mermeid](https://hub.docker.com/r/edirom/mermeid/) https://img.shields.io/docker/cloud/build/edirom/MerMEId](https://hub.docker.com/r/edirom/mermeid/) https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg](CODE_OF_CONDUCT.md)

MerMEId是用于编辑、处理和（预）查看音乐元数据的系统，基于音乐编码倡议（MEI）XML模式。截至2019年3月，MerMEId支持MEI 4.0.0。

MerMEId最初由丹麦音乐编辑中心（DCM）开发，既用于制作作品主题目录，也用于在学术音乐编辑准备过程中组织源信息与作品相关信息。目前由社区维护。

MerMEId用于创建和维护以下项目：

• Carl Nielsen作品目录（CNW）
• Johann Adolph Scheibe作品目录
• J.P.E. Hartmann主题-书目作品目录

上述服务通过https://github.com/kb-dk/dcm_catalog_ui%E6%8F%90%E4%BE%9B%E3%80%82

可在https://mermeid.edirom.de/%E7%BD%91%E7%AB%99%E8%AF%95%E7%94%A8MerMEId%E3%80%82

如何使用此Docker镜像

设置MerMEId最便捷的方式是从https://hub.docker.com/r/edirom/mermeid%E6%8B%89%E5%8F%96%E7%8E%B0%E6%88%90%E7%9A%84Docker%E9%95%9C%E5%83%8F%E3%80%82

启动MerMEId服务器实例

启动MerMEId实例非常简单：

sh
$ docker run --name my-mermeid -p 8080:8080 -d edirom/mermeid:develop

其中，my-mermeid是你要分配给容器的名称，8080是MerMEId服务器将监听的本地端口。

通过docker stack deploy或docker-compose

MerMEId的stack.yml示例：

yaml
version: '3'

services:
  mermeid:
    image: docker.xuanyuan.run/edirom/mermeid:develop
    ports: 
      - 8080:8080
    environment: 
      - MERMEID_exist_endpoint=http://localhost:8080

运行docker stack deploy -c stack.yml mermeid（或docker-compose -f stack.yml up），等待完全初始化后，访问http://localhost:8080。

登录MerMEId的默认凭据为用户名“mermeid”和密码“mermeid”。

环境变量

启动MerMEId镜像时，可通过在docker run命令行传递一个或多个环境变量来调整MerMEId实例的配置。通常，properties.xml中的所有设置都可通过提供以“MERMEID_”为前缀的相应环境变量来覆盖。常用变量包括：

MERMEID_exist_endpoint

此变量必须反映部署URL。例如，若将MerMEId部署到https://my.mermeid.org，则MERMEID_exist_endpoint变量必须设置为https://my.mermeid.org。

MERMEID_admin_password

提供管理员密码。注意：这将覆盖之前设置的任何密码！

MERMEID_admin_password_file

通过密钥文件提供管理员密码。环境变量MERMEID_admin_password_file必须提供容器内该文件的路径。注意：这将覆盖之前设置的任何密码！

MERMEID_mermeid_password

提供mermeid用户的密码（默认为“mermeid”）。注意：这将覆盖之前设置的任何密码！

MERMEID_mermeid_password_file

通过密钥文件提供mermeid用户的密码（默认为“mermeid”）。环境变量MERMEID_mermeid_password_file必须提供容器内该文件的路径。注意：这将覆盖之前设置的任何密码！

持久化数据卷

在生产环境中运行MerMEId服务时，你可能需要持久化数据卷。否则，重启容器可能导致数据丢失！

数据库文件存储在容器内的/exist/data目录中，因此只需将主机目录挂载到该位置：

sh
$ docker run --name my-mermeid -p 8080:8080 -d --mount type=bind,source="$(pwd)/exist-data",target=/exist/data edirom/mermeid:develop

日志

Orbeon将所有内容记录到stdout，因此可通过docker logs my-mermeid访问日志。而Existdb则将大部分信息写入日志文件，若需访问这些日志，应将主机目录挂载到/exist/logs，如下所示：

sh
$ docker run --name my-mermeid -p 8080:8080 -d --mount type=bind,source="$(pwd)/exist-logs",target=/exist/logs edirom/mermeid:develop

行为准则

请注意，本项目发布时有贡献者行为准则。参与本项目即表示你同意遵守其条款。