opensuse/registries-operator

Docker Registries Operator 镜像文档

镜像概述

Docker Registries Operator是Kubernetes的Docker镜像仓库操作器，由Kubic项目开发，旨在简化Kubernetes集群中Docker镜像仓库的证书管理，确保集群内Docker守护进程能够顺利拉取镜像。

核心功能与特性

• 基于CRD自动安装证书：通过Kubernetes自定义资源定义（CRD）实现镜像仓库证书的自动安装与管理，无需手动配置节点证书。

使用场景

适用于Kubernetes集群环境，特别是需要配置私有或特定Docker镜像仓库时，自动管理仓库证书，确保集群中所有节点的Docker守护进程能够信任并拉取目标仓库的镜像。

快速开始

1. 加载操作器

通过以下命令部署完整的操作器资源：

bash
kubectl apply -f https://raw.githubusercontent.com/kubic-project/registries-operator/master/deployments/registries-operator-full.yaml

2. 创建证书Secret

将镜像仓库的CA证书存储在Kubernetes Secret中，示例命令如下（以SUSE CaaSP CA证书为例）：

bash
kubectl create secret generic suse-ca-crt --from-file=ca.crt=/etc/pki/trust/anchors/SUSE_CaaSP_CA.crt -n kube-system

• /etc/pki/trust/anchors/SUSE_CaaSP_CA.crt：证书文件路径
• suse-ca-crt：Secret名称
• -n kube-system：指定命名空间为kube-system

3. 创建Registry自定义资源

创建Registry对象CRD，定义镜像仓库配置，示例YAML文件（registry.yaml）：

yaml
apiVersion: "kubic.opensuse.org/v1beta1"
kind: Registry
metadata:
  name: suse-registry
  namespace: kube-system
spec:
  hostPort: "registry.suse.de:5000"  # 镜像仓库地址和端口
  certificate:
    name: suse-ca-crt  # 存储证书的Secret名称
    namespace: kube-system  # Secret所在命名空间

应用该配置：

bash
kubectl apply -f registry.yaml

4. 验证效果

操作器运行后，证书将自动分发到集群所有节点，Docker守护进程可自动拉取registry.suse.de:5000仓库的镜像。

开发相关

如需贡献代码，可参考开发文档。

额外信息

• Docker Hub镜像：https://hub.docker.com/r/opensuse/registries-operator/
• kubic-init容器：用于在MicroOS（基于openSUSE-Tumbleweed的容器优化操作系统）上引导Kubernetes集群的容器，详见https://github.com/kubic-project/kubic-init
• Kubic项目主页：Portal:Kubic