Odpravljanje napake »Manjkajoči začetni skript« v Node.js znotraj Dockerja

Zagon zaledja Node.js v Dockerju: vodnik za odpravljanje težav

Pri poskusu zagona vašega Zaledje Node.js znotraj a Docker kontejner je lahko frustrirajuće, še posebej, če je posledica preprostega sporočila »Manjka začetni skript«. Ta napaka se pogosto pojavi, ko NPM v vaši nastavitvi ne more najti pravilnega ukaza za zagon. Če vas je to prizadelo, niste sami!

V mnogih primerih se težava zmanjša na nepravilne poti ali neporavnane konfiguracije med vašimi nastavitvami package.json in Docker. Ko imate opravka z lahkoto spregledate majhno podrobnost večstopenjske gradnje, kontejnerizacijo in konfiguracijske datoteke. Ker sem se sam soočil s to težavo, lahko rečem, da popravljanje pogosto vključuje preverjanje umestitve posamezne datoteke in skriptov.

Na primer, nekoč sem uvedel zaledje in pozneje ugotovil, da moja mapa dist ni bila pravilno preslikana, kar je povzročilo neuspeh ukaza za zagon. Preprosti popravki lahko rešijo te težave, vendar iskanje pravega zahteva potrpljenje 🔍. Preverjanje, ali so vse odvisnosti in skripti pravilno preslikani, lahko prihrani ure odpravljanja napak.

V tem priročniku se bomo poglobili v nekaj praktičnih korakov za odpravo te napake, še posebej, če zaledje izvajate skupaj z bazo podatkov, kot je DynamoDB v Dockerju. Skupaj odpravimo napako »manjkajoči začetni skript«, da bo vaše zaledje delovalo nemoteno!

Konfiguracija Dockerja za Node.js in povezavo z bazo podatkov

V zgornjem primeru nastavitev Dockerja uporablja večstopenjsko gradnjo, ki je uporabna za ustvarjanje učinkovitih vsebnikov, pripravljenih za proizvodnjo. Prva stopnja, definirana kot "graditelj", namesti odvisnosti in prevede TypeScript datoteke v JavaScript v dist mapo. Ta korak zagotavlja, da je prevedena koda pripravljena za proizvodnjo brez vključitve nepotrebnih odvisnosti od razvijalcev. Ko je zgrajena, druga stopnja (izvajalno okolje) kopira samo prevedene datoteke in produkcijske odvisnosti, kar zmanjša velikost vsebnika. Ta nastavitev je še posebej uporabna, če pogosto uvajate v okolja v oblaku, kjer vsak košček optimizacije šteje! 🚀

The DELOVNI DIR ukaz v obeh fazah nastavi delovni imenik vsebnika na /app. To poenostavi poti datotek in organizira vse operacije okoli tega imenika. Po tem, KOPIRAJ navodila premaknejo določene datoteke iz gostiteljskega računalnika v vsebnik. V prvi fazi se kopirajo datoteke package*.json in tsconfig.json, da se omogoči namestitev odvisnosti in prevajanje TypeScript, ter ZAGENI namestitev npm in RUN npm zaženi gradnjo ukazi zagotavljajo, da je vse pravilno nastavljeno. Ta nastavitev pomaga preprečiti težave, kot so manjkajoči začetni skripti, saj poskrbi, da so vse datoteke pravilno kopirane in konfigurirane.

The docker-compose.yml datoteka povezuje zaledje z DynamoDB, kar je bistveno za lokalno testiranje in razvoj. The odvisno_od možnost sporoči Dockerju, naj zažene DynamoDB pred zaledno storitvijo, s čimer zagotovi, da je baza podatkov pripravljena na vse poskuse povezave iz ozadja. V realnih scenarijih lahko pomanjkanje takšne nastavitve odvisnosti povzroči težave s povezljivostjo, ko se zaledje zažene pred zbirko podatkov, kar povzroči frustrirajoče napake. The zdravstveni pregled ukaz preizkusi, ali je DynamoDB dosegljiv s pinganjem končne točke in znova poskuša, dokler ni vzpostavljena povezava. Ta raven obravnave napak prihrani čas, saj zagotavlja, da se storitve začnejo v pravilnem vrstnem redu 🕒.

Končno smo v package.json definirali začetek scenarij kot vozlišče dist/server.js. Ta ukaz zagotavlja, da NPM natančno ve, katero datoteko zagnati v vsebniku, kar pomaga preprečiti napako »manjkajoči začetni skript«. Na voljo sta tudi ukaz za gradnjo za prevajanje kode TypeScript in ukaz za čiščenje za odstranitev mape dist, kar zagotavlja, da se vsaka uvedba začne znova. Uporaba skriptov npm, kot so ti, naredi nastavitev bolj zanesljivo, zlasti ko je vključen Docker, saj ponuja predvidljive poti in dejanja. Ta celovita konfiguracija skriptov Docker, Docker Compose in NPM skupaj ustvarja poenostavljen potek dela 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"\]/);
  });
});

Zagotavljanje pravilnega kopiranja in strukture datotek v Dockerju za projekte Node.js

Pri delu z aplikacijami Node.js v Dockerju je eden ključnih dejavnikov zagotavljanje, da so vse potrebne datoteke pravilno kopirane in strukturirane v vsebniku. V večstopenjskih zgradbah, kot je zgornji primer, ima vsaka stopnja poseben namen. Začetna stopnja, "builder", obravnava prevajanje TypeScripta v JavaScript in pripravi dist mapo. V drugi fazi so vključene samo produkcijske datoteke, kar zmanjša velikost vsebnika in optimizira uvajanje. Ta pristop ne le zmanjša nepotrebno napihnjenost, ampak tudi poveča varnost, saj opusti razvojna orodja.

Bistveni vidik Dockerja za Node.js je organiziranje package.json in zagonski skript natančno. Z jasnim podajanjem poti v datoteki Dockerfile in zagotavljanjem, da je ukaz za zagon pravilno nastavljen package.json, minimizirate napake, kot je "Manjka začetni skript." Prav tako je ključnega pomena potrditi, da Docker ve, kje bi morala biti posamezna datoteka, zlasti v kompleksnih nastavitvah, ki vključujejo več storitev ali map. Na primer, z ukazom COPY dodate samo dist mapo in potrebne konfiguracije do končnega vsebnika zagotavlja, da so v proizvodnji na voljo le bistvene datoteke 📂.

Za preverjanje zdravja vaših storitev je docker-compose.yml datoteka uporablja pregled stanja, da preveri, ali je zbirka podatkov pripravljena. Z definiranjem odvisnosti zagotovimo, da se zaledna storitev ne zažene, dokler se baza podatkov ne odzove, s čimer preprečimo težave s povezavo, povezane s časom. Ta nastavitev je še posebej uporabna v aplikacijah v resničnem svetu, kjer je povezljivost z bazo podatkov ključnega pomena. Brez te strukture se lahko storitve poskušajo povezati, preden druge storitve delujejo, kar vodi do napak med izvajanjem in morebitnih izpadov za uporabnike 🔄.