logo
Alauda Container Platform
English
简体中文
English
简体中文
logo
Alauda Container Platform
导航

产品概览

架构
发版日志

安装

安装概述

安装准备

前提条件
下载
节点预处理
安装
global 集群灾难恢复

升级

Overview
升级前准备
升级 global 集群
升级业务集群

用户界面

灵雀控制台

概览
访问 Web 控制台
Customizing the Web Console
Customizing the Left Navigation
CLI 工具

配置

功能开关配置

集群

概述
创建本地集群
etcd 加密
自动旋转 Kubernetes 证书

实用指南

为内置注册表添加外部地址
选择容器运行时
更新公共仓库凭证

网络

介绍

架构

理解 Kube-OVN
了解 ALB
了解 MetalLB

核心概念

认证
Ingress-nginx 注解兼容性
TCP/HTTP 保持连接
ModSecurity
不同 Ingress 方式的比较
HTTP 重定向
L4/L7 超时
GatewayAPI
OTel

功能指南

创建服务
创建 Ingress
配置网关
创建 Ingress-Nginx
创建域名
创建证书
创建外部 IP 地址池
创建 BGP Peers
配置子网
配置网络策略
创建 Admin 网络策略
配置集群网络策略

如何操作

为 ALB 部署高可用 VIP
软件数据中心负载均衡方案(Alpha)
准备 Kube-OVN Underlay 物理网络
Underlay 和 Overlay 子网的自动互联
在 ALB 中使用 OAuth Proxy
创建 GatewayAPI Gateway
配置负载均衡器
如何合理分配 CPU 和内存资源
将 IPv6 流量转发到集群内的 IPv4 地址
Calico 网络支持 WireGuard 加密
Kube-OVN Overlay 网络支持 IPsec 加密
ALB 监控
Application Load Balancer (ALB) 中的负载均衡会话亲和策略

故障排除

如何解决 ARM 环境中的节点间通信问题?
查找错误原因

机器配置

概览
使用 MachineConfig 管理节点配置
节点中断策略

存储

介绍

概念

访问模式与卷模式
核心概念
Persistent Volume

功能指南

创建 CephFS 文件存储类型存储类
创建 CephRBD 块存储类
创建 TopoLVM 本地存储类
创建 NFS 共享存储类
部署 Volume Snapshot 组件
创建 PV
创建 PVCs
使用卷快照

实用指南

设置 NFS 共享存储类的子目录命名规则
通用临时卷
使用 emptyDir
第三方存储能力注解指南

故障排除

从 PVC 扩容失败中恢复

存储

Ceph 分布式存储

介绍

安装

创建标准类型集群
创建 Stretch 类型集群
架构

核心概念

核心概念

操作指南

访问存储服务
管理存储池
节点特定组件部署
添加设备/设备类
监控与告警

实用指南

配置专用集群用于分布式存储
清理分布式存储

数据容灾

文件存储灾备
块存储灾难恢复
对象存储灾备
更新优化参数
创建 ceph 对象存储用户

MinIO 对象存储

介绍
安装
架构

核心概念

核心概念

操作指南

添加存储池
Monitoring & Alerts

实用指南

数据灾难恢复

TopoLVM 本地存储

介绍
安装

操作指南

设备管理
监控与告警

实用指南

使用 Velero 备份和恢复 TopoLVM 文件系统 PVC

安全

Alauda Container Security

安全性与合规性

合规

介绍
安装

使用指南

私有镜像仓库访问配置
Image Signature Verification Policy
使用 Secrets 的镜像签名验证策略
镜像仓库验证策略
容器逃逸防护策略
Security Context Enforcement Policy
网络安全策略
Volume Security Policy

API Refiner

介绍
安装

用户与角色

用户

介绍

功能指南

管理用户角色
创建用户
用户管理

用户组

介绍

功能指南

管理用户组角色
创建本地用户组
管理本地用户组成员资格

角色

介绍

功能指南

创建角色
管理自定义角色

IDP

介绍

功能指南

LDAP 管理
OIDC 管理

故障排除

删除用户

用户策略

介绍

多租户(项目)

介绍

功能指南

创建项目
管理项目
管理项目集群
管理项目成员

审计

