Rezolvarea erorii „Missing Start Script” din Node.js din Docker

Pornirea backend-ului Node.js în Docker: un ghid de depanare

Întâmpinați o eroare când încercați să rulați dvs Backend-ul Node.js în interiorul unui Container Docker poate fi frustrant, mai ales când se datorează unui simplu mesaj „Lipsește scriptul de pornire”. Această eroare apare adesea când NPM nu pot găsi comanda de pornire corectă în configurația dvs. Dacă ai fost lovit de asta, nu ești singur!

În multe cazuri, problema se rezumă la căi incorecte sau configurații nealiniate între setările package.json și Docker. Este ușor să treceți cu vederea un mic detaliu atunci când aveți de-a face cu el construcții în mai multe etape, containerizare și fișiere de configurare. După ce m-am confruntat eu cu această problemă, pot spune că remedierea ei implică adesea verificarea plasării și scripturilor fiecărui fișier.

De exemplu, am implementat odată un backend și mi-am dat seama mai târziu că folderul meu dist nu a fost mapat corect, ceea ce a cauzat eșuarea comenzii de pornire. Modificările simple pot rezolva aceste probleme, dar găsirea celui potrivit necesită răbdare 🔍. Verificarea dacă toate dependențele și scripturile sunt mapate corect poate economisi ore de depanare.

În acest ghid, vom aborda câțiva pași practici pentru remedierea acestei erori, mai ales dacă rulați backend-ul împreună cu o bază de date precum DynamoDB în Docker. Să depanăm împreună eroarea „scriptului de pornire lipsă” pentru ca backend-ul să funcționeze fără probleme!

Configurare Docker pentru Node.js și conexiune la baza de date

În exemplul de mai sus, configurația Docker folosește o construcție în mai multe etape, care este utilă pentru crearea de containere eficiente gata de producție. Prima etapă, definită ca „constructor”, instalează dependențe și compilează TypeScript fișiere la JavaScript în dist pliant. Acest pas asigură că codul compilat este gata pentru producție, fără a include dependențe inutile de dezvoltare. Odată construită, a doua etapă (runtime) copiază numai fișierele compilate și dependențele de producție, minimizând dimensiunea containerului. Această configurare este utilă în special dacă implementați frecvent în medii cloud unde fiecare parte de optimizare contează! 🚀

The WORKDIR comanda în ambele etape setează directorul de lucru al containerului la /app. Acest lucru simplifică căile fișierelor și organizează toate operațiunile în jurul acestui director. În urma acesteia, COPIE instrucțiunile mută fișiere specifice de pe mașina gazdă în container. În prima etapă, fișierele pachet*.json și tsconfig.json sunt copiate pentru a permite instalarea dependenței și compilarea TypeScript și RUN instalarea npm şi RUN npm run build comenzile asigură că totul este configurat corect. Această configurare ajută la evitarea problemelor precum lipsa scripturilor de pornire, asigurându-vă că toate fișierele sunt copiate și configurate corect.

The docker-compose.yml fișierul conectează backend-ul cu DynamoDB, care este esențial pentru testarea și dezvoltarea locală. The depinde_de opțiunea îi spune lui Docker să pornească DynamoDB înainte de serviciul backend, asigurându-se că baza de date este pregătită pentru orice încercare de conectare de la backend. În scenariile din lumea reală, lipsa unei astfel de configurări de dependență poate duce la probleme de conectivitate atunci când backend-ul pornește înainte de baza de date, ceea ce duce la erori frustrante. The controlul de sănătate comanda testează dacă DynamoDB este accesibil prin ping la punctul final, reîncercând până când se stabilește o conexiune. Acest nivel de gestionare a erorilor economisește timp, asigurând că serviciile pornesc în ordinea corectă 🕒.

În cele din urmă, în package.json, am definit început scenariu ca nodul dist/server.js. Această comandă asigură că NPM știe exact ce fișier să ruleze în container, ajutând la evitarea erorii „lipsă scriptul de pornire”. Există, de asemenea, o comandă de compilare pentru a compila codul TypeScript și o comandă de curățare pentru a elimina folderul dist, asigurându-se că fiecare implementare începe din nou. Utilizarea scripturilor npm ca acestea face configurarea mai fiabilă, mai ales atunci când este implicat Docker, deoarece oferă căi și acțiuni previzibile. Această configurație cuprinzătoare a scripturilor Docker, Docker Compose și NPM funcționează împreună pentru a crea un flux de lucru simplificat de la dezvoltare la producție.

# 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"\]/);
  });
});

Asigurarea copierii și structurii corecte a fișierelor în Docker pentru proiectele Node.js

Când lucrați cu aplicațiile Node.js în Docker, un aspect cheie este să vă asigurați că toate fișierele necesare sunt copiate și structurate corect în container. În versiunile în mai multe etape, ca în exemplul de mai sus, fiecare etapă are un scop specific. Etapa inițială, „builder”, se ocupă de compilarea TypeScript în JavaScript și pregătește dist pliant. În a doua etapă, sunt incluse doar fișierele de producție, reducând dimensiunea containerului și optimizând implementarea. Această abordare nu numai că reduce balonarea inutilă, ci și îmbunătățește securitatea, lăsând deoparte instrumentele de dezvoltare.

Un aspect esențial al Docker pentru Node.js este organizarea pachet.json şi scriptul de pornire cu precizie. Specificând căile în mod clar în fișierul Docker și asigurându-vă că comanda de pornire este configurată corect în pachet.json, minimizați erori precum „Scriptul de pornire lipsă”. De asemenea, este esențial să confirmăm că Docker știe unde ar trebui să fie fiecare fișier, în special în setările complexe care implică mai multe servicii sau foldere. De exemplu, folosind comanda COPY pentru a adăuga numai dist folderul și configurațiile necesare pentru containerul final asigură că numai fișierele esențiale sunt disponibile în producție 📂.

Pentru a verifica starea de sănătate a serviciilor dvs., docker-compose.yml fișierul utilizează o verificare a stării de sănătate pentru a verifica că baza de date este gata. Prin definirea dependențelor, ne asigurăm că serviciul backend nu pornește până când baza de date este receptivă, prevenind problemele de conexiune legate de sincronizare. Această configurare este deosebit de benefică în aplicațiile din lumea reală în care conectivitatea bazei de date este vitală. Fără această structură, serviciile pot încerca să se conecteze înainte ca alte servicii să funcționeze, ceea ce duce la erori de rulare și la posibile perioade de nefuncționare pentru utilizatori 🔄.