DevCollective.io

Devcollective.io

Pengembangan Lokal

1. Pasang Docker

Anda harus menginstal Docker untuk mengaktifkan Postgres. Pengguna Windows, pastikan untuk menginstal ekstensi WSL2 karena ini diperlukan agar postgres berfungsi dengan benar.

2. Pasang benang

Karena berbagai alasan, proyek ini tergantung pada benang. Anda dapat menginstalnya menggunakan:

npm install -g yarn

3. Instalasi benang

Ini akan menginstal dependensi Anda.

yarn

4. Mulai database Anda

yarn dbup

Langkah ini membuat 2 database postgres di Docker. Yang ada di port 10800 adalah pengembangan, sedangkan yang ada di port 10801 adalah untuk tes unit.

Pengguna Windows:

Jika Anda melihat kesalahan ini:

 The command 'docker-compose' could not be found in this WSL 2 distro.

Kemudian pastikan di desktop Docker Anda di bawah Pengaturan/Umum yang "Gunakan mesin berbasis WSL 2" diperiksa.

5. Jalankan Pristine untuk membuat semua database Anda.

Kami memiliki perintah yang nyaman, yarn pristine , yang menciptakan kembali dan mengambil kembali database. Anda dapat menggunakan perintah ini kapan saja untuk menghapus database Anda dan mengatur ulang.

yarn pristine

Jalankan Pristine setiap kali DB berubah.

Pristine harus dijalankan setelah setiap perubahan DB untuk memperbarui database Anda dengan migrasi terbaru.

Pristine dapat digunakan untuk mengatur ulang basis data Anda

Pristine dapat dijalankan kapan saja untuk mengatur ulang database Anda ke keadaan bersih. Ini bisa berguna dalam banyak situasi.

Jika Anda menghadapi masalah yang tidak dipecahkan oleh murni yang tidak diselesaikan

Jika Anda mengalami masalah yang lebih dalam, Anda mungkin ingin menghancurkan instance postgres Anda dan mulai dari goresan absolut. Ada perintah yang akan menghancurkan semua gambar Docker, wadah, volume yang saat ini tidak berjalan. Pertama, Anda akan ingin menghentikan semua proses Docker yang terkait dengan proyek ini, dan kemudian menjalankan docker system prune -a . Catatan: Ini adalah perintah berbahaya yang akan menghancurkan segala sesuatu yang saat ini tidak berjalan di Docker, termasuk proyek non-DC.IO.

6. Deklarasikan nomor port khusus untuk memulai aplikasi

** Pembuatan file ini opsional. Jika Anda tidak membuat file ini di lingkungan dev, maka nilai default akan digunakan dari file dev.env yang ada di folder dev.

Pertama-tama buat file dev-override.env di folder dev hadir di direktori root. Kemudian salin dan tempel bidang berikut di file Anda.

 PORT= *

Di tempat * Anda dapat mendeklarasikan nomor port Anda sendiri yang tersedia di mesin Anda.

7. Mulai server Anda

Akhirnya, Anda dapat menjalankan perintah Command yarn dev (Windows: yarn dev:win ) untuk memulai server. Ini akan melayani baik frontend dan backend di port 3000.

8. Opsional: Siapkan Ekstensi VScode

Menu debugging di vScode, yang bergantung pada luncurkan.json, telah diisi dengan beberapa opsi menjalankan. Satu menjalankan server, sementara yang lain menjalankan tes unit. Keduanya diaktifkan dengan breakpoint, dan bisa menjadi cara yang bagus untuk Anda juga men -debug kode Anda bila perlu.

Proyek ini diatur untuk bermain dengan baik dengan Jest VScode. Ini akan menjalankan tes Anda di latar belakang dan juga memberi Anda tombol "debug" yang berguna untuk tes tertentu. Sangat direkomendasikan untuk pekerjaan backend apa pun.

Menginstal VScode GraphQL Mengaktifkan Sorot Sintaks GraphQL. Direkomendasikan untuk pekerjaan GQL.

Dokumen yang berguna

Cara membuat permintaan tarik pertama Anda - terima kasih, Julio Alcantara! Cara membuat entitas baru cara menyinkronkan repo Anda dengan kode yang diperbarui

Konfigurasi Produksi

Jika menggunakan produksi, tempat pertama tempat konfigurasi Anda di /etc/mintbean-v4/config/* . Kemudian jalankan yarn start .