This is an original planning guide. It is not a vendor manual, an official standard, or legal advice. Example addresses use documentation ranges. Review every command before you paste it.
What this hour is for
GitLab CI Troubleshooting Guide is one failed job on GitLab CI in a repository you administer. This page does not name a browser tool. The pillar it belongs to links the calculators for the neighbouring work.
Write the job name, the branch, and the first error line. Redact secrets before the log goes in the ticket. Do not rerun the job during the reading. Do not disable branch protection to make it green.
If the same read fails twice, stop. A change to the workflow waits for the how-to that owns that pipeline.
192.0.2.10/24, gateway 192.0.2.1, 198.51.100.0/24, 203.0.113.0/24, and 2001:db8::/32 are documentation. example.com is a documentation name. A sample password is replaced. It is not a password you keep. 10.0.0.0/16 is a sample prefix, not a network you publish unless you already use it.
The change you can finish
Apply nothing while you are writing the note. When the lab window opens, it is one change on the account named in the ticket. Read the draft, then the account, then decide.
Rollback is the previous file, the previous plan, or the lab resource you can delete because it was only a lab.
- Write the job name and the branch.
- Confirm you administer the repository.
- Read the first error line.
- Redact secrets.
- Do not rerun the job during the reading.
- Stop, or hand one change to the how-to.
Mistakes that outlive the statement
GitLab CI troubleshooting goes wrong in a small set of ways. The list is here so the ticket can forbid them before the window.
- A secret left in the pasted log.
- Branch protection disabled to get a green run.
- The job rerun during the reading.
- A repository you do not administer.
- Several unrelated failures and no sentence.
Decisions to write down
One decision for GitLab CI troubleshooting: The failure is one sentence. The repository is yours. The first action is a read. Secrets are redacted. And branch protection stayed on.
Checks before you call it done
Confirm this before you call the change done: The job name is written. The error line is in the ticket. Secrets are redacted. The job was not rerun. And branch protection is still on. If one of those fails, stop.
# Troubleshoot by reading.
# GitLab CI.
# Redact secrets. Do not rerun during the reading.
# 192.0.2.10/24, gateway 192.0.2.1, 198.51.100.0/24, 203.0.113.0/24, and 2001:db8::/32 are documentation. example.com is a documentation name. A sample password is replaced. It is not a password you keep. 10.0.0.0/16 is a sample prefix, not a network you publish unless you already use it.Before you leave the account
GitLab CI Troubleshooting Guide ends when the account in the note is the account in the ticket. If it is not, stop.
The draft stays a draft until a person has read the names in it. A generator does not log in, does not apply, and does not scan.
192.0.2.10/24, gateway 192.0.2.1, 198.51.100.0/24, 203.0.113.0/24, and 2001:db8::/32 are documentation. example.com is a documentation name. A sample password is replaced. It is not a password you keep. 10.0.0.0/16 is a sample prefix, not a network you publish unless you already use it.
prompt-for-this is a reminder that a secret is missing. It is not an access key, a token, or a password you save. An Azure secret draft may contain a sample password. Replace it. Do not file it.
One change is the window. If two things move and the result is wrong, you will not know which one did it.
If the same step fails twice, stop for the day. Restore the copy you took first.
A second person reads the account and the change aloud. If they cannot find them in the ticket, the note is not done.
This page is a planning guide. It is not a vendor manual, not an official standard, not legal advice, and not an audit opinion. You do not apply it against an account you do not administer.
Tools for this guide
This guide does not name a browser tool. The pillar it belongs to links the calculators for the neighbouring work.
Related pillar guides
More in this cluster
The pillar for this page, and the next published pages filed with it.