From 1a9220cac53387ad4b67344ae1132d80cacb30d9 Mon Sep 17 00:00:00 2001
From: Daan De Meyer <daan.j.demeyer@gmail.com>
Date: Jun 15 2022 13:25:51 +0000
Subject: docs: Add instructions on how to update the CI on OpenShift


---

diff --git a/docs/internal/ci.md b/docs/internal/ci.md
index 65ec1dc..1b47835 100644
--- a/docs/internal/ci.md
+++ b/docs/internal/ci.md
@@ -1,15 +1,29 @@
+# CI
+
 SIG members can request access to the CentOS
 [OpenShift](https://console-openshift-console.apps.ocp.ci.centos.org/topology/ns/hyperscale)
 instance to run CI/CD jobs as needed.
 
+OpenShift can be configured either via the UI or via the "oc" CLI. The CLI is
+not packaged but can be downloaded [here](https://mirror.openshift.com/pub/openshift-v4/clients/ocp/latest/openshift-client-linux.tar.gz).
+
+To use the CLI, you'll need to login first. You can get the required token via
+the UI. First, login to OpenShift, then click on your username in the top right
+corner and click "copy login command", you'll then get a CLI command that you
+can use to login using the CLI.
+
 Currently we're running:
 
 - [systemd-git-update](https://pagure.io/centos-sig-hyperscale/systemd-releng/blob/main/f/systemd-git-update),
   a periodic task to keep our
   [systemd repo](https://pagure.io/centos-sig-hyperscale/systemd) in sync with
-  [upstream](https://github.com/systemd/systemd)
+  [upstream](https://github.com/systemd/systemd). To update to a new version,
+  run `oc start-build systemd-git-update --from-repo .` from the root of the
+  systemd-releng repository.
 - [systemd-cd](https://pagure.io/centos-sig-hyperscale/systemd-releng/blob/main/f/systemd-cd),
   a periodic task to kick off
   [builds on CBS](https://cbs.centos.org/koji/userinfo?userID=255)
-  for systemd based off the latest git changes
+  for systemd based off the latest git changes. To update to a new version,
+  run `oc start-build systemd-cd --from-repo .` from the root of the
+  systemd-releng repository.
 - a Jenkins instance that is currently unused