diff options
Diffstat (limited to 'doc/integration/glab/index.md')
-rw-r--r-- | doc/integration/glab/index.md | 111 |
1 files changed, 7 insertions, 104 deletions
diff --git a/doc/integration/glab/index.md b/doc/integration/glab/index.md index aae04c36210..29cec231d51 100644 --- a/doc/integration/glab/index.md +++ b/doc/integration/glab/index.md @@ -1,108 +1,11 @@ --- -stage: Create -group: Code Review -info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments +redirect_to: '../../editor_extensions/gitlab_cli/index.md' +remove_date: '2023-10-31' --- -# GitLab CLI - `glab` +This document was moved to [another location](../../editor_extensions/gitlab_cli/index.md). -GLab is an open source GitLab CLI tool. It brings GitLab to your terminal: -next to where you are already working with Git and your code, without -switching between windows and browser tabs. - -- Work with issues. -- Work with merge requests. -- Watch running pipelines directly from your CLI. - -![command example](img/glabgettingstarted.gif) - -The GitLab CLI uses commands structured like `glab <command> <subcommand> [flags]` -to perform many of the actions you usually do from the GitLab user interface: - -```shell -# Sign in -glab auth login --stdin < token.txt - -# View a list of issues -glab issue list - -# Create merge request for issue 123 -glab mr for 123 - -# Check out the branch for merge request 243 -glab mr checkout 243 - -# Watch the pipeline in progress -glab pipeline ci view - -# View, approve, and merge the merge request -glab mr view -glab mr approve -glab mr merge -``` - -## Core commands - -- [`glab alias`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/alias) -- [`glab api`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/api) -- [`glab auth`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/auth) -- [`glab check-update`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/check-update) -- [`glab ci`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/ci) -- [`glab completion`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/completion) -- [`glab config`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/config) -- [`glab incident`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/incident) -- [`glab issue`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/issue) -- [`glab label`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/label) -- [`glab mr`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/mr) -- [`glab release`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/release) -- [`glab repo`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/repo) -- [`glab schedule`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/schedule) -- [`glab snippet`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/snippet) -- [`glab ssh-key`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/ssh-key) -- [`glab user`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/user) -- [`glab variable`](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source/variable) - -## Install the CLI - -Installation instructions are available in the GLab -[`README`](https://gitlab.com/gitlab-org/cli/#installation). - -## Authenticate with GitLab - -To authenticate with your GitLab account, run `glab auth login`. -`glab` respects tokens set using `GITLAB_TOKEN`. - -## Report issues - -Open an issue in the [`gitlab-org/cli` repository](https://gitlab.com/gitlab-org/cli/-/issues/new) -to send us feedback. - -## Related topics - -- [Install the CLI](https://gitlab.com/gitlab-org/cli/-/blob/main/README.md#installation) -- [Documentation](https://gitlab.com/gitlab-org/cli/-/tree/main/docs/source) -- Extension source code in the [`cli`](https://gitlab.com/gitlab-org/cli/) project - -## Troubleshooting - -### `glab completion` commands fail when using the 1Password shell plugin - -The [1Password shell plugin](https://developer.1password.com/docs/cli/shell-plugins/gitlab/) -adds the alias `glab='op plugin run -- glab'`, which can interfere with the `glab completion` -command. If your `glab completion` commands fail, configure your shell to prevent expanding aliases -before performing completions: - -- For Zsh, edit your `~/.zshrc` file and add this line: - - ```plaintext - setopt completealiases - ``` - -- For Bash, edit your `~/.bashrc` file and add this line: - - ```plaintext - complete -F _functionname glab - ``` - -For more information, see [issue 122](https://github.com/1Password/shell-plugins/issues/122) -for the 1Password shell plugin. +<!-- This redirect file can be deleted after <2023-10-31>. --> +<!-- Redirects that point to other docs in the same project expire in three months. --> +<!-- Redirects that point to docs in a different project or site (link is not relative and starts with `https:`) expire in one year. --> +<!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/redirects.html --> |