datadog/apm-library-php-package-dev

Staging 镜像文档

概述

Staging镜像旨在提供一个标准化的过渡环境，用于应用程序在部署到生产环境之前的测试和验证。该镜像模拟生产环境的配置和特性，同时提供开发和测试所需的工具和灵活性。

核心功能

• 模拟生产环境配置，降低环境差异导致的部署问题
• 集成常用的应用服务器和运行时环境
• 内置日志收集和监控工具
• 支持多种应用类型部署（Web应用、API服务、微服务等）
• 提供灵活的配置选项和环境变量设置
• 包含基本的安全控制和访问管理

适用场景

• 应用程序发布前的集成测试
• 性能和负载测试环境
• 团队协作开发中的共享测试环境
• 演示环境搭建
• 版本发布前的用户验收测试(UAT)
• 多环境部署流程中的过渡阶段

使用方法

基本使用

使用以下命令启动一个基本的staging环境容器：

bash
docker run -d --name staging-env -p 8080:80 docker.xuanyuan.run/staging:latest

Docker Compose 配置

yaml
version: '3'
services:
  staging:
    image: docker.xuanyuan.run/staging:latest
    ports:
      - "8080:80"
      - "443:443"
    environment:
      - ENVIRONMENT=staging
      - DB_HOST=db
      - DB_PORT=5432
    volumes:
      - ./app:/app
      - ./config:/etc/staging/config
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/postgres:13
    environment:
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=staging_db

配置参数

环境变量

卷挂载

高级配置

自定义配置文件

可以通过挂载配置文件目录来自定义环境设置：

bash
docker run -d --name staging-env -p 8080:80 -v ./custom-config:/etc/staging/config docker.xuanyuan.run/staging:latest

启用调试模式

bash
docker run -d --name staging-env -e DEBUG_MODE=true -p 8080:80 -p 9229:9229 docker.xuanyuan.run/staging:latest

维护和监控

查看日志

bash
docker logs -f staging-env

进入容器

bash
docker exec -it staging-env /bin/bash

健康检查

bash
docker inspect --format='{{json .State.Health}}' staging-env

注意事项

• 该镜像不建议直接用于生产环境
• 敏感信息应通过环境变量或安全挂载方式提供
• 定期更新镜像以获取最新的安全补丁和功能改进
• 在生产环境部署前，应确保所有在staging环境中进行的测试都已通过

版本信息

• 最新稳定版本: staging:latest
• LTS版本: staging:lts
• 特定版本: staging:1.2.3