​
Versions prises en charge

Version 2022.3 ou ultérieure.
  • JetBrains Fleet ou ReSharper ne sont pas pris en charge
  • La connexion SSH à distance n’est pas prise en charge.

​
Collecte des logs de l’extension

À partir de la version 1.10.0 de l’extension, le panneau Chat inclut un bouton Diagnostics de l’extension sur la page Paramètres. Ce bouton collecte automatiquement les logs et les paramètres pertinents dans un fichier texte téléchargeable. Pour les versions antérieures de l’extension :
  1. Les logs sont écrits dans le fichier idea.log. Pour localiser ce fichier, allez dans le menu Help > Show Log in Finder/Explorer
  2. Exportez ou copiez les logs

​
Comment réinitialiser ou modifier votre URL Enterprise

  1. Accédez à Tools → Codeium Enterprise → Reset Codeium Enterprise Updater.
  2. Saisissez la nouvelle URL en veillant à ce qu’il n’y ait pas d’espace au début ni à la fin.
  3. Redémarrez votre IDE.
  4. Après le redémarrage, vous serez invité à vous connecter.

​
Problèmes connus de l’IDE et solutions

​
Cascade ne fonctionne pas (ou le plugin Windsurf ne fonctionne pas du tout)

Si le plugin Windsurf pour JetBrains ne fonctionne pas, une bonne première étape consiste à tenter de le réinitialiser via Help > Find Action > Reset Windsurf Enterprise Updater. Si le problème ne touche que quelques utilisateurs, il est probable que le certificat de l’URL de domaine Enterprise ne soit pas chargé dans votre IDE. L’administrateur de votre équipe saura comment procéder.

​
Cascade ne s’affiche pas

En général, vous verrez l’erreur suivante dans les logs : 
JCEF n'est pas pris en charge dans cet environnement ou l'initialisation a échoué
ou 
JCEF interne non pris en charge, tentative avec JCEF externe
JCEF est le composant navigateur nécessaire pour afficher Cascade. Pour corriger ce problème, allez dans Help > Find Actions > Choose Java Boot Runtime et choisissez un runtime incluant JCEF. Si JCEF est déjà inclus dans votre runtime, il se peut qu’il soit désactivé dans votre registre/propriétés. Modifiez vos propriétés : Help > Edit Custom Properties, ajoutez l’indicateur suivant et redémarrez votre IDE : 
ide.browser.jcef.enabled=true

​
Problèmes de certificat

Si vous rencontrez les erreurs suivantes : 
Échec de la récupération de l'URL de base de l'extension à <YourDomainURL>

Échec de la construction du chemin PKIX : sun.security.provider.certpath.SunCertPathBuilderException : 
impossible de trouver un chemin de certification valide vers la cible demandée
Cela suggère que l’extension Codeium ne parvient pas à faire confiance à la connexion TLS à votre portail/serveur d’API d’entreprise, car elle ne fait pas confiance au certificat présenté. Cela signifie soit que le certificat présenté par le déploiement Codeium n’est pas approuvé, soit qu’un certificat présenté par un proxy d’entreprise interceptant la requête ne l’est pas. Dans les deux cas, la solution à privilégier consiste à s’assurer que le certificat racine ayant signé ce certificat est correctement installé sur les machines des utilisateurs finaux à l’emplacement approprié. Les IDE JetBrains et la plupart des autres IDE chargent les certificats à partir de l’emplacement par défaut du système d’exploitation. Votre certificat est émis et géré par votre équipe Informatique ou Admin locale. Veuillez la contacter pour obtenir de l’aide concernant l’installation des certificats nécessaires sur votre système. Il est important que la chaîne de certification complète soit présentée à l’endroit où le TLS est terminé. Souvent, si seul le certificat feuille est présenté, l’IDE JetBrains et d’autres IDE ne peuvent pas en vérifier l’authenticité, car ils ne connaissent pas le certificat intermédiaire qui valide le certificat feuille et qui est lui-même validé par le certificat racine. Les navigateurs parviennent souvent à contourner ce problème, car les utilisateurs auront probablement consulté un autre site Web qui présente la chaîne de certification complète, de sorte que le certificat intermédiaire est vu et mis en cache, mais des applications comme les IDE JetBrains n’ont pas cet avantage. Note : Dans les produits de la famille JetBrains 2024.3 un bug a été introduit empêchant l’IDE d’accepter les certificats du système d’exploitation (JetBrains issue report). Pour résoudre ce problème, les utilisateurs peuvent effectuer l’une des actions suivantes :
  • Revenir à des versions antérieures des produits JB
  • Utiliser la version 2024.3.1 preview (version bêta)
  • Ajouter -Djavax.net.ssl.trustStoreType=Windows-ROOT en tant qu’option JVM personnalisée

​
Espaces de travail personnalisés

Si vous voyez l’erreur suivante lors de l’utilisation de Cascade : 
Cascade ne peut pas accéder aux chemins sans workspace actif
Cela indique que Cascade doit accéder à un workspace personnalisé pour fonctionner correctement. Pour résoudre ce problème :
  1. Ouvrez les paramètres de votre IDE JetBrains via File > Settings (ou IntelliJ IDEA > Preferences sur macOS)
  2. Accédez à Tools > Windsurf Settings
  3. Dans le panneau Windsurf Settings, repérez la section “Custom Workspaces” en bas
  4. Cliquez sur le bouton “Add Workspace” pour ajouter le workspace de votre projet
  5. Sélectionnez le répertoire du workspace approprié pour votre projet
  6. Cliquez sur “OK” pour appliquer les paramètres
  7. Redémarrez votre IDE pour que les modifications prennent effet

​
Comportement Enterprise vs non‑Enterprise

Le comportement des workspaces personnalisés varie selon votre type d’utilisateur :

​
Utilisateurs Enterprise

Les utilisateurs Enterprise disposent d’un contrôle granulaire sur l’indexation du workspace :
  • Lors de l’ajout de workspaces, une case à cocher permet d’activer l’indexation pour chaque workspace
  • Seuls les workspaces dont la case est cochée seront indexés et accessibles à Cascade
  • Cela vous permet de maîtriser quels workspaces consomment des ressources d’indexation
  • Par sécurité, les appels d’outils sont limités au workspace actif

​
Utilisateurs non‑Enterprise

Les utilisateurs non‑Enterprise bénéficient de l’indexation automatique du workspace :
  • Tout workspace que vous ajoutez est automatiquement indexé, sans case à cocher
  • Tous les workspaces ajoutés sont immédiatement disponibles dans Cascade
  • Les appels d’outils ne sont jamais bloqués en dehors du workspace actif
  • La fonctionnalité d’indexation sélective n’est pas pertinente dans ce modèle
Après avoir terminé les étapes de configuration ci‑dessus, Cascade devrait pouvoir accéder à votre workspace et fonctionner normalement.