From 0699a0b58110f8221b8c008811f357b19180c00e Mon Sep 17 00:00:00 2001
From: Pedro Pombeiro <noreply@pedro.pombei.ro>
Date: Wed, 1 Nov 2023 10:46:24 +0000
Subject: [PATCH] Document known issue regarding runner token rotation

Changelog: changed
---
 doc/ci/runners/new_creation_workflow.md | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/doc/ci/runners/new_creation_workflow.md b/doc/ci/runners/new_creation_workflow.md
index bf05c1b8286a..022f7af11ec5 100644
--- a/doc/ci/runners/new_creation_workflow.md
+++ b/doc/ci/runners/new_creation_workflow.md
@@ -202,5 +202,22 @@ you can set it to any string - it will be ignored when `runner-token` is present
 
 ## Known issues
 
-- When you use the new registration workflow to register your runners with the Helm chart, the pod name is not visible
-  in the runner details page. For more information, see [issue 423523](https://gitlab.com/gitlab-org/gitlab/-/issues/423523).
+### Pod name is not visible in runner details page
+
+When you use the new registration workflow to register your runners with the Helm chart, the pod name is not visible
+in the runner details page.
+For more information, see [issue 423523](https://gitlab.com/gitlab-org/gitlab/-/issues/423523).
+
+### Runner authentication token does not update when rotated
+
+When you use the new registration workflow to register your runners with the GitLab Operator,
+the runner authentication token referenced by the Custom Resource Definition does not update when the token is rotated.
+This occurs when:
+
+- You're using a runner authentication token (prefixed with `glrt-`) in a secret
+  [referenced by a Custom Resource Definition](https://docs.gitlab.com/runner/install/operator.html#install-gitlab-runner).
+- The runner authentication token is due to expire.
+  For more information about runner authentication token expiration,
+  see [Authentication token security](configure_runners.md#authentication-token-security).
+
+For more information, see [issue 186](https://gitlab.com/gitlab-org/gl-openshift/gitlab-runner-operator/-/issues/186).
-- 
GitLab