Bitnami ASP.NET Core 镜像文档

1. 镜像概述和主要用途

ASP.NET Core 是由 Microsoft 开发的开源 Web 应用程序开发框架。它既可以在 Windows 上运行于完整的 .NET Framework，也可以跨平台运行于 .NET Core。Bitnami 提供的 ASP.NET Core 镜像经过精心设计和维护，可快速部署到 Kubernetes 集群，适用于生产环境工作负载。

ASP.NET Core 概述

商标说明：本软件列表由 Bitnami 打包。产品中提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或认可。

2. 核心功能和特性

• 基于 Helm 的快速部署方案，适合生产环境
• 支持多种应用部署方式：外部 Docker 镜像、GIT 仓库克隆、现有 PVC 挂载
• 提供完整的 Kubernetes 集成，包括 Ingress、ConfigMap、Secret 等
• 支持资源请求与限制配置，优化集群资源使用
• 内置安全最佳实践，遵循软件供应链完整性标准
• 可配置的亲和性规则，优化 Pod 调度
• 支持额外的 Sidecar 和 Init 容器，满足复杂部署需求
• 提供完整的参数配置选项，支持高度定制化

3. 使用场景和适用范围

• ASP.NET Core Web 应用程序的容器化部署
• Kubernetes 集群上的 ASP.NET Core 应用管理
• 开发环境快速搭建与测试
• 需要高可用性和可扩展性的生产环境部署
• CI/CD 流程集成，自动化构建和部署
• 需要安全加固和供应链安全保障的企业级应用

4. 先决条件

• Kubernetes 1.23+
• Helm 3.8.0+

5. 安装与部署

5.1 快速部署 (TL;DR)

helm install my-release oci://registry-1.docker.io/bitnamicharts/aspnet-core

5.2 使用 Helm 安装

使用发布名称 my-release 安装图表：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/aspnet-core

这些命令会使用默认配置在 Kubernetes 集群上部署 ASP.NET Core 应用。

提示：使用 helm list 命令列出所有发布版本

5.3 部署自定义 ASP.NET Core 应用

5.3.1 使用包含 ASP.NET Core 应用的 Docker 镜像

构建包含 ASP.NET Core 应用的自定义 Docker 镜像，通过覆盖默认镜像参数和设置自定义命令来部署：

appFromExternalRepo.enabled=false
image.registry=docker.io
image.repository=你的镜像仓库
image.tag=你的镜像标签
command=[命令]
args=[参数]

使用 Helm 命令安装：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/aspnet-core \
  --set appFromExternalRepo.enabled=false \
  --set image.registry=docker.io \
  --set image.repository=你的镜像仓库 \
  --set image.tag=你的镜像标签 \
  --set command=[命令] \
  --set args=[参数]

5.3.2 从 GIT 仓库克隆 ASP.NET Core 应用代码

此方法使用两个初始化容器：

• clone-repository: 使用 Bitnami GIT 镜像下载代码仓库
• dotnet-publish: 使用 Bitnami .Net SDK 镜像构建/发布 ASP.NET Core 应用

启用此功能需设置 appFromExternalRepo.enabled=true 并配置仓库参数：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/aspnet-core \
  --set appFromExternalRepo.enabled=true \
  --set appFromExternalRepo.clone.repository=[***] \
  --set appFromExternalRepo.clone.revision=main \
  --set appFromExternalRepo.publish.subFolder=应用子文件夹路径 \
  --set appFromExternalRepo.startCommand[0]=dotnet \
  --set appFromExternalRepo.startCommand[1]=应用入口.dll

示例：部署 OCMinimal 示例应用

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/aspnet-core \
  --set appFromExternalRepo.enabled=true \
  --set appFromExternalRepo.clone.repository=[***] \
  --set appFromExternalRepo.clone.revision=main \
  --set appFromExternalRepo.publish.subFolder=aspnetcore/performance/caching/output/samples/7.x/ \
  --set appFromExternalRepo.startCommand[0]=dotnet \
  --set appFromExternalRepo.startCommand[1]=OCMinimal.dll

5.3.3 从现有 PVC 挂载 ASP.NET Core 应用

如果已创建包含应用代码的 PVC，可通过以下命令挂载部署：

helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/aspnet-core \
  --set appFromExistingPVC.enabled=true \
  --set appFromExistingPVC.existingClaim=my-custom-apsnet-core-app

6. 配置说明

6.1 资源请求和限制

Bitnami 图表允许为部署中的所有容器设置资源请求和限制，通过 resources 参数配置。对于生产工作负载，设置请求至关重要，应根据具体用例进行调整。

