|
1 | 1 | --- |
2 | | -title:"Troubleshooting GitOpsRuntimes" |
| 2 | +title:"Troubleshooting GitOpsRuntime installation" |
3 | 3 | description:"Review how to resolve issues during Runtime installation" |
4 | 4 | toc:true |
5 | 5 | --- |
@@ -70,32 +70,39 @@ The `--wait` flag in Install Runtime command controls how long the installation |
70 | 70 | ##Invalid Git token error |
71 | 71 |
|
72 | 72 | ###Possible cause |
73 | | -Your token is invalid because of missing scopes, or you are using a fine-grained token or one with custom scopes. |
| 73 | +Your token is invalid because of missing scopes |
| 74 | +OR |
| 75 | +You are using a fine-grained token or one with custom scopes |
74 | 76 |
|
75 | 77 | ###Resolution |
76 | 78 |
|
77 | 79 | #####Check token scopes |
78 | 80 |
|
79 | 81 | **GitHub Git Runtime token** |
80 | | -| Type| Required scopes| |
81 | | -| ----------------------------|------------------------------| |
| 82 | +| Type| Required scopes| |
| 83 | +| --------| -----------------| |
82 | 84 | |**Classic**|{::nomarkdown}<ul><li><codeclass="highlighter-rouge">repo</code></li><li><codeclass="highlighter-rouge">admin:repo_hook</code></li></ul>{:/}| |
83 | 85 | |**Fine-grained** (personal or group-based) |{::nomarkdown}<ul><li>Repository access: <codeclass="highlighter-rouge">All repositories</code> or <codeclass="highlighter-rouge">Only select repositories</code> including all repos that Argo CD syncs from</li><li>Repository permissions:<ul><li>Administration: <codeclass="highlighter-rouge">Read and write</code></li><li>Commit statuses: <codeclass="highlighter-rouge">Read and write</code></li><li>Contents: <codeclass="highlighter-rouge">Read and write</code></li><li>Metadata: <codeclass="highlighter-rouge">Read-only</code></li><li>Pull requests: <codeclass="highlighter-rouge">Read and write</code></li><li>Webhooks: <codeclass="highlighter-rouge">Read and write</code></li></ul></li></ul></li> </ul>{:/} |
84 | | -**User token** |
| 86 | + |
85 | 87 |
|
86 | 88 | **GitHub Git user token** |
87 | | -| Type| Required scopes| |
88 | | -| ----------------------------|------------------------------| |
| 89 | +| Type| Required scopes| |
| 90 | +| ------------|-----------------| |
89 | 91 | |**Classic**|{::nomarkdown}<ul><li><codeclass="highlighter-rouge">repo</code></li></ul>{:/}| |
90 | 92 | |**Fine-grained**|{::nomarkdown}<ul><li>Repository access: <codeclass="highlighter-rouge">All repositories</code> or <codeclass="highlighter-rouge">Only select repositories</code></li><li>Repository permissions:<ul><li>Contents: <codeclass="highlighter-rouge">Read and write</code></li><li>Metadata: <codeclass="highlighter-rouge">Read-only</code></li></ul></li></ul></li></ul>{:/}| |
91 | 93 |
|
92 | 94 | <!--- ##### Ensure token formatting |
93 | 95 | Make sure the token is pasted without leading or trailing spaces.--> |
94 | 96 |
|
95 | 97 | #####Skip validation for fine-grained GitHub tokens |
96 | | -If using a custom-scope or fine-grained token, disable token validation to prevent failures. |
| 98 | +If using a custom-scope or fine-grained token and your_Runtime version is v0.18.0 or lower_, you must disable token validation to prevent failures. |
| 99 | + |
| 100 | +1. Check Runtime version: |
| 101 | +* In the Codefresh UI, on the toolbar, click the**Settings** icon. |
| 102 | +* From the sidebar, select**GitOps Runtimes**. |
| 103 | +* In the**Versionw** column, if the chart version is v0.18.0 or lower, continue with_step 2_. |
97 | 104 |
|
98 | | -* Add the`skipGitPermissionValidation` flag to your`values.yaml` file: |
| 105 | +1. Add the`skipGitPermissionValidation` flag to your`values.yaml` file: |
99 | 106 |
|
100 | 107 | ```yaml |
101 | 108 | app-proxy: |
|