Create SSoT doc page for CI_JOB_TOKEN feature
Problem
The CI_JOB_TOKEN CI/CD variable allows CI jobs to authenticate without exposing PAT or other sensitive tokens. We recently worked on enhancing the security of this feature. In that occasion we didn't have a dedicated page for CI_JOB_TOKEN feature and we added it were other information about this feature already existed: in API Docs
page, which is very generic. We then realized that we needed a troubleshooting section for this feature since users could see some pipeline failures and they would need to understand why and how to fix those errors.
Solution
Create a dedicate page for the CI job token feature, including the security setting of the job token scope, troubleshooting guide, etc. Ensure references of CI_JOB_TOKEN in the docs are linked to this SSoT page we users can learn anything they need to know about CI job token.
Steps:
-
Create ci/jobs/ci_job_token.md
and move details inapi/index.md
to there. -
Move details in ci/triggers/index.md
to new doc. -
Add doc to nav. -
Add troubleshooting details for token scope feature.
Related
- Related to #332272 (closed)
- Related to #35067 (comment 665419050)