图表包含 resourcesPreset 值，可根据不同预设自动设置 resources 部分，但生产环境中建议手动配置以适应特定需求。

6.2 滚动标签与不可变标签

在生产环境中强烈建议使用不可变标签，确保部署不会因标签更新而自动更改。Bitnami 会在主容器有新版本、重大更改或关键漏洞时发布新图表更新容器。

6.3 备份与恢复

要在 Kubernetes 上备份和恢复 Helm 图表部署，需要使用 Velero 工具备份源部署的持久卷并将其附加到新部署。

6.4 添加额外环境变量

可通过 extraEnvVars 属性添加额外环境变量：

extraEnvVars:
  - name: LOG_LEVEL
    value: error

也可使用包含环境变量的 ConfigMap 或 Secret：

extraEnvVarsCM: "configmap-name"        # 包含环境变量的 ConfigMap 名称
extraEnvVarsSecret: "secret-name"       # 包含环境变量的 Secret 名称

6.5 边车容器 (Sidecars) 和初始化容器 (Init Containers)

如需在 ASP.NET Core 应用所在的 Pod 中运行额外容器，可通过 sidecars 参数定义：

sidecars:
  - name: 容器名称
    image: 镜像地址
    imagePullPolicy: Always
    ports:
      - name: 端口名称
        containerPort: 1234

同样，可通过 initContainers 参数添加额外的初始化容器：

initContainers:
  - name: 容器名称
    image: 镜像地址
    imagePullPolicy: Always
    ports:
      - name: 端口名称
        containerPort: 1234

6.6 部署额外资源

如需部署额外对象（如包含应用配置的 ConfigMap），可使用 extraDeploy 参数：

extraDeploy: |-
  - apiVersion: v1
    kind: ConfigMap
    metadata:
      name: aspnet-core-configuration
      labels: {{- include "common.labels.standard" ( dict "customLabels" .Values.commonLabels "context" $ ) | nindent 6 }}
      {{- if .Values.commonAnnotations }}
      annotations: {{- include "common.tplvalues.render" ( dict "value" .Values.commonAnnotations "context" $ ) | nindent 6 }}
      {{- end }}
    data:
      appsettings.json: |-
        {
          "AllowedHosts": "*"
        }

然后挂载到容器中：

extraVolumeMounts:
  - name: configuration
    mountPath: /app/config/
    readOnly: true
extraVolumes:
  - name: configuration
    configMap:
      name: aspnet-core-configuration

6.7 设置 Pod 亲和性

可通过 affinity 参数设置自定义亲和性规则：

affinity:
  podAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      - labelSelector:
          matchExpressions:
            - key: app
              operator: In
              values:
                - aspnet-core
        topologyKey: "kubernetes.io/hostname"

也可使用预设配置：

podAffinityPreset: "soft"          # Pod 亲和性预设
podAntiAffinityPreset: "soft"      # Pod 反亲和性预设
nodeAffinityPreset:                # 节点亲和性预设
  type: "soft"
  key: "kubernetes.io/os"
  values: ["linux"]

6.8 Ingress 配置

如需启用 Ingress 集成，请将 ingress.enabled 设置为 true：

ingress:
  enabled: true
  hostname: aspnet.example.com
  annotations:
    kubernetes.io/ingress.class: nginx
    cert-manager.io/cluster-issuer: letsencrypt-prod
  tls: true

可通过 ingress.extraHosts 添加多个主机：

ingress:
  enabled: true
  hostname: aspnet.example.com
  extraHosts:
    - name: aspnet-admin.example.com
      path: /admin
  extraTLS:
    - hosts:
        - aspnet-admin.example.com
      secretName: aspnet-admin-tls

7. 参数说明

7.1 全局参数

7.2 通用参数

7.3 ASP.NET Core 参数

7.4 ASP.NET Core 部署参数

8. 重要通知：Bitnami 目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将改进其公共目录，在新的 Bitnami Secure Images 计划 下提供精选的强化安全聚焦镜像。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限
• Bitnami 将开始在免费层中弃用对非强化的基于 Debian 的软件镜像的支持，并将逐步从公共目录中删除非最新标签。社区用户将只能访问数量减少的强化镜像，这些镜像仅以 "latest" 标签发布，用于开发目的
• 从 8 月 28 日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如 2.50.0、10.6）将从公共目录 (docker.io/bitnami) 迁移到 "Bitnami Legacy" 仓库 (docker.io/bitnamilegacy)，不再接收更新
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，包括强化容器、更小的攻击面、CVE 透明度（通过 VEX/KEV）、SBOM 和企业支持

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全态势。更多详情，请访问 Bitnami Secure Images 公告。