Neo Tools CLI Docker镜像

概述

Neo Tools CLI Docker镜像是SAP Cloud Platform Neo环境工具的容器化封装，专为持续交付（CD）流水线设计，尤其适用于与Jenkins的Piper项目集成。该镜像通过Docker容器技术简化CD工具链配置，封装执行流水线步骤所需的Neo工具及运行环境，支持在CI/CD流程中便捷地与SAP Cloud Platform Neo环境进行交互。

核心功能与特性

• 内置Neo工具：集成SAP Cloud Platform Tools for Neo，提供neo.sh命令行工具，支持Neo环境的应用部署、资源管理等操作。
• 容器化部署：通过Docker容器封装工具及依赖，避免本地环境配置冲突，简化跨环境的CD流水线工具管理。
• CI/CD优化：针对Jenkins流水线场景优化，可直接集成Piper项目的neoDeploy步骤，实现自动化部署流程。

使用场景与适用范围

• Jenkins CI/CD流水线：作为流水线步骤的执行环境，通过neoDeploy等步骤实现SAP Cloud Platform Neo环境的应用自动部署。
• Neo工具直接调用：在需要临时执行Neo环境操作的场景下（如手动部署、资源查询），通过容器直接调用neo.sh命令行工具。
• SAP开发项目：适用于所有需在CI/CD流程中与SAP Cloud Platform Neo环境交互的开发项目，包括Java应用部署、环境配置管理等场景。

使用方法

镜像下载

该镜像已发布至Docker Hub，可通过以下命令拉取：

bash
docker pull ppiper/neo-cli

本地构建

如需本地构建镜像，在Dockerfile所在目录执行以下命令：

bash
docker build -t ppiper/neo-cli .

运行镜像

直接调用neo.sh工具

通过docker run命令直接调用容器内的neo.sh工具，示例如下：

bash
# 查看neo.sh帮助信息
docker run ppiper/neo-cli neo.sh help

# 执行具体操作（如部署应用，需替换占位符）
docker run ppiper/neo-cli neo.sh deploy --account <account> --application <app-name> --war <war-file-path>

集成Jenkins Piper项目

推荐通过Piper项目的neoDeploy流水线步骤使用该镜像，实现与Jenkins流水线的无缝集成。具体配置请参考Piper项目***文档。

测试

服务端测试（Travis CI）

项目通过Travis CI进行自动化测试，配置详情参见根目录下的.travis.yml文件。测试需配置以下环境变量（敏感信息）：

• CX_INFRA_IT_CF_USERNAME：SAP Cloud Platform部署用户名（用于认证）
• CX_INFRA_IT_CF_PASSWORD：SAP Cloud Platform部署密码（用于认证）

本地测试

本地测试需满足以下条件：

• 已安装Docker，且分配至少4GB内存。

执行步骤：

1. 配置环境变量：

bash
export CX_INFRA_IT_CF_USERNAME="实际SAP Cloud Platform用户名"
export CX_INFRA_IT_CF_PASSWORD="实际SAP Cloud Platform密码"

2. 运行测试脚本：

bash
./runTests.sh

许可信息

版权所有 2017-2021 SAP SE或其关联公司及devops-docker-neo-cli贡献者。详细版权和许可信息参见LICENSE文件。第三方组件及其许可/版权信息可通过REUSE工具获取。