Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion fixture-docs/en/development/component-quickstart/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,6 @@ Explanation:
- `RELEASE_YAML_PATH`: The address where the configuration list is saved locally.
- **Must** be stored within the `release` directory, although the file name can be customized.
- `VERSION_CONFIGMAP_NAME`: The name of the `configmap` that records the component version number in the configuration list.

- For example, the configuration file name for the `tektoncd-pipeline` component is `pipelines-info`.

```yaml
Expand Down
9 changes: 0 additions & 9 deletions fixture-docs/en/install/installing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,47 +127,38 @@ bash setup.sh --network-mode calico
In the Web UI, configure the key parameters for installing the management cluster as prompted, with details as follows:

- **Kubernetes Version**

- All optional versions have been strictly tested.
- It is recommended to choose the latest version for optimal features and support.

- **Cluster Network Protocol**

- Supports IPv4 single-stack, IPv6 single-stack, and IPv4/IPv6 dual-stack.
- Note: When selecting dual-stack mode, all nodes must be correctly configured with IPv6 addresses; the network protocol setting cannot be changed once configured.

- **Cluster Address**

- Enter the prepared `global VIP` for external access to the kube-apiserver.
- If a LoadBalancer is configured, please fill in its VIP address and disable "Self-built VIP"; otherwise, enable "Self-built VIP" and enter the requested VIP, the installer will automatically deploy keepalived.

- **Platform Access Address**

- Enter the prepared `External IP` or domain name.
- HTTPS access is enabled by default; if HTTP is needed, enable it in the advanced settings.
- Supports multiple address configurations: you can fill in internal addresses and add external addresses in "Other Settings > Other Platform Access Addresses."

- **Certificate**

- Defaults to using self-signed certificates to support HTTPS.
- To customize the certificate, please upload the existing certificate.

- **Image Repository**

- Defaults to using the platform-deployed image repository, which includes all component images.
- If you need to use an external image repository, please contact technical support to obtain an image synchronization plan for configuration.

- **Container Network**

- The default subnet and Service range for the management cluster must not overlap.
- When using the Kube-OVN Overlay network, ensure the container network and host network are not in the same subnet to prevent network anomalies.

- **Node Name**

- If you choose "Use Hostname as Node Name," please ensure all node hostnames are unique.

- **Global Cluster Platform Node Isolation**

- Enable this when planning to run workloads on the management cluster.
- Once enabled, nodes can be set to "Platform Exclusive," meaning they will only run platform components; DaemonSet types are an exception.

Expand Down
2 changes: 0 additions & 2 deletions fixture-docs/en/install/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,10 @@ title: Installation overview
The platform architecture and key features are as follows:

- **Architecture Design**

- **Management Cluster**: Responsible for the core management of the platform, providing cluster, tenant management, and global scheduling. After the management cluster is installed, business clusters can be added or created as needed.
- **Business Cluster**: Specifically designed to bear business workloads and supports horizontal scaling. Business clusters can be independently deployed or connected through existing clusters that meet version requirements.

- **Design Principles**

1. **Control Plane Isolation Deployment**
When installing the management cluster, dedicated physical resources must be used and not shared with business clusters to ensure the stability and security of the control plane.
2. **Hybrid Deployment Compatibility**
Expand Down
5 changes: 0 additions & 5 deletions fixture-docs/en/install/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,6 @@ Check the script logs to confirm that the system configuration items have been s
Check the following requirements item by item to ensure that the local environment meets the installation needs:

- **Operating System and Kernel Configuration:**

- [x] The grub boot configuration includes the `transparent_hugepage=never` parameter.
- \[!] CentOS 7.x systems must add the `cgroup.memory=nokmem` parameter in the grub configuration.
- [x] When the kernel version is below 4.19.0 (or RHEL below 4.18.0), ensure that the `nf_conntrack_ipv4` and (for IPv6) `nf_conntrack_ipv6` modules are enabled.
Expand All @@ -137,13 +136,11 @@ Check the following requirements item by item to ensure that the local environme
- [x] Disable swap.

- **User and Permission Settings:**

- [x] SSH users have `root` privileges and can use `sudo` without a password.
- [x] The `UseDNS` and `UsePAM` parameters in `/etc/ssh/sshd_config` are set to `no`.
- [x] `systemctl show --property=DefaultTasksMax` returns `infinity` or a very large value; if not, adjust `/etc/systemd/system.conf`.

- **Network and Hostname:**

- [x] Hostname requirements: No more than 36 characters, starting and ending with letters or numbers, only containing lowercase letters, numbers, `-`, and `.` (must not contain `.-`, `..`, or `-.`).
- [x] `localhost` in `/etc/hosts` should resolve to `127.0.0.1`.
- [x] The `/etc/resolv.conf` file exists and contains the `nameserver` configuration, but must not include addresses starting with 172 (disable systemd-resolved).
Expand Down Expand Up @@ -350,12 +347,10 @@ To ensure that the management cluster can receive external traffic forwarded by
**Other Configuration Requirements:**

1. **LoadBalancer Configuration:**

- Please refer to the relevant documentation for specific configuration methods.
- It is recommended to configure health checks to monitor port status.

2. **Disaster Recovery Solutions:**

- If planning for disaster recovery, port 2379 must be open for all control nodes to synchronize ETCD data between the primary cluster and disaster recovery cluster.

3. **HTTP Support:**
Expand Down
1 change: 0 additions & 1 deletion fixture-docs/ru/development/component-quickstart/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,7 +139,6 @@ VERSION_CONFIGMAP_NAME ?= pipelines-info
- `RELEASE_YAML_PATH`: Адрес, по которому список конфигураций сохраняется локально.
- **Обязательно** хранить в каталоге `release`, хотя имя файла можно настроить.
- `VERSION_CONFIGMAP_NAME`: Название `configmap`, который записывает номер версии компонента в списке конфигураций.

- Например, имя файла конфигурации для компонента `tektoncd-pipeline` — это `pipelines-info`.

```yaml
Expand Down
9 changes: 0 additions & 9 deletions fixture-docs/ru/install/installing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -129,47 +129,38 @@ bash setup.sh --network-mode calico
В веб-интерфейсе настройте ключевые параметры для установки управляющего кластера в соответствии с подсказками, с деталями, приведенными ниже:

