### 使用 Docker 部署 OpenProject 开源项目 #### 准备工作 为了成功部署 OpenProject，确保本地环境已经安装并配置好 Docker 和 Docker Compose[^2]。 #### 获取官方镜像 OpenProject 提供了官方的 Docker 镜像来简化部署过程。可以从 Docker Hub 上拉取最新的稳定版本： ```bash docker pull openproject/community:latest ``` 这一步骤会下载包含所有必需组件和服务的预构建映像文件到本地机器上[^1]。 #### 创建必要的目录结构 建议为应用程序创建专门的工作空间以便于管理和维护： ```bash mkdir -p ~/openproject/{data,config} cd ~/openproject/ ``` 这里 `~/openproject/data` 将用于存储持久化数据，而 `~/openproject/config` 则保存自定义设置和其他重要文件[^4]。 #### 编写 docker-compose.yml 文件 编写一个名为 `docker-compose.yml` 的 YAML 格式的描述文档，它指定了服务之间的关系以及它们各自的参数选项： ```yaml version: '3' services: db: image: postgres:alpine environment: POSTGRES_DB: openproject POSTGRES_USER: openproject POSTGRES_PASSWORD: mysecretpassword volumes: - ./data/db:/var/lib/postgresql/data app: depends_on: - db image: openproject/community:latest ports: - "8080:80" environment: DB_HOST: db DB_NAME: openproject DB_USER: openproject DB_PASS: mysecretpassword command: > sh -c " sleep 10 && /usr/local/bin/wait-for-it.sh db:5432 --timeout=0 --strict -- \ bundle exec rake db:create && bundle exec rails server -b 0.0.0.0 " volumes: data: ``` 上述配置中包含了两个主要的服务——数据库 (`db`) 和 Web 应用程序本身(`app`). 容器间通过内部网络相互通信，并且对外暴露端口使得能够访问Web界面. #### 启动服务 完成以上准备工作之后，在命令行工具里执行如下指令即可一键启动整个系统: ```bash docker-compose up -d ``` 此操作将以守护进程模式后台运行指定的服务实例；如果想要查看日志输出，则去掉 `-d` 参数直接前台启动. #### 访问应用 一旦所有容器都正常启动完毕，默认情况下应该可以在浏览器地址栏输入 http://localhost:8080 来浏览新建立起来的 OpenProject 实例页面[^3].