Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/SUSE/registries-operator

A Kubernetes operator for images registries
https://github.com/SUSE/registries-operator

containers docker images kubernetes operator registries

Last synced: about 1 month ago
JSON representation

A Kubernetes operator for images registries

Host: GitHub
URL: https://github.com/SUSE/registries-operator
Owner: SUSE
License: apache-2.0
Archived: true
Created: 2018-11-02T10:04:38.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2019-01-23T19:51:31.000Z (over 5 years ago)
Last Synced: 2024-05-13T05:32:14.596Z (about 2 months ago)
Topics: containers, docker, images, kubernetes, operator, registries
Language: Go
Size: 156 KB
Stars: 12
Watchers: 16
Forks: 8
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-operators - kubic-project/registries-operator

README

        ![alpha](https://img.shields.io/badge/stability%3F-beta-yellow.svg)

[![CircleCI](https://circleci.com/gh/kubic-project/registries-operator/tree/master.svg?style=svg)](https://circleci.com/gh/kubic-project/registries-operator/tree/master)

[![Go Report Card](https://goreportcard.com/badge/github.com/kubic-project/registries-operator)](https://goreportcard.com/report/github.com/kubic-project/registries-operator)

[![Build Status Master branch](https://travis-ci.org/kubic-project/registries-operator.svg?branch=master)](https://travis-ci.org/kubic-project/registries-operator)

## Registry operator:

- [Description](#description)

- [Quickstart](#quickstart)

- [Devel](docs/devel.md)

- [Additional Info](#extra)

# Description

A Docker registries operator for Kubernetes, developed inside the [Kubic](https://en.opensuse.org/Portal:Kubic) project.

#### features:

* Automatic installation of registries certificates based on

some [CRD](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/)s.

# Quick start

* load the operator with

    ```

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

    ```

* once the operator is running, store the certificate for your registry in a _Secret_ with:

    ```

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

    ```

  where `/etc/pki/trust/anchors/SUSE_CaaSP_CA.crt` is the certificate and `suse-ca-crt` is the _Secret_.

* create a `Registry` object like this:

    ```yaml

    # registry.yaml

    apiVersion: "kubic.opensuse.org/v1beta1"

    kind: Registry

    metadata:

      name: suse-registry

      namespace: kube-system

    spec:

      hostPort: "registry.suse.de:5000"

      # secret with the ca.crt used for pulling images from this registry

      certificate:

        name: suse-ca-crt

        namespace: kube-system

    ```

    then you can load it with `kubectl apply -f registry.yaml`.

* once this is done, the `suse-ca-crt` should automatically appear in all

  the machines in your cluster, and all the Docker daemons in your cluster

  will be able to `pull` from that registry automatically.

# Devel

* See the [development documentation](docs/devel.md) if you intend to contribute to this project.

# Extra

* the [registries-operator image](https://hub.docker.com/r/opensuse/registries-operator/) in the Docker Hub.

* the [kubic-init](https://github.com/kubic-project/kubic-init) container, a container for

bootstrapping a Kubernetes cluster on top of [MicroOS](https://en.opensuse.org/Kubic:MicroOS)

(an openSUSE-Tumbleweed-based OS focused on running containers).

* the [Kubic Project](https://en.opensuse.org/Portal:Kubic) home page.