Dev Containers permet à Kiro IDE de rouvrir un projet dans l'environnement défini par sa configuration Dev Container. L'éditeur reste sur votre ordinateur, tandis que le terminal, les outils du projet et l'agent Kiro s'exécutent dans le conteneur.
Vous pouvez utiliser un conteneur sur votre ordinateur. Vous pouvez aussi vous connecter d'abord avec Remote SSH et exécuter le conteneur sur cet hôte Linux.
Ouvrez uniquement les configurations Dev Container auxquelles vous faites confiance. Une configuration peut exécuter des commandes de configuration, installer des extensions, monter des fichiers et modifier l'environnement du conteneur. Une fenêtre Dev Container possède sa propre connexion Kiro et son propre historique de clavardage. Elle n'affiche pas les clavardages de la fenêtre locale ou SSH.
Votre projet doit contenir .devcontainer/devcontainer.json ou .devcontainer.json.
Le conteneur doit disposer des éléments suivants :
- Linux sur x64 ou ARM64 avec glibc
- Un répertoire personnel absolu pour l'utilisateur du conteneur
tar
Pour un conteneur local, installez et démarrez un moteur compatible avec Docker. Kiro utilise la CLI nommée par kiroDevContainers.dockerPath, dont la valeur par défaut est docker.
Pour un conteneur sur un hôte SSH, installez Docker sur cet hôte. La commande docker doit être dans le PATH distant, et /bin/sh doit être disponible. Docker n'a pas besoin de s'exécuter sur votre ordinateur pour ce parcours.
- Ouvrez le dossier du projet dans Kiro IDE.
- Examinez sa configuration Dev Container.
- Ouvrez la palette de commandes.
- Sélectionnez Dev Containers: Reopen in Container.
- Approuvez l'espace de travail. Si Kiro affiche une commande
initializeCommand, examinez-la avant de l'approuver, car elle s'exécute sur votre ordinateur ou votre hôte SSH, hors du conteneur. - Attendez que Kiro crée ou démarre le conteneur.
Sélectionnez Dev Containers: Show Container Log pour vérifier la progression de la configuration.
- Connectez-vous à l'hôte Linux avec Remote SSH.
- Ouvrez le dossier du projet sur cet hôte.
- Confirmez que Docker s'exécute sur l'hôte.
- Sélectionnez Dev Containers: Reopen in Container.
Kiro crée ou démarre le conteneur sur l'hôte SSH. Sélectionnez Dev Containers: Reopen Folder on the Remote Machine pour quitter le conteneur sans revenir à un dossier local.
Une configuration Dev Container peut exécuter des commandes de configuration, installer des extensions, monter des fichiers et modifier l'environnement du conteneur. Kiro exige que vous approuviez l'espace de travail avant d'exécuter la configuration.
Lorsque le dossier est déjà approuvé, Kiro demande votre autorisation avant qu'une commande initializeCommand s'exécute sur votre ordinateur ou votre hôte SSH. Lorsque vous approuvez un dossier pour la première fois, l'invite de confiance de l'espace de travail affiche cette commande. La commande s'exécute hors du conteneur. Examinez-la avant de l'approuver. Kiro demande une nouvelle approbation si la commande change.
Ouvrez le terminal intégré et exécutez :
uname -s uname -m pwd
Confirmez que les commandes s'exécutent dans le conteneur et le chemin de projet prévus. Créez et enregistrez un fichier de test, puis demandez à Kiro de le lire.
Par défaut, Kiro transfère les ports de conteneur déclarés et détectés vers 127.0.0.1. Ouvrez l'adresse locale dans le panneau Ports.
Utilisez Dev Containers: Reopen in Container pour revenir à l'environnement de conteneur actuel.
Utilisez Dev Containers: Rebuild Container après avoir modifié l'image ou la configuration. La reconstruction arrête le travail de l'agent Kiro qui s'exécute encore dans le conteneur. Elle remplace aussi la couche inscriptible du conteneur, y compris l'historique de session qui y est stocké. Les fichiers de projet montés sont conservés.
Enregistrez ou effectuez un commit avant de reconstruire. Stockez les données qui doivent persister hors de la couche inscriptible du conteneur.
- Si Kiro ne trouve aucune configuration, ouvrez un projet contenant
.devcontainer/devcontainer.jsonou.devcontainer.json. - Si le conteneur ne démarre pas, vérifiez le moteur, l'architecture de l'image, glibc, le répertoire personnel et
tar. - Si le projet se trouve sur un hôte SSH, vérifiez Docker à distance,
/bin/shet Remote SSH. - Si la configuration échoue, sélectionnez Dev Containers: Show Container Log.
- Si l'inspection TLS réinitialise les services Kiro, suivez les étapes de compatibilité avec l'inspection TLS.
Développer dans Dev Containers