본문으로 건너뛰기

Portal의 Startup 탭에서 서버의 Docker 이미지, 설치 명령, 시작 명령을 설정하는 방법.

Portal의 Startup 탭은 서버가 어떻게 빌드되고 실행되는지를 제어해요. 세 가지 핵심 설정이 있어요: Docker 이미지(런타임 버전), 설치 명령(의존성 설정), 시작 명령(애플리케이션을 실행하는 명령). 이를 올바르게 설정하는 것이 서버가 정상적으로 작동하는 데 필수예요.

배울 내용

  • 올바른 Docker 이미지(런타임 버전)를 고르는 방법
  • 설치 명령과 시작 명령의 차이
  • Node.js와 Python의 일반적인 예시
  • Startup 탭으로 대화형 셸에 접근하는 방법

Docker 이미지

Daki는 각 서버를 Docker 컨테이너 안에서 실행해요. Docker 이미지는 그 컨테이너 안에서 어떤 프로그래밍 언어 버전을 쓸 수 있는지 결정해요.

Startup 탭에는 이미지를 선택하는 드롭다운이 있어요. 항상 애플리케이션이 요구하는 것과 맞춰 주세요.

런타임이미지 예시
Node.jsNode.js 22, Node.js 24, Node.js 26 (이전 버전은 EOL 표시)
PythonPython 3.11~3.15 (이전 버전은 EOL 표시)
JavaJava 17, Java 21
기타Rust, C#, Lua 등 (유료 플랜)

잘못된 런타임 버전을 고르면 시작에 실패해요. 프로젝트에 Node.js 22 기능이 필요하다면 Node.js 18을 선택하지 마세요.

Node.js와 Python 이미지는 Daki Yolks예요. 보안 수정이 나올 때마다 자동으로 다시 빌드되며, 서버를 재시작하면 최신 이미지를 받아요. EOL로 표시된 이미지는 더 이상 보안 업데이트를 받지 못해요. Eggs & Docker 이미지를 참고하세요.


설치 명령

설치 명령은 서버를 설정하거나 재설치할 때 한 번 실행돼요. 의존성을 설치하고 환경을 준비하도록 설계되어 있어요.

런타임일반적인 설치 명령
Node.jsnpm install
Pythonpip install -r requirements.txt

의존성이 자동으로 설치되도록 이 항목을 설정하세요. 프로젝트에 맞게 이 명령을 자유롭게 바꿀 수 있어요 — 예를 들어 다른 패키지 관리자를 쓴다면(예: yarn install 또는 pnpm install).


시작 명령

시작 명령은 서버가 시작될 때마다 실행돼요. 실제로 애플리케이션을 실행하는 명령이에요.

애플리케이션 종류시작 명령
Node.js — 단일 진입 파일node index.js
Node.js — npm start 스크립트npm start
Python — 단일 진입 파일python main.py
Python — 모듈로 실행python -m mypackage

프로젝트 구조, 진입점, 애플리케이션에 필요한 플래그나 인수에 맞게 시작 명령을 자유롭게 바꿀 수 있어요.

중요: 파일 이름은 대소문자를 구분해요. 시작 명령의 파일 이름이 파일 관리자에 표시된 이름과 정확히 일치하는지 확인하세요.


대화형 셸 접근

디버깅, 파일 확인, 일회성 명령 실행 등을 위해 컨테이너와 직접 상호작용하며 명령을 수동으로 실행하고 싶다면, 시작 명령을 임시로 bash로 설정할 수 있어요.

  1. Startup 탭으로 이동하세요.
  2. 시작 명령을 bash로 바꾸세요.
  3. 서버를 재시작하세요.
  4. Console 탭을 여세요 — 이제 셸 명령을 직접 입력할 수 있어요.

시작 명령이 bash로 설정되어 있는 동안에는 애플리케이션이 자동으로 시작되지 않아요. 작업이 끝나면 원래 시작 명령으로 되돌리세요. 자세한 내용은 콘솔 & 전원 작업을 참고하세요.


egg(프로그래밍 언어) 변경하기

egg는 전체 프로그래밍 언어와 프레임워크를 정의해요. 한 언어에서 다른 언어로 바꾸려면(예: Node.js → Python) Startup 탭이 아니라 Settings 탭을 사용하세요. egg를 바꾸면 재설치가 실행되므로, 미리 백업해 두기를 강력히 권장해요. 서버 설정을 참고하세요.


팁

  • Startup 탭에서 설정을 바꾼 뒤에는 변경 사항이 적용되도록 서버를 재시작하세요.
  • 서버가 시작하자마자 충돌하면, Console 탭의 출력에서 대부분 그 이유를 확인할 수 있어요.
  • 시작 명령의 파일 이름을 파일 관리자에 표시된 이름과 다시 한번 대조하세요.

다음 단계