Install Workflow¶

If you have a pure host, it can be a cloud server, bare metal server, virtual machine, or even your laptop. Then this chapter is very suitable for you.

Operating Systems¶

Drycc is expected to work on most modern Linux systems. Some OSS have specific requirements:

• (Red Hat/CentOS) Enterprise Linux, they usually use RPM package management.
• Ubuntu (Desktop/Server/Cloud) Linux, a very popular distribution.
• Debian GNU Linux, a very pure distribution of opensource software.

If you want to add more Linux distribution support, please submit a issue on github or submit PR directly.

System Software¶

Some basic software needs to be installed before installing drycc workflow.

OS configuration¶

K8s requires a large number of ports. If you are not sure what they are, please close the local firewall or open these ports. At the same time, because k8s you need system time, you need to ensure that the system time is correct.

Installing open-iscsi¶

The command used to install open-iscsi differs depending on the Linux distribution. We recommend using Ubuntu as the guest OS image since it contains open-iscsi already. You may need to edit the cluster security group to allow SSH access. For SUSE and openSUSE, use this command:

$ zypper install open-iscsi

For Debian and Ubuntu, use this command:

$ apt-get install open-iscsi

For RHEL, CentOS, and EKS with EKS Kubernetes Worker AMI with AmazonLinux2 image, use this command:

$ yum install iscsi-initiator-utils

Installing NFSv4 client¶

The command used to install a NFSv4 client differs depending on the Linux distribution.

For Debian and Ubuntu, use this command:

$ apt-get install nfs-common

For RHEL, CentOS, and EKS with EKS Kubernetes Worker AMI with AmazonLinux2 image, use this command:

$ yum install nfs-utils

Installing curl¶

For Debian and Ubuntu, use this command:

$ apt-get install curl

For RHEL, CentOS, and EKS with EKS Kubernetes Worker AMI with AmazonLinux2 image, use this command:

$ yum install curl

Installing bc¶

For Debian and Ubuntu, use this command:

$ apt-get install bc

For RHEL, CentOS, and EKS with EKS Kubernetes Worker AMI with AmazonLinux2 image, use this command:

$ yum install bc

Hardware¶

Hardware requirements scale based on the size of your deployments. Minimum recommendations are outlined here.

• RAM: 1G Minimum (we recommend at least 2GB)
• CPU: 1 Minimum

This configuration only contains the minimum requirements that can meet the operation.

Disk¶

Drycc performance depends on the performance of the database. To ensure optimal speed, we recommend using an SSD when possible. Disk performance will vary on ARM devices utilizing an SD card or eMMC.

Domain Name¶

Drycc needs a root domain name under your full control and points this domain name to the server to be installed. Suppose there is a wildcard domain pointing to the current server to install drycc, which is the name *.dryccdoman.com. We need to set the PLATFORM_DOMAIN environment variables before installation.

$ export PLATFORM_DOMAIN=dryccdoman.co

Of course, if it is a test environment, we can also use nip.io, an IP to domain name service. For example, your host IP is 59.46.3.190, we will get the following domain name 59.46.3.190.nip.io

$ export PLATFORM_DOMAIN=59.46.3.190.nip.io

Install¶

Before installation, please make sure whether your installation environment is a public network. If it is an intranet environment and there is no public IP, you need to disable the automatic certificate.

$ export CERT_MANAGER_ENABLED=false

Then you can use the installation script available at https://drycc.cc/install.sh to install drycc as a service on systemd and openrc based systems.

$ curl -sfL https://drycc.cc/install.sh | bash -

Install Node¶

Node can be a simple agent or a server; Server has the function of agent. Multiple servers have high availability, but the number of servers should not exceed 7 at most. There is no limit to the number of agents.

• First, check the cluster token of the master.

$ cat /var/lib/rancher/k3s/server/node-token
K1078e7213ca32bdaabb44536f14b9ce7926bb201f41c3f3edd39975c16ff4901ea::server:33bde27f-ac49-4483-b6ac-f4eec2c6dbfa

We assume that the IP address of the cluster master is 192.168.6.240, in that way.

• Then, Set the environment variable:

$ export K3S_URL=https://192.168.6.240:6443
$ export K3S_TOKEN="K1078e7213ca32bdaabb44536f14b9ce7926bb201f41c3f3edd39975c16ff4901ea::server:33bde27f-ac49-4483-b6ac-f4eec2c6dbfa"

• Join the cluster as server:

$ curl -sfL https://drycc.cc/install.sh | bash -s - install_k3s_server

• Join the cluster as agent:

$ curl -sfL https://drycc.cc/install.sh | bash -s - install_k3s_agent

Install Options¶

When using this method to install drycc, the following environment variables can be used to configure the installation:

ENVIRONMENT VARIABLE	DESCRIPTION
PLATFORM_DOMAIN	Required item, specify drycc's domain name
DRYCC_ADMIN_USERNAME	Required item, specify drycc's admin username
DRYCC_ADMIN_PASSWORD	Required item, specify drycc's admin password
CERT_MANAGER_ENABLED	Whether to use automatic certificate. It is true by default
CHANNEL	By default, stable channel will be installed. You can also specify testing
REGISTRIES_FILE	The registers.yaml file path used by drycc registry
KUBE_API_SERVER_ADDRESS	Set with the IP address of the loadbalancer that was in front of kube-apiserver, The default is the IP address of the current node
KUBE_API_SERVER_PORT	Set with the PORT of the loadbalancer that was in front of kube-apiserver, which is 6443 by default
METALLB_CONFIG_FILE	The metallb config file path, layer 2 network is used by default
INSTALL_DRYCC_MIRROR	Specify the accelerated mirror location. Currently, only cn is supported
CONTROLLER_APP_STORAGE_CLASS	StorageClass allocated by drycc volumes; default storageClass is used by default
REDIS_PERSISTENCE_SIZE	The size of the persistence space allocated to redis, which is 5Gi by default
REDIS_PERSISTENCE_STORAGE_CLASS	StorangeClass of redis; default storangeclass is used by default
MINIO_PERSISTENCE_SIZE	The size of the persistence space allocated to minio, which is 20Gi by default
MINIO_PERSISTENCE_STORAGE_CLASS	StorangeClass of minio; default storangeclass is used by default
MONITOR_GRAFANA_PERSISTENCE_SIZE	The size of the persistence space allocated to monitor.grafana, which is 5Gi by default
MONITOR_GRAFANA_PERSISTENCE_STORAGE_CLASS	StorangeClass of monitor grafana; default storangeclass is used by default
INFLUXDB_PERSISTENCE_SIZE	The size of the persistence space allocated to influxdb, which is 5Gi by default
INFLUXDB_PERSISTENCE_STORAGE_CLASS	StorangeClass of influxdb; default storangeclass is used by default
RABBITMQ_PERSISTENCE_SIZE	The size of the persistence space allocated to rabbitmq, which is 5Gi by default
RABBITMQ_PERSISTENCE_STORAGE_CLASS	StorangeClass of rabbitmq; default storangeclass is used by default
DATABASE_PERSISTENCE_SIZE	The size of the persistence space allocated to database, which is 5Gi by default
DATABASE_PERSISTENCE_STORAGE_CLASS	StorangeClass of database; default storangeclass is used by default
HELMBROKER_PERSISTENCE_SIZE	The size of the persistence space allocated to helmbroker, which is 5Gi by default
HELMBROKER_PERSISTENCE_STORAGE_CLASS	StorangeClass of helmbroker; default storangeclass is used by default
K3S_DATA_DIR	The config of k3s data dir; If not set, the default path is used
DEFAULT_STORAGE_CLASS	K3s default stroageclass, If not set, the openebs-hostpath stroageclass is used
LOCAL_PROVISIONER_PATH	Local path storage path, If not set, the /var/openebs/local path is used
ACME_SERVER	ACME Server url, default use letsencrypt
ACME_EAB_KEY_ID	The key ID of which your external account binding is indexed by the external account
ACME_EAB_KEY_SECRET	The key Secret of which your external account symmetric MAC key

Since the installation script will install k3s, other environment variables can refer to k3s installation environment variables.

Uninstall¶

If you installed drycc using an installation script, you can uninstall the entire drycc using this script.

$ curl -sfL https://drycc.cc/uninstall.sh | bash -