介绍

遥测

安装

虚拟化

虚拟化

概览

介绍
安装

镜像

介绍

操作指南

添加虚拟机镜像
更新/删除虚拟机镜像
更新/删除镜像凭据

实用指南

使用 KubeVirt 基于 ISO 创建 Windows 镜像
使用 KubeVirt 基于 ISO 创建 Linux 镜像
导出虚拟机镜像
权限说明

虚拟机

介绍

操作指南

创建虚拟机/虚拟机组
虚拟机批量操作
使用 VNC 登录虚拟机
管理密钥对
管理虚拟机
监控与告警
虚拟机快速定位

实用指南

配置 USB 主机直通
虚拟机热迁移
虚拟机恢复
在 KubeVirt 上克隆虚拟机
物理 GPU 直通环境准备
配置虚拟机的高可用性
从现有虚拟机创建虚拟机模板

问题处理

虚拟机节点正常关机下的 Pod 迁移及异常宕机恢复问题
热迁移错误信息及解决方案

网络

介绍

操作指南

配置网络

实用指南

通过网络策略实现虚拟机网络请求控制
配置 SR-IOV
配置虚拟机使用网络绑定模式以支持 IPv6

存储

介绍

操作指南

管理虚拟磁盘

备份和恢复

介绍

操作指南

使用快照

开发者

快速开始

Creating a simple application via image

构建应用

核心概念

应用类型
Custom Applications
Workload Types
理解参数
理解环境变量
理解启动命令
资源单位说明

命名空间

创建命名空间
导入 Namespace
Resource Quota
Limit Range
Pod Security Admission
Overcommit Ratio
管理命名空间成员
更新命名空间
删除/移除命名空间

创建应用

Creating applications from Image
Creating applications from Chart
通过 YAML 创建应用
通过代码创建应用
Creating applications from Operator Backed
通过 CLI 工具创建应用

应用的操作与维护

Application Rollout

安装 Alauda Container Platform Argo Rollouts
Application Blue Green Deployment
Application Canary Deployment
状态说明

KEDA(Kubernetes Event-driven Autoscaling)

KEDA Overview
Installing KEDA

实用指南

Integrating ACP Monitoring with Prometheus Plugin
在 KEDA 中暂停自动扩缩容
配置 HPA
启动和停止原生应用
配置 VerticalPodAutoscaler (VPA)
配置 CronHPA
更新原生应用
导出应用
更新和删除 Chart 应用
应用版本管理
删除原生应用
健康检查

计算组件

Deployments
DaemonSets
StatefulSets
CronJobs
任务
Pods
Containers
使用 Helm charts

配置

Configuring ConfigMap
Configuring Secrets

应用可观测

监控面板
Logs
实时事件

实用指南

设置定时任务触发规则

镜像仓库

介绍

安装

通过 YAML 安装
通过 Web UI 安装

使用指南

Common CLI Command Operations
Using Alauda Container Platform Registry in Kubernetes Clusters

S2I

介绍

安装

Installing Alauda Container Platform Builds

升级

升级 Alauda Container Platform Builds
架构

功能指南

Managing applications created from Code

How To

通过代码创建应用

节点隔离策略

引言
架构

概念

核心概念

功能指南

创建节点隔离策略
权限说明
常见问题

GitOps

介绍

安装

Installing Alauda Build of Argo CD
Installing Alauda Container Platform GitOps

升级

Upgrading Alauda Container Platform GitOps
架构

核心概念

GitOps

Argo CD 核心概念

Argo CD Introduction
Application 概念
ApplicationSet 概念
Tool
Helm 概念
Kustomize 概念
Directory 概念
Sync 概念
Health 概念

Alauda Container Platform GitOps 核心概念

介绍
Alauda Container Platform GitOps 的同步及健康检查

功能指南

创建 GitOps 应用

Creating GitOps Application
Creating GitOps ApplicationSet

GitOps 可观测

Argo CD 组件监控
GitOps 应用运维

实用指南

通过 Argo CD Dashboard 集成代码仓库
通过 Argo CD dashboard 创建 Argo CD Application
通过平台创建 Argo CD Application
如何获取 Argo CD 访问信息
故障排查

扩展

