Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration d'un fichier de développement pour un environnement de développement

Un fichier de développement est un standard ouvert qui vous permet de personnaliser vos environnements de développement au sein de votre équipe. Un fichier de développement est un YAML fichier qui codifie les outils de développement dont vous avez besoin. En configurant un fichier de développement, vous pouvez prédéterminer les outils de projet et les bibliothèques d'applications dont vous avez besoin et Amazon les CodeCatalyst installe pour vous dans votre environnement de développement. Le fichier de développement est spécifique au référentiel pour lequel il a été créé, et vous pouvez créer un fichier de développement distinct pour chaque référentiel. Votre environnement de développement prend en charge les commandes et les événements et fournit une image de fichier de développement universelle par défaut.

Si vous créez un projet à l'aide du plan vide, vous pouvez créer un fichier de développement manuellement. Si vous créez un projet à l'aide d'un plan différent, CodeCatalyst crée automatiquement un fichier de développement. Le /projects répertoire d'un environnement de développement stocke les fichiers extraits du référentiel source et du fichier de développement. Le /home répertoire, qui est vide lorsque vous créez un environnement de développement pour la première fois, stocke les fichiers que vous créez lors de l'utilisation de votre environnement de développement. Tout ce qui se trouve dans les /home répertoires /projects et d'un environnement de développement est stocké de manière persistante.

Si vous créez un environnement de développement avec un référentiel source qui ne contient pas de fichier de développement à sa racine, ou si vous créez un environnement de développement sans référentiel source, un fichier de développement universel par défaut est automatiquement appliqué au référentiel source. La même image de fichier de développement universelle par défaut est utilisée pour tousIDEs. CodeCatalyst supporte actuellement la version 2.0.0 de devfile. Pour plus d'informations sur le fichier de développement, voir Schéma de fichier de développement - Version 2.0.0.

Notez que les environnements de développement VPC connectés ne prennent en charge que les images de fichier de développement suivantes :

Fonctionnalités de Devfile prises en charge par CodeCatalyst

CodeCatalyst prend en charge les fonctionnalités de fichier de développement suivantes sur la version 2.0.0. Pour plus d'informations sur le fichier de développement, voir Schéma de fichier de développement - Version 2.0.0.

Exemple de fichier de développement pour un environnement de développement

Voici un exemple de fichier de développement simple.

schemaVersion: 2.0.0
metadata:
  name: al2
components:
  - name: test
    container:
      image: public.ecr.aws/amazonlinux/amazonlinux:2
      mountSources: true
      command: ['sleep', 'infinity']
  - name: dockerstore
commands:
  - id: setupscript
    exec:
      component: test
      commandLine: "chmod +x script.sh"
      workingDir: /projects/devfiles
  - id: executescript
    exec:
      component: test
      commandLine: "/projects/devfiles/script.sh"
  - id: yumupdate
    exec:
      component: test
      commandLine: "yum -y update --security"
events:
  postStart:
    - setupscript
    - executescript
    - yumupdate

Les journaux de démarrage, de commande et d'événements de Devfile sont capturés et stockés dans/aws/mde/logs. Pour déboguer le comportement des fichiers de développement, démarrez votre environnement de développement à l'aide d'un fichier de développement fonctionnel et accédez aux journaux.

Dépannage d'un fichier de développement d'un référentiel à l'aide du mode de

En cas de problème lors du démarrage de votre fichier de développement, celui-ci passe en mode de restauration afin que vous puissiez toujours vous connecter à votre environnement et corriger votre fichier de développement. En mode de restauration, l'exécution /aws/mde/mde status ne contiendra pas l'emplacement de votre fichier de développement.

{
            "status": "STABLE"
        }

Vous pouvez vérifier l'erreur dans les journaux ci-dessous/aws/mde/logs, corriger le fichier de développement et réessayer de l'exécuter/aws/mde/mde start.