microsoft/dotnet-nightly-yarp

重要提示：dotnet/nightly仓库中的镜像包含https://github.com/dotnet/core%E4%B8%8B%E4%B8%80%E7%89%88%E6%9C%AC%E7%9A%84last-known-good (LKG)构建。有关https://github.com/dotnet/core%E5%AE%98%E6%96%B9%E5%8F%91%E5%B8%83%E7%89%88%E6%9C%AC%E7%9A%84%E9%95%9C%E5%83%8F%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://hub.docker.com/r/microsoft/dotnet/%E3%80%82

推荐标签

• 2.3-preview
  • docker pull ***-mcr.xuanyuan.run/dotnet/nightly/yarp:2.3-preview

概述

此镜像包含YARP的实现，YARP是一个.NET中的反向代理框架。

关注https://github.com/dotnet/dotnet-docker/discussions/categories/announcements%E4%BB%A5%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

使用方法

https://github.com/dotnet/dotnet-docker/blob/main/samples/README.md%E5%B1%95%E7%A4%BA%E4%BA%86.NET%E4%B8%8EDocker%E7%BB%93%E5%90%88%E4%BD%BF%E7%94%A8%E7%9A%84%E5%A4%9A%E7%A7%8D%E6%96%B9%E5%BC%8F%E3%80%82%E6%9C%89%E5%85%B3%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81.NET%E4%B8%8EDocker%E7%AE%80%E4%BB%8B%E3%80%82

您可以运行此镜像以启动YARP实例。

配置

YARP期望配置文件位于/etc/yarp.config，默认监听5000端口。

配置示例：

json
{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ReverseProxy": {
    "Routes": {
      "route1": {
        "ClusterId": "cluster1",
        "Match": {
          "Path": "/aspnetapp/{**catch-all}"
        },
        "Transforms": [
            { "PathRemovePrefix": "/aspnetapp" }
        ]
      }
    },
    "Clusters": {
      "cluster1": {
        "Destinations": {
          "destination1": {
            "Address": "http://aspnetapp1:8080"
          }
        }
      }
    }
  }
}

可通过以下命令使用（其中my-config.config是包含上述配置的文件）：

bash
docker run --rm --name myaspnetapp -d -t ***-mcr.xuanyuan.run/dotnet/samples:aspnetapp
docker run --rm -v $(pwd)/my-config.config:/etc/yarp.config -p 5000:5000 --link myaspnetapp:aspnetapp1 ***-mcr.xuanyuan.run/dotnet/yarp:latest

此示例会将所有来自http://localhost:5000/aspnetapp的请求代理到部署的mcr.microsoft.com/dotnet/samples:aspnetapp容器。

https://github.com/dotnet/yarp/tree/main/samples/%E5%8C%85%E5%90%AB%E6%9B%B4%E5%A4%9A%E9%85%8D%E7%BD%AE%E7%A4%BA%E4%BE%8B%E3%80%82

有关配置镜像和反向代理配置的更多详细信息，请参见https://aka.ms/YarpDocumentation%E3%80%82

OpenTelemetry支持

此镜像支持OpenTelemetry。可通过向容器传递环境变量进行配置：

bash
docker run --rm -v $(pwd)/my-config.config:/etc/yarp.config -p 5000:5000 -e OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp-endpoint.internal:4317 ***-mcr.xuanyuan.run/dotnet/yarp:latest

有关所有支持的环境变量，请参见https://opentelemetry.io/docs/languages/sdk-configuration/otlp-exporter/%E3%80%82

仅可通过传递环境变量YARP_UNSAFE_OLTP_CERT_ACCEPT_ANY_SERVER_CERTIFICATE跳过OTLP端点的HTTPS验证。

相关仓库

.NET：

