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/installation/gitops/gitops-values-yaml-validation.md
+4-4
Original file line number
Diff line number
Diff line change
@@ -79,9 +79,10 @@ global:
79
79
{% endhighlight %}
80
80
81
81
## Disable validation for custom/fine-grained Git tokens
82
-
When using token with custom scopes, or GitHub's fine-grained tokens (currently not officially supported by Codefresh), _skip token validation_ to avoid validation failures during installation.
82
+
When using token with custom scopes, or GitHub's fine-grained tokens (currently not officially supported by Codefresh), _for Runtime version v0.18.0 or lower, skip token validation_ to avoid validation failures during installation.
83
83
84
-
Add the `skipGitPermissionValidation` flag to your `values.yaml` file:
84
+
85
+
* Add the `skipGitPermissionValidation` flag to your `values.yaml` file:
85
86
86
87
```yaml
87
88
app-proxy:
@@ -105,6 +106,5 @@ where:
105
106
* `<version>` is the version of the runtime to install.
106
107
107
108
108
-
## Install first GitOps Runtime in account
109
-
If you are installing the first GitOps Runtime in your Codefresh account, follow the installation wizard for guided instructions.
Copy file name to clipboardExpand all lines: _docs/installation/gitops/runtime-troubleshooting.md
+23-26
Original file line number
Diff line number
Diff line change
@@ -4,10 +4,12 @@ description: "Review how to resolve issues during Runtime installation"
4
4
toc: true
5
5
---
6
6
7
-
7
+
## Troubleshooting Runtime installation
8
+
This article describes potential issues you may encounter when installing the GitOps Runtime, whether you're using an existing Argo CD instance or setting up a new one.
8
9
9
10
## Error: Job has reached the specified backoff limit
10
-
Before initiating the installation, Codefresh automatically validates the `values.yaml` file to verify that the supplied values are correct.
11
+
This error appears when you copy and run the Install Runtime command in the Runtime Installation wizard.
12
+
Before starting the installation, GitOps Cloud automatically validates the `values.yaml` file to ensure the supplied values are correct.
11
13
12
14
### Possible cause
13
15
Validation errors in your `values.yaml` file.
@@ -31,18 +33,18 @@ Validation errors in your `values.yaml` file.
31
33
32
34
33
35
## Error: failed converting helm release <runtime-name> to GitOops;...ISC repo not initialized
34
-
This error displayed when you try to Configure the Runtime as Argo CD Application.
36
+
This error appears when you try to Configure the Runtime as Argo CD Application in the Runtime Installation wizard.
35
37
36
38
### Possible cause
37
-
The Shared Configuration Repository (`ISC`) has been created but is not yet initialized.
39
+
The Shared Configuration Repository (`ISC`) has been created but is not yet initialized.
38
40
39
41
### Resolution
40
42
Wait a few seconds, and try again.
41
43
42
44
43
45
## Runtime timeout errors
44
-
One of these errors indicating a timeout:
45
-
*`Error: "unable to initialise Codefresh Client", "error": "secrets \"codefresh-token\" not found"`
46
+
One of these errors appear in the UI indicating a timeout after completing Runtime installation and configuration in the Runtime Installation wizard:
47
+
*`Error: "unable to initialize Codefresh Client", "error": "secrets \"codefresh-token\" not found"`
46
48
* For tunnel-based access mode, the `codefresh-tunnel-client` pod fails after installation.
47
49
* Pods failed error
48
50
@@ -68,45 +70,40 @@ The `--wait` flag in Install Runtime command controls how long the installation
68
70
69
71
70
72
## Invalid Git token error
73
+
This error appears in the UI after Runtime installation when all Runtime components including the Application Proxy (app-proxy) are up and running.
71
74
72
75
### Possible cause
73
-
Your token is invalid because of missing scopes
76
+
Your token is [invalid because of missing scopes](#check-token-scopes)
74
77
OR
75
-
You are using a fine-grained token or one with custom scopes
78
+
You are using a [fine-grained token or one with custom scopes](#skip-validation-for-fine-grained-github-tokens)
76
79
77
80
### Resolution
78
81
79
82
##### Check token scopes
83
+
1. Check the scopes for the Runtime token you provided during installation.
84
+
If you provided the same token as both the Runtime and user token, make sure the token has the additional scopes required.
85
+
1. If needed, generate a new PAT (Personal Access Token) with the correct scopes.
|**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>{:/}|
| **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
93
-
</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>{:/} |
93
+
|**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>{:/} |
|**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>{:/} |
104
+
|**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>{:/} |
105
+
106
+
110
107
111
108
112
109
<!--- ##### Ensure token formatting
@@ -184,6 +181,6 @@ global:
184
181
...
185
182
```
186
183
187
-
188
-
## Add Git Source failure
189
-
TBD
184
+
## Related articles
185
+
[Install GitOps Runtime with existing Argo CD]({{site.baseurl}}/docs/installation/gitops/runtime-install-with-existing-argo-cd/)
186
+
[Install GitOps Runtime with new Argo CD]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/)
0 commit comments