Title: docs(tutorials/gitlab_ci): document Project Access Token (HTTPS) workflow by bearomorphism · Pull Request #1963 · commitizen-tools/commitizen · GitHub
Open Graph Title: docs(tutorials/gitlab_ci): document Project Access Token (HTTPS) workflow by bearomorphism · Pull Request #1963 · commitizen-tools/commitizen
X Title: docs(tutorials/gitlab_ci): document Project Access Token (HTTPS) workflow by bearomorphism · Pull Request #1963 · commitizen-tools/commitizen
Description: Description Closes #482. The current utorials/gitlab_ci/ page only documents how to bump versions from a GitLab CI pipeline using SSH keys + a deploy key. The issue requested an alternative path that does not require SSH (no key generation, no deploy key) and that demonstrates running specific jobs per release vs. per tag. This PR keeps the existing SSH walkthrough intact and adds a parallel section for GitLab Project Access Tokens (HTTPS): Adds an Authentication options summary that points at both the SSH and Access Token paths. Renames the existing instructions to Option A: SSH key for clarity. Adds Option B: Project Access Token (HTTPS) covering: creating the token (Settings > Access Tokens, write_repository, Developer role), exposing it as a masked CI/CD variable (GITLAB_TOKEN), allowing the token's bot user to push to protected branches/tags, a complete .gitlab-ci.yml example that: tests on every branch / MR but skips the bump commit, runs cz bump only on the default branch using oauth2:@… for HTTPS pushes, has a separate release job that only runs on tag pipelines (so packaging / publishing only happens once per tag, as the issue asked). Adds notes about CI_JOB_TOKEN not being usable for repository writes, Group / Personal Access Tokens being valid alternatives, bump_message loops, and token rotation. Checklist Updated documentation only — no code changes. uv run mkdocs build --strict passes locally with no warnings. Pre-commit hooks pass (codespell, blacken-docs, trailing whitespace, EOF, commitizen check). No CHANGELOG / version bumps (auto-managed). Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com
Open Graph Description: Description Closes #482. The current utorials/gitlab_ci/ page only documents how to bump versions from a GitLab CI pipeline using SSH keys + a deploy key. The issue requested an alternative path t...
X Description: Description Closes #482. The current utorials/gitlab_ci/ page only documents how to bump versions from a GitLab CI pipeline using SSH keys + a deploy key. The issue requested an alternative path t...
Opengraph URL: https://github.com/commitizen-tools/commitizen/pull/1963
X: @github
Domain: github.com
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:9efdff00-c95a-49ad-9480-fcf92a049644 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | EB64:1AF143:86A79A:8ABA4B:6A638408 |
| html-safe-nonce | a80f31652b0657127c3b5114a8db15373038422a9ead576a825e1ee6fa69b4fb |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFQjY0OjFBRjE0Mzo4NkE3OUE6OEFCQTRCOjZBNjM4NDA4IiwidmlzaXRvcl9pZCI6IjgzOTAyMjU2MDY3Mjc2NjQ2NDgiLCJyZWdpb25fZWRnZSI6InNlYSIsInJlZ2lvbl9yZW5kZXIiOiJzZWEifQ== |
| visitor-hmac | cefd2d5a1d2af19807e6f6a42f200a1c1cc49cba39601aa62bab1445b8325411 |
| hovercard-subject-tag | pull_request:3654543878 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/commitizen-tools/commitizen/pull/1963/files |
| twitter:image | https://avatars.githubusercontent.com/u/26526132?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/26526132?s=400&v=4 |
| og:image:alt | Description Closes #482. The current utorials/gitlab_ci/ page only documents how to bump versions from a GitLab CI pipeline using SSH keys + a deploy key. The issue requested an alternative path t... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | e4fb64aef87da454ec25b158147f7f5f14aef29216e5ca1612c2e48faa599d1f |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/commitizen-tools/commitizen git https://github.com/commitizen-tools/commitizen.git |
| octolytics-dimension-user_id | 62252524 |
| octolytics-dimension-user_login | commitizen-tools |
| octolytics-dimension-repository_id | 106127589 |
| octolytics-dimension-repository_nwo | commitizen-tools/commitizen |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 106127589 |
| octolytics-dimension-repository_network_root_nwo | commitizen-tools/commitizen |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | e839936ba5faffb9c836dda1cf4729d50c88a32e |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width