ppiper/neo-cli

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项目的https://sap.github.io/jenkins-library/steps/neoDeploy/%E6%B5%81%E6%B0%B4%E7%BA%BF%E6%AD%A5%E9%AA%A4%E4%BD%BF%E7%94%A8%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E5%AE%9E%E7%8E%B0%E4%B8%8EJenkins%E6%B5%81%E6%B0%B4%E7%BA%BF%E7%9A%84%E6%97%A0%E7%BC%9D%E9%9B%86%E6%88%90%E3%80%82%E5%85%B7%E4%BD%93%E9%85%8D%E7%BD%AE%E8%AF%B7%E5%8F%82%E8%80%83Piper%E9%A1%B9%E7%9B%AE%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E3%80%82

测试

服务端测试（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工具获取。