Cloud Foundry CLI Docker镜像文档

镜像概述

本镜像基于Dockerfile构建，主要用于SAP开发项目的持续交付（CD）管道。该镜像针对SAP Piper项目与Jenkins集成进行了优化，通过容器化封装了执行管道步骤所需的工具和环境，简化CD工具链的搭建过程。

核心功能和特性

• 内置工具：包含Cloud Foundry CLI（命令行界面），用于与Cloud Foundry平台交互。
• 扩展插件：集成蓝绿部署（Blue-Green Deployment）插件，支持零停机部署策略。
• MTA支持：包含Multi-Target Applications（MTA）插件，支持SAP多目标应用的部署与管理。

使用场景和适用范围

• SAP Cloud Platform部署：适用于SAP Cloud Platform上应用的自动化部署流程。
• CI/CD管道集成：作为Jenkins或其他CI/CD工具的执行环境，用于Cloud Foundry相关操作（如应用推送、服务绑定等）。
• Piper项目适配：与SAP Piper项目的cloudFoundryDeploy等管道步骤无缝集成，简化SAP开发项目的交付流程。

使用方法和配置说明

下载镜像

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

docker pull ppiper/cf-cli

本地构建

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

docker build -t ppiper/cf-cli .

推荐用法

通过Piper管道步骤使用

推荐通过Piper项目的cloudFoundryDeploy管道步骤集成使用，该步骤会自动调用本镜像执行部署操作。

直接执行cf命令

如需直接使用镜像中的cf工具，可通过docker run命令调用，示例：

# 查看cf命令帮助
docker run ppiper/cf-cli cf --help

# 执行具体cf操作（需挂载配置或传递参数）
docker run ppiper/cf-cli cf login -a <API端点> -u <用户名> -p <密码> -o <组织> -s <空间>

测试配置

环境变量说明

测试或部署时需配置以下环境变量（敏感信息）：

本地测试步骤

1. 环境要求：安装Docker，且Docker分配至少4GB内存。
2. 配置环境变量：

   export CX_INFRA_IT_CF_USERNAME="your-username"
   export CX_INFRA_IT_CF_PASSWORD="your-password"
   

3. 执行测试脚本：

   ./runTests.sh
   

作为服务运行

配置参考项目根目录下的.travis.yml文件，需在CI服务（如Travis CI）中设置上述环境变量。

许可证

本镜像的基础代码版权归SAP SE或其关联公司所有，采用Apache Software License, v. 2许可协议（详见LICENSE文件）。
请注意，Docker镜像可能包含其他软件，其许可协议可能不同。使用前请检查镜像中包含的所有组件的许可证。