Dockeri Node.js-i vea "Puuduv algusskript" lahendamine

Node.js taustaprogrammi käivitamine Dockeris: tõrkeotsingu juhend

Teie käivitamisel ilmnes tõrge Node.js taustaprogramm sees a Docker konteiner võib olla masendav, eriti kui see on tingitud lihtsast teatest "Puuduv algusskript". See viga ilmneb sageli siis, kui NPM ei leia teie seadistuses õiget käivituskäsku. Kui see on teid tabanud, pole te üksi!

Paljudel juhtudel taandub probleem valedele teedele või valesti joondatud konfiguratsioonidele teie package.jsoni ja Dockeri seadete vahel. Tegelemisel on lihtne tähelepanuta jätta mõni väike detail mitmeastmelised ehitused, konteineriseerimis- ja konfiguratsioonifailid. Olles ise selle probleemiga silmitsi seisnud, võin öelda, et selle parandamine hõlmab sageli iga faili paigutuse ja skriptide kontrollimist.

Näiteks juurutasin kord taustaprogrammi ja mõistsin hiljem, et mu dist-kaust ei olnud õigesti kaardistatud, mistõttu käivitamiskäsk ebaõnnestus. Lihtsad näpunäited võivad need probleemid lahendada, kuid õige leidmine nõuab kannatlikkust 🔍. Kontrollides, kas kõik sõltuvused ja skriptid on õigesti kaardistatud, võib silumine säästa tunde.

Selles juhendis käsitleme mõningaid praktilisi samme selle vea parandamiseks, eriti kui kasutate oma taustaprogrammi koos andmebaasiga, nagu DynamoDB Dockeris. Otsime koos puuduva käivitusskripti vea tõrkeotsingut, et teie taustaprogramm töötaks sujuvalt!

Dockeri konfiguratsioon Node.js-i ja andmebaasiühenduse jaoks

Ülaltoodud näites kasutab Dockeri seadistus mitmeastmelist koostamist, mis on kasulik tõhusate tootmisvalmis konteinerite loomiseks. Esimene etapp, mida määratletakse kui "ehitaja", installib sõltuvused ja kompileerib TypeScript failid JavaScripti dist kausta. See samm tagab, et kompileeritud kood on tootmiseks valmis ilma tarbetuid arendaja sõltuvusi kaasamata. Pärast ülesehitamist kopeerib teine ​​etapp (käitusaeg) ainult kompileeritud failid ja tootmissõltuvused, vähendades konteineri suurust. See seadistus on eriti kasulik, kui kasutate sageli pilvekeskkonda, kus iga optimeerimine loeb! 🚀

The TÖÖDIREKTOR käsk mõlemas etapis määrab konteineri töökataloogiks /app. See lihtsustab failiteid ja korraldab kõik toimingud selle kataloogi ümber. Pärast seda, KOPERI juhised teisaldavad konkreetsed failid hostmasinast konteinerisse. Esimeses etapis kopeeritakse failid package*.json ja tsconfig.json, et võimaldada sõltuvuse installimist ja TypeScripti kompileerimist ning RUN npm install ja RUN npm run build käsud tagavad, et kõik on õigesti seadistatud. See seadistus aitab vältida selliseid probleeme nagu käivitusskriptide puudumine, tagades, et kõik failid on õigesti kopeeritud ja konfigureeritud.

The docker-compose.yml fail ühendab taustaprogrammiga DynamoDB, mis on kohalikuks testimiseks ja arendamiseks hädavajalik. The oleneb valik käsib Dockeril käivitada DynamoDB enne taustateenust, tagades, et andmebaas on valmis kõigiks taustaprogrammi ühenduskatseteks. Reaalses maailmas võib sellise sõltuvuse seadistuse puudumine põhjustada ühenduvusprobleeme, kui taustaprogramm käivitub enne andmebaasi, mille tulemuseks on masendavad vead. The tervisekontroll käsk testib, kas DynamoDB on lõpp-punkti pingimise teel kättesaadav, proovides uuesti, kuni ühendus luuakse. Selline veakäsitluse tase säästab aega, tagades teenuste käivitumise õiges järjekorras 🕒.

Lõpuks oleme failis package.json määratlenud alustada skript nagu sõlm dist/server.js. See käsk tagab, et NPM teab täpselt, millist faili konteineris käivitada, aidates vältida tõrget "puuduv käivitusskript". Samuti on olemas ehituskäsk TypeScripti koodi kompileerimiseks ja puhas käsk kausta dist eemaldamiseks, tagades, et iga juurutamine algab värskelt. Selliste npm-skriptide kasutamine muudab häälestuse usaldusväärsemaks, eriti kui Docker on kaasatud, kuna see pakub prognoositavaid teid ja toiminguid. See Dockeri, Docker Compose'i ja NPM-i skriptide põhjalik konfiguratsioon töötab koos, et luua sujuvam arendusest tootmiseni töövoog.

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

Failide õige kopeerimise ja struktuuri tagamine Dockeris Node.js projektide jaoks

Dockeris Node.js-i rakendustega töötades on üks peamisi kaalutlusi tagada, et kõik vajalikud failid oleksid konteineris õigesti kopeeritud ja struktureeritud. Mitmeetapilistes ehitustes, nagu ülaltoodud näites, on igal etapil konkreetne eesmärk. Algetapp "ehitaja" tegeleb TypeScripti JavaScripti kompileerimisega ja valmistab ette dist kausta. Teises etapis kaasatakse ainult tootmisfailid, vähendades konteineri suurust ja optimeerides juurutamist. See lähenemisviis mitte ainult ei vähenda tarbetut paisumist, vaid suurendab ka turvalisust, jättes välja arendustööriistad.

Docker for Node.js oluline aspekt on selle korraldamine package.json ja skripti käivitamine täpselt. Määrates Dockerfile'is teed selgelt ja tagades, et käivituskäsk on õigesti seadistatud package.json, minimeerite vead, nagu "Puuduv algusskript". Samuti on oluline kinnitada, et Docker teab, kus iga fail peaks olema, eriti keeruliste seadistuste korral, mis hõlmavad mitut teenust või kausta. Näiteks kasutades käsku COPY, et lisada ainult dist kaust ja vajalikud konfiguratsioonid lõppkonteinerisse tagab, et tootmises on saadaval ainult olulised failid 📂.

Et kontrollida oma teenuste seisukorda, docker-compose.yml fail kasutab tervisekontrolli, et kontrollida, kas andmebaas on valmis. Sõltuvuste määratlemisega tagame, et taustateenus ei käivitu enne, kui andmebaas reageerib, vältides ajastusega seotud ühenduseprobleeme. See seadistus on eriti kasulik reaalsetes rakendustes, kus andmebaasi ühenduvus on ülioluline. Ilma selle struktuurita võivad teenused proovida ühendust luua enne, kui teised teenused on käivitatud, mis põhjustab käitusvigu ja kasutajate võimalikke seisakuid 🔄.