ppc64le/notary

Notary Docker镜像文档

镜像概述

【弃用通知】
上游Notary项目（https://github.com/notaryproject/notary%EF%BC%89%E5%B7%B2%E4%BA%8E2025%E5%B9%B47%E6%9C%8830%E6%97%A5%E5%BD%92%E6%A1%A3%E3%80%82%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E8%AF%B7%E5%8F%82%E8%A7%81%EF%BC%9Ahttps://github.com/notaryproject/.github/issues/70%E3%80%82

本镜像为notary官方镜像的ppc64le架构构建版本（特定架构仓库）。Notary包含两个独立应用：Notary Server（服务器）和Notary Signer（签名器），分别通过"server-"和"signer-"标签提供，需配合使用以实现签名与分发功能。

警告：此镜像在ppc64le架构上不支持。

快速参考

• 维护者：
  https://github.com/docker/notary-official-images

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

• 支持标签：
  警告：此镜像在ppc64le架构上不支持

• 问题反馈：
  https://github.com/docker/notary-official-images/issues?q=

• 支持架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  无支持架构

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/notary%EF%BC%88https://github.com/docker-library/repo-info/commits/master/repos/notary%EF%BC%89
  （包含镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnotary
  https://github.com/docker-library/official-images/blob/master/library/notary%EF%BC%88https://github.com/docker-library/official-images/commits/master/library/notary%EF%BC%89

• 描述来源：
  https://github.com/docker-library/docs/tree/master/notary%EF%BC%88https://github.com/docker-library/docs/commits/master/notary%EF%BC%89

使用方法

Notary仓库包含两个应用：Notary Server（服务器）和Notary Signer（签名器），镜像标签分别为"server-"和"signer-"。服务器可配置为纯内存运行，但生产环境需同时部署服务器和签名器。

注意：服务器和签名器必须使用版本匹配的标签（如server-0.2.0与signer-0.2.0），不同版本组合不支持。

Notary Server

Notary服务器管理JSON格式的TUF（The Update Framework）元数据，支持Notary客户端和Docker命令行工具的Docker Content Trust功能。需配合Notary签名器实例及MySQL（或MariaDB）数据库使用。

镜像使用

镜像包含以下示例配置：

json
{
    "server": {
        "http_addr": ":4443",
        "tls_key_file": "/certs/notary-server.key",
        "tls_cert_file": "/certs/notary-server.crt"
    },
    "trust_service": {
      "type": "remote",
      "hostname": "notarysigner",
      "port": "7899",
      "tls_ca_file": "/certs/root-ca.crt",
      "key_algorithm": "ecdsa",
      "tls_client_cert": "/certs/notary-server.crt",
      "tls_client_key": "/certs/notary-server.key"
    },
    "logging": {
        "level": "info"
    },
    "storage": {
        "backend": "mysql",
        "db_url": "server@tcp(mysql:3306)/notaryserver?parseTime=True"
    }
}

必须提供的组件：

• 证书和密钥（root-ca.crt、notary-server.crt、notary-server.key）
• notarysigner和mysql主机名的网络链接

root-ca.crt用于服务器识别有效签名器（通过GRPC接口的双向TLS通信）；notary-server.crt和notary-server.key用于服务身份验证。所有证书和密钥文件需对容器内的notary用户可读（该用户运行notary-server进程）。

如需自定义配置，需通过Dockerfile基于此镜像构建。
详细配置说明：https://github.com/theupdateframework/notary/blob/master/docs/reference/server-config.md

Notary Signer

Notary签名器是服务器的支持服务，负责管理私钥并执行签名操作，需配合MySQL（或MariaDB）数据库使用。

镜像使用

镜像包含以下示例配置：

json
{
    "server": {
        "http_addr": ":4444",
        "grpc_addr": ":7899",
        "tls_cert_file": "/certs/notary-signer.crt",
        "tls_key_file": "/certs/notary-signer.key",
        "client_ca_file": "/certs/notary-server.crt"
    },
    "logging": {
        "level": "info"
    },
    "storage": {
        "backend": "mysql",
        "db_url": "signer@tcp(mysql:3306)/notarysigner?parseTime=True"
    }
}

必须提供的组件：

• 证书和密钥（notary-server.crt、notary-signer.crt、notary-signer.key）
• mysql主机名的网络链接

notary-server.crt用于签名器识别有效服务器（通过GRPC接口的双向TLS通信）；notary-signer.crt和notary-signer.key用于服务身份验证。所有证书和密钥文件需对容器内的notary用户可读（该用户运行notary-signer进程）。

如需自定义配置，需通过Dockerfile基于此镜像构建。
详细配置说明：https://github.com/theupdateframework/notary/blob/master/docs/reference/signer-config.md

数据库迁移

Notary服务器和签名器均使用https://github.com/golang-migrate/migrate%E7%AE%A1%E7%90%86%E6%95%B0%E6%8D%AE%E5%BA%93%E6%9B%B4%E6%96%B0%E3%80%82%E8%BF%81%E7%A7%BB%E6%96%87%E4%BB%B6%E4%BD%8D%E4%BA%8Ehttps://github.com/theupdateframework/notary/tree/master/migrations/%EF%BC%8C%E4%B8%BA%E6%9C%89%E5%BA%8FSQL%E6%96%87%E4%BB%B6%E5%88%97%E8%A1%A8%E3%80%82migrate%E5%B7%A5%E5%85%B7%E9%80%9A%E8%BF%87%E7%AE%A1%E7%90%86 schema 版本确保迁移正确执行。

强烈建议：为服务器和签名器创建独立数据库及权限受限的用户，确保服务器无法访问签名器数据库，反之亦然。

许可证

软件许可证信息：https://github.com/theupdateframework/notary/blob/master/LICENSE

与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版中的Bash等），这些软件可能具有其他许可证。

自动检测的附加许可证信息可在https://github.com/docker-library/repo-info/tree/master/repos/notary%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

使用预构建镜像时，用户有责任确保其使用符合镜像中所有软件的相关许可证要求。