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/git-resolver.md
+13-12
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ This Resolver responds to type `git`.
12
12
|`repo`| The repository to find the resource in. Either `url`, or `repo` (with `org`) must be specified, but not both. |`pipeline`, `test-infra`|
13
13
|`org`| The organization to find the repository in. Default can be set in [configuration](#configuration). |`tektoncd`, `kubernetes`|
14
14
|`revision`| Git revision to checkout a file from. This can be commit SHA, branch or tag. |`aeb957601cf41c012be462827053a21a420befca``main``v0.38.2`|
15
-
|`pathInRepo`| Where to find the file in the repo. |`/task/golang-build/0.3/golang-build.yaml`|
15
+
|`pathInRepo`| Where to find the file in the repo. |`task/golang-build/0.3/golang-build.yaml`|
16
16
17
17
## Requirements
18
18
@@ -47,6 +47,8 @@ The `git` resolver has two modes: cloning a repository anonymously, or fetching
47
47
48
48
### Anonymous Cloning
49
49
50
+
Anonymous cloning is supported only for public repositories. This mode clones the full git repo.
51
+
50
52
#### Task Resolution
51
53
52
54
```yaml
@@ -90,6 +92,16 @@ spec:
90
92
91
93
### Authenticated API
92
94
95
+
The authenticated API supports private repositories, and fetches only the file at the specified path rather than doing a full clone.
96
+
97
+
When using the authenticated API, [providers with implementations in `go-scm`](https://github.com/jenkins-x/go-scm/tree/main/scm/driver) can be used.
98
+
Note that not all `go-scm` implementations have been tested with the `git` resolver, but it is known to work with:
99
+
* github.com and GitHub Enterprise
100
+
* gitlab.com and self-hosted Gitlab
101
+
* Gitea
102
+
* BitBucket Server
103
+
* BitBucket Cloud
104
+
93
105
#### Task Resolution
94
106
95
107
```yaml
@@ -135,17 +147,6 @@ spec:
135
147
value: Ranni
136
148
```
137
149
138
-
## What's Supported?
139
-
140
-
- When using anonymous cloning, only public repositories can be used.
141
-
- When using the authenticated API, [providers with implementations in `go-scm`](https://github.com/jenkins-x/go-scm/tree/main/scm/driver) can be used.
142
-
Note that not all `go-scm` implementations have been tested with the `git` resolver, but it is known to work with:
143
-
* github.com and GitHub Enterprise
144
-
* gitlab.com and self-hosted Gitlab
145
-
* Gitea
146
-
* BitBucket Server
147
-
* BitBucket Cloud
148
-
149
150
## `ResolutionRequest` Status
150
151
`ResolutionRequest.Status.Source` field captures the source where the remote resource came from. It includes the 3 subfields: `url`, `digest` and `entrypoint`.
0 commit comments