openEuler Container Image Deployment Guide ​

Beyond base images, the openEuler community has released over 20 images of commonly used open source applications. This document focuses on the installation and basic usage of openEuler base images. If you are interested in other openEuler community images, we encourage you to explore and experiment with them.

Base Image Overview ​

1. Container image repository

   openEuler official container image repository, containing openEuler base images and application images. You can find the usage and introduction of the images here.

2. Base image address

   openEuler base image official website: repo.openeuler.org

3. Base image versions

   • 20.03-lts
   • 20.03-lts-sp1
   • 20.03-lts-sp2
   • 20.03-lts-sp3
   • 20.03-lts-sp4, 20.03
   • 20.09
   • 21.03
   • 21.09
   • 22.03-lts
   • 22.09
   • 22.03-lts-sp1
   • 22.03-lts-sp2
   • 22.03-lts-sp3, 22.03, latest
   • 23.03
   • 23.09

Image Repositories ​

Supported base images and application images are released to the following image repositories for download and use:

• hub.docker.com
• quay.io
• hub.oepkgs.net
• repo.openeuler.org

Image Deployment Process ​

1. Environment Setup ​

• For Windows, prepare a VM.
• For macOS, use the built-in terminal.

2. Docker Deployment ​

#1. Run the Docker installation command. If Docker has been installed or the Docker client has been downloaded, skip this step.
dnf -y install docker  # Example command for installing Docker in a VM. For macOS, follow the respective procedures.

# 2. After Docker is installed, run the following command to view the installed version.
docker version

3. Image Pulling ​

Generally, the latest image version is used. To use other versions, replace latest with the required version. You are advised to pull images from a geographically closer mirror repository for fast and stable pulling.

# Pull an image from the default repository.
docker pull openeuler/openeuler:latest
# Pull an image from the OEPKGS repository.
docker pull hub.oepkgs.net/openeuler/openeuler:latest

#After the image is pulled, run the following command to view images:
docker images

4. Container Startup ​

Generally, the latest image version is used. To use other versions, replace latest with the required version.

# Start an image from the default repository.
docker run -it  openeuler/openeuler:latest
# Start an image from the OEPKGS repository.
docker run -it  hub.oepkgs.net/openeuler/openeuler:latest

5. Container Running Test ​

Write a test script. By default, openEuler is installed with Python 3. You can write a simple "HelloWorld" script for testing.

The example is as follows:

# Open the text editor.
vi HelloWorld.py

# Press "Insert" or "i" to start editing.

# Write the test program.
print("Hello, world!")

# Press Esc to stop editing. Enter ":" (Shift+;) and "wq!" to save the file and exit.

# Run the Python script for testing.
python3 HelloWorld.py

File editing example

Application running example

Obtaining openEuler in OrbStack ​

OrbStack is a lightweight VM platform on macOS that supports openEuler. After downloading OrbStack from https://orbstack.dev/download, click + and select openEuler to create an openEuler VM.