blackieops / rollingpin

👩‍🍳 Rolls out your containers.

🧑‍🍳 rollingpin

rollingpin is a small Go infrastructure service that receives webhooks from a container regsitry and updates corresponding Kubernetes deployments to facilitate minimal continuous delivery without complex CI/CD pipelines.

Currently, the only supported webhook source is from a Harbor Registry.

Usage

rollingpin is first and foremost a Kubernetes service, so the only supported usage is as a container in a Kubernetes pod.

Authorization

As rollingpin modifies Kubernetes resources, it needs to be authorized to take certain actions against the Kubernetes API. You'll need to set up a Service Account and a couple RBAC policies to allow this.

First, a service account:

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: rollingpin

Then, for each namespace you want rollingpin to access, you'll need to create a Role and RoleBinding. It is highly recommended to be as strict as possible, and to avoid using a ClusterRole if at all possible.

The only permissions needed are to get and update deployments.

---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: rollingpin-deploy
rules:
- apiGroups: ["apps/v1"]
  resources: ["deployments"]
  verbs: ["get", "update"]

# Create a RoleBinding in every namespace that rollingpin needs to have access
# to deployments.
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: rollingpin
  namespace: default
subjects:
- kind: ServiceAccount
  name: rollingpin
  apiGroup: ""
roleRef:
  kind: ClusterRole
  name: rollingpin-deploy
  apiGroup: rbac.authorization.k8s.io

Deployment

rollingpin is a stateless service; deploy it as you would any other container on Kubernetes. Just ensure you set the serviceAccountName in your pod spec to match the Service Account you created for rollingpin.

Containers can either by built yourself, or pulled from GitHub Packages:

ghcr.io/blackieops/rollingpin:v1.3.0

rollingpin's Issues

Support GitHub Packages

It would be advantageous to diversify the container registry support by adding support for GitHub webhooks, so containers pushed to GitHub Packages notify rollingpin.

Support Gitea

Gitea has a package repo that can host Docker containers. We should investigate what it would take to integrate with Gitea Packages/webhooks.