- **Версия Kubernetes**

- Все версии являются необязательными и были тщательно протестированы.
- Рекомендуется выбрать последнюю версию для оптимальных функций и поддержки.

- **Протокол сети кластера**

- Поддерживает IPv4 одноразовый стек, IPv6 одноразовый стек и IPv4/IPv6 двойной стек.
- Примечание: При выборе режима двойного стека все узлы должны быть правильно настроены с IPv6-адресами; параметры сетевого протокола нельзя изменить после конфигурации.

- **Адрес кластера**

- Введите подготовленный `глобальный VIP` для внешнего доступа к kube-apiserver.
- Если настроен LoadBalancer, пожалуйста, укажите его VIP-адрес и отключите "Самостоятельно создаваемый VIP"; в противном случае включите "Самостоятельно создаваемый VIP" и введите необходимый VIP, установщик автоматически развернет keepalived.

- **Адрес доступа к платформе**

- Введите подготовленный `Внешний IP` или доменное имя.
- Доступ по HTTPS включен по умолчанию; если нужен HTTP, включите его в расширенных настройках.
- Поддерживает несколько конфигураций адресов: вы можете ввести внутренние адреса и добавить внешние адреса в "Другие настройки > Другие адреса доступа к платформе".

- **Сертификат**

- По умолчанию используется самоподписанный сертификат для поддержки HTTPS.
- Чтобы настроить сертификат, пожалуйста, загрузите существующий сертификат.

- **Репозиторий образов**

- По умолчанию используется репозиторий образов, развернутый на платформе, который включает все образы компонентов.
- Если вам нужно использовать внешний репозиторий образов, пожалуйста, свяжитесь с технической поддержкой, чтобы получить план синхронизации образов для настройки.

- **Сетевая инфраструктура контейнера**

- Подсеть и диапазон сервисов для управляющего кластера не должны пересекаться.
- При использовании сетевого решения Kube-OVN Overlay убедитесь, что контейнерная сеть и сетевая сеть хоста находятся в разных подсетях, чтобы предотвратить сетевые аномалии.

- **Имя узла**

- Если вы выбрали "Использовать имя хоста в качестве имени узла", убедитесь, что все имена узлов уникальны.

- **Глобальная блокировка узлов платформы кластера**

