Усунення помилки «Відсутній початковий сценарій» у Node.js у Docker

Запуск Node.js Backend у Docker: Посібник з усунення несправностей

Помилка під час спроби запустити ваш Сервер Node.js всередині a Докер-контейнер може бути неприємним, особливо коли це пов’язано з простим повідомленням «Відсутній початковий сценарій». Ця помилка часто виникає, коли НПМ не може знайти правильну команду запуску у ваших налаштуваннях. Якщо ви постраждали від цього, ви не самотні!

У багатьох випадках проблема зводиться до неправильних шляхів або неузгоджених конфігурацій між параметрами package.json і Docker. Маючи справу, легко не помітити дрібну деталь багатоступеневі збірки, файли контейнеризації та конфігурації. Я сам зіткнувся з цією проблемою, і можу сказати, що її вирішення часто передбачає перевірку розташування кожного файлу та сценаріїв.

Наприклад, одного разу я розгорнув бекенд і пізніше зрозумів, що моя папка dist була неправильно зіставлена, що спричинило помилку запуску команди. Прості налаштування можуть вирішити ці проблеми, але щоб знайти правильний, потрібне терпіння 🔍. Перевірка правильності відображення всіх залежностей і сценаріїв може заощадити години налагодження.

У цьому посібнику ми зануримося в деякі практичні кроки для виправлення цієї помилки, особливо якщо ви використовуєте серверну систему разом із базою даних, як DynamoDB у Docker. Давайте разом усунемо помилку «відсутній початковий сценарій», щоб забезпечити безперебійну роботу вашого сервера!

Конфігурація Docker для Node.js і підключення до бази даних

У наведеному вище прикладі налаштування Docker використовує багатоетапну збірку, яка корисна для створення ефективних готових до виробництва контейнерів. Перший етап, визначений як «конструктор», встановлює залежності та компілює TypeScript файли в JavaScript у відст папку. Цей крок гарантує, що скомпільований код готовий до виробництва без включення непотрібних залежностей розробника. Після створення друга стадія (виконання) копіює лише скомпільовані файли та робочі залежності, мінімізуючи розмір контейнера. Це налаштування особливо корисно, якщо ви часто розгортаєте в хмарних середовищах, де кожна оптимізація має значення! 🚀

The WORKDIR на обох етапах встановлює робочий каталог контейнера на /app. Це спрощує шляхи до файлів і організовує всі операції навколо цього каталогу. Після цього КОПІЮВАТИ інструкції переміщують певні файли з головної машини в контейнер. На першому етапі файли package*.json і tsconfig.json копіюються, щоб дозволити встановлення залежностей і компіляцію TypeScript, а також ЗАПУСТИТИ npm install і RUN npm run build команди гарантують, що все налаштовано правильно. Це налаштування допомагає уникнути таких проблем, як відсутність сценаріїв запуску, переконавшись, що всі файли правильно скопійовано та налаштовано.

The docker-compose.yml файл з’єднує серверну частину з DynamoDB, що є важливим для локального тестування та розробки. The залежить_від Параметр повідомляє Docker запускати DynamoDB перед серверною службою, гарантуючи, що база даних готова до будь-яких спроб підключення з серверної частини. У реальних сценаріях відсутність такого налаштування залежностей може призвести до проблем із підключенням, коли серверна програма запускається перед базою даних, що призводить до неприємних помилок. The перевірка стану здоров'я команда перевіряє, чи доступний DynamoDB, шляхом pingування кінцевої точки, повторюючи спроби, доки не буде встановлено з’єднання. Цей рівень обробки помилок економить час, забезпечуючи запуск служб у правильному порядку 🕒.

Нарешті, у package.json ми визначили початок сценарій як вузол dist/server.js. Ця команда гарантує, що NPM точно знає, який файл запустити в контейнері, допомагаючи уникнути помилки «відсутній початковий сценарій». Існує також команда збірки для компіляції коду TypeScript і команда clean для видалення папки dist, гарантуючи, що кожне розгортання починається заново. Використання таких сценаріїв npm робить налаштування більш надійними, особливо коли задіяний Docker, оскільки він пропонує передбачувані шляхи та дії. Ця комплексна конфігурація сценаріїв Docker, Docker Compose та NPM працює разом, щоб створити спрощений робочий процес від розробки до виробництва.

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

Забезпечення належного копіювання та структури файлів у Docker для проектів Node.js

Під час роботи з програмами Node.js у Docker одним із ключових моментів є забезпечення правильного копіювання та структурування всіх необхідних файлів у контейнері. У багатоетапних збірках, як у прикладі вище, кожен етап має певну мету. Початковий етап, «конструктор», обробляє компіляцію TypeScript до JavaScript і готує відст папку. На другому етапі включаються лише робочі файли, що зменшує розмір контейнера та оптимізує розгортання. Цей підхід не тільки зменшує непотрібне роздування, але й підвищує безпеку, виключаючи інструменти розробки.

Важливим аспектом Docker для Node.js є організація package.json і стартовий сценарій точно. Чітко вказавши шляхи у файлі Docker і переконавшись, що команда запуску правильно налаштована package.json, ви мінімізуєте такі помилки, як «Відсутній початковий сценарій». Також важливо підтвердити, що Docker знає, де має бути кожен файл, особливо в складних налаштуваннях із залученням кількох служб або папок. Наприклад, за допомогою команди COPY додати лише відст папку та необхідні конфігурації до кінцевого контейнера гарантує, що лише важливі файли доступні у виробництві 📂.

Щоб перевірити працездатність ваших послуг, docker-compose.yml файл використовує перевірку працездатності, щоб переконатися, що база даних готова. Визначаючи залежності, ми гарантуємо, що серверна служба не запускається, доки база даних не реагує, що запобігає проблемам підключення, пов’язаним із часом. Це налаштування є особливо корисним у реальних програмах, де підключення до бази даних є життєво важливим. Без цієї структури служби можуть спробувати підключитися до того, як інші служби запрацюють, що призведе до помилок під час виконання та потенційного простою для користувачів 🔄.