Configuration SSH pour une utilisation à distance
Après avoir installé l’interface de ligne de commande d’Amazon Q, vous pouvez configurer l’intégration de Linux à distance afin d’activer la fonctionnalité de ligne de commande avec Amazon Q sur des machines distantes.
Intégration à partir de votre machine macOS locale
Pour activer l’intégration SSH à partir de votre machine macOS locale :
-
Ouvrez votre terminal ou votre invite de commande.
-
Activez les intégrations SSH locales :
q integrations install ssh
Intégration de Linux sur une machine distante
Pour configurer l’intégration SSH sur votre machine Linux distante :
-
Modifier la configuration SSH du serveur :
sudo -e /etc/ssh/sshd_config -
Ajoutez les lignes suivantes à la fin du fichier de configuration :
AcceptEnv Q_SET_PARENT AllowStreamLocalForwarding yes -
Redémarrez le service SSH :
sudo systemctl restart sshd -
Déconnectez-vous de la session SSH, puis reconnectez-vous.
-
Une fois reconnecté, connectez-vous à Amazon Q :
q login -
Vérifiez l’installation :
q doctor
Limitations connues
Si le client de bureau Amazon Q se ferme alors qu’il est connecté à une machine distante via SSH, un message d’erreur peut s’afficher à plusieurs reprises :
connect to /var/folders/tg/u1vx4xfmvqav0oxfa4zfknaxiwmbsbr/T/cwrun/remote.sock port -2 failed: Connection refused
Pour arrêter cette erreur, quittez la session SSH et reconnectez-vous ou redémarrez le client de bureau Amazon Q.
Résolution des problèmes
Si vous rencontrez des problèmes avec l’intégration SSH :
-
Exécutez q doctor pour identifier et résoudre les problèmes courants
-
Vérifiez que les configurations locale et distante sont correctes
-
Vérifiez que votre serveur SSH est configuré pour accepter les variables d’environnement requises
-
Vérifiez que vous utilisez la bonne version (standard ou musl) pour votre système