From c6bff91c452bf8a345d44a09951561cf9b6a4586 Mon Sep 17 00:00:00 2001 From: fengruixiang <474182370@qq.com> Date: Thu, 2 Jul 2026 11:01:14 +0800 Subject: [PATCH] feat(docker): add local development setup with Docker for AML_Backend --- CLAUDE.md | 1 + .../docker-compose本地开发/Dockerfile.local | 68 +++++++++++++++ .../Dockerfile.local.dockerignore | 10 +++ .../docker-compose.local.yml | 86 +++++++++++++++++++ .../docker-compose本地开发.md | 0 5 files changed, 165 insertions(+) create mode 100644 docs/AML_Backend/docker-compose本地开发/Dockerfile.local create mode 100644 docs/AML_Backend/docker-compose本地开发/Dockerfile.local.dockerignore create mode 100644 docs/AML_Backend/docker-compose本地开发/docker-compose.local.yml rename docs/AML_Backend/{ => docker-compose本地开发}/docker-compose本地开发.md (100%) diff --git a/CLAUDE.md b/CLAUDE.md index 6abae20..faeacbf 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,6 +1,7 @@ # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. +需要遵守：@AGENTS.md ## Repository Overview diff --git a/docs/AML_Backend/docker-compose本地开发/Dockerfile.local b/docs/AML_Backend/docker-compose本地开发/Dockerfile.local new file mode 100644 index 0000000..407fd47 --- /dev/null +++ b/docs/AML_Backend/docker-compose本地开发/Dockerfile.local @@ -0,0 +1,68 @@ +# syntax=docker/dockerfile:1 +# +# Local-development image for iCON.Abp.FX.HttpApi.Host (+ DbMigrator). +# +# Differs from src/iCON.Abp.FX.HttpApi.Host/Dockerfile (CI): +# - Targets .NET 6 (the projects are net6.0; the CI Dockerfile still says 5.0). +# - Does not COPY the non-existent src/access-token.bin. +# - Produces two runtime targets: `host` (the API) and `migrator` (data init). +# +# Build context = repository root (AML_Backend). See Dockerfile.local.dockerignore. + +############################ +# Restore + build (whole solution available) +############################ +FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build +ARG BUILD_CONFIGURATION=Release +WORKDIR /src + +# NuGet.Config carries the ABP commercial feed (the account key is embedded in the URL). +COPY NuGet.Config ./ +COPY . . + +# Cache the NuGet global-packages folder so context changes don't force a re-download. +RUN --mount=type=cache,target=/root/.nuget/packages \ + dotnet restore "src/iCON.Abp.FX.HttpApi.Host/iCON.Abp.FX.HttpApi.Host.csproj" && \ + dotnet restore "src/iCON.Abp.FX.DbMigrator/iCON.Abp.FX.DbMigrator.csproj" + +############################ +# Publish API host +############################ +FROM build AS publish-host +ARG BUILD_CONFIGURATION=Release +# -m:1 builds one project at a time to keep peak memory down (this solution's +# DbMigrations project is large enough to OOM Roslyn when compiled in parallel). +RUN --mount=type=cache,target=/root/.nuget/packages \ + dotnet publish "src/iCON.Abp.FX.HttpApi.Host/iCON.Abp.FX.HttpApi.Host.csproj" \ + -c "$BUILD_CONFIGURATION" -o /app/host /p:UseAppHost=false -m:1 + +############################ +# Publish DbMigrator (schema migration + data seeding) +############################ +FROM build AS publish-migrator +ARG BUILD_CONFIGURATION=Release +RUN --mount=type=cache,target=/root/.nuget/packages \ + dotnet publish "src/iCON.Abp.FX.DbMigrator/iCON.Abp.FX.DbMigrator.csproj" \ + -c "$BUILD_CONFIGURATION" -o /app/migrator /p:UseAppHost=false -m:1 + +############################ +# Runtime: API host +############################ +FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS host +WORKDIR /app +COPY --from=publish-host /app/host ./ +EXPOSE 44331 +ENTRYPOINT ["dotnet", "iCON.Abp.FX.HttpApi.Host.dll"] + +############################ +# Runtime: DbMigrator +# Seed contributors read data files and the full AppConfig relative to the +# app base directory, so we reuse the host's appsettings.json / Data / wwwroot. +############################ +FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS migrator +WORKDIR /app +COPY --from=publish-migrator /app/migrator ./ +COPY --from=publish-host /app/host/appsettings.json ./appsettings.json +COPY --from=publish-host /app/host/Data ./Data +COPY --from=publish-host /app/host/wwwroot ./wwwroot +ENTRYPOINT ["dotnet", "iCON.Abp.FX.DbMigrator.dll"] diff --git a/docs/AML_Backend/docker-compose本地开发/Dockerfile.local.dockerignore b/docs/AML_Backend/docker-compose本地开发/Dockerfile.local.dockerignore new file mode 100644 index 0000000..472b9b1 --- /dev/null +++ b/docs/AML_Backend/docker-compose本地开发/Dockerfile.local.dockerignore @@ -0,0 +1,10 @@ +# Dedicated ignore file for Dockerfile.local (BuildKit picks .dockerignore). +# Unlike the repo .dockerignore, this one keeps appsettings*.json so the local +# image is self-contained (config is then overridden via env vars in compose). +**/bin +**/obj +**/.git +**/.vs +**/.vscode +**/node_modules +**/*.user diff --git a/docs/AML_Backend/docker-compose本地开发/docker-compose.local.yml b/docs/AML_Backend/docker-compose本地开发/docker-compose.local.yml new file mode 100644 index 0000000..ece213b --- /dev/null +++ b/docs/AML_Backend/docker-compose本地开发/docker-compose.local.yml @@ -0,0 +1,86 @@ +# Local development stack for iCON.Abp.FX.HttpApi.Host +# +# docker compose -f docker-compose.local.yml up -d --build +# +# Services: +# mssql - SQL Server 2022 (amd64 under Rosetta on Apple Silicon) +# db-migrator - runs once: applies EF migrations + seeds data, then exits +# httpapi-host - the API; waits for a successful migration before starting +# +# After it is up: +# Swagger : http://localhost:44331/swagger +# DB : localhost,11433 (sa / Aml@Local2026) +# Admin : admin / 1q2w3E* +name: aml-local + +services: + mssql: + image: mcr.microsoft.com/mssql/server:2022-latest + platform: linux/amd64 # Apple Silicon: requires Rosetta emulation in Docker Desktop + container_name: aml-mssql + environment: + ACCEPT_EULA: "Y" + MSSQL_SA_PASSWORD: "Aml@Local2026" + MSSQL_PID: "Developer" + ports: + - "11433:1433" + volumes: + - mssql-data:/var/opt/mssql + healthcheck: + test: ["CMD-SHELL", "/opt/mssql-tools18/bin/sqlcmd -S localhost -U sa -P \"$$MSSQL_SA_PASSWORD\" -C -Q \"SELECT 1\" -b"] + interval: 10s + timeout: 5s + retries: 30 + start_period: 60s + + db-migrator: + build: + context: . + dockerfile: Dockerfile.local + target: migrator + image: aml-dbmigrator:local + container_name: aml-dbmigrator + depends_on: + mssql: + condition: service_healthy + environment: + DOTNET_ENVIRONMENT: "Development" + ConnectionStrings__Default: "Server=mssql,1433;Database=AbpAML;User Id=sa;Password=Aml@Local2026;TrustServerCertificate=True;Encrypt=False;" + restart: "no" + + httpapi-host: + build: + context: . + dockerfile: Dockerfile.local + target: host + image: aml-httpapi-host:local + container_name: aml-httpapi-host + depends_on: + mssql: + condition: service_healthy + db-migrator: + condition: service_completed_successfully + ports: + - "44331:44331" + volumes: + # ABP commercial license token (from `abp login`). The runtime license + # check reads /root/.abp/cli/access-token.bin; without it the host aborts + # (ABP-LIC-0008). Generate once with: abp login -o -p + - "${HOME}/.abp/cli:/root/.abp/cli:ro" + environment: + ASPNETCORE_ENVIRONMENT: "Development" + ASPNETCORE_URLS: "http://+:44331" + ConnectionStrings__Default: "Server=mssql,1433;Database=AbpAML;User Id=sa;Password=Aml@Local2026;TrustServerCertificate=True;Encrypt=False;" + # IdentityServer issuer / self URL must match the URL used by the browser. + App__SelfUrl: "http://localhost:44331" + AuthServer__Authority: "http://localhost:44331" + AuthServer__RequireHttpsMetadata: "false" + # Silence integrations that point at unreachable infra in local dev. + AppConfig__RabbitMQConfig__EnableConsumer: "false" + AppConfig__RabbitMQConfig__HostName: "127.0.0.1" + AppConfig__JobConfig__SanctionJob__Enabled: "false" + AppConfig__JobConfig__EngineListSyncJob__Enabled: "false" + restart: unless-stopped + +volumes: + mssql-data: diff --git a/docs/AML_Backend/docker-compose本地开发.md b/docs/AML_Backend/docker-compose本地开发/docker-compose本地开发.md similarity index 100% rename from docs/AML_Backend/docker-compose本地开发.md rename to docs/AML_Backend/docker-compose本地开发/docker-compose本地开发.md