Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter Comment effectuer une migration depuis CodeCatalyst.
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 devfile est un standard ouvert qui vous permet de personnaliser vos environnements de développement au sein de votre équipe. Un devfile est un fichier YAML 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 devfile manuellement. Si vous créez un projet à l'aide d'un plan différent, CodeCatalyst crée automatiquement un devfile. 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.
Note
Le /home dossier ne change que si vous modifiez le nom du fichier devfile ou le nom du composant devfile. Si vous modifiez le nom du composant devfile ou devfile, le contenu du répertoire est remplacé et les données de votre /home /home répertoire précédent ne peuvent pas être récupérées.
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 tous les IDE. CodeCatalyst prend actuellement en charge la version 2.0.0 de devfile. Pour plus d'informations sur le devfile, consultez Devfile schema - Version 2.0.0.
Note
Vous pouvez uniquement inclure des images de conteneur publiques dans votre devfile.
Notez que les environnements VPC-connected de développement ne prennent en charge que les images de fichier de développement suivantes :
-
Image universelle
-
Images Amazon ECR privées, si le référentiel se trouve dans la même région que le VPC
Rubriques
Modification d'un fichier de développement d'un référentiel pour un environnement de développement
Fonctionnalités de Devfile prises en charge par CodeCatalyst
Exemple de fichier de développement pour un environnement de développement
Résolution des problèmes liés à un fichier de développement d'un référentiel en mode de restauration
Fonctionnalités de Devfile prises en charge par CodeCatalyst
CodeCatalyst prend en charge les fonctionnalités de devfile suivantes dans la version 2.0.0. Pour plus d'informations sur le devfile, consultez Devfile schema - Version 2.0.0.
| Fonctionnalité | Type |
|---|---|
|
|
Commande |
|
|
Événement |
|
|
Composant |
|
|
Propriétés des composants |
|
|
Propriétés des composants |
|
|
Propriétés des composants |
|
|
Propriétés des composants |
Exemple de fichier de développement pour un environnement de développement
Voici un exemple de fichier de configuration 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 du Devfile sont capturés et stockés dans/aws/mde/logs. Pour déboguer le comportement d'un fichier de développement, démarrez votre environnement de développement à l'aide d'un fichier de développement fonctionnel et accédez aux journaux.
Résolution des problèmes liés à un fichier de développement d'un référentiel en mode de restauration
En cas de problème lors du démarrage de votre devfile, il passera en mode de restauration afin que vous puissiez toujours vous connecter à votre environnement et réparer votre devfile. En mode de récupération, l'exécution /aws/mde/mde status ne contiendra pas l'emplacement de votre fichier de périphérique.
{
"status": "STABLE"
}
Vous pouvez vérifier l'erreur dans les journaux ci-dessous/aws/mde/logs, corriger le fichier de développement et /aws/mde/mde start réessayer de l'exécuter.