Asp-Net-Core开发笔记：FrameworkDependent搭配docker部署

前言#

之前我写过一篇使用 docker 部署 AspNetCore 应用的文章，这种方式搭配 CICD 非常方便， build 之后 push 到私有的 dockerhub ，在生产服务器上 pull 下来镜像就可以直接运行了。

然而，有时需要一种更传统的部署方式，比如在本地打包可执行文件之后直接放到服务器上执行。

.NetCore 打包可执行文件有两种方式

• 独立可执行文件 - 不依赖任何运行时环境，直接执行就可以启动
• 框架依赖 - 需要先安装对应版本的 dotnet-runtime 才可以运行

前者虽然方便，但打包出来比较大，据说在 .net8 版本会有优化，但后面的事后面再说，本文记录第二种方式，框架依赖，搭配 docker 部署，这样就无需在服务器上安装 runtime 了。

（PS：有点Java部署内味了）

这种方式配置完成之后，每次更新只需要重新本地重新 publish 后把可执行文件上传覆盖服务器上的版本即可，非常方便~

不生成 PDB#

每次打包会生成一堆 pdb 调试文件，但部署的时候我们不需要这些文件，可以通过配置 .csproj 文件关闭。

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
  <DebugType>noneDebugType>
  <DebugSymbols>falseDebugSymbols>
PropertyGroup>

更好的方式是在解决方案的目录下创建 common.props 文件，把以上配置放在这个文件中，然后每个 .csproj 都引用这个文件，具体路径根据实际情况而定。

<Import Project="../../common.props" />

打包#

使用以下命令打包

dotnet publish -f net7.0 -c Release -p:PublishSingleFile=true

打包之后生成一个需要依赖 runtime 运行的可执行文件，接下来准备一下 docker 的配置。

dockerfile#

官方的 dockerfile 包含从源码构建到部署的整个流程，我们这里只需要 base 和 final ，也就是把可执行文件放进去微软的基础镜像里运行。

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM base AS final
WORKDIR /app
COPY . .
ENTRYPOINT ["./AIHub.Blazor"]

docker-compose#

不想每次都打一堆 docker 的命令，或者不想写 bash 脚本的话，docker-compose 是最好的选择，还可以很方便的和其他容器编排使用。

version: '3.6'

services:
  web:
    image: ${DOCKER_REGISTRY-}web
    container_name: aihub
    restart: always
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://+:80
    build:
      context: .
    volumes:
      - .:/app
    ports:
      - "12001:80"
    networks:
      - default
      - swag

networks:
  swag:
    name: swag
    external: true
  default:
    name: aihub

补充：

• ports 节点映射了容器内的 80 端口
• 我使用了 swag 来提供 web 服务，所以其实不需要使用 ports 映射端口
• 后续再试用 candy / traefik 来替代 nginx （本项目没有nginx，直接用 kestrel）

启动！#

使用命令行启动！

docker compose up

如果没有映射端口的话，还需要接着配置一下反向代理。

swag配置#

直接上配置

/path/to/swag/config/nginx/proxy-confs/aihub.subdomain.conf

server {
    listen 443 ssl;
    listen [::]:443 ssl;

    server_name aihub.*;

    include /config/nginx/ssl.conf;

    client_max_body_size 0;

    # enable for ldap auth, fill in ldap details in ldap.conf
    #include /config/nginx/ldap.conf;

    # enable for Authelia
    #include /config/nginx/authelia-server.conf;

    location / {
        # enable the next two lines for http auth
        #auth_basic "Restricted";
        #auth_basic_user_file /config/nginx/.htpasswd;

        # enable the next two lines for ldap auth
        #auth_request /auth;
        #error_page 401 =200 /ldaplogin;

        # enable for Authelia
        #include /config/nginx/authelia-location.conf;

        include /config/nginx/proxy.conf;
        include /config/nginx/resolver.conf;

        set $upstream_app aihub;
        set $upstream_port 80;
        set $upstream_proto http;
        proxy_pass $upstream_proto://$upstream_app:$upstream_port;

        proxy_hide_header X-Frame-Options; # Possibly not needed after Portainer 1.20.0
    }
}