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 \
  docker.xuanyuan.run/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: docker.xuanyuan.run/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

环境变量说明

注：更多环境变量及详细配置可参考https://devops.pingidentity.com/docker-images/pingtoolkit/。

许可证信息

许可协议接受

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

• 若镜像用户（或其所属组织）未从Ping Identity购买软件的商业许可，适用许可协议条款见https://www.pingidentity.com/en/legal/subscription-agreement.html，且软件视为该条款下的"试用产品"（Trial Product）。
• 若镜像用户（或其所属组织）已购买有效的商业许可，且与Ping Identity Corporation签订了软件许可协议，则适用该协议条款；否则，适用条款见https://www.pingidentity.com/en/legal/subscription-agreement.html。

许可证获取

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

• 评估许可证：可通过https://devops.pingidentity.com/get-started/prereqs/#evaluation-license获取。
• 商业许可证：联系Ping Identity购买商业许可。

第三方软件许可

与所有Docker镜像一样，本镜像可能包含基础发行版中的其他软件及主软件的直接/间接依赖，这些软件可能受其他许可协议约束。各发行版中包含的第三方软件及其许可列表见https://github.com/pingidentity/pingidentity-devops-getting-started/blob/master/3RD_PARTY_SOFTWARE.md。使用本镜像时，用户有责任确保其使用行为符合所有包含软件的相关许可要求。

商业支持

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

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

Docker镜像保留政策

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

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

Docker支持政策

• Ping Identity支持政策：https://devops.pingidentity.com/home/supportPolicy/
• Ping Identity镜像支持政策：https://devops.pingidentity.com/docker-images/imageSupport/

版权

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