git-bug_bridge_configure.md

  1## git-bug bridge configure
  2
  3Configure a new bridge.
  4
  5### Synopsis
  6
  7	Configure a new bridge by passing flags or/and using interactive terminal prompts. You can avoid all the terminal prompts by passing all the necessary flags to configure your bridge.
  8
  9```
 10git-bug bridge configure [flags]
 11```
 12
 13### Examples
 14
 15```
 16# Interactive example
 17[1]: github
 18[2]: gitlab
 19[3]: jira
 20[4]: launchpad-preview
 21
 22target: 1
 23name [default]: default
 24
 25Detected projects:
 26[1]: github.com/a-hilaly/git-bug
 27[2]: github.com/MichaelMure/git-bug
 28
 29[0]: Another project
 30
 31Select option: 1
 32
 33[1]: user provided token
 34[2]: interactive token creation
 35Select option: 1
 36
 37You can generate a new token by visiting https://github.com/settings/tokens.
 38Choose 'Generate new token' and set the necessary access scope for your repository.
 39
 40The access scope depend on the type of repository.
 41Public:
 42	- 'public_repo': to be able to read public repositories
 43Private:
 44	- 'repo'       : to be able to read private repositories
 45
 46Enter token: 87cf5c03b64029f18ea5f9ca5679daa08ccbd700
 47Successfully configured bridge: default
 48
 49# For Github
 50git bug bridge configure \
 51    --target=github \
 52    --login==$(LOGIN) \
 53    --owner==$(OWNER) \
 54    --project==$(PROJECT) \
 55    --token=$(TOKEN) \
 56    --url=https://github.com/MichaelMure/git-bug \
 57
 58
 59# For Gitlab
 60git bug bridge configure \
 61    --target=gitlab \
 62    --login==$(LOGIN) \
 63    --token=$(TOKEN) \
 64    --url=https://gitlab.com/gitlab-org/gitlab \
 65
 66
 67# For Jira
 68git bug bridge configure \
 69    --target=jira \
 70    --login==$(LOGIN) \
 71    --project==$(PROJECT) \
 72
 73
 74# For Launchpad-Preview
 75git bug bridge configure \
 76    --target=launchpad-preview \
 77    --project==$(PROJECT) \
 78    --url=https://bugs.launchpad.net/ubuntu/ \
 79
 80```
 81
 82### Options
 83
 84```
 85  -n, --name string         A distinctive name to identify the bridge
 86  -t, --target string       The target of the bridge. Valid values are [github,gitlab,jira,launchpad-preview]
 87  -u, --url string          The URL of the remote repository
 88  -b, --base-url string     The base URL of your remote issue tracker
 89  -l, --login string        The login on your remote issue tracker
 90  -c, --credential string   The identifier or prefix of an already known credential for your remote issue tracker (see "git-bug bridge auth")
 91      --token string        A raw authentication token for the remote issue tracker
 92      --token-stdin         Will read the token from stdin and ignore --token
 93  -o, --owner string        The owner of the remote repository
 94  -p, --project string      The name of the remote repository
 95  -h, --help                help for configure
 96```
 97
 98### SEE ALSO
 99
100* [git-bug bridge](git-bug_bridge.md)	 - Configure and use bridges to other bug trackers.
101