Rješavanje pogreške "Nedostaje početna skripta" u Node.js unutar Dockera

Pokretanje pozadine Node.js u Dockeru: Vodič za rješavanje problema

Došlo je do pogreške prilikom pokušaja pokretanja vašeg Node.js pozadina unutar a Docker spremnik može biti frustrirajuće, pogotovo kada je to zbog jednostavne poruke "Nedostaje početna skripta". Ova se pogreška često javlja kada NPM ne može pronaći ispravnu naredbu za pokretanje u vašim postavkama. Ako vas je ovo pogodilo, niste sami!

U mnogim slučajevima problem se svodi na netočne staze ili neusklađene konfiguracije između vaših postavki package.json i Docker. Lako je previdjeti mali detalj kada se bavite njime višestupanjske građevine, kontejnerizacija i konfiguracijske datoteke. Budući da sam se i sam suočio s ovim problemom, mogu reći da njegovo popravljanje često uključuje provjeru položaja svake datoteke i skripti.

Na primjer, jednom sam implementirao backend i kasnije sam shvatio da moja mapa dist nije bila ispravno mapirana, što je uzrokovalo neuspjeh naredbe start. Jednostavna podešavanja mogu riješiti ove probleme, ali pronalaženje pravog zahtijeva strpljenje 🔍. Provjera jesu li sve ovisnosti i skripte ispravno mapirane može uštedjeti sate otklanjanja pogrešaka.

U ovom vodiču zaronit ćemo u neke praktične korake za ispravljanje ove pogreške, posebno ako svoju pozadinu pokrećete uz bazu podataka kao što je DynamoDB u Dockeru. Otklonimo zajedno pogrešku "nedostaje početna skripta" kako bi vaša pozadina radila glatko!

Docker konfiguracija za Node.js i vezu s bazom podataka

U gornjem primjeru, postavka Dockera koristi višefaznu izgradnju, što je korisno za stvaranje učinkovitih spremnika spremnih za proizvodnju. Prva faza, definirana kao "builder", instalira ovisnosti i kompilira TypeScript datoteke u JavaScript u dist mapa. Ovaj korak osigurava da je kompilirani kod spreman za proizvodnju bez uključivanja nepotrebnih ovisnosti o programerima. Nakon izgradnje, druga faza (vrijeme izvođenja) kopira samo kompajlirane datoteke i proizvodne ovisnosti, smanjujući veličinu spremnika. Ova postavka je posebno korisna ako često implementirate u okruženja oblaka gdje se svaka optimizacija računa! 🚀

The RADNI DIR naredba u obje faze postavlja radni direktorij spremnika na /app. Ovo pojednostavljuje staze datoteka i organizira sve operacije oko ovog direktorija. Nakon toga, KOPIRATI upute premjestiti određene datoteke s glavnog stroja u spremnik. U prvoj fazi, paket*.json datoteke i tsconfig.json se kopiraju kako bi se omogućila instalacija ovisnosti i TypeScript kompilacija, a POKRENI npm instalaciju i POKRENI npm pokreni izgradnju naredbe osiguravaju da je sve ispravno postavljeno. Ova postavka pomaže u izbjegavanju problema kao što su nedostajuće početne skripte osiguravajući da su sve datoteke ispravno kopirane i konfigurirane.

The docker-compose.yml datoteka povezuje pozadinu s DynamoDB, što je bitno za lokalno testiranje i razvoj. The ovisi_o opcija govori Dockeru da pokrene DynamoDB prije pozadinske usluge, osiguravajući da je baza podataka spremna za sve pokušaje povezivanja iz pozadine. U scenarijima stvarnog svijeta, nepostojanje takve postavke ovisnosti može dovesti do problema s povezivanjem kada se backend pokrene prije baze podataka, što rezultira frustrirajućim pogreškama. The zdravstveni pregled naredba testira je li DynamoDB dostupan pinganjem krajnje točke, pokušavajući ponovno dok se ne uspostavi veza. Ova razina rješavanja pogrešaka štedi vrijeme osiguravajući pokretanje usluga ispravnim redoslijedom 🕒.

