ppiper/cf-cli

Cloud Foundry CLI Docker镜像文档

镜像概述

本镜像基于Dockerfile构建，主要用于SAP开发项目的持续交付（CD）管道。该镜像针对SAP https://github.com/SAP/jenkins-library%E4%B8%8EJenkins%E9%9B%86%E6%88%90%E8%BF%9B%E8%A1%8C%E4%BA%86%E4%BC%98%E5%8C%96%EF%BC%8C%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E5%8C%96%E5%B0%81%E8%A3%85%E4%BA%86%E6%89%A7%E8%A1%8C%E7%AE%A1%E9%81%93%E6%AD%A5%E9%AA%A4%E6%89%80%E9%9C%80%E7%9A%84%E5%B7%A5%E5%85%B7%E5%92%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%AE%80%E5%8C%96CD%E5%B7%A5%E5%85%B7%E9%93%BE%E7%9A%84%E6%90%AD%E5%BB%BA%E8%BF%87%E7%A8%8B%E3%80%82

核心功能和特性

• 内置工具：包含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开发项目的交付流程。

使用方法和配置说明

下载镜像

镜像已发布至https://hub.docker.com/r/ppiper/cf-cli%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E5%91%BD%E4%BB%A4%E6%8B%89%E5%8F%96%EF%BC%9A

bash
docker pull ppiper/cf-cli

本地构建

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

bash
docker build -t ppiper/cf-cli .

推荐用法

通过Piper管道步骤使用

推荐通过Piper项目的https://sap.github.io/jenkins-library/steps/cloudFoundryDeploy/%E7%AE%A1%E9%81%93%E6%AD%A5%E9%AA%A4%E9%9B%86%E6%88%90%E4%BD%BF%E7%94%A8%EF%BC%8C%E8%AF%A5%E6%AD%A5%E9%AA%A4%E4%BC%9A%E8%87%AA%E5%8A%A8%E8%B0%83%E7%94%A8%E6%9C%AC%E9%95%9C%E5%83%8F%E6%89%A7%E8%A1%8C%E9%83%A8%E7%BD%B2%E6%93%8D%E4%BD%9C%E3%80%82

直接执行cf命令

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

bash
# 查看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. 配置环境变量：

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

3. 执行测试脚本：

   bash
   ./runTests.sh
   

作为服务运行

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

许可证

本镜像的基础代码版权归SAP SE或其关联公司所有，采用Apache Software License, v. 2许可协议（详见https://github.com/SAP/devops-docker-cf-cli/blob/master/LICENSE%EF%BC%89%E3%80%82
请注意，Docker镜像可能包含其他软件，其许可协议可能不同。使用前请检查镜像中包含的所有组件的许可证。