Documentation
Connexion avec SSH, scp, sftp et rsync
Bientôt disponible. L’accès SSH standard et les connexions aux éditeurs ne sont pas encore offerts.
Connexion après activation
Sur macOS ou Linux, installez rzv et OpenSSH, connectez-vous avec rzv login et sélectionnez votre espace de travail. Le bac à sable doit être en cours d’exécution et Runzivo doit avoir activé SSH pour votre environnement. SSH depuis un ordinateur Windows n’est pas encore pris en charge. Utilisez plutôt rzv sandboxes exec. La connexion exige sandboxes:write. La configuration avec une clé API exige sandboxes:read. Aucun port SSH ni aucune adresse IP publics ne sont nécessaires.
rzv sandboxes ssh <sandbox-id>
rzv sandboxes ssh <sandbox-id> -- 'uname -a'
rzv sandboxes ssh-config <sandbox-id> --write
ssh <sandbox-id>.rzv
scp file.txt <sandbox-id>.rzv:/workspace/
sftp <sandbox-id>.rzv
rsync -a -e ssh ./project/ <sandbox-id>.rzv:/workspace/project/
ssh -N -L 8080:localhost:3000 <sandbox-id>.rzvUtiliser VS Code ou Cursor
Exécutez ssh-config avec --write comme ci-dessus. Il gère son bloc Host et ajoute un Include à ~/.ssh/config en conservant le reste. Vérifiez la connexion ssh, installez l’extension Remote SSH de votre éditeur, choisissez <sandbox-id>.rzv et ouvrez /workspace. Le ProxyCommand généré utilise rzv sandboxes ssh <sandbox-id> --stdio. Conservez la vérification de l’hôte. Nous n’avons pas encore testé VS Code ou Cursor avec un bac à sable réel.
Transférer des fichiers
Utilisez l’alias SSH généré avec scp, sftp ou rsync. Vérifiez les fichiers avant de les copier : les dossiers sources contiennent parfois des identifiants. Conservez la vérification des clés d’hôte et ne collez aucun jeton dans les commandes.
Utilisez rzv sandboxes terminal <sandbox-id> pour le terminal PTY existant. Seule la commande rzv sandboxes ssh <sandbox-id> sans arguments supplémentaires peut utiliser ce terminal si SSH ou OpenSSH est indisponible. Les commandes distantes et les transferts de fichiers reçoivent plutôt des instructions.
Redirection et limites
La redirection locale atteint uniquement les services sur localhost du bac à sable. La redirection distante, celle de l’agent SSH, X11, les tunnels et les sockets Unix sont désactivés. Deux sessions SSH au maximum sont permises. Elles se ferment après trente minutes d’inactivité, à l’arrêt, à l’expiration ou à la suppression du bac à sable.
Cas d’utilisation : réviser le travail d’un agent
Après activation, connectez-vous depuis VS Code ou Cursor, laissez votre agent modifier les fichiers et examinez les différences avant de créer un commit. Redirigez un port local vers un aperçu sur localhost du bac à sable. Récupérez le travail avant la fin de sa durée de vie de huit heures.