diff --git a/Cloud/docker/README.md b/Cloud/docker/README.md new file mode 100644 index 0000000000000000000000000000000000000000..19d254826a02287153abf91c787e8274932871d0 --- /dev/null +++ b/Cloud/docker/README.md @@ -0,0 +1,68 @@ +# Quick reference + +- The official 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). + +# Docker | openEuler +Current Docker images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +Docker is an open platform for developing, shipping, and running applications. Docker enables you to separate your applications from your infrastructure so you can deliver software quickly. With Docker, you can manage your infrastructure in the same ways you manage your applications. By taking advantage of Docker's methodologies for shipping, testing, and deploying code, you can significantly reduce the delay between writing code and running it in production. + +Learn more about Docker on [Docker Website](https://www.docker.com/)⁠. + +# Supported tags and respective Dockerfile links +The tag of each `docker` docker image is consist of the version of `docker` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|----------------------------------------------------------------------------------------------------------------------------------|------------------------------------------|---------------| +| [28.2.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/docker/28.2.1/24.03-lts-sp1/Dockerfile) | Docker 28.2.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/docker` image from docker + + ```bash + docker pull openeuler/docker:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use docker. + ``` + docker run -it -v /var/run/docker.sock:/var/run/docker.sock --rm openeuler/docker:{Tag} bash + ``` + +- Mount the Docker socket when starting your container + + When you run your container, make sure to mount the host machine's Docker socker: + ``` + docker run -it --rm \ + -v /var/run/docker.sock:/var/run/docker.sock \ + openeuler/docker:{Tag} bash + ``` + **Key Points:** + * `-v /var/run/docker.sock:/var/run/docker.sock:` This allows the container's Docker CLI to communicate with the host's Docker daemon. + * Docker is installed on the host machine. + +- Pull the `openeuler/openeuler:latest` image + + Inside the container, use the `./docker` CLI to pull the image from Docker Hub: + ``` + ./docker pull openeuler/openeuler:latest + ``` + +- Run the openEuler container + + Finally, run the openEuler image with an interactive terminal: + ``` + ./docker run -it --rm openeuler/openeuler:latest + ``` + * `-it:` Start an interactive terminal + * `--rm:` Automatically remove the container when it exits. + +# 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/docker/doc/image-info.yml b/Cloud/docker/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..5eda994ed96129746724023e2ba4204ad9194fd8 --- /dev/null +++ b/Cloud/docker/doc/image-info.yml @@ -0,0 +1,65 @@ +name: docker +category: cloud +description: Docker 是一个开源的容器化引擎，它通过将应用程序和运行所需的所有依赖打包到轻量级、可移植的容器中，实现了“一次构建，到处运行”。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[28.2.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/docker/28.2.1/24.03-lts-sp1/Dockerfile)| Docker 28.2.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/docker:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 通过交互式 Shell 启动容器，使用docker： + ``` + docker run -it --rm openeuler/docker:{Tag} bash + ``` + + - 挂载 `Docker Socket` 启动你的容器 + + 运行容器时，确保挂载宿主机的 Docker Socket： + ``` + docker run -it --rm \ + -v /var/run/docker.sock:/var/run/docker.sock \ + openeuler/docker:{Tag} bash + ``` + **要点:** + * `-v /var/run/docker.sock:/var/run/docker.sock:` 这允许容器内的 Docker CLI 与宿主机上的 Docker 守护进程通信。 + * 宿主机已安装docker + + - 拉取 `openeuler/openeuler:latest` 镜像 + + 进入容器后，使用 `./docker` CLI 从 Docker Hub 拉取镜像： + ``` + ./docker pull openeuler/openeuler:latest + ``` + + - 运行 openEuler 容器 + + 最后，使用交互式终端运行 openEuler 镜像： + ``` + ./docker run -it --rm openeuler/openeuler:latest + ``` + * `-it:` 启动交互式终端。 + * `--rm:` 容器退出后自动删除。 + +license: Apache-2.0 license +similar_packages: + - iSulad: iSulad 是 openEuler 社区自研的轻量级容器运行时，是一个面向 IoT 和云边端多场景的 轻量级 Daemonless 容器引擎。 +dependency: + - containerd + - runc + - iptables + - systemd diff --git a/Cloud/docker/doc/picture/logo.png b/Cloud/docker/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..6cb3eec4ad4104e4545b6bd5c10f195658b9a193 Binary files /dev/null and b/Cloud/docker/doc/picture/logo.png differ diff --git a/Cloud/kubernetes/README.md b/Cloud/kubernetes/README.md index 253c7dcd374d04fc5add07b2e0bb967cafda1e92..9d38b1ef1ee961c7f0deedefedeec6afa9b31f96 100644 --- a/Cloud/kubernetes/README.md +++ b/Cloud/kubernetes/README.md @@ -122,7 +122,10 @@ aarch64-host2 Ready 104s v1.20.2 ## Supported tags and respective Dockerfile links -- [v1.20.2-openEuler2109](./1.20.2/21.09/Dockerfile): kubernetes v1.20.2, openEuler 21.09 + | Tag | Currently | Architectures | + |--------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|---------------| + | [1.20.2-oe2109](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.20.2/21.09/Dockerfile) | kubernetes 1.20.2 on openEuler 21.09 | amd64, arm64 | + | [1.33.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.33.1/24.03-lts-sp1/Dockerfile) | kubernetes 1.33.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | ## Operating System diff --git a/Cloud/kubernetes/doc/image-info.yml b/Cloud/kubernetes/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..f9083e15291ff25d93db1214c00f0cbba4312504 --- /dev/null +++ b/Cloud/kubernetes/doc/image-info.yml @@ -0,0 +1,36 @@ +name: kubernetes +category: cloud +description: Kubernetes（简称 K8s）是 Google 开源的容器编排（Orchestration）系统，用于自动化容器化应用的部署、扩缩容、调度、服务发现和运维。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + kubernetes镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[1.33.1-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/kubernetes/1.33.1/24.03-lts-sp1/Dockerfile)| kubernetes 1.33.1 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/kubernetes:{Tag} + ``` + +usage: | + - 启动kubernetes实例 + + ``` + docker run -it --name kubernetes openeuler/kubernetes:{Tag} + ``` + `openeuler/使用kubernetes`镜像用于验证上游kubernetes版本和openEuler的集成。 + + +license: Apache-2.0 license +similar_packages: + - Docker Swarm: Docker 官方提供的轻量级容器编排工具。 +dependency: + - rsync + - golang diff --git a/Cloud/kubernetes/doc/picture/logo.png b/Cloud/kubernetes/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..3854a11da8b6c16eff4a89c599f7c5a24d475812 Binary files /dev/null and b/Cloud/kubernetes/doc/picture/logo.png differ diff --git a/Cloud/libvirt/README.md b/Cloud/libvirt/README.md new file mode 100644 index 0000000000000000000000000000000000000000..60d6c4762fdc98922d0f3a37ad3bd21582575b49 --- /dev/null +++ b/Cloud/libvirt/README.md @@ -0,0 +1,44 @@ +# Quick reference + +- The official Libvirt 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). + +# Libvirt | openEuler +Current Libvirt docker images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +Libvirt provides a portable, long term stable C API for managing the +virtualization technologies provided by many operating systems. It +includes support for QEMU, KVM, Xen, LXC, bhyve, Virtuozzo, VMware +vCenter and ESX, VMware Desktop, Hyper-V, VirtualBox and the POWER +Hypervisor. + +Learn more about Libvirt on [libvirt Website](https://libvirt.org)⁠. + +# Supported tags and respective Dockerfile links +The tag of each `libvirt` docker image is consist of the version of `libvirt` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|----------|-------------|------------------| +|[11.3.0-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/libvirt/11.3.0/24.03-lts-sp1/Dockerfile)| Libvirt 11.3.0 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/libvirt` image from docker + + ```bash + docker pull openeuler/libvirt:{Tag} + ``` + +- Start a libvirt instance + + ``` + docker run -it --rm openeuler/libvirt:{Tag} + ``` + The `openeuler/libvirt` image is used to verify the integration between the upstream libvirt version and openEuler. + +# 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/libvirt/doc/image-info.yml b/Cloud/libvirt/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..4af2e6a00cc6f341e322225518c23e4104e29347 --- /dev/null +++ b/Cloud/libvirt/doc/image-info.yml @@ -0,0 +1,42 @@ +name: libvirt +category: cloud +description: libvirt 是一个开源的虚拟化管理工具和API框架，用于管理和控制各种虚拟化技术，包括 KVM、QEMU、Xen、LXC 等。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + libvirt镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[11.3.0-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/libvirt/11.3.0/24.03-lts-sp1/Dockerfile)| libvirt 11.3.0 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/libvirt:{Tag} + ``` + +usage: | + - 启动libvirt实例 + + ``` + docker run -it --name libvirt openeuler/libvirt:{Tag} + ``` + `openeuler/使用libvirt`镜像用于验证上游libvirt版本和openEuler的集成。 + + +license: GPL-2+ +similar_packages: + - oVirt：基于 libvirt 的企业级虚拟化管理平台，提供完整的虚拟机管理和自动化功能。 +dependency: + - libpcap + - fuse3 + - libacl + - libtirpc + - libxslt + - libnl3 + - libcap + - python diff --git a/Cloud/libvirt/doc/picture/logo.png b/Cloud/libvirt/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..7e487ed09508b5a16c209e3d19c938a5b4249f00 Binary files /dev/null and b/Cloud/libvirt/doc/picture/logo.png differ diff --git a/Cloud/openvswitch/README.md b/Cloud/openvswitch/README.md new file mode 100644 index 0000000000000000000000000000000000000000..c92ef5b9f26f8f26951e0eafb36bbc5f049c36ac --- /dev/null +++ b/Cloud/openvswitch/README.md @@ -0,0 +1,103 @@ +# Quick reference + +- The official Open vSwitch 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). + +# Open vSwitch | openEuler +Current Open vSwitch images are built on the [openEuler](https://repo.openeuler.org/). This repository is free to use and exempted from per-user rate limits. + +Open vSwitch is a multilayer software switch licensed under the open source Apache 2 license. Our goal is to implement a production quality switch platform that supports standard management interfaces and opens the forwarding functions to programmatic extension and control. + +# Supported tags and respective dockerfile links +The tag of each `openvswitch` docker image is consist of the version of `openvswitch` and the version of basic image. The details are as follows + +| Tag | Currently | Architectures | +|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------|---------------| +| [3.5.0-oe2403sp1](https://gitee.com/openeuler/openeuler-openvswitch-images/blob/master/Cloud/openvswitch/3.5.0/24.03-lts-sp1/openvswitchfile) | Open vSwitch 3.5.0 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/openvswitch` image from docker + + ``` + docker pull openeuler/openvswitch:{Tag} + ``` + +- Run with an interactive shell + + You can also start the container with an interactive shell to use open vSwitch. + ``` + docker run -it --rm --privileged openeuler/openvswitch bash + ``` + The container should run in `--privileged` mode or wit `CAP_NET_ADMIN` and `CAP_SYS_MODULE` capabilities. + +- Create the OVS database directories + + ``` + mkdir -p /usr/local/etc/openvswitch + mkdir -p /usr/local/var/run/openvswitch + ``` + +- Initialize the OVS configuration database + + This command creates `conf.db` using the provided schema. + ``` + ovsdb-tool create /usr/local/etc/openvswitch/conf.db /usr/local/share/openvswitch/vswitch.ovsschema + ``` + +- Start the `ovsdb-server` process + + ``` + ovsdb-server \ + --remote=punix:/usr/local/var/run/openvswitch/db.sock \ + --remote=db:Open_vSwitch,Open_vSwitch,manager_options \ + --pidfile --detach + ``` + * `--remote=punix:...:` sets up a local UNIX socket for `ovs-vswitchd` to communicate. + * `--remote=db:...:` allows `ovs-vsctl` to modify the database. + * `--pidfile:` writes the process ID to a file. + * `--detach:` runs it in the background. + +- Initialize the OVS database + + This sets up the default Open vSwitch database tables if they don't exist. + ``` + ovs-vsctl --no-wait init + ``` + +- Start the `ovs-switchd` process + + This starts the main switching daemon, which talks to the kernel mode. + ``` + ovs-vswitchd unix:/usr/local/var/run/openvswitch/db.sock --pidfile --detach + ``` + +- Create a new birge + + Creates a new virtual switch brige named `br0`. + ``` + ovs-vsctl add-br br0 + ``` + +- Verify the brige + + ``` + ovs-vsctl show + ``` + + Sample output: + ``` + 8d72419a-06d6-491b-aac0-85554e26dca0 + Bridge br0 + Port br0 + Interface br0 + type: internal + ``` + This confirms the `br0` bridge was created successfully with an internal interface. + +# 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/openvswitch/doc/image-info.yml b/Cloud/openvswitch/doc/image-info.yml new file mode 100644 index 0000000000000000000000000000000000000000..2487f6ccbfae9c3243a272340a75dec6286831eb --- /dev/null +++ b/Cloud/openvswitch/doc/image-info.yml @@ -0,0 +1,104 @@ +name: openvswitch +category: cloud +description: Open vSwitch（简称 OVS） 是一个开源的多层虚拟交换机，用于为虚拟化环境（如 KVM、Xen、容器）提供灵活的网络转发和流表管理能力。 +environment: | + 本应用在Docker环境中运行，安装Docker执行如下命令 + ``` + yum install -y docker + ``` +tags: | + docker镜像的Tag由其版本信息和基础镜像版本信息组成，详细内容如下 + + | Tag | Currently | Architectures | + |----------|-------------|------------------| + |[3.5.0-oe2403sp1](https://gitee.com/openeuler/openeuler-docker-images/blob/master/Cloud/openvswitch/3.5.0/24.03-lts-sp1/Dockerfile)| Open vSwitch 3.5.0 on openEuler 24.03-LTS-SP1 | amd64, arm64 | + +download: | + 拉取镜像到本地 + ``` + docker pull openeuler/openvswitch:{Tag} + ``` + +usage: | + - 交互式shell启动进入容器中 + + 交互式 shell 启动容器来操作 Open vSwitch： + ``` + docker run -it --rm --privileged openeuler/openvswitch:{Tag} bash + ``` + 容器需要使用 `--privileged` 模式，或至少包含 `CAP_NET_ADMIN` 和 `CAP_SYS_MODULE` 权限。 + + - 创建 OVS 数据库目录 + + ``` + mkdir -p /usr/local/etc/openvswitch + mkdir -p /usr/local/var/run/openvswitch + ``` + + - 初始化 OVS 配置数据库 + + 使用指定的 schema 创建 `conf.db`： + ``` + ovsdb-tool create /usr/local/etc/openvswitch/conf.db /usr/local/share/openvswitch/vswitch.ovsschema + ``` + + - 启动 `ovsdb-server` 进程 + + ``` + ovsdb-server \ + --remote=punix:/usr/local/var/run/openvswitch/db.sock \ + --remote=db:Open_vSwitch,Open_vSwitch,manager_options \ + --pidfile --detach + ``` + **说明：** + * `--remote=punix:...` 为 ovs-vswitchd 设置本地 UNIX socket。 + * `--remote=db:...` 允许 ovs-vsctl 修改数据库。 + * `--pidfile` 写入 PID 文件。 + * `--detach` 后台运行。 + + - 初始化 OVS 数据库 + + 为 Open vSwitch 创建默认数据库表（如果还没有创建）： + ``` + ovs-vsctl --no-wait init + ``` + + - 启动 `ovs-vswitchd` 进程 + + 这会启动核心转发守护进程，与内核模块通信： + ``` + ovs-vswitchd unix:/usr/local/var/run/openvswitch/db.sock --pidfile --detach + ``` + + - 创建新网桥 + + 创建名为 `br0` 的虚拟交换机： + ``` + ovs-vsctl add-br br0 + ``` + + - 验证网桥 + + ``` + ovs-vsctl show + ``` + + 示例输出： + ``` + 8d72419a-06d6-491b-aac0-85554e26dca0 + Bridge br0 + Port br0 + Interface br0 + type: internal + ``` + 这表明 `br0` 网桥已成功创建，并带有一个内部接口。 + +license: Apache-2.0 license +similar_packages: + - Linux Bridge: Linux 自带的简单二层网桥，最基础的虚拟交换方式，配置简单但功能有限。 +dependency: + - libcap + - unbound + - nmap + - python3 + - openssl diff --git a/Cloud/openvswitch/doc/picture/logo.png b/Cloud/openvswitch/doc/picture/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..f24bc5f4f999203df992e943b50d040fae3abb68 Binary files /dev/null and b/Cloud/openvswitch/doc/picture/logo.png differ