1.nh
  2.TH "GIT-BUG" "1" "Apr 2019" "Generated from git-bug's source code" ""
  3
  4.SH NAME
  5.PP
  6git-bug-bridge-new - Configure a new bridge
  7
  8
  9.SH SYNOPSIS
 10.PP
 11\fBgit-bug bridge new [flags]\fP
 12
 13
 14.SH DESCRIPTION
 15.PP
 16Configure 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.
 17
 18
 19.SH OPTIONS
 20.PP
 21\fB-n\fP, \fB--name\fP=""
 22	A distinctive name to identify the bridge
 23
 24.PP
 25\fB-t\fP, \fB--target\fP=""
 26	The target of the bridge. Valid values are [github,gitlab,jira,launchpad-preview]
 27
 28.PP
 29\fB-u\fP, \fB--url\fP=""
 30	The URL of the remote repository
 31
 32.PP
 33\fB-b\fP, \fB--base-url\fP=""
 34	The base URL of your remote issue tracker
 35
 36.PP
 37\fB-l\fP, \fB--login\fP=""
 38	The login on your remote issue tracker
 39
 40.PP
 41\fB-c\fP, \fB--credential\fP=""
 42	The identifier or prefix of an already known credential for your remote issue tracker (see "git-bug bridge auth")
 43
 44.PP
 45\fB--token\fP=""
 46	A raw authentication token for the remote issue tracker
 47
 48.PP
 49\fB--token-stdin\fP[=false]
 50	Will read the token from stdin and ignore --token
 51
 52.PP
 53\fB-o\fP, \fB--owner\fP=""
 54	The owner of the remote repository
 55
 56.PP
 57\fB-p\fP, \fB--project\fP=""
 58	The name of the remote repository
 59
 60.PP
 61\fB--non-interactive\fP[=false]
 62	Do not ask for user input
 63
 64.PP
 65\fB-h\fP, \fB--help\fP[=false]
 66	help for new
 67
 68
 69.SH EXAMPLE
 70.EX
 71# Interactive example
 72[1]: github
 73[2]: gitlab
 74[3]: jira
 75[4]: launchpad-preview
 76
 77target: 1
 78name [default]: default
 79
 80Detected projects:
 81[1]: github.com/git-bug/git-bug
 82
 83[0]: Another project
 84
 85Select option: 1
 86
 87[1]: user provided token
 88[2]: interactive token creation
 89Select option: 1
 90
 91You can generate a new token by visiting https://github.com/settings/tokens.
 92Choose 'Generate new token' and set the necessary access scope for your repository.
 93
 94The access scope depend on the type of repository.
 95Public:
 96	- 'public_repo': to be able to read public repositories
 97Private:
 98	- 'repo'       : to be able to read private repositories
 99
100Enter token: 87cf5c03b64029f18ea5f9ca5679daa08ccbd700
101Successfully configured bridge: default
102
103# For GitHub
104git bug bridge new \\
105    --name=default \\
106    --target=github \\
107    --owner=example-owner
108    --project=example-repo \\
109    --token=$TOKEN
110
111# For Launchpad
112git bug bridge new \\
113    --name=default \\
114    --target=launchpad-preview \\
115    --url=https://bugs.launchpad.net/ubuntu/
116
117# For Gitlab
118git bug bridge new \\
119    --name=default \\
120    --target=gitlab \\
121    --url=https://github.com/example-org/example-repo \\
122    --token=$TOKEN
123.EE
124
125
126.SH SEE ALSO
127.PP
128\fBgit-bug-bridge(1)\fP