Operator
集群插件

可观测性

概览

监控

介绍
安装

架构

监控模块架构
监控组件选型指南
核心概念

操作指南

指标管理
告警管理
通知管理
监控面板管理
探针管理

实用指南

Prometheus 监控数据的备份与恢复
VictoriaMetrics 监控数据备份与恢复
从自定义命名的网络接口采集网络数据

调用链

介绍
安装
架构
核心概念

操作指南

查询追踪
查询追踪日志

实用指南

Java 应用无侵入方式接入调用链
与 TraceID 相关的业务日志

问题处理

查询不到所需的调用链
调用链数据不完整

日志

介绍
安装

架构

日志模块架构
日志组件选型指南
日志组件容量规划
概念

操作指南

日志

实用指南

如何将日志归档至第三方存储
如何对接外部 ES 存储集群

事件

介绍
Events

巡检

介绍
架构

操作指南

巡检
Component Health Status

硬件加速器

概述

介绍
功能概览
安装

应用开发

介绍

功能指南

CUDA 驱动与运行时兼容性
使用 ConfigMap 添加自定义设备

故障排除

解决 vLLM 中 “float16 is only supported on GPUs with compute capability at least xx” 错误
Paddle Autogrow 内存分配在 GPU-Manager 上的崩溃问题

配置管理

介绍

功能指南

在 GPU 节点上配置硬件加速器

资源监控

介绍

功能指南

GPU 资源监控

Alauda 服务网格

关于 Alauda Service Mesh

Alauda AI

关于 Alauda AI

Alauda DevOps

关于灵雀云 DevOps

Alauda 计量计费

关于 Alauda 成本管理

Alauda 应用服务

概览

介绍
架构
安装
升级

Alauda Database Service for MySQL

关于 Alauda Database Service for MySQL-MGR
关于 Alauda Database Service for MySQL-PXC

Alauda Cache Service for Redis OSS

关于 Alauda Cache Service for Redis OSS

Alauda Streaming Service for Kafka

About Alauda Streaming Service for Kafka

Alauda Streaming Service for RabbitMQ

关于 Alauda Streaming Service for RabbitMQ

Alauda support for PostgreSQL

关于 Alauda support for PostgreSQL

运维管理

介绍

参数模板管理

介绍

功能指南

参数模板管理

备份管理

介绍

功能指南

外部 S3 存储
备份管理

检查管理

介绍

操作指南

创建巡检任务
Exec Inspection Task
更新和删除巡检任务

实用指南

如何设置检查调度?

检查优化建议

MySQL

MySQL IO负载优化
MySQL 内存使用优化
MySQL存储空间优化
MySQL 活动线程计数优化
MySQL 行锁优化

Redis

Redis 大键
Redis中的高CPU使用率
Redis中的高内存使用

Kafka

Kafka 中的高 CPU 利用率
Kafka Rebalance 优化
Kafka内存使用优化
Kafka 存储空间优化

RabbitMQ

RabbitMQ Mnesia 数据库异常处理

警报管理

介绍

操作指南

与平台能力的关系

升级管理

介绍

操作指南

示例升级

API 参考

概览

介绍
Kubernetes API 使用指南

Advanced APIs

Alert APIs

AlertHistories [v1]
AlertHistoryMessages [v1]
AlertStatus [v2]
SilenceStatus [v2]

Event APIs

Search

Log APIs

Aggregation
Archive
Context
Search

Monitoring APIs

Indicators [monitoring.alauda.io/v1beta1]
Metrics [monitoring.alauda.io/v1beta1]
Variables [monitoring.alauda.io/v1beta1]

Kubernetes APIs

Alert APIs

AlertTemplate [alerttemplates.aiops.alauda.io/v1beta1]
PrometheusRule [prometheusrules.monitoring.coreos.com/v1]

Inspection APIs

Inspection [inspections.ait.alauda.io/v1alpha1]

Notification APIs

Notification [notifications.ait.alauda.io/v1beta1]
NotificationGroup [notificationgroups.ait.alauda.io/v1beta1]
NotificationTemplate [notificationtemplates.ait.alauda.io/v1beta1]
📝 在 GitHub 上编辑此页
上一页概述
下一页etcd 加密