- Включите это при планировании работы нагрузок на управляющем кластере.
- После включения узлы могут быть установлены в состояние "Эксклюзивная платформа", что означает, что они будут запускать только компоненты платформы; типы DaemonSet являются исключением.

Expand Down
2 changes: 0 additions & 2 deletions fixture-docs/ru/install/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,10 @@ sourceSHA: 65ab5f0e33c2067f1fc518d249bdec7ce35af1f684f66e3d4093d8421e0c89f7
Архитектура платформы и ключевые функции следующие:

- **Дизайн архитектуры**

- **Управляющий кластер**: Ответственный за core управление платформой, предоставляющий cluster, tenant управление и глобальное scheduling. После установки управляющего кластера можно добавлять или создавать бизнес-кластеры по мере необходимости.
- **Бизнес-кластер**: Специально разработан для обработки business нагрузок и поддерживает горизонтальное масштабирование. Бизнес-кластеры могут быть развернуты независимо или подключены через существующие кластеры, которые соответствуют требованиям по версиям.

- **Принципы дизайна**

1. **Изоляция развертывания управляющей плоскости**
При установке управляющего кластера должны использоваться выделенные физические ресурсы, которые не должны делиться с бизнес-кластерами, чтобы обеспечить стабильность и безопасность управляющей плоскости.
2. **Совместимость гибридного развертывания**
Expand Down
5 changes: 0 additions & 5 deletions fixture-docs/ru/install/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,6 @@ bash res/init.sh
Проверьте следующие требования по пунктам, чтобы убедиться, что локальная среда соответствует требованиям установки:

- **Конфигурация операционной системы и ядра:**

- [x] Конфигурация загрузки grub включает параметр `transparent_hugepage=never`.
- \[!] Системы CentOS 7.x должны добавить параметр `cgroup.memory=nokmem` в конфигурацию grub.
- [x] Когда версия ядра ниже 4.19.0 (или RHEL ниже 4.18.0), убедитесь, что модули `nf_conntrack_ipv4` и (для IPv6) `nf_conntrack_ipv6` включены.
Expand All @@ -139,13 +138,11 @@ bash res/init.sh
- [x] Отключите своп.

- **Настройки пользователя и разрешений:**

- [x] Пользователи SSH имеют привилегии `root` и могут использовать `sudo` без пароля.
- [x] Параметры `UseDNS` и `UsePAM` в `/etc/ssh/sshd_config` установлены в `no`.
- [x] `systemctl show --property=DefaultTasksMax` возвращает `infinity` или очень большое значение; если нет, отрегулируйте `/etc/systemd/system.conf`.

- **Сеть и имя хоста:**

- [x] Требования к имени хоста: не более 36 символов, начинающееся и заканчивающееся буквами или цифрами, содержащие только строчные буквы, цифры, `-` и `.` (не должно содержать `.-`, `..` или `-.`).
- [x] `localhost` в `/etc/hosts` должен разрешаться в `127.0.0.1`.
- [x] Файл `/etc/resolv.conf` существует и содержит конфигурацию `nameserver`, но не должен включать адреса, начинающиеся с 172 (отключите systemd-resolved).
Expand Down Expand Up @@ -352,12 +349,10 @@ done
**Другие требования к конфигурации:**

1. **Конфигурация LoadBalancer:**

- Пожалуйста, смотрите соответствующую документацию для конкретных методов настройки.
- Рекомендуется настраивать проверки состояния, чтобы контролировать состояние портов.

2. **Решения по восстановлению после сбоев:**

- Если планируется восстановление после сбоев, порт 2379 должен быть открыт для всех управляющих узлов для синхронизации данных ETCD между основным кластером и кластером восстановления после сбоев.

3. **Поддержка HTTP:**
Expand Down
9 changes: 0 additions & 9 deletions fixture-docs/zh/install/installing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -128,47 +128,38 @@ bash setup.sh --network-mode calico
在 Web UI 中按提示配置安装管理集群的关键参数,具体说明如下:

- **Kubernetes 版本**

- 所有可选版本均经过严格测试。
- 推荐选择最新版本以获得最佳功能和支持。

- **集群网络协议**

- 支持 IPv4 单栈、IPv6 单栈及 IPv4/IPv6 双栈。
- 注意:选择双栈模式时,所有节点必须正确配置 IPv6 地址;一旦配置,网络协议设置不可更改。

