From 819d830dbc7912512a2769bfbd9219062e6e8bc4 Mon Sep 17 00:00:00 2001 From: windsonsea Date: Mon, 8 Apr 2024 14:37:41 +0800 Subject: [PATCH] [en] update installer to 0.16.0 --- docs/en/docs/install/air-tag-download.md | 2 +- .../best-practices/etcd-host-deploy.md | 4 +- .../install/best-practices/offline-clipper.md | 57 +++++++++++++++++++ .../install/best-practices/thinder-restore.md | 40 +++++++++++++ docs/en/docs/install/commercial/prepare.md | 9 +-- .../docs/install/commercial/start-install.md | 41 +++++++++---- .../install/community/k8s/k8s-dce-deploy.md | 4 +- docs/en/docs/install/community/k8s/offline.md | 4 +- docs/en/docs/install/community/k8s/online.md | 4 +- docs/en/docs/install/install-tools.md | 13 +++-- .../install/k8s-install/ecs-install-dce5.0.md | 12 ++-- .../install/k8s-install/ocp-install-dce5.0.md | 8 +-- .../os-install/TencentOS-install-dce5.0.md | 10 ++-- .../os-install/oracleLinux-install-dce5.0.md | 14 ++--- .../os-install/uos-v20-install-dce5.0.md | 8 +-- docs/en/docs/install/release-notes.md | 20 +++++++ docs/en/docs/install/upgrade.md | 2 +- docs/en/navigation.yml | 2 + .../install/best-practices/offline-clipper.md | 43 +++++++------- .../docs/install/best-practices/thinder-ha.md | 4 +- docs/zh/docs/install/commercial/prepare.md | 2 +- .../docs/install/commercial/start-install.md | 12 ++-- docs/zh/docs/install/community/k8s/offline.md | 2 +- docs/zh/docs/install/install-tools.md | 3 +- .../install/k8s-install/ecs-install-dce5.0.md | 4 +- .../os-install/TencentOS-install-dce5.0.md | 2 +- .../os-install/uos-v20-install-dce5.0.md | 2 +- 27 files changed, 239 insertions(+), 89 deletions(-) create mode 100644 docs/en/docs/install/best-practices/offline-clipper.md create mode 100644 docs/en/docs/install/best-practices/thinder-restore.md diff --git a/docs/en/docs/install/air-tag-download.md b/docs/en/docs/install/air-tag-download.md index 04ad80680b..f39417e8f9 100644 --- a/docs/en/docs/install/air-tag-download.md +++ b/docs/en/docs/install/air-tag-download.md @@ -10,7 +10,7 @@ This page provides a script to easily download all the offline packages required ## Download Script ```bash -export VERSION=v0.15.0 +export VERSION=v0.16.0 curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/download_packages_${VERSION}.sh chmod +x download_packages_${VERSION}.sh ``` diff --git a/docs/en/docs/install/best-practices/etcd-host-deploy.md b/docs/en/docs/install/best-practices/etcd-host-deploy.md index 345b83534c..7307bebb5f 100644 --- a/docs/en/docs/install/best-practices/etcd-host-deploy.md +++ b/docs/en/docs/install/best-practices/etcd-host-deploy.md @@ -18,12 +18,12 @@ achieving an independent high-availability etcd. | CPU Architecture | Version | Download Link | | ---------------- | ------- | ------------- | | AMD64 | v0.13.0 | | - | ARM64 | v0.13.0 | | + | ARM64 | v0.13.0 | | After downloading, extract the offline package: ```bash - ## Taking the amd64 architecture offline package as an example + # Taking the amd64 architecture offline package as an example tar -xvf offline-v0.13.0-amd64.tar ``` diff --git a/docs/en/docs/install/best-practices/offline-clipper.md b/docs/en/docs/install/best-practices/offline-clipper.md new file mode 100644 index 0000000000..1b74edf571 --- /dev/null +++ b/docs/en/docs/install/best-practices/offline-clipper.md @@ -0,0 +1,57 @@ +--- +MTPE: windsonsea +Date: 2024-04-08 +--- + +# Offline Clipper Script User Manual + +The offline package contains offline resources for all products of DCE 5.0. However, in actual usage, +customers may not need to deploy all products. Therefore, the offline package clipper script +`offline/utils/offline-clipper.sh` in installer v0.16.0 provides the `offline-clipper.sh` script +to trim the offline package. This allows customers to decide which products' offline resources to use based on their actual needs. + +## Prerequisites + +- Clipper is only for GProduct. Before clipping, you need to understand which GProducts are included + and their corresponding product codes. Refer to the information in the `components` section of + the [product list file manifest.yaml](../commercial/manifest.md). + +- The `kubean`, `ghippo`, and `kpanda` components must exist, meaning these three components will be retained by default. + +## Operating Guide + +- If the input is an offline package tarball and the output is an offline package tarball, for example, to keep the `insight` component: + + ```shell + offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --out-tar-path ./offline.tar --enable-only insight + ``` + +- If the input is the `offline` directory extracted from the offline package and the output is the source directory of the extracted offline package, for example, to keep the `insight` component: + + ```shell + offline-clipper.sh --offline-path ./offline --enable-only insight + ``` + +- If the input is an offline package tarball and the output is the extracted offline package directory, for example, to trim only the `insight` component: + + ```shell + offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --disable-only insight + ``` + +- If the input is the offline package directory and the output is an offline package tarball, for example, to keep the `insight` and `skoala` components: + + ```shell + offline-clipper.sh --offline-path ./offline --out-tar-path ./offline.tar --enable-only insight,skoala + ``` + +- View the names of trimmable components: + + ```shell + offline-clipper.sh --offline-path ./offline -l + ``` + +- View the help document: + + ```shell + offline-clipper.sh -h + ``` diff --git a/docs/en/docs/install/best-practices/thinder-restore.md b/docs/en/docs/install/best-practices/thinder-restore.md new file mode 100644 index 0000000000..8370b6848e --- /dev/null +++ b/docs/en/docs/install/best-practices/thinder-restore.md @@ -0,0 +1,40 @@ +# Backup and Restore of Bootstrap Node + +This article describes the backup and restore of the kind cluster in the bootstrap node. + +## Backup Overview + +Installer v0.16.0 supports backup and restore of the kind cluster in the bootstrap node. Currently, the following information is backed up: + +1. Two important files: [clusterConfig.yaml](../commercial/cluster-config.md), + [manifest.yaml](../commercial/manifest.md) + + The information in clusterConfig.yaml and manifest.yaml is stored in the configmap of the kind cluster. + + ```shell + root@my-cluster-installer-control-plane:/# kubectl get -n default cm + NAME DATA AGE + clusterconfig-1710711049 1 4h46m + kube-root-ca.crt 1 4h46m + manifest-1710711049 1 4h46m + ``` + +2. All data of the kind cluster + + The data of the kind cluster is mounted on the host machine at `/home/kind`, + and the data of etcd is mounted at `/home/kind/etcd`. Do not delete any files + in this directory. + + !!! note + + The mount directory can be defined in clusterconfig.yaml with + `spec.tinderKind.resourcesMountPath`, and the default is `/home/kind`. + +## Restore + +Since the above backup is enabled by default for users, in case the kind cluster +is accidentally deleted or lost, you can run the installer command: + +```shell +./offline/dce5-installer cluster-create -c ./offline/sample/clusterConfig.yaml -m ./offline/manifest.yaml -j1,2 +``` diff --git a/docs/en/docs/install/commercial/prepare.md b/docs/en/docs/install/commercial/prepare.md index 5876505810..1f1e76f630 100644 --- a/docs/en/docs/install/commercial/prepare.md +++ b/docs/en/docs/install/commercial/prepare.md @@ -4,8 +4,8 @@ This page explains the preparations required for deploying DCE 5.0. !!! note - Currently, the installer script only performs pre-deployment checks on the bootstrap machine, - including whether the prerequisites have been installed and whether the CPU of the bootstrap machine + Currently, the installer script only performs pre-deployment checks on the bootstrap node, + including whether the prerequisites have been installed and whether the CPU of the bootstrap node is greater than 10 cores, the memory is greater than 12GB, and the disk space is greater than 100GB. ## Machine Checks @@ -19,8 +19,9 @@ This page explains the preparations required for deploying DCE 5.0. | Time Sync | All cluster nodes must have synchronized time | This is a requirement from Docker and Kubernetes. Otherwise, the kube.conf will report an error `Unable to connect to the server: x509: certificate has expired or is not yet` | | Timezone | All servers must have the same timezone | It is recommended to set it to Asia/Shanghai.
Refer to the command: timedatectl set-timezone Asia/Shanghai | | Nameserver | /etc/resolv.conf must have at least one nameserver | Required by CoreDNS, otherwise there will be errors. In a pure offline environment, this nameserver can be a non-existent IP address. The default CentOS 8 minimal does not have the /etc/resolv file, so you need to create it manually. | +| Protocol | IPv6 Support | IPv6 must be enabled for bootstrap nodes using Podman | -## Dependency Component Checks on the bootstrap machine +## Dependency Component Checks on the Bootstrap Node | **Check Item** | **Version Requirement** | **Description** | | -------------- | ---------------------- | --------------- | @@ -35,7 +36,7 @@ This page explains the preparations required for deploying DCE 5.0. If the dependency components do not exist, install the dependency components using the script [Installing Prerequisites](../install-tools.md). ```bash -export VERSION=v0.13.0 +export VERSION=v0.16.0 # Download the script curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/install_prerequisite_${VERSION}.sh diff --git a/docs/en/docs/install/commercial/start-install.md b/docs/en/docs/install/commercial/start-install.md index b643db7b4a..f571d1e546 100644 --- a/docs/en/docs/install/commercial/start-install.md +++ b/docs/en/docs/install/commercial/start-install.md @@ -21,14 +21,14 @@ You can download the latest version from the [Download Center](../../download/in | CPU Architecture | Version | Download | | :--------------- | :------ | :------- | -| AMD64 | v0.15.0 | [offline-v0.15.0-amd64.tar](https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.15.0-amd64.tar) | -| ARM64 | v0.15.0 | [offline-v0.15.0-arm64.tar](https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.15.0-arm64.tar) | +| AMD64 | v0.16.0 | [offline-v0.16.0-amd64.tar](https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.16.0-amd64.tar) | +| ARM64 | v0.16.0 | [offline-v0.16.0-arm64.tar](https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.16.0-arm64.tar) | After downloading, extract the offline package. Take the amd64 architecture offline package as an example ```bash -tar -xvf offline-v0.15.0-amd64.tar +tar -xvf offline-v0.16.0-amd64.tar ``` #### ISO Operating System Image File (Required) @@ -42,12 +42,18 @@ The ISO operating system image file needs to be configured in | CPU Architecture | Operating System Version | Download | | :--------------- | :---------------------- | :-------- | | AMD64 | CentOS 7 | [CentOS-7-x86_64-DVD-2009.iso](https://mirrors.tuna.tsinghua.edu.cn/centos/7.9.2009/isos/x86_64/CentOS-7-x86_64-DVD-2009.iso ) | -| | Redhat 7, 8, 9 | [assembly-field-downloads-page-content-61451](https://developers.redhat.com/products/rhel/download#assembly-field-downloads-page-content-61451)
Note: Redhat operating system requires a Redhat account to download | -| | Ubuntu 20.04 | [ubuntu-20.04.6-live-server-amd64.iso](https://releases.ubuntu.com/focal/ubuntu-20.04.6-live-server-amd64.iso) | -| | UOS V20 (1020a) | [uniontechos-server-20-1020a-amd64.iso](https://cdimage-download.chinauos.com/uniontechos-server-20-1020a-amd64.iso) | -| | openEuler 22.03 | [openEuler-22.03-LTS-SP1-x86_64-dvd.iso](https://mirrors.nju.edu.cn/openeuler/openEuler-22.03-LTS-SP1/ISO/x86_64/openEuler-22.03-LTS-SP1-x86_64-dvd.iso) | -| | OracleLinux R9 U1 | [OracleLinux-R9-U1-x86_64-dvd.iso](https://yum.oracle.com/ISOS/OracleLinux/OL9/u1/x86_64/OracleLinux-R9-U1-x86_64-dvd.iso) | -| ARM64 | Kylin Linux Advanced Server release V10 (Sword) SP2 | [Application Address](https://www.kylinos.cn/scheme/server/1.html)
Note: Kylin operating system requires providing personal information to download and use. Please select V10 (Sword) SP2 when downloading | +| | Redhat 7, 8, 9 | [assembly-field-downloads-page-content-61451](https://developers.redhat.com/products/rhel/download#assembly-field-downloads-page-content-61451)
Note: Redhat operating system requires a Redhat account to download | +| | Ubuntu 20.04 | [ubuntu-20.04.6-live-server-amd64.iso](https://releases.ubuntu.com/focal/ubuntu-20.04.6-live-server-amd64.iso) | +| | UOS V20 (1020a) | [uniontechos-server-20-1020a-amd64.iso](https://cdimage-download.chinauos.com/uniontechos-server-20-1020a-amd64.iso) | +| | openEuler 22.03 | [openEuler-22.03-LTS-SP1-x86_64-dvd.iso](https://mirrors.nju.edu.cn/openeuler/openEuler-22.03-LTS-SP1/ISO/x86_64/openEuler-22.03-LTS-SP1-x86_64-dvd.iso) | +| | OracleLinux R9 U1 | [OracleLinux-R9-U1-x86_64-dvd.iso](https://yum.oracle.com/ISOS/OracleLinux/OL9/u1/x86_64/OracleLinux-R9-U1-x86_64-dvd.iso) | +| | Rocky Linux 9.2 | [Rocky-9.2-x86_64-dvd.iso](https://dl.rockylinux.org/vault/rocky/9.2/isos/x86_64/Rocky-9.2-x86_64-dvd.iso) | +| ARM64 | Kylin Linux Advanced Server release V10 (Sword) SP2 | [Request Address](https://www.kylinos.cn/scheme/server/1.html) | + +!!! note + + Kylin operating system requires providing personal information to download and use. + Please select V10 (Sword) SP2 when downloading. #### osPackage Offline Packages (Required) @@ -64,6 +70,19 @@ operating systems, which can be found at ARM64 | v0.15.0 | [addon-offline-full-package-v0.15.0-arm64.tar.gz](https://qiniu-download-public.daocloud.io/DaoCloud_DigitalX_Addon/addon-offline-full-package-v0.15.0-arm64.tar.gz) | #### One-Click Download of Required Offline Packages diff --git a/docs/en/docs/install/community/k8s/k8s-dce-deploy.md b/docs/en/docs/install/community/k8s/k8s-dce-deploy.md index b7ebd05e54..113b564e53 100644 --- a/docs/en/docs/install/community/k8s/k8s-dce-deploy.md +++ b/docs/en/docs/install/community/k8s/k8s-dce-deploy.md @@ -22,7 +22,7 @@ The components used in this example are: - CRI: containerd (as Docker is no longer directly supported in newer versions of Kubernetes) - CNI: Calico - StorageClass: local-path -- DCE 5.0 Community: v0.15.0 +- DCE 5.0 Community: v0.16.0 ## Prepare Nodes @@ -316,7 +316,7 @@ bash install_prerequisite.sh online community ### Download dce5-installer ```bash -export VERSION=v0.15.0 +export VERSION=v0.16.0 curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION chmod +x ./dce5-installer ``` diff --git a/docs/en/docs/install/community/k8s/offline.md b/docs/en/docs/install/community/k8s/offline.md index 07263219bc..3c5b421ee8 100644 --- a/docs/en/docs/install/community/k8s/offline.md +++ b/docs/en/docs/install/community/k8s/offline.md @@ -25,10 +25,10 @@ Click [Online Install DCE Community](../../../videos/install.md) to watch a vide 1. Download and decompress the offline package of DCE Community on the controller node of your kubernetes cluster, or download and decompress the offline package from [Download Center](../../../download/index.md). - Take VERSION=0.15.0 as an example. + Take VERSION=v0.16.0 as an example. ```bash - export VERSION=v0.15.0 + export VERSION=v0.16.0 wget https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-community-$VERSION-amd64.tar tar -xvf offline-community-$VERSION-amd64.tar ``` diff --git a/docs/en/docs/install/community/k8s/online.md b/docs/en/docs/install/community/k8s/online.md index 3b0867972f..71e3c72999 100644 --- a/docs/en/docs/install/community/k8s/online.md +++ b/docs/en/docs/install/community/k8s/online.md @@ -29,10 +29,10 @@ This page will guide you to install DCE Community package online in a standard K 1. Download the `dce5-installer` binary file on the controller node of the Kubernetes cluster (you can also [download it via browser](../../../download/index.md)). - Take VERSION=v0.15.0 as an example. + Take VERSION=v0.16.0 as an example. ```shell - export VERSION=v0.15.0 + export VERSION=v0.16.0 ## For ARM CPU, change `dce5-installer-$VERSION` to `dce5-installer-$VERSION-linux-arm64` diff --git a/docs/en/docs/install/install-tools.md b/docs/en/docs/install/install-tools.md index b3fee83b8b..3f9ef8398b 100644 --- a/docs/en/docs/install/install-tools.md +++ b/docs/en/docs/install/install-tools.md @@ -23,7 +23,8 @@ Before installing DCE 5.0, you need to install some dependencies. - minio client - charts-syncer - If there are any existing tools in your environment with versions lower than what we define, they will be forcefully updated and replaced during the installation process. + If there are any existing tools in your environment with versions lower than what we define, + they will be forcefully updated and replaced during the installation process. ## Online Install Dependencies @@ -61,20 +62,21 @@ Offline installation means that the target host is in an offline state and canno 1. Download the script. ```bash - export VERSION=v0.13.0 + export VERSION=v0.16.0 curl -LO https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/install_prerequisite_${VERSION}.sh ``` 2. Download the offline package for prerequisites. ```bash - export VERSION=v0.13.0 + export VERSION=v0.16.0 curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/prerequisite_${VERSION}_amd64.tar.gz ``` !!! note - - For arm architecture, the download link is: + - For arm architecture, use the download link for arm: + - Make sure the offline package and the script are in the same directory level. 3. Perform the offline installation. @@ -95,4 +97,5 @@ Offline installation means that the target host is in an offline state and canno ./install_prerequisite_${VERSION}.sh offline full ``` -You can now proceed to install DCE 5.0 [Community](community/resources.md) or [Enterprise](commercial/deploy-requirements.md). +You can now proceed to install DCE 5.0 [Community](community/resources.md) or +[Enterprise](commercial/deploy-requirements.md). diff --git a/docs/en/docs/install/k8s-install/ecs-install-dce5.0.md b/docs/en/docs/install/k8s-install/ecs-install-dce5.0.md index 4a0cdbd1cf..97c2c5b52f 100644 --- a/docs/en/docs/install/k8s-install/ecs-install-dce5.0.md +++ b/docs/en/docs/install/k8s-install/ecs-install-dce5.0.md @@ -19,10 +19,10 @@ When deploying DCE 5.0 on Alibaba Cloud ECS, special handling is required for lo 1. Log in to a machine and download the dce5-installer binary file. - Assuming VERSION is v0.13.0: + Assuming VERSION is v0.16.0: ```shell - export VERSION=v0.13.0 + export VERSION=v0.16.0 curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION chmod +x ./dce5-installer ``` @@ -81,10 +81,10 @@ When deploying DCE 5.0 on Alibaba Cloud ECS, special handling is required for lo 1. Log in to a machine and download the dce5-installer binary file. - Assuming VERSION is v0.13.0: + Assuming VERSION is v0.16.0: ```shell - export VERSION=v0.13.0 + export VERSION=v0.16.0 curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION chmod +x ./dce5-installer ``` @@ -156,10 +156,10 @@ When deploying DCE 5.0 on Alibaba Cloud ECS, special handling is required for lo 1. Log in to a machine and download the dce5-installer binary file. - Assuming VERSION is v0.13.0: + Assuming VERSION is v0.16.0: ```shell - export VERSION=v0.13.0 + export VERSION=v0.16.0 curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION chmod +x ./dce5-installer ``` diff --git a/docs/en/docs/install/k8s-install/ocp-install-dce5.0.md b/docs/en/docs/install/k8s-install/ocp-install-dce5.0.md index 8d95f05420..6f32d1076b 100644 --- a/docs/en/docs/install/k8s-install/ocp-install-dce5.0.md +++ b/docs/en/docs/install/k8s-install/ocp-install-dce5.0.md @@ -17,14 +17,14 @@ This page describes how to install DCE 5.0 on OCP. | CPU Architecture | Version | Download URL | | -------- | ------ | ------------------------------ -------------------------------------------------- -------------- | - | AMD64 | v0.12.0 | | - | ARM64 | v0.12.0 | | + | AMD64 | v0.16.0 | | + | ARM64 | v0.16.0 | | Unzip the offline package after downloading: ```bash - ## Take the amd64 architecture offline package as an example - tar -xvf offline-v0.12.0-amd64.tar + # Take the amd64 architecture offline package as an example + tar -xvf offline-v0.16.0-amd64.tar ``` 3. Set [clusterConfig.yaml](../commercial/cluster-config.md), which can be obtained under the offline package `offline/sample` and modified as needed. diff --git a/docs/en/docs/install/os-install/TencentOS-install-dce5.0.md b/docs/en/docs/install/os-install/TencentOS-install-dce5.0.md index e60e47947b..24624ffdba 100644 --- a/docs/en/docs/install/os-install/TencentOS-install-dce5.0.md +++ b/docs/en/docs/install/os-install/TencentOS-install-dce5.0.md @@ -14,15 +14,15 @@ Installer v0.9.0 and higher versions support this deployment method. 1. Download the full mode offline package. You can download the latest version from the [Download Center](../../download/index.md). - | CPU Architecture | Version | Download Link | - | ---------------- | ------- | --------------------------------------------------------------------------------------------- | - | AMD64 | v0.9.0 | | + | CPU Architecture | Version | Download Link | + | ---------------- | ------- | -------------- | + | AMD64 | v0.16.0 | | After downloading, extract the offline package: ```bash - curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.9.0-amd64.tar - tar -xvf offline-v0.9.0-amd64.tar + curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.16.0-amd64.tar + tar -xvf offline-v0.16.0-amd64.tar ``` 2. Download the TencentOS Server 3.1 image file. diff --git a/docs/en/docs/install/os-install/oracleLinux-install-dce5.0.md b/docs/en/docs/install/os-install/oracleLinux-install-dce5.0.md index 104d3acb62..6304d82e60 100644 --- a/docs/en/docs/install/os-install/oracleLinux-install-dce5.0.md +++ b/docs/en/docs/install/os-install/oracleLinux-install-dce5.0.md @@ -17,15 +17,15 @@ Installer v0.8.0 and higher versions support this deployment method. 1. Download the full mode offline package. You can download the latest version from the [Download Center](../../download/index.md). - | CPU Architecture | Version | Download Link | - | ---------------- | ------- | ---------------------------------------------------------------------------------------------- | - | AMD64 | v0.10.0 | | + | CPU Architecture | Version | Download Link | + | ---------------- | ------- | ------------- | + | AMD64 | v0.16.0 | | After downloading, extract the offline package: ```bash - curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.10.0-amd64.tar - tar -xvf offline-v0.10.0-amd64.tar + curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.16.0-amd64.tar + tar -xvf offline-v0.16.0-amd64.tar ``` 2. Download the Oracle Linux R9/R8 U1 image file. @@ -42,10 +42,10 @@ Installer v0.8.0 and higher versions support this deployment method. ```bash # Oracle Linux R9 U1 - curl -LO https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.7.4/os-pkgs-oracle9-v0.7.4.tar.gz + curl -LO https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-oracle9-v0.13.9.tar.gz # Oracle Linux R8 U1 - curl -LO https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.7.4/os-pkgs-oracle8-v0.7.4.tar.gz + curl -LO https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-oracle8-v0.13.9.tar.gz ``` 4. Download the addon offline package. You can download the latest version from diff --git a/docs/en/docs/install/os-install/uos-v20-install-dce5.0.md b/docs/en/docs/install/os-install/uos-v20-install-dce5.0.md index 035a6efe4d..2949b5aa21 100644 --- a/docs/en/docs/install/os-install/uos-v20-install-dce5.0.md +++ b/docs/en/docs/install/os-install/uos-v20-install-dce5.0.md @@ -25,14 +25,14 @@ Installer v0.6.0 and higher versions support this deployment method. 2. Download the full mode offline package, you can download the latest version in [Download Center](../../download/index.md). | CPU Architecture | Version | Download URL | - | -------- | ------ | ------------------------------ -------------------------------------------------- -------------- | - | AMD64 | v0.6.1 | | + | -------- | ------ | --------------------- | + | AMD64 | v0.16.0 | | Unzip the offline package after downloading: ```bash - curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.6.1-amd64.tar - tar -xvf offline-v0.6.1-amd64.tar + curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.16.0-amd64.tar + tar -xvf offline-v0.16.0-amd64.tar ``` 3. Download the UnionTech Server V20 1020a ISO image. diff --git a/docs/en/docs/install/release-notes.md b/docs/en/docs/install/release-notes.md index 35ce88d267..0f21ce70ac 100644 --- a/docs/en/docs/install/release-notes.md +++ b/docs/en/docs/install/release-notes.md @@ -15,6 +15,26 @@ the evolution path and feature changes of each version. *[Kpanda]: Dev codename for Container Management in DCE 5.0 *[Skoala]: Dev codename for Microservice Engine in DCE 5.0 +## 2024-03-31 + +### v0.16.0 + +#### Improvements + +- **Improved** Support for deploying on Rocky Linux 9.2 x86 with containerd +- **Improved** Optimized maximum number of user instances for Rocky Linux +- **Improved** Simplified extension usage of custom actions on the installer side +- **Improved** Added manual trimming tool script for offline package +- **Improved** persistence and reloadability of Firestarter data +- **Improved** Allow skipping Docker runtime installation when deploying clusters +- **Improved** Allow specifying configuration for Firestarter apiserver port + +#### Bug Fixes + +- **Fixed** issue where OCI_PATH was not effective when importing heterogeneous images +- **Fixed** manifest disorder issue with kubean custom actions +- **Fixed** issue where the timezone of the Firestarter cluster was inconsistent with the host machine + ## 2024-03-01 ### v0.15.2 diff --git a/docs/en/docs/install/upgrade.md b/docs/en/docs/install/upgrade.md index 81cd479f89..19588d69a6 100644 --- a/docs/en/docs/install/upgrade.md +++ b/docs/en/docs/install/upgrade.md @@ -26,7 +26,7 @@ You can download the latest version from the [Download Center](../download/index | CPU Architecture | Version | Download Link | | :--------------- | :------ | :----------------------------------------------------------- | | AMD64 | v0.9.0 | [Download Link](https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.9.0-amd64.tar) | -| ARM64 | v0.9.0 | [Download Link](https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.9.0-arm64.tar) | +| ARM64 | v0.9.0 | [Download Link](https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.9.0-arm64.tar) | After downloading, extract the offline package. For example, for the AMD64 architecture: diff --git a/docs/en/navigation.yml b/docs/en/navigation.yml index 854e4e59d3..5830a0127e 100644 --- a/docs/en/navigation.yml +++ b/docs/en/navigation.yml @@ -62,10 +62,12 @@ nav: - Import Offline Resources: install/import.md - Troubleshoot: install/faq.md - Best Practices: + - Offline Clipper Script User Manual: install/best-practices/offline-clipper.md - Use Cases: install/commercial/scenarios.md - Deploy on DCE 5.0 Appliance: install/best-practices/all-in-one-machine.md - etcd Deployed in Host Mode and Separated from Control Plane: install/best-practices/etcd-host-deploy.md - HA Bootstrap Nodes: install/best-practices/thinder-ha.md + - Backup and Restore of Bootstrap Node: install/best-practices/thinder-restore.md - Fix CVE-2024-21626: install/best-practices/cve-20240-21626.md - Installer Release Notes: install/release-notes.md - Workbench: diff --git a/docs/zh/docs/install/best-practices/offline-clipper.md b/docs/zh/docs/install/best-practices/offline-clipper.md index 13c2d19f85..c2e6db12b3 100644 --- a/docs/zh/docs/install/best-practices/offline-clipper.md +++ b/docs/zh/docs/install/best-practices/offline-clipper.md @@ -1,10 +1,13 @@ # 安装器离线包裁剪脚本使用手册 -离线包包含了 DCE5.0 所有产品的离线资源，由于在实际使用过程中，客户并不需要部署所有产品，所以在安装器 v0.16.0 的离线包 `offline/utils/offline-clipper.sh` 提供了 `offline-clipper.sh` 脚本，用以裁剪离线包，以便客户根据实际情况来决定使用哪些产品的离线资源。 +离线包包含了 DCE 5.0 所有产品的离线资源。由于在实际使用过程中，客户并不需要部署所有产品， +所以在安装器 v0.16.0 的离线包 `offline/utils/offline-clipper.sh` 提供了 `offline-clipper.sh` 脚本， +用以裁剪离线包，以便客户根据实际情况来决定使用哪些产品的离线资源。 ## 前提条件 -- 裁剪仅针对 GProdcut，在进行裁剪之前，需要先了解包含的 GProdcut 有哪些，以及对应的产品代码，参考[产品清单文件 manifest.yaml](../commercial/manifest.md) 中 `components` 内的信息。 +- 裁剪仅针对 GProdcut，在进行裁剪之前，需要先了解包含的 GProdcut 有哪些，以及对应的产品代码， + 参考[产品清单文件 manifest.yaml](../commercial/manifest.md) 中 `components` 内的信息。 - `kubean`、`ghippo`、`kpanda` 三个组件必须存在，即默认情况会保留这三个组件 @@ -12,36 +15,36 @@ - 若输入为离线包 tarball，输出为离线包 tarball，以保留 `insight` 组件为例： -```shell -offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --out-tar-path ./offline.tar --enable-only insight -``` + ```shell + offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --out-tar-path ./offline.tar --enable-only insight + ``` - 若输入为离线包解压后的 `offline` 目录，输出为源离线包解压目录，以保留 `insight` 组件为例： -```shell -offline-clipper.sh --offline-path ./offline --enable-only insight -``` + ```shell + offline-clipper.sh --offline-path ./offline --enable-only insight + ``` - 若输入为离线包 tarball，输出为离线包解压目录，以仅裁剪 `insight` 组件为例： -```shell -offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --disable-only insight -``` + ```shell + offline-clipper.sh --in-tar-path ./offline-v0.15.0-amd64.tar --disable-only insight + ``` - 若输入为离线包解压目录，输出为离线包 tarball，以保留 `insight` 和 `skoala` 组件为例： -```shell -offline-clipper.sh --offline-path ./offline --out-tar-path ./offline.tar --enable-only insight,skoala -``` + ```shell + offline-clipper.sh --offline-path ./offline --out-tar-path ./offline.tar --enable-only insight,skoala + ``` - 查看可裁剪组件名称 -```shell -offline-clipper.sh --offline-path ./offline -l -``` + ```shell + offline-clipper.sh --offline-path ./offline -l + ``` - 查看帮助文档 -```shell -offline-clipper.sh -h -``` + ```shell + offline-clipper.sh -h + ``` diff --git a/docs/zh/docs/install/best-practices/thinder-ha.md b/docs/zh/docs/install/best-practices/thinder-ha.md index e32e9c823d..c080a04d1c 100644 --- a/docs/zh/docs/install/best-practices/thinder-ha.md +++ b/docs/zh/docs/install/best-practices/thinder-ha.md @@ -117,7 +117,7 @@ creationTimestamp: null spec: clusterName: my-cluster - bootstrapNode: www.tinder-node-server.com ## 基于外部域名模式 + bootstrapNode: www.tinder-node-server.com # 基于外部域名模式 masterNodes: - nodeName: "g-master1" @@ -133,7 +133,7 @@ imagesAndCharts: type: builtin - additionalSSLSubjectAltName: "xxx.xx.xx.193" ## dns 服务所解析的域名 + additionalSSLSubjectAltName: "xxx.xx.xx.193" # dns 服务所解析的域名 addonPackage: binaries: diff --git a/docs/zh/docs/install/commercial/prepare.md b/docs/zh/docs/install/commercial/prepare.md index ff05b8dfaf..80f411d1df 100644 --- a/docs/zh/docs/install/commercial/prepare.md +++ b/docs/zh/docs/install/commercial/prepare.md @@ -34,7 +34,7 @@ 如果不存在依赖组件，通过脚本进行安装依赖组件，[安装前置依赖](../install-tools.md)。 ```bash -export VERSION=v0.13.0 +export VERSION=v0.16.0 # 下载脚本 curl -LO https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/install_prerequisite_${VERSION}.sh diff --git a/docs/zh/docs/install/commercial/start-install.md b/docs/zh/docs/install/commercial/start-install.md index 1feacbd957..9553462aad 100644 --- a/docs/zh/docs/install/commercial/start-install.md +++ b/docs/zh/docs/install/commercial/start-install.md @@ -41,7 +41,11 @@ ISO 操作系统镜像文件需要在[集群配置文件 clusterConfig.yaml](./c | | openEuler 22.03 | [openEuler-22.03-LTS-SP1-x86_64-dvd.iso](https://mirrors.nju.edu.cn/openeuler/openEuler-22.03-LTS-SP1/ISO/x86_64/openEuler-22.03-LTS-SP1-x86_64-dvd.iso) | | | Oracle Linux R9 U1 | [OracleLinux-R9-U1-x86_64-dvd.iso](https://yum.oracle.com/ISOS/OracleLinux/OL9/u1/x86_64/OracleLinux-R9-U1-x86_64-dvd.iso) | | | Rocky Linux 9.2 | [Rocky-9.2-x86_64-dvd.iso](https://dl.rockylinux.org/vault/rocky/9.2/isos/x86_64/Rocky-9.2-x86_64-dvd.iso) | -| ARM64 | Kylin Linux Advanced Server release V10 (Sword) SP2 | [查看申请地址](https://www.kylinos.cn/scheme/server/1.html)
注意：麒麟操作系统需要提供个人信息才能下载使用，下载时请选择 V10 (Sword) SP2 | +| ARM64 | Kylin Linux Advanced Server release V10 (Sword) SP2 | [查看申请地址](https://www.kylinos.cn/scheme/server/1.html) | + +!!! note + + 麒麟操作系统需要提供个人信息才能下载使用，下载时请选择 V10 (Sword) SP2。 #### osPackage 离线包（必需） @@ -161,11 +165,11 @@ osPackage 离线包是 [Kubean](https://github.com/kubean-io/kubean)这个开源 统信 UOS V20（1020a）osPackage 部署请参考 [UOS V20 (1020a) 操作系统上部署 DCE 5.0](../os-install/uos-v20-install-dce5.0.md)。 -#### addon 离线包 （可选） +#### Addon 离线包 （可选） -addon 离线包包含一些常用组件的 Helm Chart 离线包，具体清单请参考[addon](../../download/addon/history.md)。 +Addon 离线包包含一些常用组件的 Helm Chart 离线包，具体清单请参考 [Addon](../../download/addon/history.md)。 -安装器从 v0.5.0 版本，支持了 addon 的离线包导入能力，如果需要支持 addon 中所有的 helm chart 离线化。 +安装器从 v0.5.0 版本，支持了 Addon 的离线包导入能力，如果需要支持 Addon 中所有的 Helm Chart 离线化。 可以在[下载中心](../../download/index.md)下载最新版本。 首先需要事先下载好离线包，并在[集群配置文件 clusterConfig.yaml](./cluster-config.md)中定义 `addonOfflinePackagePath`。 diff --git a/docs/zh/docs/install/community/k8s/offline.md b/docs/zh/docs/install/community/k8s/offline.md index 6402374440..e5a20380da 100644 --- a/docs/zh/docs/install/community/k8s/offline.md +++ b/docs/zh/docs/install/community/k8s/offline.md @@ -26,7 +26,7 @@ 1. 在 k8s 集群控制平面节点（Controller Node）下载社区版的对应离线包并解压， 或者从[下载中心](../../../download/index.md)下载离线包并解压。 - 假定版本 VERSION=0.16.0 + 假定版本 VERSION=v0.16.0 ```bash export VERSION=v0.16.0 diff --git a/docs/zh/docs/install/install-tools.md b/docs/zh/docs/install/install-tools.md index 31bcfbe065..b69ca6d663 100644 --- a/docs/zh/docs/install/install-tools.md +++ b/docs/zh/docs/install/install-tools.md @@ -69,7 +69,8 @@ !!! note - - 如果是 arm 架构，下载地址为：https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/prerequisite_${VERSION}_arm64.tar.gz + - 如果是 arm 架构，请使用下载地址： + - 确保离线包与脚本在同一个目录层级 3. 执行离线安装。 diff --git a/docs/zh/docs/install/k8s-install/ecs-install-dce5.0.md b/docs/zh/docs/install/k8s-install/ecs-install-dce5.0.md index 97dee39dcc..cccf7e2bca 100644 --- a/docs/zh/docs/install/k8s-install/ecs-install-dce5.0.md +++ b/docs/zh/docs/install/k8s-install/ecs-install-dce5.0.md @@ -165,10 +165,10 @@ 1. 登录一台机器，下载 dce5-installer 二进制文件。 - 假定 VERSION 为 v0.11.0 + 假定 VERSION 为 v0.16.0 ```shell - export VERSION=v0.11.0 + export VERSION=v0.16.0 curl -Lo ./dce5-installer https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/dce5-installer-$VERSION chmod +x ./dce5-installer ``` diff --git a/docs/zh/docs/install/os-install/TencentOS-install-dce5.0.md b/docs/zh/docs/install/os-install/TencentOS-install-dce5.0.md index bf7f2e3601..7cdb3fbf1b 100644 --- a/docs/zh/docs/install/os-install/TencentOS-install-dce5.0.md +++ b/docs/zh/docs/install/os-install/TencentOS-install-dce5.0.md @@ -1,7 +1,7 @@ # 在 TencentOS Server 3.1 上部署 DCE 5.0 商业版 本文将介绍如何在 TencentOS Server 3.1 上部署 DCE 5.0。 -安装器 v0.16.0 及更高版本支持这种部署方式。 +安装器 v0.9.0 及更高版本支持这种部署方式。 ## 前提条件 diff --git a/docs/zh/docs/install/os-install/uos-v20-install-dce5.0.md b/docs/zh/docs/install/os-install/uos-v20-install-dce5.0.md index 5199fd375c..d0c3317653 100644 --- a/docs/zh/docs/install/os-install/uos-v20-install-dce5.0.md +++ b/docs/zh/docs/install/os-install/uos-v20-install-dce5.0.md @@ -23,7 +23,7 @@ 2. 下载全模式离线包，可以在[下载中心](../../download/index.md)下载最新版本。 - | CPU 架构 | 版本 | 下载地址 | + | CPU 架构 | 版本 | 下载地址 | | -------- | ----- | -------- | | AMD64 | v0.16.0 | |