#创建本地集群

#目录

#前提条件

#节点要求

  1. 如果您从下载安装包下载了单架构安装包,请确保节点机器的架构与安装包一致,否则节点因缺少对应架构的镜像无法启动。
  2. 确认节点操作系统和内核版本受支持,详情见支持的操作系统和内核。
  3. 对节点机器进行可用性检查,具体检查项请参考节点预处理 > 节点检查。
  4. 如果节点机器的 IP 无法通过 SSH 直接访问,需要为节点提供 SOCKS5 代理,global 集群将通过该代理服务访问节点。

#负载均衡

生产环境中,集群控制平面节点需要负载均衡器以保证高可用性。 您可以提供自有硬件负载均衡器,或启用“自建 VIP”,该方式通过 haproxy + keepalived 实现软件负载均衡。 推荐使用硬件负载均衡器,原因如下:

  • 性能更优:硬件负载均衡性能优于软件负载均衡。
  • 复杂度更低:如果不熟悉 keepalived,配置错误可能导致集群不可用,排查耗时且严重影响集群可靠性。

使用自有硬件负载均衡器时,可将负载均衡器的 VIP 作为“IP 地址 / 域名”参数;如果有解析到负载均衡器 VIP 的域名,也可使用该域名作为“IP 地址 / 域名”参数。 注意:

  • 负载均衡器必须正确转发流量到集群所有控制平面节点的端口 6443、11780 和 11781。
  • 如果集群仅有一个控制平面节点,且使用该节点 IP 作为“IP 地址 / 域名”参数,后续无法将单节点集群扩展为高可用多节点集群,因此建议即使是单节点集群也提供负载均衡器。

启用“自建 VIP”时,需要准备:

  1. 可用的 VRID
  2. 支持 VRRP 协议的主机网络
  3. 所有控制平面节点和 VIP 必须在同一子网,且 VIP 不能与任何节点 IP 相同。

#连接 global 集群与业务集群

平台要求 global 集群与业务集群之间互通访问。若不在同一网络,需要:

  1. 为业务集群提供“外部访问”,确保 global 集群可访问业务集群。网络要求确保 global 可访问所有控制平面节点的端口 6443、11780 和 11781。
  2. 为 global 添加业务集群可访问的额外地址。创建业务集群时,将该地址以键 cpaas.io/platform-url 和值为 global 公共访问地址的形式添加到集群注解中。

#镜像仓库

集群镜像支持平台内置、私有仓库和公共仓库三种选项。

  • 平台内置:使用 global 集群提供的镜像仓库。若集群无法访问 global,请参见为内置仓库添加外部地址。
  • 私有仓库:使用您自有的镜像仓库。关于将所需镜像推送至私有仓库的详情,请联系技术支持。
  • 公共仓库:使用平台公共镜像仓库。使用前请完成更新公共仓库凭据。

#容器网络

若计划使用 Kube-OVN 的 Underlay 方案,请参考准备 Kube-OVN Underlay 物理网络。

#创建操作步骤

  1. 进入 管理员 视图,点击左侧导航栏的 Clusters/Clusters。

  2. 点击 创建集群。

  3. 按照以下说明配置:基础信息、容器网络、节点设置和扩展参数。

#基础信息

参数说明
Kubernetes 版本

所有可选版本均经过严格测试,保证稳定性和兼容性。


推荐:选择最新版本以获得最佳功能和支持。

容器运行时

默认提供 containerd 作为容器运行时。


如果您偏好使用 Docker 作为容器运行时,请参考选择容器运行时。

集群网络协议

支持三种模式:IPv4 单栈、IPv6 单栈、IPv4/IPv6 双栈。


注意:选择双栈模式时,确保所有节点均正确配置 IPv6 地址;网络协议设置后不可更改。

集群访问端点

IP 地址 / 域名:填写预先准备的域名,若无域名则填写 VIP。


自建 VIP:默认关闭,仅当未提供 LoadBalancer 时启用。启用后安装程序会自动部署 keepalived 以支持软件负载均衡。


外部访问:当集群与 global 集群不在同一网络环境时,填写为集群准备的外部可访问地址。

#容器网络

Kube-OVN
Calico
Flannel
Custom

