cloudfoundry/diego-docker-app

diego-docker-app 镜像文档

概述

diego-docker-app是Cloud Foundry Diego项目提供的官方Docker基础镜像，专为在Cloud Foundry平台上运行Docker化应用程序而设计。该镜像提供了与Cloud Foundry环境集成所需的核心组件和配置，使开发者能够轻松地将Docker应用部署到Cloud Foundry平台。

核心功能与特性

• 提供最小化的Linux运行环境，适合运行各类Docker应用
• 包含与Cloud Foundry Diego运行时集成的必要工具和配置
• 支持Cloud Foundry的健康检查机制和应用生命周期管理
• 内置日志收集功能，与Cloud Foundry的日志系统无缝集成
• 支持环境变量注入，便于应用配置
• 轻量级设计，基于Alpine Linux构建，减小镜像体积

使用场景

• 开发需要部署到Cloud Foundry平台的Docker应用
• 构建与Cloud Foundry环境深度集成的容器化服务
• 迁移现有Docker应用到Cloud Foundry平台
• 开发符合Cloud Foundry应用模型的微服务

使用方法

基础使用

在Dockerfile中使用diego-docker-app作为基础镜像：

dockerfile
FROM cloudfoundry/diego-docker-app:latest

# 复制应用代码
COPY . /app

# 设置工作目录
WORKDIR /app

# 暴露应用端口
EXPOSE 8080

# 启动命令
CMD ["./your-app-executable"]

构建镜像

bash
docker build -t your-app-name .

本地测试

bash
docker run -p 8080:8080 -e "PORT=8080" your-app-name

部署到Cloud Foundry

bash
cf push your-app-name -o your-app-name --docker-username your-registry-username

环境变量

diego-docker-app镜像支持Cloud Foundry平台提供的标准环境变量，包括：

• PORT: 应用监听端口，默认为8080
• VCAP_APPLICATION: 应用元数据信息JSON字符串
• VCAP_SERVICES: 绑定到应用的服务信息JSON字符串
• MEMORY_LIMIT: 应用内存限制
• CPU_LIMIT: 应用CPU限制

健康检查

该镜像支持Cloud Foundry的健康检查机制，包括：

• HTTP健康检查: 通过访问应用的/health端点
• TCP健康检查: 检查应用监听端口的可用性
• 进程健康检查: 监控应用主进程状态

日志收集

应用输出到stdout和stderr的日志会自动被Cloud Foundry日志系统收集，无需额外配置。如需自定义日志路径，可通过以下方式配置：

bash
ln -s /dev/stdout /var/log/application.log

高级配置

自定义启动脚本

创建/app/start.sh文件自定义应用启动流程：

bash
#!/bin/sh
# 自定义初始化逻辑
echo "Starting application..."
exec ./your-app-executable

设置执行权限：

dockerfile
RUN chmod +x /app/start.sh

持久化存储

使用Cloud Foundry的持久化存储服务：

bash
cf bind-service your-app-name your-volume-service

注意事项

• 确保应用监听在环境变量PORT指定的端口上
• 避免使用固定的文件系统路径，优先使用环境变量
• 应用应设计为无状态，依赖外部服务存储持久化数据
• 考虑使用健康检查端点提高应用可靠性

相关资源

• Cloud Foundry官方文档
• https://github.com/cloudfoundry-incubator/diego-dockerfiles
• Cloud Foundry Docker应用部署指南