revert: 示例回到 image/compile-dotnet6/demo,移除顶层 demo 目录

This commit is contained in:
2025-11-08 21:55:08 +08:00
parent 5c929a6ed6
commit 1976816e4e
12 changed files with 6 additions and 36 deletions
-25
View File
@@ -1,25 +0,0 @@
# 使用示例
用 `image/` 下的自建镜像构建、部署应用的完整示例。每个示例目录都是独立可运行的项目(含 Dockerfile、构建与部署脚本、说明文档),
不参与 `image/` 镜像本身的构建,可以直接拷贝出去改造。
| 示例 | 使用的镜像 | 说明 |
|----------------------------------------|----------------------------------------------|---------------------------------------------------------|
| [dotnet6](dotnet6/run.md) | `compile-dotnet6` → `runtime-dotnet6` | .NET 6 Web API,两阶段构建:编译镜像出产物、运行镜像只带运行时;含 compose 部署与健康检查 |
## 运行方式
以 dotnet6 为例(每个示例的 `run.md` 有完整说明):
```shell
cd demo/dotnet6
sh build.sh # 构建示例镜像
sh install.sh # 启动
sh shutdown.sh # 停止
```
## 约定
- 示例镜像统一推送到 `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-<名称>`,与 `image/` 的自建镜像区分开
- 示例所用基础镜像需先按 `image/<目录>/build.sh` 构建并推送
- 部署示例默认使用 compose,端口与 `app/` 中的部署编排错开(如 dotnet6 用 8080)
-4
View File
@@ -1,4 +0,0 @@
bin/
obj/
.git/
.DS_Store
-2
View File
@@ -1,2 +0,0 @@
bin/
obj/
-11
View File
@@ -1,11 +0,0 @@
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net6.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<InvariantGlobalization>true</InvariantGlobalization>
<RootNamespace>Demo</RootNamespace>
</PropertyGroup>
</Project>
-18
View File
@@ -1,18 +0,0 @@
# 编译阶段:使用编译环境镜像 compile-dotnet6(含 SDK 6.0.427)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet6 AS build
WORKDIR /src
COPY Demo.csproj ./
RUN dotnet restore Demo.csproj
COPY . ./
RUN dotnet publish Demo.csproj -c Release -o /app/publish --no-restore
# 运行阶段:使用运行环境镜像 runtime-dotnet6(仅含 ASP.NET Core 运行时 6.0.35)
FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet6 AS runtime
LABEL MAINTAINER="tianjun@odboy.cn"
ENV TimeZone=Asia/Shanghai
ENV ASPNETCORE_URLS=http://0.0.0.0:8080
ENV DOTNET_RUNNING_IN_CONTAINER=true
WORKDIR /home/admin
COPY --from=build /app/publish ./
EXPOSE 8080
ENTRYPOINT ["dotnet", "Demo.dll"]
-18
View File
@@ -1,18 +0,0 @@
var builder = WebApplication.CreateBuilder(args);
// 容器内监听 8080,避免与宿主机其它 80 端口冲突;可用环境变量 ASPNETCORE_URLS 覆盖
builder.WebHost.UseUrls(Environment.GetEnvironmentVariable("ASPNETCORE_URLS") ?? "http://0.0.0.0:8080");
var app = builder.Build();
app.MapGet("/", () => Results.Json(new
{
message = "dotnet6 is running",
runtime = Environment.Version.ToString(),
os = System.Runtime.InteropServices.RuntimeInformation.OSDescription,
time = DateTimeOffset.Now.ToString("yyyy-MM-dd HH:mm:ss zzz")
}));
app.MapGet("/health", () => Results.Ok("ok"));
app.Run();
-11
View File
@@ -1,11 +0,0 @@
#!/usr/bin/env bash
# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成)
set -euo pipefail
cd "$(dirname "$0")"
IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet6}
docker build -t "${IMAGE}" .
if [ "${PUSH:-0}" = "1" ]; then
docker push "${IMAGE}"
fi
-28
View File
@@ -1,28 +0,0 @@
version: '3.8'
networks:
dotnet6-demo:
ipam:
driver: default
config:
- subnet: "172.26.0.0/24"
services:
demo:
image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet6 # 镜像由 build.sh 构建
container_name: dotnet6-demo
restart: unless-stopped
ports: # 映射端口
- "8080:8080"
environment: # 设置环境变量,相当于docker run命令中的-e
TZ: Asia/Shanghai
ASPNETCORE_URLS: http://0.0.0.0:8080
healthcheck:
test: ["CMD-SHELL", "netstat -tln | grep -q ':8080 '"]
interval: 30s
timeout: 5s
retries: 3
start_period: 5s
networks:
dotnet6-demo:
ipv4_address: 172.26.0.20
-4
View File
@@ -1,4 +0,0 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p dotnet6-demo up -d
-79
View File
@@ -1,79 +0,0 @@
# 示例:.NET 6 编译 + 运行
演示如何组合 `image/` 下的两个自建镜像构建一个 .NET 6 Web 应用(本目录是独立示例,不参与镜像构建):
| 阶段 | 镜像 | 说明 |
|----|-------------------------------------------------------------|-----------------------------|
| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet6` | 含 SDK 6.0.427(见 `image/compile-dotnet6`) |
| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet6` | 仅含 ASP.NET Core 运行时 6.0.35(见 `image/runtime-dotnet6`) |
编译环境镜像带 SDK 和整套编译工具链(体积大),只在构建阶段使用;运行阶段只拷贝 `dotnet publish` 的产物,
镜像里不带 SDK、源码和中间文件。
### 示例内容
```
demo/dotnet6/
├── Demo.csproj # net6.0 Web 项目
├── Program.cs # 最小 Web API:GET / 返回运行时信息,GET /health 健康检查
├── Dockerfile # 两阶段构建:compile-dotnet6 -> runtime-dotnet6
├── build.sh # 构建镜像(PUSH=1 时同时推送)
├── docker-compose.yml # 部署编排(端口 8080,固定 IP 172.26.0.20)
├── install.sh # docker-compose up -d
├── shutdown.sh # docker-compose down
└── run.md # 本文
```
### 构建与部署
```shell
sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet6 .
PUSH=1 sh build.sh # 构建并推送
sh install.sh # docker-compose -f docker-compose.yml -p dotnet6-demo up -d
```
访问:
```shell
curl http://192.168.235.104:8080/ # {"message":"dotnet6 is running","runtime":"6.0.35",...}
curl http://192.168.235.104:8080/health # ok
```
### 关键点
**还原与发布分离**:先 `COPY` 只有 `*.csproj` 的一层执行 `dotnet restore`,再 `COPY` 源码 `dotnet publish --no-restore`。
源码改动不会让还原缓存失效,重复构建更快。多项目解决方案可按需增加 `COPY` 的 `*.sln` / `*.csproj` 文件。
**监听地址**:容器内监听 `8080`(`ASPNETCORE_URLS=http://0.0.0.0:8080`),不占用 80 端口,方便与宿主机其它服务共存。
镜像环境变量、compose 环境变量、部署时 `-e` 三者依次覆盖。
**时区**:镜像已内置 `TimeZone=Asia/Shanghai`,`DateTimeOffset.Now` 输出 +08:00;compose 中再用 `TZ` 显式声明一次。
**入口**:`ENTRYPOINT ["dotnet", "Demo.dll"]`,使用 exec 形式保证 `docker stop` 的 SIGTERM 能传到进程,优雅退出。
**健康检查**:运行镜像自带 `netstat`(`net-tools`),直接用端口探测,不需要额外安装 curl。
### 运维命令
```shell
docker logs -f dotnet6-demo # 应用日志(stdout/stderr)
docker exec dotnet6-demo dotnet --info # 确认运行时版本
docker exec dotnet6-demo sh -c 'ls /home/admin'
```
### 调试时直接在编译镜像里运行
需要看编译报错或临时跑一下时,可以只挂载源码进编译镜像(不需要构建镜像):
```shell
docker run --rm -it -p 8080:8080 \
-v "$PWD":/src -w /src \
registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet6 \
dotnet run
```
### 停止
```shell
sh shutdown.sh
```
-4
View File
@@ -1,4 +0,0 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
docker-compose -f docker-compose.yml -p dotnet6-demo down