docs: add comprehensive project overview documentation - #408
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: afa640200d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| ./installHarbor.sh <镜像仓库IP> 12380 /data1 aliyun | ||
|
|
||
| # 3. 修改配置 | ||
| cd ../deploy |
There was a problem hiding this comment.
Return to the actual deploy directory
When this quick-start block is followed sequentially, the current directory is opendcp/deploy/scripts, so cd ../deploy resolves to the nonexistent opendcp/deploy/deploy. The failed directory change leaves every subsequent relative command in the wrong location; use cd .. (or an unambiguous repository-root path) before invoking ./scripts/change_conf.sh.
Useful? React with 👍 / 👎.
|
|
||
| # 4. 构建镜像 | ||
| cd ../ | ||
| ./build.sh source aliyun |
There was a problem hiding this comment.
Use the supported build argument order
Even after correcting the working directory, this build command cannot build anything: the repository's build.sh accepts only aliyun or dockerio as its first argument and treats the second argument as the image tag, so passing source causes it to print the supported clouds and exit with status 1. Use ./build.sh aliyun or ./build.sh aliyun <tag>.
Useful? React with 👍 / 👎.
| - 检查 Git/SVN 地址、用户名、密码是否正确。 | ||
| - 检查 Dockerfile 中的 shell 命令是否合法。 | ||
| - 确保磁盘空间充足。 | ||
| - 查看日志:`opendcp/deploy/log/imagebuild/imagebuild.log` |
There was a problem hiding this comment.
Point troubleshooting at the mounted imagebuild log
After a package build fails, the documented path does not exist because the deployment directory is named logs, not log. The imagebuild service bind-mounts ./logs/imagebuild to /tmp, where the application writes imagebuild.log, so users need opendcp/deploy/logs/imagebuild/imagebuild.log to inspect the failure.
Useful? React with 👍 / 👎.
变更说明
本次提交新增了一份全面的项目说明文档
PROJECT_OVERVIEW.md,涵盖以下内容:Commit Summary
docs: add comprehensive project overview documentation