diff --git a/Cloud/containerd/README.md b/Cloud/containerd/README.md new file mode 100644 index 0000000000000000000000000000000000000000..5787ff38f3c081a87ec0463dd62654f06939d0df --- /dev/null +++ b/Cloud/containerd/README.md @@ -0,0 +1,85 @@ +# Quick reference + +- The official containerd docker image. + +- Maintained by: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative). + +- Where to get help: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative), [openEuler](https://gitee.com/openeuler/community). + +# containerd | openEuler +Current containerd images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +containerd is an industry-standard container runtime with an emphasis on simplicity, robustness, and portability. It is available as a daemon for Linux and Windows, which can manage the complete container lifecycle of its host system: image transfer and storage, container execution and supervision, low-level storage and network attachments, etc. + +Read more on [containerd Website](https://containerd.io/). + +# Supported tags and respective dockerfile links +The tag of each `containerd` docker image is consist of the version of `containerd` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|--------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------|---------------| +| [2.1.1-oe2403sp1](https://gitee.com/openeuler/openeuler-containerd-images/blob/master/Cloud/containerd/2.1.1/24.03-lts-sp1/containerdfile) | containerd 2.1.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +# Usage +In this usage, users can select the corresponding `{Tag}` based on their requirements. + +- Pull the `openeuler/containerd` image from docker + + ``` + docker pull openeuler/containerd:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use containerd. + ``` + docker run -it --rm openeuler/containerd:{Tag} bash + ``` + +- Create a simple CNI configuration file + + Create a basic CNI config file(e.g., empty.conf) inside `/etc/cni/net.d/` to avoid network plugin errors when starting containerd: + ``` + mkdir -p /etc/cni/net.d/ + + # vi /etc/cni/net.d/empty.conf + { + "cniVersion": "0.4.0", + "name": "empty-net", + "type": "bridge", + "bridge": "cni0", + "isGateway": true, + "ipMasq": true, + "ipam": { + "type": "host-local", + "subnet": "10.88.0.0/16", + "routes": [ + { "dst": "0.0.0.0/0" } + ] + } + } + ``` + +- Create the containerd configuration directory + + Make sure the containerd config directory exist: + ``` + mkdir -p /etc/containerd + ``` + +- Generate the default containerd configuration file + + Generate the default configuration and save it to `/etc/containerd/config.toml`: + ``` + ./containerd config default > /etc/containerd/config.toml + ``` + +- Start containerd with the custom configuration + + Start the containerd daemon using the created config file in the background: + ``` + ./containerd --config /etc/containerd/config.toml & + ``` + +# Question and answering +If you have any questions or want to use some special features, please submit an issue or a pull request on [openeuler-docker-images](https://gitee.com/openeuler/openeuler-docker-images). \ No newline at end of file diff --git a/Cloud/containerd/doc/image-info.yml b/Cloud/containerd/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..5ee77a3cbc7d8465ad190cebbc007960ccbcb874 --- /dev/null +++ b/Cloud/containerd/doc/image-info.yml @@ -0,0 +1,79 @@ +name: containerd +category: cloud +description: containerd 是一个高性能容器运行时（Container Runtime），提供容器的生命周期管理，包括镜像管理、容器执行、存储挂载、网络配置等底层功能，但并不包含编排能力（如 Kubernetes）。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[2.1.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/containerd/2.1.1/24.03-lts-sp1/Dockerfile)| containerd 2.1.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/containerd:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 交互式 shell 启动容器来操作 containerd： + ``` + docker run -it --rm openeuler/containerd:{Tag} bash + ``` + + - 创建一个简单的 CNI 配置文件 + + 在 `/etc/cni/net.d/` 目录下创建一个基础的 CNI 配置文件（例如 `empty.conf`），以避免启动 containerd 时出现网络插件错误： + ``` + mkdir -p /etc/cni/net.d/ + + # vi /etc/cni/net.d/empty.conf + { + "cniVersion": "0.4.0", + "name": "empty-net", + "type": "bridge", + "bridge": "cni0", + "isGateway": true, + "ipMasq": true, + "ipam": { + "type": "host-local", + "subnet": "10.88.0.0/16", + "routes": [ + { "dst": "0.0.0.0/0" } + ] + } + } + ``` + + - 创建 containerd 配置目录 + + 确保 containerd 配置目录存在： + ``` + mkdir -p /etc/containerd + ``` + + - 生成默认的 containerd 配置文件 + + 生成默认配置并保存到 `/etc/containerd/config.toml` 文件： + ``` + ./containerd config default > /etc/containerd/config.toml + ``` + + - 使用自定义配置启动 containerd + + 使用创建的配置文件后台启动 containerd 守护进程： + ``` + ./containerd --config /etc/containerd/config.toml & + ``` + +license: Apache-2.0 license +similar_packages: + - CRI-O: Kubernetes 社区开发的轻量级容器运行时，只实现 Kubernetes CRI 接口。 +dependency: + - golang \ No newline at end of file diff --git a/Cloud/containerd/doc/picture/logo.png b/Cloud/containerd/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..9dd28220e1cef93d847ee32dccdd6da3c8d5666f Binary files /dev/null and b/Cloud/containerd/doc/picture/logo.png differ diff --git a/Cloud/coredns/README.md b/Cloud/coredns/README.md new file mode 100644 index 0000000000000000000000000000000000000000..2b42118670aaf92ce4066c74f83c30e906b5f1cf --- /dev/null +++ b/Cloud/coredns/README.md @@ -0,0 +1,73 @@ +# Quick reference + +- The official CoreDNS docker image. + +- Maintained by: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative). + +- Where to get help: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative), [openEuler](https://gitee.com/openeuler/community). + +# CoreDNS | openEuler +Current coredns images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +CoreDNS is a DNS server. It is written in Go. It can be used in a multitude of environments because of its flexibility. CoreDNS is licensed under the Apache License Version 2, and completely open source. + +Read more on [CoreDNS Website](https://coredns.io/). + +# Supported tags and respective dockerfile links +The tag of each `coredns` docker image is consist of the version of `coredns` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|-------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|---------------| +| [1.12.1-oe2403sp1](https://gitee.com/openeuler/openeuler-coredns-images/blob/master/Cloud/coredns/1.12.1/24.03-lts-sp1/corednsfile) | CoreDNS 1.12.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +# Usage +In this usage, users can select the corresponding `{Tag}` based on their requirements. + +- Pull the `openeuler/coredns` image from docker + + ``` + docker pull openeuler/coredns:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use coredns. + ``` + docker run -it --rm openeuler/coredns:{Tag} bash + ``` + +- Create a `Corefile` + + In your current working directory, create a simple `Corefile`: + ``` + # Corefile + .:53 { + forward . 8.8.8.8 + log + } + ``` + What this means: + * `.:53`: Listen for all DNS queries on port 53. + * `forward . 8.8.8.8`: Forward all DNS queries to Google Public DNS. You can replace `8.8.8.8` with your loca DNS server if needed. + * `log`: Log each DNS request for debugging. + +- Start CoreDNS (Run as a local binary) + + If you have the `coredns` binary, start it with: + ``` + ./coredns -conf Corefile + ``` + After starting, CoreDNS will listen on `0.0.0.0:53` and forward incoming DNS queries according to your configuration. + +- Test DNS Resolution + + Use `dig` on your container to test if CoreDNS is working: + ``` + # You should install bind-utils first in order to use the dig command. + dnf install -y bind-utils + dig @127.0.0.1 www.example.com + ``` + You should see a DNS response in your terminal, and CoreDNS should log the request in its output. + +# Question and answering +If you have any questions or want to use some special features, please submit an issue or a pull request on [openeuler-docker-images](https://gitee.com/openeuler/openeuler-docker-images). \ No newline at end of file diff --git a/Cloud/coredns/doc/image-info.yml b/Cloud/coredns/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..2e9bbe98f9c8435b3639262005d0eefc5bc800e8 --- /dev/null +++ b/Cloud/coredns/doc/image-info.yml @@ -0,0 +1,67 @@ +name: coredns +category: cloud +description: CoreDNS 是一个可扩展、灵活的开源 DNS 服务器，最初是为替代 SkyDNS 开发的，现在已经成为 Kubernetes 默认的 DNS 插件之一。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[1.12.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/coredns/1.12.1/24.03-lts-sp1/Dockerfile)| CoreDNS 1.12.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/coredns:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 交互式 shell 启动容器来操作 coredns： + ``` + docker run -it --rm openeuler/coredns:{Tag} bash + ``` + + - 创建文件 `Corefile` + + 在当前工作目录下创建一个简单的 `Corefile` 文件， 内容如下： + ``` + # Corefile + .:53 { + forward . 8.8.8.8 + log + } + ``` + What this means: + * `.:53`: 在 53 端口监听所有 DNS 查询请求。 + * `forward . 8.8.8.8`: 将所有 DNS 查询转发到 Google 公共 DNS（可以把 `8.8.8.8` 替换成你自己的 DNS 服务器）。 + * `log`: 记录每条 DNS 请求，方便调试。 + + - 启动 CoreDNS（以本地二进制方式运行） + + 如果你已经有 `coredns` 可执行文件，用下面的命令启动： + ``` + ./coredns -conf Corefile + ``` + 启动后，CoreDNS 会监听 `0.0.0.0:53`，并按照你的配置把收到的 DNS 请求转发出去。 + + - 测试 DNS 解析是否可用 + + 使用 `dig` 来验证 CoreDNS 是否正常工作： + ``` + # 使用 dig 命令前，需先安装 bind-utils 工具包。 + dnf install -y bind-utils + dig @127.0.0.1 www.example.com + ``` + 执行后，你应该能在终端里看到 DNS 响应结果，同时 CoreDNS 会在输出里记录查询日志。 + +license: Apache-2.0 license +similar_packages: + - dnsmasq: 轻量级的 DNS 和 DHCP 转发器，适合本地网络、开发环境或小型集群。 +dependency: + - golang \ No newline at end of file diff --git a/Cloud/coredns/doc/picture/logo.png b/Cloud/coredns/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..c643b7b898a3ed9c82a48e03046b2c98c0a119bc Binary files /dev/null and b/Cloud/coredns/doc/picture/logo.png differ diff --git a/Cloud/ovirt-engine/README.md b/Cloud/ovirt-engine/README.md new file mode 100644 index 0000000000000000000000000000000000000000..726260dcf54e7dd3a8c9cb0c19c0c579fa408f3e --- /dev/null +++ b/Cloud/ovirt-engine/README.md @@ -0,0 +1,48 @@ +# Quick reference + +- The official oVirt Engine docker image. + +- Maintained by: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative). + +- Where to get help: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative), [openEuler](https://gitee.com/openeuler/community). + +# oVirt Engine | openEuler +Current oVirt Engine images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +oVirt Engine is the central management service of the oVirt virtualization platform. + +# Supported tags and respective dockerfile links +The tag of each `ovirt-engine` docker image is consist of the version of `ovirt-engine` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|--------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|---------------| +| [4.5.6-oe2403sp1](https://gitee.com/openeuler/openeuler-ovirt-engine-images/blob/master/Cloud/ovirt-engine/4.5.6/24.03-lts-sp1/ovirt-enginefile) | oVirt Engine 4.5.6 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +# Usage +In this usage, users can select the corresponding `{Tag}` based on their requirements. + +- Pull the `openeuler/ovirt-engine` image from docker + + ``` + docker pull openeuler/ovirt-engine:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use ovirt-engine. + ``` + docker run -it --rm openeuler/ovirt-engine:{Tag} bash + ``` + +- WildFly Standalone Server Startup Command + + Command Syntax + ``` + /usr/share/ovirt-engine-wildfly/bin/standalone.sh -b 0.0.0.0 -bmanagement 0.0.0.0 + ``` + **Options Explained:** + * `-b 0.0.0.0:` Bind to all available network interfaces(`0.0.0.0`). + * `-bmanagement 0.0.0.0:` Listen for both application traffic and management traffic. + +# Question and answering +If you have any questions or want to use some special features, please submit an issue or a pull request on [openeuler-docker-images](https://gitee.com/openeuler/openeuler-docker-images). \ No newline at end of file diff --git a/Cloud/ovirt-engine/doc/image-info.yml b/Cloud/ovirt-engine/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..d1b4451c1454b5c1ffb95eeb20f6f27ac8f7c452 --- /dev/null +++ b/Cloud/ovirt-engine/doc/image-info.yml @@ -0,0 +1,47 @@ +name: ovirt-engine +category: cloud +description: oVirt Engine 是 oVirt 虚拟化管理平台的核心组件，相当于虚拟化集群的大脑。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[4.5.6-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/ovirt-engine/4.5.6/24.03-lts-sp1/Dockerfile)| oVirt Engine 4.5.6 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/ovirt-engine:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 交互式 shell 启动容器来操作 ovirt-engine： + ``` + docker run -it --rm openeuler/ovirt-engine:{Tag} bash + ``` + + - WildFly独立服务器启动命令 + + 启动命令: + ``` + /usr/share/ovirt-engine-wildfly/bin/standalone.sh -b 0.0.0.0 -bmanagement 0.0.0.0 + ``` + **选项说明:** + * `-b 0.0.0.0:` 绑定到所有可用网络接口(0.0.0.0)。 + * `-bmanagement 0.0.0.0:` 同时监听应用流量和管理流量。 + +license: Apache-2.0 license +similar_packages: + - N/A +dependency: + - postgresql + - openssl + - wildfly + - python3 diff --git a/Cloud/ovirt-engine/doc/picture/logo.png b/Cloud/ovirt-engine/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..2ce3e7bae076af865ee7c18e78b3dc3426089422 Binary files /dev/null and b/Cloud/ovirt-engine/doc/picture/logo.png differ diff --git a/Cloud/qemu/README.md b/Cloud/qemu/README.md new file mode 100644 index 0000000000000000000000000000000000000000..1172ff5fc36043bb7e67936470fd83ad732e6e4c --- /dev/null +++ b/Cloud/qemu/README.md @@ -0,0 +1,67 @@ +# Quick reference + +- The official QEMU docker image. + +- Maintained by: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative). + +- Where to get help: [openEuler CloudNative SIG](https://gitee.com/openeuler/cloudnative), [openEuler](https://gitee.com/openeuler/community). + +# QEMU | openEuler +Current QEMU images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +QEMU is capable of emulating a complete machine in software without any need for hardware virtualization support. By using dynamic translation, it achieves very good performance. QEMU can also integrate with the Xen and KVM hypervisors to provide emulated hardware while allowing the hypervisor to manage the CPU. With hypervisor support, QEMU can achieve near native performance for CPUs. When QEMU emulates CPUs directly it is capable of running operating systems made for one machine (e.g. an ARMv7 board) on a different machine (e.g. an x86_64 PC board). + +Read more on [QEMU documentation](https://www.qemu.org/documentation/). + +# Supported tags and respective dockerfile links +The tag of each `qemu` docker image is consist of the version of `qemu` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|----------------------------------------------------------------------------------------------------------------------------|----------------------------------------|---------------| +| [10.0.2-oe2403sp1](https://gitee.com/openeuler/openeuler-qemu-images/blob/master/Cloud/qemu/10.0.2/24.03-lts-sp1/qemufile) | QEMU 10.0.2 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +# Usage +In this usage, users can select the corresponding `{Tag}` based on their requirements. + +- Pull the `openeuler/qemu` image from docker + + ``` + docker pull openeuler/qemu:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use QEMU. + ``` + docker run -it --rm openeuler/qemu:{Tag} bash + ``` + +- Download a Bootable ISO + + Use wget to download your prefered bootable ISO image for the target architecture. + ``` + wget https://example.com/path/to/your-os-image-aarch64.iso + ``` + Replace this URL with your own ISO image. + +- Start QEMU with the ISO(aarch64). + + Run the ISO in your container with `qemu-system-aarch64`. + ``` + qemu-system-aarch64 \ + -m 512M \ + -machine virt \ + -cpu cortex-a57 \ + -cdrom ./your-os-image-aarch64.iso \ + -boot d + ``` + + **Key options:** + * `-m 512M:` Allocate 512M RAM. + * `-machine:` Generic ARM64 virtual machine. + * `-cpu cortex-a57:` ARM CPU type. + * `-cdrom:` Path to your ISO file. + * `-boot d:` Boot from the CD-ROM drive. + +# Question and answering +If you have any questions or want to use some special features, please submit an issue or a pull request on [openeuler-docker-images](https://gitee.com/openeuler/openeuler-docker-images). \ No newline at end of file diff --git a/Cloud/qemu/doc/image-info.yml b/Cloud/qemu/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..f40a9ebc4777f5316a70114a8c1bf74ffde50254 --- /dev/null +++ b/Cloud/qemu/doc/image-info.yml @@ -0,0 +1,71 @@ +name: qemu +category: cloud +description: QEMU（Quick Emulator） 是一个开源的通用虚拟化和硬件仿真器，最初由 Fabrice Bellard 开发并由社区持续维护。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[10.0.2-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/qemu/10.0.2/24.03-lts-sp1/Dockerfile)| QEMU 10.0.2 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/qemu:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 交互式 shell 启动容器来操作 QEMU： + ``` + docker run -it --rm openeuler/qemu:{Tag} bash + ``` + + - 下载可引导的 ISO 镜像 + + 下载你需要的可引导操作系统 ISO 镜像，针对目标架构（例如 aarch64） + ``` + wget https://example.com/path/to/your-os-image-aarch64.iso + ``` + 替换 URL 为自己的 ISO 镜像地址。 + + - 使用 ISO（aarch64）启动 QEMU + + 在容器中使用 `qemu-system-aarch64` 加载 ISO 镜像运行： + ``` + qemu-system-aarch64 \ + -m 512M \ + -machine virt \ + -cpu cortex-a57 \ + -cdrom ./your-os-image-aarch64.iso \ + -boot d + ``` + + **参数解释:** + * `-m 512M:` 分配 512M 内存。 + * `-machine:` 指定通用的 ARM64 虚拟机类型。 + * `-cpu cortex-a57:` 指定使用的 ARM CPU 类型。 + * `-cdrom:` 指定 ISO 镜像文件的路径。 + * `-boot d:` 从 CD-ROM 驱动器引导。 + +license: GPL-2.0 license +similar_packages: + - VirtualBox: Oracle 提供的开源桌面虚拟机软件，适合个人桌面环境。 +dependency: + - liburing + - fuse3 + - libcurl + - libcap + - pulseaudio + - libiscsi + - libattr + - libselinux + - libzstd + - libusbx + - libseccomp diff --git a/Cloud/qemu/doc/picture/logo.png b/Cloud/qemu/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..f9cf931783de1aff1913745eb0e2ecf6afd3af04 Binary files /dev/null and b/Cloud/qemu/doc/picture/logo.png differ