There are different container engine. But we recommend to use Docker. This guide shows your how to install Docker Engine (not Docker Desktop). This is a useful guide if you are using dflow on a cloud.
Go to Docker official website to follow the official download guide: Get Docker
We will show you how to install Docker Engine on a Ubuntu platform: Install Docker Engine on Ubuntu
This guide is copied from: https://docs.docker.com/engine/install/ubuntu/#install-using-the-repository.
-
Update the
apt
package index and install packages to allowapt
to use a repository over HTTPS:sudo apt-get update sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release
-
Add Docker's official GPG key:
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
-
Use the following command to set up the repository:
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
-
Update the
apt
package index, and install the latest version of Docker Engine, containerd, and Docker Compose, or go to the next step to install a specific version:sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Receiving a GPG error when running
apt-get update
?Your default umask may not be set correctly, causing the public key file for the repo to not be detected. Run the following command and then try to update your repo again:
sudo chmod a+r /etc/apt/keyrings/docker.gpg
. -
To install a specific version of Docker Engine, list the available versions in the repo, then select and install:
a. List the versions available in your repo:
apt-cache madison docker-ce docker-ce | 5:20.10.16~3-0~ubuntu-jammy | https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages docker-ce | 5:20.10.15~3-0~ubuntu-jammy | https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages docker-ce | 5:20.10.14~3-0~ubuntu-jammy | https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages docker-ce | 5:20.10.13~3-0~ubuntu-jammy | https://download.docker.com/linux/ubuntu jammy/stable amd64 Packages
b. Install a specific version using the version string from the second column, for example,
5:20.10.16~3-0~ubuntu-jammy
.sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io docker-compose-plugin
Run the hello-world
official image to verify the installation.
docker run hello-world
This command downloads a test image and runs it in a container. When the container runs, it prints a message and exits.
To use kubernetes, we can install minikube, a local kubernetes.
Check if you are the root user. Minikube does not allow root user to start. Follow the following guide to add a user. See the original issue here: kubernetes/minikube#7903
adduser developer
#add the user. Follow the prompt
usermod -aG sudo developer
su - developer
sudo groupadd docker
sudo usermod -aG docker $USER
- Re-Login or Restart the Server
Go to minikube official website to download: Minikube
NOTE: this is the recommended route for users in China. The minikube image repository for the up-to-date version is not correct, which leads to minikube start failure.
- Install older version from the official github repository: Releases · kubernetes/minikube
- Install older version using mirror in China: minikube (The latest version that works is 1.25.2)
Command to install minikube older version (1.25.2)
curl -o minikube -L https://registry.npmmirror.com/-/binary/minikube/v1.25.2/minikube-linux-amd64
Install you downloaded minikube to /usr/local/bin
:
sudo install minikube /usr/local/bin/minikube
minikube version