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.PP
 71.RS
 72
 73.nf
 74# Interactive example
 75[1]: github
 76[2]: gitlab
 77[3]: jira
 78[4]: launchpad-preview
 79
 80target: 1
 81name [default]: default
 82
 83Detected projects:
 84[1]: github.com/a-hilaly/git-bug
 85[2]: github.com/git-bug/git-bug
 86
 87[0]: Another project
 88
 89Select option: 1
 90
 91[1]: user provided token
 92[2]: interactive token creation
 93Select option: 1
 94
 95You can generate a new token by visiting https://github.com/settings/tokens.
 96Choose 'Generate new token' and set the necessary access scope for your repository.
 97
 98The access scope depend on the type of repository.
 99Public:
100	- 'public_repo': to be able to read public repositories
101Private:
102	- 'repo'       : to be able to read private repositories
103
104Enter token: 87cf5c03b64029f18ea5f9ca5679daa08ccbd700
105Successfully configured bridge: default
106
107# For GitHub
108git bug bridge new \\
109    --name=default \\
110    --target=github \\
111    --owner=$(OWNER) \\
112    --project=$(PROJECT) \\
113    --token=$(TOKEN)
114
115# For Launchpad
116git bug bridge new \\
117    --name=default \\
118    --target=launchpad-preview \\
119    --url=https://bugs.launchpad.net/ubuntu/
120
121# For Gitlab
122git bug bridge new \\
123    --name=default \\
124    --target=github \\
125    --url=https://gitlab.com/git-bug/git-bug \\
126    --token=$(TOKEN)
127
128.fi
129.RE
130
131
132.SH SEE ALSO
133.PP
134\fBgit-bug-bridge(1)\fP