Offline Install in a Standard Kubernetes Cluster¶
This page will guide you to install DCE Community package offline in a standard Kubernetes cluster, which is recommended in the production environment.
Click Online Install DCE Community to watch a video demo for online install.
Preparation¶
-
Prepare a Kubernetes cluster. For resources required, see Cluster Resources for Installing DCE Community.
- Create a StorageClass and set it the default SC
- Install CoreDNS in the cluster
- If there is only one node in the cluster, make sure you have removed taints for that node
-
You must install certain versions of each dependency:
- helm ≥ 3.11.1
- skopeo ≥ 1.11.1
- kubectl ≥ 1.25.6
- yq ≥ 4.31.1
Download and install¶
-
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.
Take VERSION=v0.18.0 as an example.
-
Customize
clusterConfig.yaml
-
If Console is exposed via NodePort (recommended only for PoC use cases), skip this step.
-
In non-public cloud environment (virtual/physical machine), please enable load balancer (metallb) to avoid NodePort instability caused by node IP changes. Plan your network carefully and set up 2 necessary VIPs. Here is an example of
clusterConfig.yaml
:yaml title="clusterConfig.yaml" apiVersion: provision.daocloud.io/v1alpha3 kind: ClusterConfig spec: loadBalancer: type: metallb istioGatewayVip: 10.6.229.10/32 insightVip: 10.6.229.11/32 fullPackagePath: absolute-path-of-the-offline-directory # (1)! imagesAndCharts: # (2)! type: external externalImageRepo: your-external-registry # (3)! # externalImageRepoUsername: admin # externalImageRepoPassword: Harbor123456
- path for decompressed offline package
- container registry
- container registry address, must be http or https
-
If it is a public cloud environment that already has a Kubernetes load balancer, set
clusterConfig.yaml
as follows:clusterConfig.yamlapiVersion: provision.daocloud.io/v1alpha3 kind: ClusterConfig spec: loadBalancer: type: cloudLB fullPackagePath: absolute-path-of-the-offline-directory # (1)! imagesAndCharts: # (2)! type: external externalImageRepo: your-external-registry # (3)! # externalImageRepoUsername: admin # externalImageRepoPassword: Harbor123456
- path for decompressed offline package
- container registry
- container registry address, must be http or https
-
If Console is exposed via NodePort (recommended only for PoC use cases), set
clusterConfig.yaml
as follows:clusterConfig.yamlapiVersion: provision.daocloud.io/v1alpha3 kind: ClusterConfig spec: loadBalancer: type: NodePort fullPackagePath: absolute-path-of-the-offline-directory # (1)! imagesAndCharts: # (2)! type: external externalImageRepo: your-external-registry # (3)! # externalImageRepoUsername: admin # externalImageRepoPassword: Harbor123456
- path for decompressed offline package
- container registry
- container registry address, must be http or https
-
-
Install DCE 5.0.
Note
- Parameter
-p
specifies the offline directory to decompress the offline package. - For
clusterConfig.yaml
file settings, refer to Online Installation. -z
minimal install-c
specifies the cluster configuration file. You don't need to specify-c
when using NodePort to expose the console.-d
enable debug mode--serial
specifies that all installation tasks are executed serially
- Parameter
-
After the installation is complete, the command line will prompt that the installation is successful. Congratulations!
Now you can use the default account and password (admin/changeme) to explore the new DCE 5.0 through the URL prompted on the screen!
Success
It's recommended to write down the prompted URL for your next visit.
-
Before fully explore the features of DCE 5.0, you need to apply for a license. The Community package is provided for free. All you need to do is to apply for a free license.