Alauda Container Platform
  • 简体中文

    • Creating applications from Image

    目录

    前提条件操作步骤 1 - 工作负载工作负载 1 - 配置基本信息工作负载 2 - 配置 Pod工作负载 3 - 配置容器操作步骤 2 - 服务操作步骤 3 - Ingress应用管理操作参考信息存储卷挂载说明健康检查参数通用参数协议特定参数

    前提条件

    获取镜像地址。镜像来源可以是平台管理员通过工具链集成的镜像仓库，也可以是第三方平台的镜像仓库。

    • 对于前者，管理员通常会将镜像仓库分配给您的项目，您可以使用其中的镜像。如果找不到所需的镜像仓库，请联系管理员进行分配。

    • 如果是第三方平台的镜像仓库，请确保当前集群可以直接拉取该镜像。

    操作步骤 1 - 工作负载

    1. 在 Container Platform 中，左侧边栏导航至 Applications > Applications。

    2. 点击 Create。

    3. 选择 Create from Image 作为创建方式。

    4. 选择或输入镜像，点击 Confirm。

    INFO

    注意：使用来自 Web 控制台集成的镜像仓库中的镜像时，可以通过 Already Integrated 过滤镜像。集成项目名称，例如 images (registry-projectname)，其中包含该 Web 控制台中的项目名 projectname 以及镜像仓库中的项目名 containers。

    使用私有镜像仓库的镜像时，需要配置对应的镜像拉取凭证。详情请参见 为 ServiceAccount 添加 ImagePullSecrets。

    1. 参考以下说明配置相关参数。

    工作负载 1 - 配置基本信息

    在 Workload > Basic Info 部分，配置工作负载的声明式参数

    参数说明
    Model根据需要选择工作负载类型：
    Replicas定义 Deployment 中 Pod 副本的期望数量（默认：1）。根据工作负载需求进行调整。
    More > Update Strategy配置 rollingUpdate 策略，实现零停机部署：
    最大扩容数 (maxSurge)：
    • 更新期间允许超过期望副本数的最大 Pod 数量。
    • 支持绝对值（如 2）或百分比（如 20%）。
    • 百分比计算方式：ceil(当前副本数 × 百分比)。
    • 示例：10 个副本时，4.1 → 5。
    最大不可用数 (maxUnavailable)：
    • 更新期间允许不可用的最大 Pod 数量。
    • 百分比值不可超过 100%。
    • 百分比计算方式：floor(当前副本数 × 百分比)。
    • 示例：10 个副本时，4.9 → 4。
    注意事项：
    1. 默认值：未显式设置时，maxSurge=1，maxUnavailable=1。
    2. 非运行状态的 Pod（如 Pending/CrashLoopBackOff）视为不可用。
    3. 同时限制：
    • maxSurge 和 maxUnavailable 不能同时为 0 或 0%。
    • 若两者百分比均计算为 0，Kubernetes 会强制设置 maxUnavailable=1 以保证更新进度。
    示例：
    对于 10 个副本的 Deployment：
    • maxSurge=2 → 更新期间总 Pod 数为 10 + 2 = 12。
    • maxUnavailable=3 → 最小可用 Pod 数为 10 - 3 = 7。
    • 确保在允许受控滚动的同时保持可用性。

    工作负载 2 - 配置 Pod

    注意：在混合架构集群中部署单架构镜像时，请确保为 Pod 调度配置合适的 节点亲和规则。

    1. 在 Pod 部分，配置容器运行时参数及生命周期管理：

      参数说明
      Volumes挂载持久卷到容器。支持的卷类型包括 PVC、ConfigMap、Secret、emptyDir、hostPath 等。具体实现详情请参见 存储卷挂载说明。
      Image Credential仅在从第三方镜像仓库（通过手动输入镜像 URL）拉取镜像时必需。
      注意：平台集成的镜像仓库镜像会自动继承相关凭证。
      More > Close Grace PeriodPod 接收到终止信号后允许的优雅关闭时间（默认：30s）。
      - 在此期间，Pod 会完成正在处理的请求并释放资源。
      - 设置为 0 会强制立即删除（发送 SIGKILL），可能导致请求中断。
    1. 节点亲和规则
    参数说明
    More > Node Selector限制 Pod 调度到具有特定标签的节点（例如 kubernetes.io/os: linux）。
    Node OS Selector
    More > Affinity基于已有 Pod 定义细粒度调度规则。

    Pod 亲和类型：
    • Pod 亲和：将新 Pod 调度到托管特定 Pod 的节点（同拓扑域）。
    • Pod 反亲和：避免新 Pod 与特定 Pod 共置于同一节点。

    执行模式：
    • RequiredDuringSchedulingIgnoredDuringExecution：仅当规则满足时调度 Pod。
    • PreferredDuringSchedulingIgnoredDuringExecution：优先选择满足规则的节点，但允许例外。

    配置字段：
    • topologyKey：定义拓扑域的节点标签（默认：kubernetes.io/hostname）。
    • labelSelector：通过标签查询过滤目标 Pod。
    1. 网络配置
      • Kube-OVN
        参数说明
        带宽限制对 Pod 网络流量实施 QoS：
        • 出站速率限制：最大出站流量速率（例如 10Mbps）。
        • 入站速率限制：最大入站流量速率。
        子网从预定义的子网池分配 IP。如未指定，使用命名空间默认子网。
        静态 IP 地址绑定持久 IP 地址到 Pod：
        • 多个 Deployment 中的 Pod 可声明相同 IP，但同一时间仅允许一个 Pod 使用。
        • 关键：静态 IP 数量必须 ≥ Pod 副本数。
      • Calico
        参数说明
        静态 IP 地址分配固定 IP，严格唯一：
        • 每个 IP 在集群中只能绑定给一个 Pod。
        • 关键：静态 IP 数量必须 ≥ Pod 副本数。

    工作负载 3 - 配置容器

    1. 在 Container 部分，参考以下说明配置相关信息。

      参数说明
      资源请求与限制
      • Requests：容器运行所需的最小 CPU/内存。
      • Limits：容器运行时允许的最大 CPU/内存。单位定义请参见 资源单位。
      命名空间超售比：
      • 无超售比：
        若存在命名空间资源配额，容器请求/限制继承命名空间默认值（可修改）。
        无命名空间配额时，无默认值，自定义请求。
      • 有超售比：
        请求自动计算为 Limits / 超售比（不可修改）。
      约束条件：
      • 请求 ≤ 限制 ≤ 命名空间配额最大值。
      • 超售比变更需重建 Pod 生效。
      • 超售比启用时禁用手动请求配置。
      • 无命名空间配额时无容器资源限制。
      扩展资源配置集群可用的扩展资源（如 vGPU、pGPU）。
      卷挂载持久存储配置。详见 存储卷挂载说明。
      操作：
      • 已有 Pod 卷：点击 Add
      • 无 Pod 卷：点击 Add & Mount
      参数：
      • mountPath：容器文件系统路径（如 /data）
      • subPath：卷内相对文件/目录路径。
        对于 ConfigMap/Secret：选择具体键
      • readOnly：只读挂载（默认读写）
      详见 Kubernetes 卷。
      端口暴露容器端口。
      示例：暴露 TCP 端口 6379，名称为 redis。
      字段：
      • protocol：TCP/UDP
      • Port：暴露端口（如 6379）
      • name：符合 DNS 规范的标识符（如 redis）
      启动命令与参数覆盖默认 ENTRYPOINT/CMD：
      示例 1：执行 top -b
      - Command：["top", "-b"]
      - 或 Command：["top"]，Args：["-b"]
      示例 2：输出 $MESSAGE：
      /bin/sh -c "while true; do echo $(MESSAGE); sleep 10; done"
      详见 定义命令。
      More > 环境变量
      • 静态值：直接键值对
      • 动态值：引用 ConfigMap/Secret 键、Pod 字段（fieldRef）、资源指标（resourceFieldRef）
      注意：环境变量会覆盖镜像或配置文件中的设置。
      More > 引用 ConfigMap将整个 ConfigMap/Secret 注入为环境变量。支持的 Secret 类型：Opaque、kubernetes.io/basic-auth。
      More > 健康检查
      • 存活探针：检测容器健康（失败则重启）
      • 就绪探针：检测服务可用性（失败则从端点移除）
      详见 健康检查参数。
      More > 日志文件配置日志路径：
      - 默认：收集 stdout
      - 文件模式：如 /var/log/*.log
      要求：
      • 存储驱动 overlay2：默认支持
      • devicemapper：需手动挂载 EmptyDir 到日志目录
      • Windows 节点：确保父目录已挂载（如 c:/a 对应 c:/a/b/c/*.log）
      More > 排除日志文件排除特定日志收集（如 /var/log/aaa.log）。
      More > 停止前执行命令容器终止前执行命令。
      示例：echo "stop"
      注意：命令执行时间必须短于 Pod 的 terminationGracePeriodSeconds。

    2. 点击右上角 Add Container 或 Add Init Container。

      参见 Init Containers。 Init Container：

      1. 在应用容器启动前执行（顺序执行）。
      2. 完成后释放资源。
      3. 允许删除条件：
        • Pod 中有多个应用容器且至少有一个 Init Container。
        • 单应用容器 Pod 不允许删除 Init Container。

    3. 点击 Create。

    操作步骤 2 - 服务

    参数说明
    ServiceKubernetes Service，为集群中运行的应用暴露单一外部访问端点，即使工作负载分布在多个后端。具体参数说明请参见 创建 Service。

    注意：应用下创建的内部路由默认名称前缀为计算组件名称。若计算组件类型（部署模式）为 StatefulSet，建议不要更改内部路由（工作负载）默认名称，否则可能导致工作负载访问异常。

    操作步骤 3 - Ingress

    参数说明
    IngressKubernetes Ingress，通过协议感知的配置机制，使 HTTP（或 HTTPS）网络服务可用，支持 URI、主机名、路径等 Web 概念。Ingress 允许基于 Kubernetes API 定义的规则将流量映射到不同后端。详细参数说明请参见 创建 Ingress。

    注意：应用下创建 Ingress 时，所使用的 Service 必须是当前应用下创建的资源，且确保该 Service 关联应用下的工作负载，否则工作负载的服务发现和访问将失败。
    1. 点击 Create。

    应用管理操作

    修改应用配置时，可使用以下任一方式：

    1. 点击应用列表右侧的竖向省略号（⋮）。
    2. 在应用详情页右上角选择 Actions。
    操作说明
    Update
    • 更新：仅修改目标工作负载，使用其定义的 更新策略（以 Deployment 策略为例），保留现有副本数和滚动配置。
    • 强制更新：触发全应用滚动更新，使用各组件的更新策略。
      1. 适用场景：
      • 批量配置变更需立即在集群内传播（如作为环境变量引用的 ConfigMap/Secret 更新）。
      • 关键安全更新需协调组件重启。
      2. 警告注意：
      • 大规模重启可能导致短暂服务降级。
      • 生产环境使用前需验证业务连续性。
    • 网络影响：
      • Ingress 规则删除：若满足条件，外部访问仍通过 LB_IP:NodePort 可用：
        1) LoadBalancer Service 使用默认端口。
        2) 存在引用应用组件的存活路由规则。
        完全终止外部访问需删除 Service。
      • Service 删除：导致应用组件网络连接不可逆丢失。关联 Ingress 规则失效，尽管 API 对象仍存在。
    Delete
    • 级联删除：
      1. 删除所有子资源，包括 Deployment、Service 和 Ingress 规则。
      2. Persistent Volume Claim (PVC) 按 StorageClass 中定义的保留策略处理。
    • 删除前检查清单：
      1. 确认相关 Service 无活跃流量。
      2. 确认有状态组件数据已备份。
      3. 使用 kubectl describe ownerReferences 检查依赖资源关系。

    参考信息

    存储卷挂载说明

    类型用途
    Persistent Volume Claim绑定已有的 PVC 以申请持久存储。

    注意：仅可选择已绑定（关联 PV）的 PVC。未绑定 PVC 会导致 Pod 创建失败。
    ConfigMap将完整或部分 ConfigMap 数据挂载为文件：
    • 完整 ConfigMap：在挂载路径下创建以键名命名的文件
    • 子路径选择：挂载特定键（如 my.cnf）
    Secret将完整或部分 Secret 数据挂载为文件：
    • 完整 Secret：在挂载路径下创建以键名命名的文件
    • 子路径选择：挂载特定键（如 tls.crt）
    Ephemeral Volumes集群动态提供的临时卷，具备：
    • 动态供应
    • 生命周期与 Pod 绑定
    • 支持声明式配置

    使用场景：临时数据存储。详见 临时卷
    Empty DirectoryPod 内容器间共享的临时存储：
    - Pod 启动时在节点创建
    - Pod 删除时清理

    使用场景：容器间文件共享、临时数据存储。详见 EmptyDir
    Host Path挂载宿主机目录（必须以 / 开头，如 /volumepath）。

    健康检查参数

    通用参数

    参数说明
    Initial Delay探针启动前的宽限时间（秒）。默认值：300。
    Period探针间隔时间（1-120秒）。默认值：60。
    Timeout探针超时时间（1-300秒）。默认值：30。
    Success Threshold标记为健康所需的连续成功次数。默认值：0。
    Failure Threshold触发动作的最大连续失败次数：
    - 0：禁用失败触发动作
    - 默认：连续失败 5 次触发容器重启。

    协议特定参数

    参数适用协议说明
    ProtocolHTTP/HTTPS健康检查协议
    PortHTTP/HTTPS/TCP探测目标容器端口
    PathHTTP/HTTPS端点路径（如 /healthz）
    HTTP HeadersHTTP/HTTPS自定义请求头（添加键值对）
    CommandEXEC容器可执行的检查命令（如 sh -c "curl -I localhost:8080 | grep OK"）。
    注意：需转义特殊字符并测试命令有效性。