islandora/handleHandle 9.3.1版本的Docker镜像。
基于Islandora-DevOps/isle-buildkit handle构建。
有关更深入的信息,请参考Handle文档。
快速示例:运行以下命令可启动Handle实例,并可通过http://localhost:8000/访问。
bashdocker run --rm -ti -p 8000:8000 islandora/handle
构建需要 islandora/java Docker镜像。有关更多信息,请参考Java镜像README。
| 端口 | 描述 |
|---|---|
| 8000 (tcp) | 8000端口提供HTTP和HTTPS接口。 |
| 2641 (udp/tcp) | 2641端口(UDP和TCP)是IANA分配给Handle有线协议的端口号。 |
| 环境变量 | 默认值 | 描述 |
|---|---|---|
| HANDLE_ADMIN_FULL_ACCESS | yes | "yes"或"no"。若设为"no",则"server_admins"将在前缀级别拥有默认权限 |
| HANDLE_ADMIN_PRIVATE_KEY_PEM | 参见rootfs/etc/defaults/HANDLE_ADMIN_PRIVATE_KEY_PEM | 关于其用法,请阅读Handle文档 |
| HANDLE_ADMIN_PUBLIC_KEY_PEM | 参见rootfs/etc/defaults/HANDLE_ADMIN_PUBLIC_KEY_PEM | 关于其用法,请阅读Handle文档 |
| HANDLE_ALLOW_NA_ADMINS | yes | "yes"或"no"。是否允许来自GHR的管理员 |
| HANDLE_AUTO_HOME | yes | "yes"或"no"。控制server配置(config.dct)中是否包含auto_homed_prefixes子句 |
| HANDLE_CASE_SENSITIVE | no | "yes"或"no"。Handle是否区分大小写 |
| HANDLE_DB_NAME | handle | Handle数据库名称 |
| HANDLE_DB_PASSWORD | password | 数据库用户密码 |
| HANDLE_DB_READONLY | no | 布尔设置("yes"或"no"),防止/允许数据库修改 |
| HANDLE_DB_USER | handle | 数据库用户 |
| HANDLE_MAX_AUTH_TIME | 60000 | 等待客户端响应身份验证挑战的秒数 |
| HANDLE_MAX_SESSION_TIME | 86400000 | 已认证客户端会话的持续时间(毫秒) |
| HANDLE_PREFIX | 200 | 关于其用法,请阅读Handle文档 |
| HANDLE_PRIVATE_KEY_PEM | 参见rootfs/etc/defaults/HANDLE_PRIVATE_KEY_PEM | 关于其用法,请阅读Handle文档 |
| HANDLE_PUBLIC_KEY_PEM | 参见rootfs/etc/defaults/HANDLE_PUBLIC_KEY_PEM | 关于其用法,请阅读Handle文档 |
| HANDLE_SERVER_ID | 1 | 用于区分同一站点内的其他服务器 |
| HANDLE_PERSISTENCE_TYPE | bdbje | 可以是'sql',若为'bdbje',请确保在/var/handle/bdbje创建卷以持久化更改 |
注意:对于PEM文件,私钥必须符合PKCS#8标准,而非PKCS#1,因为将密钥转换为Handle格式的工具不支持PKCS#1。
即,以-----BEGIN RSA PRIVATE KEY-----开头的PEM文件不被支持,仅支持以-----BEGIN PRIVATE KEY-----或-----BEGIN ENCRYPTED PRIVATE KEY-----开头的密钥。注意,若使用加密密钥,您需要自行处理解密,因为此镜像目前不处理解密。
Handle可以选择使用不同的数据库后端进行存储。有关默认数据库连接配置的更多信息,请参见基础镜像的文档。
以下设置仅在HANDLE_PERSISTENCE_TYPE设为mysql或postgresql时使用。
| 环境变量 | 默认值 | 描述 |
|---|---|---|
| HANDLE_DB_NAME | handle | 数据库名称 |
| HANDLE_DB_USER | handle | 连接数据库的用户 |
| HANDLE_DB_PASSWORD | password | 用于连接数据库的用户密码 |
此外,DB_DRIVER变量由HANDLE_PERSISTENCE_TYPE派生而来,因此用户无需单独指定。
manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务