From 5519633cb8291828ef0eddfc8352cafb3a80a1ef Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 2 Sep 2026 18:06:09 +0800 Subject: [PATCH 1/4] Initial commit --- README.md | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..45da18e --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# DocprintService + +managed by projman \ No newline at end of file From 31e520cf529bcb808cf9429702957d50cd9d682a Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 2 Sep 2026 18:06:10 +0800 Subject: [PATCH 2/4] init: readme guide [skip ci] --- README.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 51 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 45da18e..a80a29f 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,53 @@ # DocprintService -managed by projman \ No newline at end of file +> 本仓库由 projman 自动创建并注入 CI（`.gitea/workflows/build.yml`）与 Dockerfile（`docker/Dockerfile`）。 +> 推送代码到 main 分支即自动构建镜像并推送到 Nexus，projman 收到通知后建档待部署，由运维在 projman「后端发布」手动点部署。 + +## 首次推送本地代码到本仓库 + +> 目标：把本地已有代码推上去，同时**保留** projman 注入的文件（`build.yml`、`Dockerfile`）。 + +```bash +# 1. 进入本地代码目录 +cd /your/local/code/dir + +# 2. 初始化 git（目录已有 .git 也安全，git init 幂等无副作用） +git init +git branch -M main + +# 3. 先把本地代码提交成一个 commit（关键！不提交直接 merge 会丢失本地代码） +git add -A +git commit -m "init local code" + +# 4. 关联远程仓库（幂等：已存在 origin 则改地址，不报错） +git remote add origin http://gitea.yunhaixingtong.com/docprint/DocprintService.git 2>/dev/null \ + || git remote set-url origin http://gitea.yunhaixingtong.com/docprint/DocprintService.git + +# 5. 拉取远程信息（只下载，不合并） +git fetch origin + +# 6. 合并远程 main（关键步骤） +# 本地与远程是两条独立历史，需允许合并不相关历史。 +# 此步会把 projman 注入的 build.yml 与 Dockerfile 合并进你的本地工作区。 +git merge origin/main --allow-unrelated-histories -m "merge projman injected files" + +# 7. 查看状态（确认 .gitea/workflows/build.yml、docker/Dockerfile 已在本地） +git status + +# 8. 提交并推送 +git add -A +git commit -m "sync local code" 2>/dev/null || true +git push origin main +``` + +## 推送后验证 + +push 触发 CI 构建，前往 Gitea 仓库 → **Actions** 查看日志；构建成功后镜像推送到 Nexus，projman 建档待部署，在 projman 应用详情「后端发布」手动点部署。 + +## 禁止写法（会导致注入文件被删） + +`git reset origin/main` + `git add -A` 会把远程已注入、但你本地没有的文件（`build.yml`、`Dockerfile`）当作"删除"提交并推送，导致这些文件被删、CI 失败。务必用 `git merge` 而非 `git reset`，且 merge 前先提交本地代码。 + +## 关于 Dockerfile + +projman 注入的 Dockerfile 仅在仓库不存在时写入；你自备的 Dockerfile 优先，不会被覆盖。 From c724572e1529cf180434c7aaf4b75b16105e65a5 Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 2 Sep 2026 18:06:12 +0800 Subject: [PATCH 3/4] ci: init build workflow [skip ci] --- .gitea/workflows/build.yml | 111 +++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 .gitea/workflows/build.yml diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml new file mode 100644 index 0000000..8cffeb0 --- /dev/null +++ b/.gitea/workflows/build.yml @@ -0,0 +1,111 @@ +name: build + +# .NET Core 应用 CI（对齐 springboot 模式：构建在独立 sdk 容器内，Dockerfile 只拷产物） +# 链路：clone 源码 -> dotnet sdk 容器 publish（入 infra-infra-net，容器名直连 nexus 拉 NuGet 包， +# 复用宿主 nuget 缓存卷）-> docker build -f docker/Dockerfile（COPY publish/ 产物，RUN 零网络）-> push Nexus -> 通知 projman 建档 +# 触发：push 到 main / 手动 Run workflow（可勾选缓存重建） +# cache_bust 勾选时清空宿主 nuget 缓存卷 + docker builder 层缓存，强制下次全量重建。 +# 依赖仓库 Secrets：NEXUS_USER / NEXUS_PASSWORD（docker-hosted 推送）/ DEPLOY_TOKEN（webhook 鉴权） +# 依赖 docker/Dockerfile（由 projman 注入，开发者也可自备——已写则尊重不覆盖） + +on: + push: + branches: [ main ] + workflow_dispatch: + inputs: + cache_bust: + description: '构建前清空 NuGet 缓存' + required: false + default: 'false' + +jobs: + build-push: + runs-on: ubuntu-latest + container: + image: docker:24 + options: --network infra-infra-net + steps: + - name: 安装 git / curl（alpine） + run: apk add --no-cache git curl + - name: 拉取源码（内网无 GitHub，手动 clone 本仓库） + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + git clone --depth 1 --branch main "http://x-access-token:${GITHUB_TOKEN}@gitea.yunhaixingtong.com/${{ github.repository }}.git" /tmp/src + cp -a /tmp/src/. . + rm -rf /tmp/src + COMMIT_MSG=$(git log -1 --pretty=%s | tr '\n' ' ' | sed 's/["\\]/ /g' | cut -c1-200) + echo "COMMIT_MSG=${COMMIT_MSG}" >> "$GITHUB_ENV" + # 可选：清空 nuget 缓存卷 + docker 构建层缓存（仅手动勾选 cache_bust 时） + - name: 可选清空构建缓存 + if: ${{ inputs.cache_bust == 'true' }} + run: | + docker run --rm -v /opt/docker/projman-dotnet-nuget:/root/.nuget/packages alpine sh -c 'rm -rf /root/.nuget/packages/*' + docker builder prune -f + echo "nuget + docker build cache busted" + # dotnet 构建（对齐 maven 模式）：起独立 sdk 容器（入 infra-infra-net 用容器名 nexus 直连拉 NuGet 包） + # 通过 docker.sock 调宿主 dockerd，故 -v 路径按宿主解析；用 docker cp 进出源码/产物 + # nuget 缓存挂宿主固定目录 /opt/docker/projman-dotnet-nuget，跨构建复用依赖 + # 仓库 nuget.config 常指向域名（nexus.<域名>，本地走宿主 Caddy 反代）；容器内改写为容器名 nexus:8081 直连 + # 构建目标自愈式定位：候选排序（根 sln > 根 csproj > Web SDK > OutputType=Exe > 其余非 Test）， + # 逐个 publish，产出 *.runtimeconfig.json（可执行项目唯一标志）者胜出——类库 publish 无 runtimeconfig， + # 自动跳过换下一个（grep csproj 特征不可靠，以实际产物为准）；.slnx 需 SDK 9+ 解析，不参与定位 + - name: 构建 publish 产物（dotnet sdk 容器，复用宿主 nuget 缓存） + run: | + set -e + docker rm -f dotnetbuild 2>/dev/null || true + docker run -d --name dotnetbuild \ + --network infra-infra-net \ + -v /opt/docker/projman-dotnet-nuget:/root/.nuget/packages \ + -w /build mcr.microsoft.com/dotnet/sdk:5.0 sleep 3600 + docker cp "${PWD}/." dotnetbuild:/build/ + docker exec dotnetbuild sh -c "find /build -maxdepth 2 -iname nuget.config -exec sed -i 's|//nexus.yunhaixingtong.com|//nexus:8081|g' {} +" + docker exec dotnetbuild sh -c ' + set -e + root_sln=$(ls /build/*.sln 2>/dev/null | head -1 || true) + root_csproj=$(ls /build/*.csproj 2>/dev/null | head -1 || true) + if [ -n "$root_sln" ] || [ -n "$root_csproj" ]; then + ordered="$root_sln $root_csproj" + else + cands=$(find /build -mindepth 2 -name "*.csproj" -not -path "*/bin/*" -not -path "*/obj/*" | grep -vi test || true) + web=$(echo "$cands" | xargs -r grep -l "Microsoft.NET.Sdk.Web" 2>/dev/null || true) + exe=$(echo "$cands" | xargs -r grep -l "Exe" 2>/dev/null || true) + ordered=$(printf "%s\n%s\n%s\n" "$web" "$exe" "$cands" | grep -v "^$" | awk "!seen[\$0]++") + fi + if [ -z "$ordered" ]; then echo "ERROR: 未找到 .sln/.csproj（请自备 Dockerfile）"; exit 1; fi + target="" + for t in $ordered; do + rm -rf /app + echo "try publish: $t" + if dotnet publish "$t" -c Release -o /app /p:UseAppHost=false 2>/tmp/pub.err; then + if ls /app/*.runtimeconfig.json >/dev/null 2>&1; then target="$t"; break; fi + echo " -> 非 executable（类库），换下一候选" + else + echo " -> publish 失败，换下一候选: $(tail -3 /tmp/pub.err)" + fi + done + if [ -z "$target" ]; then echo "ERROR: 所有候选均未产出可执行产物（多可执行项目请自备 Dockerfile）"; exit 1; fi + echo "publish target: $target" + ' + mkdir -p "${PWD}/publish" + docker cp dotnetbuild:/app/. "${PWD}/publish/" + docker rm -f dotnetbuild + # 入口脚本：runtimeconfig.json 是可执行项目唯一标志（X.runtimeconfig.json <-> X.dll）， + # 类库 deps.json 无 runtimeconfig 兄弟文件，天然不会误选 + entry=$(ls "${PWD}"/publish/*.runtimeconfig.json | head -1) + dll=$(basename "${entry}" .runtimeconfig.json) + echo "exec dotnet ${dll}.dll" > "${PWD}/publish/entrypoint.sh" + - name: 构建并推送镜像 + run: | + set -e + TAG=$(echo "$GITHUB_SHA" | cut -c1-8) + echo "${{ secrets.NEXUS_PASSWORD }}" | docker login nexus:8083 -u "${{ secrets.NEXUS_USER }}" --password-stdin + docker build -t "nexus:8083/docker-hosted/docprint-service:${TAG}" -f docker/Dockerfile . + docker push "nexus:8083/docker-hosted/docprint-service:${TAG}" + echo "TAG=${TAG}" >> "$GITHUB_ENV" + - name: 通知 projman 部署 + run: | + curl -sS -X POST "http://192.168.10.160:8090/projman/api/deploy/webhook" \ + -H "Content-Type: application/json" \ + -H "X-Deploy-Token: ${{ secrets.DEPLOY_TOKEN }}" \ + -d "{\"app\":\"docprint\",\"tag\":\"${TAG}\",\"sha\":\"${GITHUB_SHA}\",\"message\":\"${COMMIT_MSG}\"}" From 102fef1d18d6a7616037f6c8a21176491c749487 Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 2 Sep 2026 18:06:13 +0800 Subject: [PATCH 4/4] ci: init Dockerfile [skip ci] --- docker/Dockerfile | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docker/Dockerfile diff --git a/docker/Dockerfile b/docker/Dockerfile new file mode 100644 index 0000000..f5fdfda --- /dev/null +++ b/docker/Dockerfile @@ -0,0 +1,26 @@ +# 由 projman 注入的 .NET 运行镜像（单阶段，publish 产物已由 CI 预构建） +# CI 已在 dotnet sdk 容器（--network infra-infra-net，容器名 nexus 直连拉 NuGet 包） +# dotnet publish 到 publish/，并按产物 *.deps.json 生成 entrypoint.sh（无须硬编码项目名） +# 构建上下文 = 仓库根：docker build -f docker/Dockerfile . +# DOTNET_VERSION 默认 5.0（平台现有 .NET 应用均为 5.0）；版本不合时自备本文件——已写则 projman 尊重不覆盖。 +ARG DOTNET_VERSION=5.0 +FROM mcr.microsoft.com/dotnet/aspnet:${DOTNET_VERSION} + +# .NET 5 基础镜像基于 Debian 10（已 EOL），apt 源须切 archive.debian.org 才能装包 +# curl 供 projman compose healthcheck（test: CMD curl -f ...）使用；tzdata 设上海时区 +RUN sed -i 's|deb.debian.org|archive.debian.org|g; s|security.debian.org|archive.debian.org|g' /etc/apt/sources.list \ + && echo 'Acquire::Check-Valid-Until "false";' > /etc/apt/apt.conf.d/99no-valid-until \ + && apt-get update \ + && apt-get install -y --no-install-recommends curl tzdata \ + && ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime \ + && echo "Asia/Shanghai" > /etc/timezone \ + && rm -rf /var/lib/apt/lists/* + +WORKDIR /app +COPY publish/ /app/ + +ENV TZ=Asia/Shanghai +ENV ASPNETCORE_ENVIRONMENT=Production +ENV ASPNETCORE_URLS=http://+:10003 +EXPOSE 10003 +ENTRYPOINT ["sh", "/app/entrypoint.sh"]