balenalib/surface-go-debian-dotnet

⚠️ 已弃用

此基础镜像已弃用，将不再接收更新。请阅读公告文章获取迁移指南和建议的替代方案。

此镜像属于balena.io的IoT设备基础镜像系列。该镜像针对balena.io和balenaOS进行了优化，但也可用于运行在适当架构上的任何Docker环境。

!balenalogo

balenalib基础镜像的一些显著特性：

• 实用的包安装脚本install_packages，它抽象了底层包管理器的细节。该脚本将以最少的依赖项（忽略可选依赖项）安装指定包，清理包管理器元数据，并在安装失败时重试。

• 支持动态插入设备：每个balenalib基础镜像都有默认的ENTRYPOINT定义为ENTRYPOINT ["/usr/bin/entry.sh"]，它会检查UDEV标志是否设置为true（通过添加ENV UDEV=1），如果为true，将启动udevd守护进程，容器的/dev目录中会出现相关设备节点。

有关更多详细信息，请查看我们文档中的特性概述。

镜像变体

balenalib镜像有多种版本，每种版本设计用于特定用例。

:<version> 或 :<version>-run

这是默认镜像。run变体设计为精简且最小化的版本，仅包含运行时必需组件。

:<version>-build

构建变体是一个较重的镜像，包含许多从源代码构建所需的工具。这减少了你需要在Dockerfile中手动安装的包数量，从而减小系统上所有镜像的总体大小。

关于此仓库

本仓库包含.NET Core平台的不同版本：.NET Core SDK、ASP.NET Core Runtime和.NET Core Runtime。

• .NET Core Runtime包含运行时和库，针对在生产环境中运行.NET Core应用进行了优化。

• ASP.NET Core Runtime包含ASP.NET Core和.NET Core运行时及库，针对在生产环境中运行ASP.NET Core应用进行了优化。

• .NET Core SDK由三部分组成：.NET Core CLI、.NET Core和ASP.NET Core。此变体用于开发过程（开发、构建和测试应用程序）。

关于.NET Core

.NET Core是由Microsoft和.NET社区在https://github.com/dotnet/core%E4%B8%8A%E7%BB%B4%E6%8A%A4%E7%9A%84%E9%80%9A%E7%94%A8%E5%BC%80%E5%8F%91%E5%B9%B3%E5%8F%B0%E3%80%82%E5%AE%83%E6%98%AF%E8%B7%A8%E5%B9%B3%E5%8F%B0%E7%9A%84%EF%BC%8C%E6%94%AF%E6%8C%81Windows%E3%80%81macOS%E5%92%8CLinux%EF%BC%8C%E5%8F%AF%E7%94%A8%E4%BA%8E%E8%AE%BE%E5%A4%87%E3%80%81%E4%BA%91%E5%8F%8A%E5%B5%8C%E5%85%A5%E5%BC%8F/IoT%E5%9C%BA%E6%99%AF%E3%80%82

.NET具有多项简化开发的功能，包括自动内存管理、（运行时）泛型类型、反射、异步、并发和本机互操作。数百万开发人员利用这些功能高效构建高质量应用程序。

你可以使用C#编写.NET Core应用。C#简单、强大、类型安全且面向对象，同时保留了C风格语言的表达性和优雅性。任何熟悉C及类似语言的人都会发现用C#编写代码很简单。

https://github.com/dotnet/core%E6%98%AF%E5%BC%80%E6%BA%90%E7%9A%84%EF%BC%88MIT%E5%92%8CApache 2许可证），由Microsoft于2014年贡献给.NET Foundation。个人和公司可自由采用，包括用于个人、学术或商业目的。多家公司将.NET Core用作应用、工具、新平台和托管服务的一部分。