Konačno, u package.json smo definirali start scenarij kao čvor dist/server.js. Ova naredba osigurava da NPM točno zna koju datoteku pokrenuti u spremniku, pomažući u izbjegavanju pogreške "nedostaje početna skripta". Tu je i naredba za izgradnju za kompajliranje TypeScript koda i naredba za čišćenje za uklanjanje mape dist, čime se osigurava da svaka implementacija počne iznova. Korištenje npm skripti poput ovih čini postavljanje pouzdanijim, posebno kada je uključen Docker, budući da nudi predvidljive putove i radnje. Ova sveobuhvatna konfiguracija skripti Docker, Docker Compose i NPM radi zajedno kako bi stvorila pojednostavljeni tijek rada od razvoja do proizvodnje.

# Dockerfile
FROM node:18 AS builder
WORKDIR /app
# Copy necessary config files and install dependencies
COPY package*.json tsconfig.json ./
RUN npm install
# Copy all source files and build the project
COPY . .
RUN npm run build
# Production stage
FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/package*.json ./
RUN npm install --omit=dev
COPY --from=builder /app/dist ./dist
EXPOSE 3001
# Adjust command to start the server
CMD ["node", "dist/server.js"]

# docker-compose.yml
version: "3.9"
services:
  backend:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3001:3001"
    environment:
      PORT: 3001
    depends_on:
      - dynamodb
    command: ["npm", "run", "start"]
  dynamodb:
    image: amazon/dynamodb-local
    ports:
      - "8001:8000"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8000"]
      interval: 10s
      timeout: 5s
      retries: 5

{
  "name": "backend",
  "version": "1.0.0",
  "main": "dist/server.js",
  "scripts": {
    "build": "tsc",
    "start": "node dist/server.js",
    "dev": "nodemon --exec ts-node src/server.ts",
    "clean": "rimraf dist"
  }
}

// test/deployment.test.js
const fs = require('fs');
describe('Deployment Tests', () => {
  test('dist folder exists', () => {
    expect(fs.existsSync('./dist')).toBe(true);
  });
  test('start script exists in package.json', () => {
    const packageJson = require('../package.json');
    expect(packageJson.scripts.start).toBe("node dist/server.js");
  });
  test('Dockerfile has correct CMD', () => {
    const dockerfile = fs.readFileSync('./Dockerfile', 'utf8');
    expect(dockerfile).toMatch(/CMD \["node", "dist\/server.js"\]/);
  });
});

Osiguravanje ispravnog kopiranja i strukture datoteka u Dockeru za Node.js projekte

Kada radite s Node.js aplikacijama u Dockeru, jedan od ključnih čimbenika je osiguravanje da su sve potrebne datoteke ispravno kopirane i strukturirane u spremniku. U višefaznim verzijama, kao u gornjem primjeru, svaka faza ima određenu svrhu. Početna faza, "builder", upravlja kompajliranjem TypeScripta u JavaScript i priprema dist mapa. U drugoj fazi uključene su samo proizvodne datoteke, čime se smanjuje veličina spremnika i optimizira implementacija. Ovaj pristup ne samo da smanjuje nepotrebno opterećenje, već i povećava sigurnost izostavljanjem razvojnih alata.

Bitan aspekt Dockera za Node.js je organiziranje paket.json i pokrenuti skriptu točno. Jasnim određivanjem staza u Docker datoteci i osiguravanjem da je startna naredba ispravno postavljena paket.json, minimizirate pogreške poput "Nedostaje početna skripta." Također je ključno potvrditi da Docker zna gdje bi svaka datoteka trebala biti, posebno u složenim postavkama koje uključuju više usluga ili mapa. Na primjer, pomoću naredbe COPY za dodavanje samo dist mapu i potrebne konfiguracije do konačnog spremnika osigurava da su samo bitne datoteke dostupne u proizvodnji 📂.

Da biste provjerili ispravnost svojih usluga, docker-compose.yml datoteka koristi provjeru stanja kako bi potvrdila da je baza podataka spremna. Definiranjem ovisnosti osiguravamo da se pozadinska usluga ne pokreće sve dok baza podataka ne reagira, čime se sprječavaju problemi s vezom povezani s vremenom. Ova postavka posebno je korisna u aplikacijama u stvarnom svijetu gdje je povezivost baze podataka vitalna. Bez ove strukture, usluge bi se mogle pokušati povezati prije nego što druge usluge počnu raditi, što dovodi do pogrešaka u radu i potencijalnog prekida rada za korisnike 🔄.