• https://hub.docker.com/r/microsoft/dotnet/%EF%BC%9A.NET
• https://hub.docker.com/r/microsoft/dotnet-nightly-sdk/%EF%BC%9A.NET SDK（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-aspnet/%EF%BC%9AASP.NET Core运行时（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-runtime/%EF%BC%9A.NET%E8%BF%90%E8%A1%8C%E6%97%B6%EF%BC%88%E9%A2%84%E8%A7%88%E7%89%88%EF%BC%89
• https://hub.docker.com/r/microsoft/dotnet-nightly-runtime-deps/%EF%BC%9A.NET%E8%BF%90%E8%A1%8C%E6%97%B6%E4%BE%9D%E8%B5%96%E9%A1%B9%EF%BC%88%E9%A2%84%E8%A7%88%E7%89%88%EF%BC%89
• https://hub.docker.com/r/microsoft/dotnet-nightly-monitor/%EF%BC%9A.NET Monitor工具（预览版）
• https://hub.docker.com/r/microsoft/dotnet-nightly-aspire-dashboard/%EF%BC%9A.NET Aspire仪表板（预览版）
• https://hub.docker.com/r/microsoft/dotnet-samples/%EF%BC%9A.NET%E7%A4%BA%E4%BE%8B

.NET Framework：

• https://hub.docker.com/r/microsoft/dotnet-framework/%EF%BC%9A.NET Framework、ASP.NET和WCF
• https://hub.docker.com/r/microsoft/dotnet-framework-samples/%EF%BC%9A.NET Framework、ASP.NET和WCF示例

完整标签列表

查看当前标签请访问Microsoft Artifact Registry门户或https://github.com/dotnet/dotnet-docker/blob/nightly/README.yarp.md#full-tag-listing%E3%80%82

支持

生命周期

• https://github.com/dotnet/yarp/blob/main/docs/roadmap.md
• https://github.com/dotnet/core/blob/main/support.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-platforms.md
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md

镜像更新策略

• 基础镜像更新：基础镜像（如debian:bookworm-slim、windows/nanoserver:ltsc2022等）更新后，镜像会在12小时内重新构建。
• .NET版本发布：作为.NET新版本发布的一部分，镜像会重新构建。包括新的主版本、次版本和服务版本。
• 严重CVE修复：如以下CVE更新策略所述，镜像会重新构建以修复严重CVE。
• 月度重新构建：镜像每月重新构建一次，通常在当月第二个星期二，以修复低严重性CVE。
• 紧急更新：必要时会重新构建镜像以解决关键问题。若发生此情况，新的修复版本标签将根据https://github.com/dotnet/dotnet-docker/blob/main/documentation/supported-tags.md#fixed-version-tags%E8%BF%9B%E8%A1%8C%E6%9B%B4%E6%96%B0%E3%80%82

CVE更新策略

.NET容器镜像会定期监控CVE。当满足以下条件时，镜像将重新构建以修复CVE：

• 检测到镜像包含https://nvd.nist.gov/vuln-metrics/cvss%E8%AF%84%E5%88%86%E4%B8%BA%E2%80%9C%E4%B8%A5%E9%87%8D%E2%80%9D%E7%9A%84CVE
• 且该CVE存在于Dockerfile层中添加的包中（即CVE存在于我们显式安装的包或其任何依赖包中）
• 且受影响的基础镜像包仓库中存在该CVE的修复包

有关在.NET镜像中遇到CVE时的处理方法，请参见https://github.com/dotnet/dotnet-docker/blob/main/SECURITY.md%E5%92%8Chttps://github.com/dotnet/dotnet-docker/blob/main/documentation/vulnerability-reporting.md%E3%80%82

反馈

• https://github.com/dotnet/dotnet-docker/issues/new/choose
• 联系Microsoft支持

许可

• ***声明：https://aka.ms/mcr/osslegalnotice
• https://github.com/dotnet/dotnet-docker/blob/main/LICENSE
• https://github.com/dotnet/dotnet-docker/blob/main/documentation/image-artifact-details.md
• Windows基础镜像许可（仅适用于Windows容器）
• Windows Server定价和许可