- **集群地址**

- 输入预先准备好的 `global VIP` 以供外部访问 kube-apiserver。
- 如果配置了 LoadBalancer,请填写其 VIP 地址并禁用“自建 VIP”;否则,启用“自建 VIP”并输入所需的 VIP,安装器将自动部署 keepalived。

- **平台访问地址**

- 输入预先准备好的 `External IP` 或域名。
- 默认情况下启用 HTTPS 访问;如需 HTTP,请在高级设置中启用。
- 支持多地址配置:可以填入内部地址,并在“其他设置 > 平台其他访问地址”中添加外部地址。

- **证书**

- 默认使用自签证书以支持 HTTPS。
- 如需自定义证书,请上传现有证书。

- **镜像仓库**

- 默认使用平台部署的镜像仓库,其中包含所有组件镜像。
- 若需使用外部镜像仓库,请联系技术支持以获取镜像同步方案并进行配置。

- **容器网络**

- 管理集群的默认子网和服务范围不得重叠。
- 使用 Kube-OVN Overlay 网络时,请确保容器网络与主机网络不在相同子网中,以免发生网络异常。

- **节点名称**

- 若选择“使用主机名作为节点名称”,请确保所有节点的主机名唯一。

- **global 集群平台节点隔离**

- 当计划在管理集群上运行业务负载时启用此选项。
- 启用后,节点可设置为“平台独占”,意味着它们将只运行平台组件;DaemonSet 类型除外。

Expand Down
2 changes: 0 additions & 2 deletions fixture-docs/zh/install/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,12 +12,10 @@ sourceSHA: 65ab5f0e33c2067f1fc518d249bdec7ce35af1f684f66e3d4093d8421e0c89f7
平台架构及关键特性如下:

- **架构设计**

- **管理集群**:负责平台核心管理,提供集群、租户管理和全局调度。安装管理集群后,后续可根据需要接入或新建业务集群。
- **业务集群**:专用于承载业务负载,支持横向扩展。业务集群可独立部署,也可通过接入符合版本要求的存量集群方式接入平台。

- **设计原则**

1. **控制面隔离部署**
安装管理集群时,必须使用专用物理资源,不得与业务集群共享,以确保控制平面的稳定性与安全性。
2. **混合部署兼容性**
Expand Down
5 changes: 0 additions & 5 deletions fixture-docs/zh/install/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,6 @@ bash res/init.sh
逐项检查以下要求,确保本机环境满足安装需求:

- **操作系统与内核配置:**

- [x] grub 启动配置包含 `transparent_hugepage=never` 参数。
- [!] CentOS 7.x 系统须在 grub 配置中添加 `cgroup.memory=nokmem` 参数。
- [x] 内核版本低于 4.19.0(或 RHEL 低于 4.18.0)时,确保 `nf_conntrack_ipv4` 与(IPv6 时)`nf_conntrack_ipv6` 模块启用。
Expand All @@ -132,13 +131,11 @@ bash res/init.sh
- [x] 禁用 swap。

- **用户与权限设置:**

- [x] SSH 用户具备 `root` 权限,并可无密码使用 `sudo`。
- [x] `/etc/ssh/sshd_config` 中 `UseDNS` 与 `UsePAM` 参数设置为 `no`。
- [x] `systemctl show --property=DefaultTasksMax` 返回 `infinity` 或极大数值;否则调整 `/etc/systemd/system.conf`。

- **网络与主机名:**

- [x] 主机名要求:不超过36字符,以字母或数字开头和结尾,仅含小写字母、数字、`-` 与 `.`(不得含 `.-`、`..` 或 `-.`)。
- [x] `/etc/hosts` 中 `localhost` 应解析为 `127.0.0.1`。
- [x] `/etc/resolv.conf` 文件存在且含 `nameserver` 配置,但不得含 172 开头地址(禁用 systemd-resolved)。
Expand Down Expand Up @@ -345,12 +342,10 @@ done
**其他配置要求:**

1. **LoadBalancer 设置:**

- 具体配置方法请参见相关文档。
- 建议配置健康检查以监控端口状态。

2. **容灾方案:**

- 若计划容灾,需为所有控制节点开放端口 2379,用于主集群与灾备集群间 ETCD 数据同步。

3. **HTTP 支持:**
Expand Down
Loading