pingidentity/pingtoolkit

Ping Identity Ping Tool Kit Docker镜像文档

镜像概述和主要用途

Ping Identity Ping Tool Kit Docker镜像是一个集成了Ping DevOps脚本的工具包，主要用于简化Ping Identity产品的部署、配置和运维流程。该镜像提供对服务器配置文件（server profiles）的支持，帮助DevOps团队高效管理Ping Identity产品的部署生命周期，包括环境搭建、配置管理和自动化运维任务。

核心功能和特性

• 提供DevOps脚本集：包含一系列预定义的DevOps脚本，支持Ping Identity产品的自动化部署流程。
• 服务器配置文件支持：集成服务器配置文件管理功能，简化多环境配置的标准化和版本控制。
• Ping Identity产品集成：与Ping Identity系列产品（如PingFederate、PingAccess等）无缝集成，支持其部署和运维需求。
• 部署流程简化：通过脚本自动化常见运维任务，减少手动操作，提升部署效率和一致性。

使用场景和适用范围

• DevOps团队自动化部署：适用于需要自动化部署、配置和管理Ping Identity产品的DevOps团队。
• 开发/测试环境快速搭建：支持开发和测试环境的快速构建与重置，加速迭代流程。
• 服务器配置文件管理：用于集中管理不同环境（开发、测试、生产）的服务器配置文件，确保配置一致性。
• CI/CD流程集成：可集成到持续集成/持续部署（CI/CD） pipeline中，实现Ping Identity产品部署的自动化和标准化。

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）。
• 已获取Ping Identity产品许可证（评估许可证或商业许可证）。
• 接受许可协议（通过环境变量配置）。

Docker运行命令示例

bash
docker run -d \
  --name pingtoolkit \
  -e PING_IDENTITY_ACCEPT_EULA=Yes \
  -v /local/path/to/server-profiles:/opt/server-profiles \
  pingidentity/pingtoolkit:latest

参数说明：

• -e PING_IDENTITY_ACCEPT_EULA=Yes：必须设置为"Yes"以接受许可协议条款。
• -v /local/path/to/server-profiles:/opt/server-profiles：挂载本地服务器配置文件目录到容器内，用于配置管理。

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  pingtoolkit:
    image: pingidentity/pingtoolkit:latest
    container_name: pingtoolkit
    environment:
      - PING_IDENTITY_ACCEPT_EULA=Yes
      # 如需指定许可证文件，可添加许可证相关环境变量（参考官方文档获取详细参数）
    volumes:
      - ./server-profiles:/opt/server-profiles  # 本地服务器配置文件目录挂载
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

环境变量说明

注：更多环境变量及详细配置可参考官方文档。

许可证信息

许可协议接受

通过将环境变量PING_IDENTITY_ACCEPT_EULA设置为Yes，镜像用户同意其对Docker镜像中软件（"Software"）的使用受本段落所述许可协议条款约束：

• 若镜像用户（或其所属组织）未从Ping Identity购买软件的商业许可，适用许可协议条款见此处，且软件视为该条款下的"试用产品"（Trial Product）。
• 若镜像用户（或其所属组织）已购买有效的商业许可，且与Ping Identity Corporation签订了软件许可协议，则适用该协议条款；否则，适用条款见此处。

许可证获取

运行镜像中的软件前，必须获取许可证：

• 评估许可证：可通过评估许可定义获取。
• 商业许可证：联系Ping Identity购买商业许可。

第三方软件许可

与所有Docker镜像一样，本镜像可能包含基础发行版中的其他软件及主软件的直接/间接依赖，这些软件可能受其他许可协议约束。各发行版中包含的第三方软件及其许可列表见https://github.com/pingidentity/pingidentity-devops-getting-started/blob/master/3RD_PARTY_SOFTWARE.md%E3%80%82%E4%BD%BF%E7%94%A8%E6%9C%AC%E9%95%9C%E5%83%8F%E6%97%B6%EF%BC%8C%E7%94%A8%E6%88%B7%E6%9C%89%E8%B4%A3%E4%BB%BB%E7%A1%AE%E4%BF%9D%E5%85%B6%E4%BD%BF%E7%94%A8%E8%A1%8C%E4%B8%BA%E7%AC%A6%E5%90%88%E6%89%80%E6%9C%89%E5%8C%85%E5%90%AB%E8%BD%AF%E4%BB%B6%E7%9A%84%E7%9B%B8%E5%85%B3%E8%AE%B8%E5%8F%AF%E8%A6%81%E6%B1%82%E3%80%82

商业支持

本镜像提供的软件按"原样"提供，不附带任何明示、暗示或法定的保证或陈述。

如需商业支持详情，请联系：***

Docker镜像保留政策

Ping Identity维护的Docker镜像在Docker Hub上的保留期限为自发布日起一（1）个日历年。为确保速度和稳定性，建议用户将所需镜像版本标记并推送到自己的容器仓库。

Ping Identity不对Docker Hub上的镜像可用性提供任何保证。

Docker支持政策

• Ping Identity支持政策：[***]
• Ping Identity镜像支持政策：[***]

版权

Copyright © 2023 Ping Identity. 保留所有权利。