Review and update cli documentation for working with self managed instances
There has been some issues raised that indicate that using glab
with self-managed instances is not straight-forward.
The purpose of this issue is to test out the current documentation and modify if there are inaccuracies or additions needed.
Some current relevant documentation: https://gitlab.com/gitlab-org/cli#authentication
Consider two use cases:
- A user who only uses their self-managed instance
- A user who uses gitlab.com AND uses their self-managed instance
Issue template changes: Add additional checks for self-managed instances
- instruction for getting gitlab version
- check access token using api (if 401)
Related issues:
-
#1229 (comment 1276612963) -> !1194 (merged) -
#1235 (comment 1276725523) -> misleading error message that would can effect self-managed instances improved -
Issue template improvements for self managed !1194 (merged) -
#1248 (closed) -
#1220 (comment 1271200669) -
#1236 -
#1236 (comment 1290682842) -
#1073 (comment 1138892801) <- possibly needs to be added to documentation -
#1233 (comment 1298012856) <-confusing workflow for self-managed user -> I believe this is addressed in !1194 (merged) -
#1258 better error message -
Add example config for self managed instance !1194 (merged)
Issues raised to improve self-managed experience:
Note: may also need to consider OnePassword plugin if relevant
Edited by Jay McCure