Common problems with Argo CD
When you add the integration
| What you see | What to do |
|---|---|
<host> refused the credentials (401). Check the token, and that it has not expired. | The token is wrong, revoked, expired (a token copied from a browser session lasts 24 h), truncated, or pasted with Bearer in front. Generate a new API token for a dedicated account (Create a token) and paste it alone. |
Astrolabe does not trust the security certificate of <host> (often an internal certificate of your company). | Argo CD uses a certificate signed by your company's own authority. Your Astrolabe administrator adds that authority to Astrolabe (see the Docker Hub installation guide). |
<host> refused the connection. Check the port, and that the service runs. | Wrong port, or Argo CD is down. Check the host and its port (argocd.example.com:8443). |
On the component page
| What you see | What to do |
|---|---|
| No Argo CD tab | Check the argocd/app-name annotation: one name only (lowercase letters, digits, - and .), no comma. Check that Argo CD is on in Administration › Plugins. |
| Argo CD switch greyed out, Configure the Argo CD integration first | No working Argo CD token. Add the integration. |
In the tab: The application <name> cannot be seen with your Argo CD token: check the argocd/app-name annotation, or what the token may read. | No application has that name, or the token's account may not read it: Argo CD answers the same in both cases. Compare the annotation with the name in Argo CD, then the account's policy.csv. |
When the tab says a module is missing
| What you see | What to do |
|---|---|
Astrolabe does not offer this Argo CD feature on this instance. and A module is missing from this Astrolabe installation. Tell your Astrolabe administrator. | The integration may be connected and the plugin on, but this installation of Astrolabe lacks the module that serves Argo CD. Tell your Astrolabe administrator. Nothing to change on the component. |
Not verified on an instance yet: this message needs an installation that lacks the module.
Still stuck?
Write to support@forgeit.fr with the name of the component and its Argo CD application.