Express.js

Pilnas diegimo vadovas, skirtas Express.js NStrim platformoje

Apžvalga

Express.js yra greitas, neprimetantis nuomonės, minimalistinis Node.js žiniatinklio karkasas. Jis suteikia tvirtas funkcijas žiniatinklio aplikacijoms ir REST API kurti, sutelkdamas dėmesį į paprastumą ir lankstumą.

Prieš pradėdami
Įsitikinkite, kad jūsų valdymo skydelis atidarytas - jums reikės ten rodomų Git prisijungimo duomenų. Šiame šablone yra Prisma ORM, Sequelize, MySQL2, JWT autentifikacija, Socket.io ir EJS šablonai.

Greitas startas

1

Sukurkite repozitoriją iš šablono

Valdymo skydelyje pereikite į skirtuką Tools & Deployment. Spauskite mygtuką "New Repository", išskleidžiamame sąraše pasirinkite Express šabloną, įveskite repozitorijos pavadinimą ir subdomeną, tada spauskite "Create Repository".

2

Klonuokite savo repozitoriją

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Įdiekite priklausomybes

npm install
4

Paleiskite kūrimo serverį

npm run dev

Pagal numatytuosius nustatymus serveris veikia adresu http://localhost:3000.

5

Įkelkite savo pakeitimus

git add .
git commit -m "Initial setup"
git push origin main
Kiekvienas push į Git automatiškai įdiegia jūsų aplikaciją. Patikrinkite Modulio darbo URL valdymo skydelyje, kad pamatytumėte savo gyvą svetainę.

Vietinis kūrimas su Docker

Jei vietoje neturite įdiegto Node.js, galite naudoti Docker Express komandoms vykdyti.

Kas yra Docker?
Docker sukuria izoliuotus „konteinerius" su visa reikalinga programine įranga (Node.js, npm) jos neįdiegiant į jūsų kompiuterį.

Komandų vykdymas su Docker

# Paleisti npm install
docker run --rm -v $(pwd):/app -w /app node:lts npm install

# Paleisti kūrimo serverį
docker run --rm -v $(pwd):/app -w /app -p 3000:3000 node:lts npm run dev

Projekto struktūra

├── src/
│   ├── controllers/          # Užklausų tvarkytuvai
│   ├── middleware/           # Pasirinktinė tarpinė programinė įranga
│   ├── models/               # Duomenų bazės modeliai
│   ├── routes/               # Maršrutų apibrėžimai
│   └── server.js             # Express aplikacijos sąranka
├── views/                    # EJS šablonų failai
├── public/                   # Statiniai failai
├── prisma/                   # Prisma schema
├── package.json              # Priklausomybės
└── Dockerfile                # Docker konfigūracija

Įprastos užduotys

Maršruto kūrimas

const express = require('express');
const router = express.Router();

router.get('/users', (req, res) => {
  res.json({ message: 'Get all users' });
});

module.exports = router;

Prisma ORM naudojimas

const { PrismaClient } = require('@prisma/client');
const prisma = new PrismaClient();

const users = await prisma.user.findMany();
const user = await prisma.user.create({
  data: { name: 'John', email: 'john@example.com' }
});

Naudingos komandos

npm run dev Paleisti kūrimo serverį su nodemon
npm start Paleisti produkcijos serverį
npx prisma migrate dev Vykdyti Prisma migracijas

Trikčių šalinimas

Nepavyko prisijungti prie duomenų bazės

Sprendimas: Patikrinkite DATABASE_URL .env faile. Formatas: mysql://user:password@host:port/database

Prievadas 3000 jau naudojamas

Sprendimas: Pakeiskite PORT .env faile arba sustabdykite kitą procesą.

Diegimo eiga

Kodo pakeitimas git push npm install Gyvai!
Daugiau informacijos rasite oficialioje Express.js dokumentacijoje.