Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Mengimpor proyek Compose — API catatan dengan PostgreSQL dan Redis

Berkas Compose yang menjalankan sebuah API, database PostgreSQL tempat API itu menyimpan catatannya, dan cache Redis, dijadikan draf berkas Aggrega oleh aggrega import — dengan koneksi, pengaturan database, kata sandi sebagai referensi variabel, dan tag setiap image ikut dibawa — dan di-build untuk Docker Compose.

Mengimpor proyek Compose membahasnya langkah demi langkah: perintahnya, berkas yang ditulisnya dan alasan setiap barisnya ada, build-nya, serta stack yang berjalan. Folder ini memuat setiap tahap dari panduan tersebut:

folder atau berkasisinya
source/proyek Compose, compose.yaml, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, dan import-answers.yaml, satu-satunya nilai yang dibutuhkan build untuk Kubernetes yang tidak dimuat oleh berkas Compose mana pun
draft/berkas yang ditulis oleh aggrega import compose.yaml --target compose, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar

Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.

Membuat contoh

Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example import-compose

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd import-compose

Build

Impor membuat draf berkas Aggrega di samping proyek, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan oleh registry bawaan ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menyebutnya berdasarkan digest-nya dalam catatan yang ditulisnya di samping draf. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder-folder itu sebagai gantinya. Impor lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:

Terminal window
cd source
aggrega import compose.yaml --target compose
aggrega build --release release.yaml

Build menulis dist/compose/docker-compose.yaml; cara menjalankannya ada di panduan yang ditautkan di atas.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-compose`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-compose` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `import-compose` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-compose/source`, `source` diatur ke `compose.yaml`, dan `target` diatur ke `compose`: alat ini membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `compose.yaml`, menulis drafnya ke `import-compose/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-compose/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-compose/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `import-compose/source/dist/`.

Mengujinya

Dengan stack berjalan seperti yang dijalankan panduan langkah demi langkah, dan image yang menjawab HTTP di port 8080 ditetapkan untuk API, kirim permintaan ke API pada port yang diterbitkan Release:

Terminal window
curl -sS http://127.0.0.1:8080/notes

Program pengganti dalam panduan menjawab dengan deskripsi permintaan yang diterimanya:

{
"path": "/notes",
"headers": {
"host": "127.0.0.1:8080",
[… omitted: the user agent and the media types the client sent]
},
"method": "GET",
[… omitted: the rest of the request as the stand-in received it, the client's address and the container's host name]
}

Diimpor dengan --target helm dan diterapkan ke Kubernetes, seperti yang ditunjukkan panduan langkah demi langkah, API menjawab permintaan yang sama di alamat yang sama setelah port lokal diteruskan ke Service-nya; di sana API belum menerima kata sandi basis datanya, karena Secret hanya menjangkau basis data:

Terminal window
kubectl port-forward -n <namespace> svc/api-default 8080:8080