Skip to content

Commit eb9c753

Browse files
upd runner docs
1 parent 2af2486 commit eb9c753

File tree

1 file changed

+3
-18
lines changed

1 file changed

+3
-18
lines changed

_docs/administration/codefresh-runner.md

Lines changed: 3 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ codefresh auth create-context --api-key {API_KEY}
4444
```
4545

4646
You can obtain an API Key from your [user settings page](https://g.codefresh.io/user/settings).
47+
>**Note:** Make sure when you generate the token used to authenticate with the CLI, you generate it with *all scopes*.
4748
4849
>**Note:** access to the Codefresh CLI is only needed once during the Runner installation. After that, the Runner will authenticate on it own using the details provided. You do NOT need to install the Codefresh CLI on the cluster that is running Codefresh pipelines.
4950
@@ -1928,26 +1929,10 @@ steps:
19281929
19291930
## Troubleshooting
19301931
1931-
* **Problem:** You receive an error regarding the provided token or CLI context used for this installation might not have enough permissions.
1932-
* **Solution:** Make sure when you generate the token used to authenticate with the CLI, you generate it with *all scopes*.
1933-
1934-
* **Problem:** the cluster does not meet the minimum requirements (Kubernetes 1.10+, required memory/CPU on at least one single node, service account to create ClusterRoleBinding).
1935-
* **Solution:** install on a different cluster
1936-
1937-
* **Problem:** Node process crashes during the installation or installation gets stuck on “Executing pipeline.“
1938-
* **Solution:** Try to run the `codefresh runner init` command from a different terminal window or restart your machine and try again.
1939-
1940-
* **Problem:** Builds will not run.
1941-
* **Solution:** Check:
1942-
* That there is only one Codefresh Runner per Kubernetes namespace
1943-
* That you selected the correct runtime for the pipeline
1944-
* The CPU/Memory specification in the pipeline settings
1945-
1946-
* **Problem:** After installing the runner, your builds are stuck in the "pending" state and if you look at the runner pod logs you get the following message: `HTTP request to Codefresh API rejected. Status-Code: 401`
1947-
* **Solution:** You probably installed the runner in a namespace where there was previously another Codefresh runner. Delete the namespace and install the runner on a new namespace.
1932+
For troubleshooting refer to the [Knowledge Base](https://support.codefresh.io/hc/en-us/sections/4416999487762-Hybrid-Runner)
19481933
19491934
## What to read next
19501935
19511936
* [Codefresh installation options]({{site.baseurl}}/docs/administration/installation-security/)
1952-
* [Access Control]({{site.baseurl}}/docs/administration/access-control/)
1937+
* [Codefresh On-Premises]({{site.baseurl}}/docs/administration/codefresh-on-prem/)
19531938
* [Codefresh API]({{site.baseurl}}/docs/integrations/codefresh-api/)

0 commit comments

Comments
 (0)