Weave Cloud for PCF builder 镜像文档

镜像概述

Weave Cloud for PCF builder是Weaveworks提供的专为Pivotal Cloud Foundry(PCF)平台设计的构建器镜像，用于简化在PCF环境中集成和部署Weave Cloud功能组件的构建过程。该镜像作为PCF构建流程的关键组件，帮助开发者和运维团队标准化Weave Cloud相关应用的构建配置，减少手动操作，提高部署效率。

核心功能与特性

• PCF构建流程集成：无缝对接PCF的buildpack机制，可直接作为构建步骤中的构建器使用，无需额外适配改造。
• Weave Cloud配置简化：内置常用Weave Cloud组件配置模板，支持通过环境变量或配置文件快速指定Weave Cloud服务参数（如API地址、认证信息等）。
• 标准构建打包支持：遵循PCF标准构建输出规范，生成可直接部署到PCF运行时的应用包或服务镜像，兼容PCF应用生命周期管理。
• 版本兼容性：针对主流PCF版本（如PCF 2.x/3.x）进行兼容性测试，确保构建过程稳定可靠，降低版本适配成本。

使用场景与适用范围

• PCF应用集成Weave Cloud功能：适用于在PCF平台开发、部署需使用Weave Cloud容器网络、监控、服务网格等功能的应用团队。
• Weave Cloud组件自动化构建：需通过标准化流程自动打包Weave Cloud代理、插件等组件到PCF应用中的场景。
• PCF与Weave Cloud迁移/集成项目：在将应用从其他平台迁移到PCF，或需在PCF中扩展Weave Cloud功能时，简化构建环节的配置与实施。

使用方法与配置说明

基本使用方式

该镜像主要作为PCF构建流程中的构建器使用，通常在manifest.yml或构建配置文件中指定。

在PCF manifest.yml中配置

yaml
---
applications:
- name: weave-cloud-app
  buildpacks:
  - [***]  # 示例基础构建pack
  builder: weaveworks/weave-cloud-pcf-builder:latest  # 指定本镜像作为构建器
  env:
    WEAVE_CLOUD_API_URL: "[***]"  # Weave Cloud API地址
    WEAVE_CLOUD_TOKEN: "your-weave-cloud-token"  # Weave Cloud认证令牌

本地测试构建（Docker运行示例）

本地测试构建流程可通过以下命令运行镜像：

bash
docker run -it --rm \
  -v $(pwd):/workspace \  # 挂载本地工作目录到容器
  -e WEAVE_CLOUD_API_URL="[***]" \
  -e WEAVE_CLOUD_TOKEN="your-weave-cloud-token" \
  weaveworks/weave-cloud-pcf-builder:latest \
  build  # 执行构建命令

环境变量配置

注意事项

• 使用前需确保PCF环境已配置正确的构建pack支持，并拥有Weave Cloud的有效访问令牌。
• 不同版本的镜像可能对应不同的PCF版本，使用时需根据实际PCF环境选择匹配的镜像标签（如:1.0.0对应PCF 2.x）。
• 自定义Weave Cloud组件配置可通过挂载配置文件到容器/etc/weave-cloud/config目录实现。

版本信息与获取

***镜像仓库地址：weaveworks/weave-cloud-pcf-builder（Docker Hub），支持通过标签指定版本（如:latest为最新版，:1.0.0为固定版本）。建议生产环境使用固定版本标签以确保构建稳定性。