countingup/nswag Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

nswag

镜像概述和主要用途

nswag镜像是基于.NET Core SDK 5.0-alpine3.13-amd64构建的工具镜像，集成了NSwag（.NET生态系统中的OpenAPI工具链）。该镜像旨在提供容器化环境下的NSwag运行环境，方便开发者通过命令行执行NSwag操作，如API文档生成、OpenAPI规范处理及客户端代码（C#、TypeScript等）生成。

核心功能和特性

• 基础环境：基于mcr.microsoft.com/dotnet/sdk:5.0-alpine3.13-amd64，提供.NET Core 5.0开发环境
• 工具集成：将NSwag作为可执行文件暴露，支持所有NSwag命令行功能（参考NSwag命令行文档）
• 轻量级：采用alpine Linux基础镜像，减少镜像体积，提升运行效率

使用场景和适用范围

• 开发者需要在容器化环境中执行NSwag命令生成API文档
• 团队协作中统一NSwag运行环境，避免本地环境差异导致的问题
• CI/CD流程中集成NSwag命令，自动化处理OpenAPI规范或生成客户端代码

使用方法和配置说明

本地构建镜像

如需本地构建镜像，执行以下命令：

bash
$ cd docker-nswag
$ docker build -t countingup/nswag .

运行容器（从Docker Hub拉取）

直接从Docker Hub拉取并运行镜像，查看帮助信息：

bash
$ docker run -it countingup/nswag help

说明：docker run命令中的-it参数用于交互式运行，可根据实际需求添加其他参数（如挂载本地目录以处理本地文件：-v $(pwd):/app）。