You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _docs/integrations/git-providers.md
+27-26Lines changed: 27 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ Creating an account with Codefresh using one of the supported Git providers (Git
14
14
15
15
You can add repositories from the other git providers regardless of the one that you used for sign-up. For example, you can use GitLab to sign up with Codefresh, but still build repositories that exist in Bitbucket.
16
16
17
-
You can even add multiple accounts from each Git provider (if you have more than one) allowing you to use Codefresh as a central CI/CD solution that can access all yourgit repositories regardless of the backinggit provider.
17
+
You can even add multiple accounts from each Git provider (if you have more than one) allowing you to use Codefresh as a central CI/CD solution that can access all yourGit repositories regardless of the backingGit provider.
18
18
19
19
Currently Codefresh supports:
20
20
@@ -27,31 +27,31 @@ Currently Codefresh supports:
27
27
* Atlassian Stash (old version of Bibucket Server)
28
28
* Bitbucket Server (new version of Stash)
29
29
30
-
Atlassian Stash/Bitbucket server as well as the on-premises version ofGiTlab and GitHub are only available to Codefresh enterprise customers.
30
+
Atlassian Stash/Bitbucket server as well as the on-premises version ofGitLab and GitHub are only available to Codefresh enterprise customers.
31
31
32
32
33
-
##Adding moreGIT providers to your Codefresh Account
33
+
##Adding moreGit providers to your Codefresh Account
34
34
35
-
By default, you have direct access togit repositories that exist in theGIT provider that you used while signing up for Codefresh. You can easily create Codefresh projects that checkout code from thatGIT provider without any extra configurations.
35
+
By default, you have direct access toGit repositories that exist in theGit provider that you used while signing up for Codefresh. You can easily create Codefresh projects that checkout code from thatGit provider without any extra configurations.
36
36
37
-
To add additionalGIT providers, go to your Account Configuration, by clicking on*Account Settings* on the left sidebar. On the first section called*Integrations* click the*Configure* button next to*Git providers*.
37
+
To add additionalGit providers, go to your Account Configuration, by clicking on*Account Settings* on the left sidebar. On the first section called*Integrations* click the*Configure* button next to*Git providers*.
For eachgit provider you need to setup authentication, so Codefresh can get access to the public and private repositories of the respective platform.
52
+
For eachGit provider you need to setup authentication, so Codefresh can get access to the public and private repositories of the respective platform.
53
53
54
-
The easiest way to setup authentication is with OAuth2 if supported by thegit provider. You only need to name your integration
54
+
The easiest way to setup authentication is with OAuth2 if supported by theGit provider. You only need to name your integration
55
55
and Codefresh will automatically set it up once you accept the permissions required. If you have problems with OAuth2
56
56
or the provider does not support it, you need to manually create credentials by yourself in your git account and then enter them into Codefresh.
57
57
@@ -87,7 +87,7 @@ you used GitHub when you [created your Codefresh account]({{site.baseurl}}/docs/
87
87
88
88
For the**Access Token** method you need
89
89
90
-
* A friendly name for thegit context (it can be anything you want)
90
+
* A friendly name for theGit context (it can be anything you want)
91
91
* An access token
92
92
93
93
>Note that the access token for an organization should be created by somebody who has**Owner** role and not just**Member** role.
@@ -97,7 +97,7 @@ sidebar. Then select *Personal access tokens* from the left menu.
97
97
For more information see the[GitHub Documentation page](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/){:target="_blank"}
98
98
99
99
The "token description" you enter in your GitHub account in order to create the token is completely arbitrary (use "Codefresh" for an example). Once you have the token, paste it in the Codefresh UI and click*Test connection*. If everything is OK, you can
100
-
now save thegit integration.
100
+
now save theGit integration.
101
101
102
102
The minimum permissions for the token are:
103
103
-`repo.*`
@@ -127,8 +127,9 @@ For example if you already have a `token` on a resource call `git-credentials` y
127
127
When the admin clicks off "Allow access to all users" another toggle appears; “Allow these credentials to be shared within a pipeline for cloning a repository“
128
128
1. When its turned on, the user that runs a pipeline will be able to clone the repo.
129
129
2. When its turned off, the user that runs a pipeline cannot use this integration.
130
-
In both cases, the user cannot decrypt the token used in git integration with CLI or API.
131
-
Important note: The credentials will be shared only to clone repo using an official git-clone step
130
+
In both cases, the user cannot decrypt the token used in Git integration with CLI or API.
131
+
132
+
>Important note: The credentials will be shared only to clone repos using an official git-clone step
132
133
133
134
##GitHub-App
134
135
@@ -162,7 +163,7 @@ Also from the URL of the browser note the ending number (this is your installati
162
163
For the required fields use:
163
164
164
165
***Installation id** - found in step 5
165
-
***Appid** - found in step 3
166
+
***AppID** - found in step 3
166
167
***Private key** - the contents of the file your created in step 3 (but convert it to base64 first)
167
168
168
169
Click*Test connection* to verify your integration and apply your changes with the*Save* button. If enabled in your account you can setup[Pipeline definition restrictions]({{site.baseurl}}/docs/administration/access-control/#pipeline-definition-restrictions) by expanding the*YAML Options* segment.
@@ -175,7 +176,7 @@ you used GitLab when you [created your Codefresh account]({{site.baseurl}}/docs/
175
176
176
177
For the**Access Key** method you need:
177
178
178
-
* A friendly name for thegit context (it can be anything you want.)
179
+
* A friendly name for theGit context (it can be anything you want.)
179
180
* An access token/key
180
181
181
182
@@ -185,7 +186,7 @@ For more information see the [GitLab Documentation page](https://docs.gitlab.com
185
186
The name you enter in order to create the token in the GitLab UI is completely arbitrary (use "Codefresh" for an example)
186
187
187
188
Once you have the token, paste it in the Codefresh UI and click*Test connection*. If everything is OK can
188
-
now save thegit integration.
189
+
now save theGit integration.
189
190
190
191
For GitLab on-premises you also need to provide the URL of the GitLab server in your organization. If enabled in your account you can setup[Pipeline definition restrictions]({{site.baseurl}}/docs/administration/access-control/#pipeline-definition-restrictions) by expanding the*YAML Options* segment.
191
192
@@ -204,7 +205,7 @@ you used Bitbucket when you [created your Codefresh account]({{site.baseurl}}/do
204
205
205
206
For the**Application Password** method you need:
206
207
207
-
* A friendly name for thegit context (It can be anything you want.)
208
+
* A friendly name for theGit context (It can be anything you want.)
208
209
* The name of your Bitbucket account/email address
209
210
* A Bitbucket application password
210
211
@@ -223,7 +224,7 @@ alt="Bitbucket permissions"
223
224
%}
224
225
225
226
The "label" you enter in your Bitbucket account in order to create the application password is completely arbitrary (use "Codefresh" for an example). Once you have the token, paste it in the Codefresh UI and click*Test connection*. If everything is OK you can
226
-
now save thegit integration.
227
+
now save theGit integration.
227
228
228
229
If enabled in your account you can setup[Pipeline definition restrictions]({{site.baseurl}}/docs/administration/access-control/#pipeline-definition-restrictions) by expanding the*YAML Options* segment.
229
230
@@ -247,7 +248,7 @@ On the screen that will appear click the *New token* Button. Enter an arbitrary
247
248
Select an expiration date for your token
248
249
249
250
>At the time of writing Azure DevOps does not have the option to create a token that is valid for ever. Choose a large
250
-
time period and make sure that you have a policy in place for renewing your tokens so that Codefresh can continue to read yourGIT repo.
251
+
time period and make sure that you have a policy in place for renewing your tokens so that Codefresh can continue to read yourGit repo.
251
252
252
253
{% include image.html
253
254
lightbox="true"
@@ -320,24 +321,24 @@ with the same syntax [shown in pipelines]({{site.baseurl}}/docs/configure-ci-cd-
320
321
For example if you already have a`token` on a resource call`git-credentials` you can put in the token field the expression {% raw %}`${{secrets.git-credentials@token}}`{% endraw %}.
321
322
322
323
323
-
##Using yourgit provider
324
+
##Using yourGit provider
324
325
325
-
Once your provider is active, you can add a new project into Codefresh and then during the[repository selection screen]({{site.baseurl}}/docs/getting-started/create-a-basic-pipeline/) you will have access to the additionalgit providers.
326
+
Once your provider is active, you can add a new project into Codefresh and then during the[repository selection screen]({{site.baseurl}}/docs/getting-started/create-a-basic-pipeline/) you will have access to the additionalGit providers.
326
327
327
328
{% include image.html
328
329
lightbox="true"
329
330
file="/images/integrations/git/select-git.png"
330
331
url="/images/integrations/git/select-git.png"
331
332
max-width="60%"
332
-
caption="SelectGIT provider"
333
-
alt="SelectGIT provider"
333
+
caption="SelectGit provider"
334
+
alt="SelectGit provider"
334
335
%}
335
336
336
337
>Notice that for all supported Git providers Codefresh will automatically create all the webhooks needed for
337
338
triggering pipelines when a commit (or another event) happens.
338
339
339
-
After adding the repository Codefresh will behave exactly the same, regardless of the selectedgit provider.
340
-
You will be able to[create pipelines]({{site.baseurl}}/docs/configure-ci-cd-pipeline/pipelines/) for differentgit providers in exactly the same manner.
340
+
After adding the repository Codefresh will behave exactly the same, regardless of the selectedGit provider.
341
+
You will be able to[create pipelines]({{site.baseurl}}/docs/configure-ci-cd-pipeline/pipelines/) for differentGit providers in exactly the same manner.