SSH 접속과 배포

키 페어 다운로드, 접속 명령, PuTTY 설정, 코드 올리기

키 페어

인스턴스를 만들 때 키 페어를 새로 만들거나 기존 것을 고릅니다. 새로 만들면 개인키를 한 번만 내려받을 수 있습니다. 엔트위즈는 개인키를 보관하지 않습니다. 잃어버리면 콘솔에서 새 키를 만들어 인스턴스에 다시 주입해야 합니다.

접속

인스턴스마다 전용 SSH 포트(22000–22999)가 배정됩니다. 호스트명은 공통 ssh.entwizhosting.com입니다.

chmod 600 my-key.pem
ssh -i my-key.pem -p 22011 [email protected]

PuTTY에서는 Host Name에 ssh.entwizhosting.com, Port에 배정된 포트, Connection → SSH → Auth → Credentials에 .ppk를 지정합니다.

접속이 안 되면 먼저 보안그룹에서 인바운드 22번이 허용돼 있는지, 그다음 로컬 방화벽이 22000번대 포트를 막고 있지 않은지 확인하세요.

기본 사용자

• 사용자: ubuntu (sudo 가능)
• OS: Ubuntu 24.04 LTS
• 패키지 설치는 apt를 그대로 씁니다.

코드 올리기

가장 단순한 방법은 rsync입니다.

rsync -avz -e "ssh -i my-key.pem -p 22011" ./dist/ [email protected]:/srv/app/

Git을 쓰면 인스턴스에서 직접 git pull 하거나, GitHub Actions에서 위 rsync 명령을 실행하면 됩니다. 비밀키는 Actions Secret에 넣으세요.

프로세스 관리

Node.js는 pm2, Java는 systemd 유닛을 권합니다. 인스턴스 재시작 시 자동 시작되도록 등록해 두세요.

sudo npm i -g pm2
pm2 start dist/main.js --name api
pm2 save && pm2 startup

스왑·메모리

인스턴스에는 메모리 상한이 걸려 있습니다. 상한을 넘으면 프로세스가 종료될 수 있으니, 빌드는 로컬이나 CI에서 하고 결과물만 올리는 편이 안전합니다.