Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[en] update installer to 0.16.0 #4173

Merged
merged 1 commit into from
Apr 8, 2024
Merged

[en] update installer to 0.16.0 #4173

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
2 changes: 1 addition & 1 deletion docs/en/docs/install/air-tag-download.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down
4 changes: 2 additions & 2 deletions docs/en/docs/install/best-practices/etcd-host-deploy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,12 @@ achieving an independent high-availability etcd.
| CPU Architecture | Version | Download Link |
| ---------------- | ------- | ------------- |
| AMD64 | v0.13.0 | <https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.13.0-amd64.tar> |
| ARM64 | v0.13.0 | <https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.13.0-arm64.tar> |
| <font color="green">ARM64</font> | v0.13.0 | <https://proxy-qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/offline-v0.13.0-arm64.tar> |

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
```

Expand Down
57 changes: 57 additions & 0 deletions docs/en/docs/install/best-practices/offline-clipper.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
```
40 changes: 40 additions & 0 deletions docs/en/docs/install/best-practices/thinder-restore.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
```
9 changes: 5 additions & 4 deletions docs/en/docs/install/commercial/prepare.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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.<br />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** |
| -------------- | ---------------------- | --------------- |
Expand All @@ -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

Expand Down
41 changes: 30 additions & 11 deletions docs/en/docs/install/commercial/start-install.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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) |
| <font color="green">ARM64</font> | 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)
Expand All @@ -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) <br />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) <br />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) <br />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) |
| <font color="green">ARM64</font> | 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)

Expand All @@ -64,6 +70,19 @@ operating systems, which can be found at <https://github.com/kubean-io/kubean/re
Currently, the installer version requires the osPackage offline package version to match.
Please download the osPackage offline package based on the corresponding version:

=== "V0.16.0"

| Operating System | Download |
| CentOS 7 | [os-pkgs-centos7-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-centos7-v0.13.9.tar.gz) |
| Redhat 8 | [os-pkgs-redhat8-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-redhat8-v0.13.9.tar.gz) |
| Redhat 7 | [os-pkgs-redhat7-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-redhat7-v0.13.9.tar.gz) |
| Redhat 9 | [os-pkgs-redhat9-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-redhat9-v0.13.9.tar.gz) |
| Kylin Linux Advanced Server release V10 (Sword) SP2 | [os-pkgs-kylinv10-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-kylinv10-v0.13.9.tar.gz) |
| Ubuntu 20.04 | [os-pkgs-ubuntu2004-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-ubuntu2004-v0.13.9.tar.gz) |
| openEuler 22.03 | [os-pkgs-openeuler22.03-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-openeuler22.03-v0.13.9.tar.gz) |
| Oracle Linux R9 U1 | [os-pkgs-oracle9-v0.13.9.tar.gz](https://files.m.daocloud.io/github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-oracle9-v0.13.9.tar.gz) |
| Rocky Linux 9.2 | [os-pkgs-rocky9-v0.13.9.tar.gz](https://github.com/kubean-io/kubean/releases/download/v0.13.9/os-pkgs-rocky9-v0.13.9.tar.gz) |

=== "V0.15.0"

| Operating System | Download |
Expand Down Expand Up @@ -171,8 +190,8 @@ in [clusterConfig.yaml](./cluster-config.md).

| CPU Architecture | Version | Download |
| :--------------- | :------ | :------- |
| AMD64 | v0.15.0 | [addon-offline-full-package-v0.15.0-amd64.tar.gz](https://qiniu-download-public.daocloud.io/DaoCloud_DigitalX_Addon/addon-offline-full-package-v0.15.0-amd64.tar.gz) |
| 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) |
| AMD64 | v0.15.0 | [addon-offline-full-package-v0.15.0-amd64.tar.gz](https://qiniu-download-public.daocloud.io/DaoCloud_DigitalX_Addon/addon-offline-full-package-v0.15.0-amd64.tar.gz) |
| <font color="green">ARM64</font> | 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

Expand Down
4 changes: 2 additions & 2 deletions docs/en/docs/install/community/k8s/k8s-dce-deploy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
```
Expand Down
4 changes: 2 additions & 2 deletions docs/en/docs/install/community/k8s/offline.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down
4 changes: 2 additions & 2 deletions docs/en/docs/install/community/k8s/online.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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`

Expand Down
13 changes: 8 additions & 5 deletions docs/en/docs/install/install-tools.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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: <https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/prerequisite_${VERSION}_arm64.tar.gz>
- For arm architecture, use the download link for arm:
<https://qiniu-download-public.daocloud.io/DaoCloud_Enterprise/dce5/prerequisite_${VERSION}_arm64.tar.gz>
- Make sure the offline package and the script are in the same directory level.

3. Perform the offline installation.
Expand All @@ -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).
12 changes: 6 additions & 6 deletions docs/en/docs/install/k8s-install/ecs-install-dce5.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
```
Expand Down Expand Up @@ -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
```
Expand Down Expand Up @@ -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
```
Expand Down
Loading
Loading