Alauda 开发的企业级云原生 Kubernetes 容器网络编排系统。它将 OpenStack 领域成熟的网络能力引入 Kubernetes,支持跨云网络管理、传统网络架构与基础设施互联、边缘集群部署场景,同时大幅提升 Kubernetes 容器网络的安全性、管理效率和性能。

参数说明
子网

也称为 Cluster CIDR,表示默认子网段。集群创建后可添加额外子网。

传输模式

Overlay:基于基础设施抽象的虚拟网络,不占用物理网络资源。创建 Overlay 默认子网时,集群内所有 Overlay 子网使用相同的集群 NIC 和节点 NIC 配置。
Underlay:依赖物理网络设备的传输方式,可直接为 Pod 分配物理网络地址,保证更好的性能和与物理网络的连通性。Underlay 子网的节点必须具备多网卡,且用于桥接网络的网卡必须专用于 Underlay,不承载其他流量如 SSH。创建 Underlay 默认子网时,集群 NIC 实际为桥接网络默认网卡,节点 NIC 为桥接网络中的节点网卡配置。

  • 默认网关:物理网络网关地址,即 Cluster CIDR 段的网关地址(必须在 Cluster CIDR 地址范围内)。
  • VLAN ID:虚拟局域网标识(VLAN 编号),例如 0。
  • 保留 IP:设置不自动分配的保留 IP,如子网内已被其他设备占用的 IP。
Service CIDR

Kubernetes 类型为 ClusterIP 的 Service 使用的 IP 地址范围,不能与默认子网范围重叠。

Join CIDR

Overlay 传输模式下,节点与 Pod 之间通信使用的 IP 地址范围,不能与默认子网或 Service CIDR 重叠。

#节点设置

参数说明
网卡

集群网络插件使用的主机网络接口设备名称。


注意:

  • 选择 Kube-OVN 默认子网的 Underlay 传输模式时,必须指定网卡名称,该网卡将作为桥接网络的默认网卡。
    - 平台默认识别名称类似 eth.|en.|wl.|ww. 的网卡流量进行监控。若使用其他命名规则的网卡,请参考从自定义命名网卡采集网络数据完成集群接入后修改相关资源,确保平台能正确监控网卡流量。
节点名称

可选择使用节点 IP 或主机名作为平台上的节点名称。


注意:选择主机名作为节点名称时,确保加入集群的节点主机名唯一。

节点

添加节点 到集群,或 从草稿恢复 临时保存的节点信息。详见下方添加节点参数说明。

监控类型

支持 Prometheus 和 VictoriaMetrics。
选择 VictoriaMetrics 监控组件时,需配置 部署类型:
- 部署 VictoriaMetrics:部署所有相关组件,包括 VMStorage、VMAlert、VMAgent 等。


- 部署 VictoriaMetrics Agent:仅部署日志采集组件 VMAgent。此部署方式需关联平台上其他集群已部署的 VictoriaMetrics 实例,为集群提供监控服务。

监控节点

选择部署集群监控组件的节点。支持选择允许部署应用的计算节点和控制平面节点。


为避免影响集群性能,建议优先选择计算节点。集群创建成功后,存储类型为 本地卷 的监控组件将在所选节点部署。

添加节点参数

参数说明
类型

控制平面节点:负责运行 kube-apiserver、kube-scheduler、kube-controller-manager、etcd、容器网络及部分平台管理组件。启用 允许部署应用 后,控制平面节点也可作为计算节点使用。


工作节点:负责承载集群中运行的业务 Pod。

IPv4 地址

节点的 IPv4 地址。内网模式创建的集群填写节点的 私有 IP。

IPv6 地址

集群启用 IPv4/IPv6 双栈时有效,节点的 IPv6 地址。

允许部署应用

在 节点类型为 控制平面节点 时有效,是否允许在该控制平面节点部署业务应用,调度业务相关 Pod 到该节点。

显示名称节点的显示名称。
SSH 连接 IP

访问节点 SSH 服务时可连接的 IP 地址。


若可通过 ssh <用户名>@<节点 IPv4 地址> 登录节点,则此参数可不填;否则需填写节点的公网 IP 或 NAT 外网 IP,确保 global 集群及代理能通过该 IP 连接节点。