欢迎你https://github.com/dotnet/core/blob/master/CONTRIBUTING.md%E3%80%81%E4%BF%AE%E5%A4%8D%E6%88%96%E6%9B%B4%E6%96%B0%EF%BC%8C%E6%97%A0%E8%AE%BA%E5%A4%A7%E5%B0%8F%EF%BC%9B%E6%88%91%E4%BB%AC%E5%A7%8B%E7%BB%88%E6%AC%A2%E8%BF%8E%E6%8B%89%E5%8F%96%E8%AF%B7%E6%B1%82%EF%BC%8C%E5%B9%B6%E4%BC%9A%E5%B0%BD%E5%8A%9B%E5%BF%AB%E9%80%9F%E5%A4%84%E7%90%86%E3%80%82

[***]

关注https://github.com/dotnet/announcements/labels/Docker%E8%8E%B7%E5%8F%96%E4%B8%8EDocker%E7%9B%B8%E5%85%B3%E7%9A%84.NET%E5%85%AC%E5%91%8A%E3%80%82

支持的版本及对应的Dockerfile链接

https://github.com/balena-io-library/base-images/tree/master/balena-base-images/dotnet/surface-go/debian/

有关此镜像及其历史的更多信息，请参阅https://github.com/balena-io-library/official-images%E4%B8%AD%E7%9A%84%E7%9B%B8%E5%85%B3%E6%B8%85%E5%8D%95%E6%96%87%E4%BB%B6(https://github.com/balena-io-library/official-images/blob/master/library/surface-go-debian-dotnet)%E3%80%82

如何使用此镜像

在你的dotnet应用项目中创建Dockerfile

dockerfile
# 指定带有所需版本的dotnet基础镜像 dotnet:<version>
FROM balenalib/surface-go-debian-dotnet:latest
# 替换为你的应用程序的默认端口
EXPOSE 8000

然后你可以构建并运行Docker镜像：

console
$ docker build -t my-dotnet-app .
$ docker run -it --rm --name my-running-app my-dotnet-app

如果你更喜欢使用Docker Compose：

yml
version: "2"
services:
  dotnet:
    image: "balenalib/surface-go-debian-dotnet:latest"
    user: "dotnet"
    working_dir: /home/dotnet/app
    volumes:
      - ./:/home/dotnet/app
    expose:
      - "8000"

然后使用Docker Compose运行：

console
$ docker-compose up -d

用户反馈

问题

如果你对此镜像有任何问题或疑问，请通过https://github.com/balena-io-library/base-images/issues%E4%B8%8E%E6%88%91%E4%BB%AC%E8%81%94%E7%B3%BB%E3%80%82

贡献

欢迎你贡献新功能、修复或更新，无论大小；我们始终欢迎拉取请求，并会尽力快速处理。

在开始编码之前，我们建议通过https://github.com/balena-io-library/base-images/issues%E8%AE%A8%E8%AE%BA%E4%BD%A0%E7%9A%84%E8%AE%A1%E5%88%92%EF%BC%8C%E7%89%B9%E5%88%AB%E6%98%AF%E5%AF%B9%E4%BA%8E%E6%9B%B4%E5%AE%8F%E5%A4%A7%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82%E8%BF%99%E8%AE%A9%E5%85%B6%E4%BB%96%E8%B4%A1%E7%8C%AE%E8%80%85%E6%9C%89%E6%9C%BA%E4%BC%9A%E4%B8%BA%E4%BD%A0%E6%8C%87%E6%98%8E%E6%AD%A3%E7%A1%AE%E6%96%B9%E5%90%91%E3%80%81%E6%8F%90%E4%BE%9B%E8%AE%BE%E8%AE%A1%E5%8F%8D%E9%A6%88%EF%BC%8C%E5%B9%B6%E5%B8%AE%E5%8A%A9%E4%BD%A0%E4%BA%86%E8%A7%A3%E6%98%AF%E5%90%A6%E6%9C%89%E5%85%B6%E4%BB%96%E4%BA%BA%E6%AD%A3%E5%9C%A8%E5%81%9A%E7%9B%B8%E5%90%8C%E7%9A%84%E5%B7%A5%E4%BD%9C%E3%80%82

文档

此镜像的文档存储在基础镜像文档中。查看该文档可获取所有基础镜像的列表，包括许多专门的镜像（如node、python、go、更小的镜像等）。

你还可以在此博客文章中找到balenalib基础镜像新功能的更多详细信息。