Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengonfigurasi devfile untuk Lingkungan Dev
<a name="devenvironment-devfile"></a>

*Devfile* adalah standar terbuka yang membantu Anda menyesuaikan Lingkungan Pengembang pengembangan di seluruh tim Anda. Devfile adalah file YAMAL yang mengkodifikasi alat pengembangan yang Anda butuhkan. Dengan mengonfigurasi devfile, Anda dapat menentukan terlebih dahulu alat proyek dan pustaka aplikasi yang Anda butuhkan dan Amazon CodeCatalyst menginstalnya ke Lingkungan Dev untuk Anda. Devfile khusus untuk repositori tempat pembuatannya, dan Anda dapat membuat devfile terpisah untuk setiap repositori. Lingkungan Dev Anda mendukung perintah dan peristiwa, dan menyediakan image devfile universal default.

Jika Anda membuat proyek menggunakan cetak biru kosong, Anda dapat membuat devfile secara manual. Jika Anda membuat proyek menggunakan cetak biru yang berbeda, CodeCatalyst buat devfile secara otomatis. `/projects`Direktori Dev Environment menyimpan file yang ditarik dari repositori sumber dan devfile. `/home`Direktori, yang kosong saat Anda pertama kali membuat Dev Environment, menyimpan file yang Anda buat saat menggunakan Dev Environment Anda. Segala sesuatu di `/projects` dan `/home` direktori Lingkungan Dev disimpan terus-menerus.

**catatan**  
`/home`Folder hanya berubah jika Anda mengubah nama devfile atau nama komponen devfile. Jika Anda mengubah nama komponen devfile atau devfile, isi direktori diganti dan data `/home` `/home` direktori Anda sebelumnya tidak dapat dipulihkan.

Jika Anda membuat Lingkungan Dev dengan repositori sumber yang tidak berisi devfile di akarnya, atau jika Anda membuat Lingkungan Dev tanpa repositori sumber, devfile universal default diterapkan ke repositori sumber secara otomatis. Gambar devfile universal default yang sama digunakan untuk semua IDEs. CodeCatalyst saat ini mendukung devfile versi 2.0.0. Untuk informasi selengkapnya tentang devfile, lihat [skema Devfile -](https://devfile.io/docs/2.0.0/devfile-schema) Versi 2.0.0.

**catatan**  
Anda hanya dapat menyertakan gambar kontainer publik di devfile Anda.

Perhatikan bahwa Lingkungan Dev yang terhubung dengan VPC hanya mendukung gambar devfile berikut:
+ Citra universal
+ Gambar ECR Amazon pribadi, jika repositori berada di wilayah yang sama dengan VPC

**Topics**
+ [Mengedit devfile repositori untuk Lingkungan Dev](devenvironment-devfile-moving.md)
+ [Fitur Devfile didukung oleh CodeCatalyst](#devenvironment-devfile-support)
+ [Contoh devfile untuk Lingkungan Dev](#devenvironment-devfile-example)
+ [Memecahkan masalah devfile repositori menggunakan mode pemulihan](#devenvironment-devfile-recovery)
+ [Menentukan gambar devfile universal untuk Lingkungan Dev](devenvironment-universal-image.md)
+ [Perintah Devfile](devenvironment-devfile-commands.md)
+ [Acara Devfile](devenvironment-devfile-events.md)
+ [Komponen Devfile](devenvironment-devfile-components.md)

## Fitur Devfile didukung oleh CodeCatalyst
<a name="devenvironment-devfile-support"></a>

CodeCatalyst mendukung fitur devfile berikut pada versi 2.0.0. Untuk informasi selengkapnya tentang devfile, lihat [skema Devfile -](https://devfile.io/docs/2.0.0/devfile-schema) Versi 2.0.0.


| Fitur | Tipe | 
| --- | --- | 
| `exec` | Perintah | 
| `postStart` | Peristiwa | 
| `container` | Komponen | 
| `args` | Properti Komponen | 
| `env` | Properti Komponen | 
| `mountSources` | Properti Komponen | 
| `volumeMounts` | Properti Komponen | 

## Contoh devfile untuk Lingkungan Dev
<a name="devenvironment-devfile-example"></a>

Berikut ini adalah contoh devfile sederhana.

```
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
```

Startup Devfile, perintah, dan log peristiwa ditangkap dan disimpan di`/aws/mde/logs`. Untuk men-debug perilaku devfile, mulai Lingkungan Dev Anda menggunakan devfile yang berfungsi dan akses log.

## Memecahkan masalah devfile repositori menggunakan mode pemulihan
<a name="devenvironment-devfile-recovery"></a>

Jika ada masalah saat memulai devfile Anda, itu akan masuk ke mode pemulihan sehingga Anda masih dapat terhubung ke lingkungan Anda dan memperbaiki devfile Anda. Saat dalam mode pemulihan, berjalan `/aws/mde/mde status` tidak akan berisi lokasi devfile Anda.

```
{
            "status": "STABLE"
        }
```

Anda dapat memeriksa kesalahan di log di bawah`/aws/mde/logs`, memperbaiki devfile, dan mencoba menjalankan `/aws/mde/mde start` lagi.