balenalib/qemux86-64-debian-dotnet

⚠️ 已弃用

此基础镜像已弃用，将不再接收更新。请阅读https://blog.balena.io/deprecate-balenalib-images/获取迁移指南和建议的替代方案。

镜像概述

该镜像属于https://balena.io/?ref=dockerhub的IoT设备基础镜像系列，专为https://balena.io/?ref=dockerhub和https://www.balena.io/os/?ref=dockerhub优化，但也可在适当架构的任何Docker环境中使用。

核心功能与特性

balenalib基础镜像的主要特性包括：

• 便捷的包安装脚本：提供install_packages工具，抽象了底层包管理器细节，可安装指定包（忽略可选依赖以减少依赖数量）、清理包管理器元数据并在安装失败时重试。

• 动态设备支持：默认ENTRYPOINT为ENTRYPOINT ["/usr/bin/entry.sh"]，会检查UDEV环境变量是否设为true（通过ENV UDEV=1设置），若为true则启动udevd守护进程，使容器内/dev目录中出现相关设备节点。

更多详情请查看文档中的https://www.balena.io/docs/reference/base-images/base-images/#features-overview。

镜像变体

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上维护的通用开发平台。它是跨平台的，支持Windows、macOS和Linux，可用于设备、云及嵌入式/IoT场景。

.NET具备多种简化开发的能力，包括自动内存管理、（运行时）泛型类型、反射、异步、并发和原生互操作。数百万开发者利用这些能力高效构建高质量应用。

可使用C#编写.NET Core应用。C#简单、强大、类型安全且面向对象，同时保留C风格语言的表达性和优雅性。熟悉C及类似语言的开发者会发现C#易于上手。

https://github.com/dotnet/core是开源的（MIT和Apache 2许可证），由Microsoft于2014年贡献给http://dotnetfoundation.org。个人和企业可自由采用，包括用于个人、学术或商业目的。多家公司将.NET Core用于应用、工具、新平台和托管服务中。

支持的版本及对应Dockerfile链接

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

有关此镜像及其历史的更多信息，请查看https://github.com/balena-io-library/official-images中的相关清单文件(`qemux86-64-debian-dotnet`)。

如何使用此镜像

在.NET应用项目中创建Dockerfile

dockerfile
# 指定带有所需版本的dotnet基础镜像 dotnet:<version>
FROM docker.xuanyuan.run/balenalib/qemux86-64-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: "docker.xuanyuan.run/balenalib/qemux86-64-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联系我们。

贡献

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

在开始编码前，建议通过https://github.com/balena-io-library/base-images/issues讨论您的计划，尤其是对于较复杂的贡献。这让其他贡献者有机会为您指明方向、提供设计反馈，并帮助您确认是否有其他人正在做相同的工作。

文档

此镜像的文档存储在https://www.balena.io/docs/reference/base-images/base-images/#balena-base-images?ref=dockerhub中。查看该文档可获取所有基础镜像列表，包括许多专用镜像（如node、python、go、更小的镜像等）。

您还可在这篇https://www.balena.io/blog/new-year-new-balena-base-images/?ref=dockerhub中找到balenalib基础镜像新功能的更多详情。