Kļūdas “Trūkst sākuma skripta” atrisināšana programmā Node.js programmā Docker

Node.js aizmugursistēmas palaišana programmā Docker: traucējummeklēšanas rokasgrāmata

Mēģinot palaist savu Node.js aizmugursistēma iekšā a Docker konteiners var būt nomākta, it īpaši, ja tas ir saistīts ar vienkāršu ziņojumu “Trūkst sākuma skripta”. Šī kļūda bieži rodas, kad NPM nevar atrast pareizo starta komandu jūsu iestatījumos. Ja jūs tas ir skārusi, jūs neesat viens!

Daudzos gadījumos problēma ir saistīta ar nepareiziem ceļiem vai nepareizi saskaņotām konfigurācijām starp jūsu package.json un Docker iestatījumiem. Saskaroties ar sīkumiem, ir viegli aizmirst daudzpakāpju konstrukcijas, konteinerizācijas un konfigurācijas faili. Tā kā pats saskāros ar šo problēmu, varu teikt, ka tās labošana bieži ietver katra faila izvietojuma un skriptu pārbaudi.

Piemēram, es reiz izvietoju aizmugursistēmu un vēlāk sapratu, ka mana dist mape nav pareizi kartēta, kā rezultātā starta komanda neizdevās. Vienkārši pielāgojumi var atrisināt šīs problēmas, taču, lai atrastu pareizo, ir nepieciešama pacietība 🔍. Pārbaudot, vai visas atkarības un skripti ir pareizi kartēti, var ietaupīt vairākas stundas atkļūdošanas.

Šajā rokasgrāmatā mēs apskatīsim dažas praktiskas darbības šīs kļūdas labošanai, it īpaši, ja izmantojat aizmugursistēmu kopā ar datubāzi, piemēram, DynamoDB programmā Docker. Kopā novērsīsim “trūkstošā sākuma skripta” kļūdu, lai jūsu aizmugursistēma darbotos nevainojami!

Docker konfigurācija Node.js un datu bāzes savienojumam

Iepriekš minētajā piemērā Docker iestatīšana izmanto daudzpakāpju būvniecību, kas ir noderīga, lai izveidotu efektīvus ražošanai gatavus konteinerus. Pirmajā posmā, kas definēts kā “veidotājs”, instalē atkarības un kompilē TypeScript failus uz JavaScript dist mapi. Šī darbība nodrošina, ka apkopotais kods ir gatavs ražošanai, neiekļaujot nevajadzīgas izstrādātāja atkarības. Pēc izveides otrais posms (izpildlaiks) kopē tikai apkopotos failus un ražošanas atkarības, samazinot konteinera izmēru. Šī iestatīšana ir īpaši noderīga, ja bieži izmantojat mākoņa vidi, kur ir svarīga katra optimizācija! 🚀

The DARBA DIREKTĪVAS komanda abos posmos iestata konteinera darba direktoriju uz /app. Tas vienkāršo failu ceļus un organizē visas darbības ap šo direktoriju. Pēc tam KOPĒT instrukcijas pārvietot konkrētus failus no saimniekdatora uz konteineru. Pirmajā posmā pakotnes*.json faili un tsconfig.json tiek kopēti, lai nodrošinātu atkarības instalēšanu un TypeScript kompilāciju, un RUN npm instalēšana un RUN npm palaist build komandas nodrošina, ka viss ir iestatīts pareizi. Šī iestatīšana palīdz izvairīties no tādām problēmām kā starta skriptu trūkums, pārliecinoties, ka visi faili ir pareizi kopēti un konfigurēti.