网卡

输入节点使用的网卡名称。网卡配置生效优先级如下(从左到右,依次递减):


Kube-OVN Underlay:节点网卡 > 集群网卡


Kube-OVN Overlay:节点网卡 > 集群网卡 > 节点默认路由对应网卡


Calico:集群网卡 > 节点默认路由对应网卡


Flannel:集群网卡 > 节点默认路由对应网卡

关联桥接网络

注意:创建集群时不支持桥接网络配置,仅在为已有 Underlay 子网的集群 添加节点 时可用。


选择已有的添加桥接网络。若不想使用桥接网络默认网卡,可单独配置节点网卡。

SSH 端口

SSH 服务端口号,例如 22。

SSH 用户名

SSH 用户名,需为具有 root 权限的用户,例如 root。

代理

是否通过代理访问节点的 SSH 端口。当 global 集群无法直接通过 SSH 访问待添加节点(如 global 集群与业务集群不在同一子网,节点 IP 为 global 集群无法直接访问的内网 IP)时,需开启此开关并配置代理相关参数。配置代理后,可通过代理访问和部署节点。


注意:目前仅支持 SOCKS5 代理。


访问地址:代理服务器地址,例如 192.168.1.1:1080 。
用户名:访问代理服务器的用户名。


密码:访问代理服务器的密码。

SSH 认证

登录新增节点的认证方式及对应认证信息,选项包括:


密码:需提供具有 root 权限的用户名及对应的 SSH 密码。
密钥:需提供具有 root 权限的 私钥及 私钥密码。

保存草稿

将当前对话框配置的数据保存为草稿并关闭 添加节点 对话框。


在不离开 创建集群 页面情况下,可选择 从草稿恢复 打开 添加节点 对话框,恢复保存的草稿配置数据。


注意:恢复的是最近一次保存的草稿数据。

#扩展参数

注意:

  • 除必填配置外,不建议设置扩展参数,错误配置可能导致集群不可用,且集群创建后无法修改。

  • 若输入的 Key 与默认参数 Key 重复,则会覆盖默认配置。

操作步骤

  1. 点击 扩展参数 展开扩展参数配置区域。可选设置以下集群扩展参数:
参数说明
Docker 参数

dockerExtraArgs,Docker 的额外配置参数,将写入 /etc/sysconfig/docker。不建议修改。若通过 daemon.json 配置 Docker,需以键值对形式配置。

Kubelet 参数

kubeletExtraArgs,Kubelet 的额外配置参数。


注意:当输入 容器网络 的 节点 IP 数量 参数时,会自动生成一个默认的 Kubelet 参数 配置,键为 max-pods,值为 节点 IP 数量,用于设置集群中任一节点可运行的最大 Pod 数量。该配置不在界面显示。


在 Kubelet 参数 区域添加新的 max-pods: 最大可运行 Pod 数量 键值对会覆盖默认值。允许任意正整数,但建议使用默认值(节点 IP 数量)或不超过 256 的值。

Controller Manager 参数

controllerManagerExtraArgs,Controller Manager 的额外配置参数。

Scheduler 参数

schedulerExtraArgs,Scheduler 的额外配置参数。

APIServer 参数

apiServerExtraArgs,APIServer 的额外配置参数。

APIServer URL

publicAlternativeNames,证书中颁发的 APIServer 访问地址。仅可填写 IP 或域名,最长 253 字符。

集群注解

集群注解信息,以键值对形式标记集群元数据特征,供平台组件或业务组件获取相关信息。

  1. 点击 创建,返回集群列表页,集群状态为 创建中。

#创建后操作

#查看创建进度

在集群列表页,可查看已创建集群列表。对于状态为 创建中 的集群,可查看执行进度。

操作步骤

  1. 点击集群状态右侧的小图标 查看执行进度。

  2. 弹出的执行进度对话框中,可查看集群执行进度(status.conditions)。

    提示:当某类型处于进行中或失败状态且有原因时,将鼠标悬停在对应原因(蓝色文字)上,可查看该原因的详细信息(status.conditions.reason)。

#关联项目

集群创建完成后,可在项目管理视图中将其添加到项目中。