The docker-compose.yml fails savieno aizmugursistēmu ar DynamoDB, kas ir būtiska vietējai testēšanai un izstrādei. The atkarīgs_no opcija liek Docker palaist DynamoDB pirms aizmugursistēmas pakalpojuma, nodrošinot, ka datu bāze ir gatava visiem savienojuma mēģinājumiem no aizmugursistēmas. Reālos scenārijos šādas atkarības iestatīšanas neesamība var izraisīt savienojamības problēmas, kad aizmugurprogramma tiek startēta pirms datu bāzes, kā rezultātā rodas kaitinošas kļūdas. The veselības pārbaude komanda pārbauda, ​​vai DynamoDB ir sasniedzams, pingot galapunktam, mēģina vēlreiz, līdz tiek izveidots savienojums. Šāds kļūdu apstrādes līmenis ietaupa laiku, nodrošinot pakalpojumu sākšanu pareizajā secībā 🕒.

Visbeidzot, failā package.json esam definējuši sākums skripts kā mezgls dist/server.js. Šī komanda nodrošina, ka NPM precīzi zina, kuru failu palaist konteinerā, tādējādi palīdzot izvairīties no kļūdas “trūkstoša sākuma skripta”. Ir arī izveidošanas komanda TypeScript koda kompilēšanai un tīra komanda dist mapes noņemšanai, nodrošinot, ka katra izvietošana tiek sākta no jauna. Izmantojot šādus npm skriptus, iestatīšana kļūst uzticamāka, it īpaši, ja ir iesaistīts Docker, jo tas piedāvā paredzamus ceļus un darbības. Šī visaptverošā Docker, Docker Compose un NPM skriptu konfigurācija darbojas kopā, lai izveidotu racionalizētu darbplūsmu no izstrādes līdz ražošanai.

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

Pareizas failu kopēšanas un struktūras nodrošināšana programmā Docker Node.js projektiem

Strādājot ar Node.js lietojumprogrammām programmā Docker, viens no galvenajiem apsvērumiem ir nodrošināt, lai visi nepieciešamie faili tiktu pareizi kopēti un strukturēti konteinerā. Vairāku posmu būvniecībā, tāpat kā iepriekš minētajā piemērā, katram posmam ir noteikts mērķis. Sākotnējais posms “veidotājs” apstrādā TypeScript kompilēšanu uz JavaScript un sagatavo dist mapi. Otrajā posmā tiek iekļauti tikai ražošanas faili, samazinot konteinera izmēru un optimizējot izvietošanu. Šī pieeja ne tikai samazina nevajadzīgu uzpūšanos, bet arī uzlabo drošību, neizmantojot izstrādes rīkus.

Būtisks Docker for Node.js aspekts ir organizēšana pack.json un sākuma skripts precīzi. Skaidri norādot ceļus Dockerfile un nodrošinot, ka starta komanda ir pareizi iestatīta pack.json, jūs samazinat kļūdas, piemēram, "Trūkst sākuma skripta". Ir arī svarīgi apstiprināt, ka Docker zina, kur katram failam jāatrodas, jo īpaši sarežģītos iestatījumos, kas ietver vairākus pakalpojumus vai mapes. Piemēram, izmantojot komandu COPY, lai pievienotu tikai dist mape un nepieciešamās konfigurācijas gala konteineram nodrošina, ka ražošanā ir pieejami tikai būtiski faili 📂.

Lai pārbaudītu savu pakalpojumu stāvokli, docker-compose.yml fails izmanto veselības pārbaudi, lai pārbaudītu, vai datu bāze ir gatava. Definējot atkarības, mēs nodrošinām, ka aizmugursistēmas pakalpojums netiek startēts, kamēr datubāze nav reaģējusi, tādējādi novēršot ar laiku saistītas savienojuma problēmas. Šī iestatīšana ir īpaši noderīga reālās pasaules lietojumprogrammās, kur datu bāzes savienojamība ir ļoti svarīga. Bez šīs struktūras pakalpojumi var mēģināt izveidot savienojumu, pirms ir izveidoti citi pakalpojumi, izraisot izpildlaika kļūdas un iespējamu dīkstāvi lietotājiem 🔄.