Coolify 자동배포 스타터 킷

Git Push 한 번으로 프로덕션까지.셀프호스팅 PaaS로 완전한 배포 자동화를 경험하세요.

무료
오픈소스
1분
배포 시간
무제한
프로젝트

배포 아키텍처

Git Push부터 프로덕션 배포까지, 완전 자동화된 CI/CD 파이프라인

Step 1

Git Push

코드를 GitHub/GitLab에 푸시

Step 2

Webhook

자동으로 Coolify에 알림

Step 3

Coolify

빌드 & 배포 오케스트레이션

Step 4

Docker

컨테이너 이미지 빌드

Step 5

Deploy

프로덕션 배포 완료

평균 배포 시간: 30초 ~ 2분 (프로젝트 크기에 따라 다름)

주요 기능

Coolify가 제공하는 강력한 기능들로 배포 워크플로우를 혁신하세요

자동 배포

Git Push만 하면 자동으로 빌드하고 배포합니다. Webhook 기반의 실시간 CI/CD 파이프라인으로 수동 작업이 필요 없습니다.

Docker 기반

모든 애플리케이션을 Docker 컨테이너로 실행합니다. Nixpacks 또는 커스텀 Dockerfile로 유연하게 빌드할 수 있습니다.

SSL 자동 발급

Let's Encrypt를 통해 SSL 인증서를 자동으로 발급하고 갱신합니다. HTTPS 설정에 대해 걱정할 필요가 없습니다.

환경변수 관리

웹 UI에서 환경변수를 안전하게 관리하세요. Preview와 Production 환경을 분리하여 설정할 수 있습니다.

데이터베이스 지원

PostgreSQL, MySQL, MongoDB, Redis 등 다양한 데이터베이스를 원클릭으로 배포하고 관리할 수 있습니다.

모니터링

실시간 로그 확인, 리소스 사용량 모니터링, 배포 히스토리 추적이 가능합니다. 문제 발생 시 빠르게 대응하세요.

초기 설정 가이드

단계별 가이드를 따라 Coolify 자동배포를 설정하세요

1
Step 1 of 5

Coolify 서버 연결

Coolify 대시보드에 접속하여 새 서버를 추가하거나 기존 서버를 선택합니다.

  • Coolify 대시보드 로그인
  • Settings → Servers 메뉴 이동
  • SSH 키 또는 비밀번호로 서버 연결
2
Step 2 of 5

GitHub 레포지토리 연결

GitHub App을 설치하고 배포할 레포지토리를 연결합니다.

  • Projects → New Resource 클릭
  • GitHub App 설치 및 권한 부여
  • 배포할 레포지토리 선택
3
Step 3 of 5

빌드 설정

Nixpacks 자동 감지를 사용하거나 Dockerfile로 커스텀 빌드를 설정합니다.

  • 빌드 팩 선택: Nixpacks (권장) 또는 Dockerfile
  • 빌드 명령어 설정 (필요시)
  • 시작 명령어 설정
4
Step 4 of 5

환경변수 설정

애플리케이션에 필요한 환경변수를 안전하게 설정합니다.

  • Settings → Environment Variables 이동
  • 필요한 환경변수 추가 (예: DATABASE_URL)
  • Preview/Production 환경별 설정 분리
5
Step 5 of 5

도메인 연결

커스텀 도메인을 연결하고 SSL 인증서를 자동 발급받습니다.

  • Settings → Domains 에서 도메인 추가
  • DNS에서 A 레코드 또는 CNAME 설정
  • Let's Encrypt SSL 자동 발급 확인
설정 완료 후 Git Push하면 자동 배포됩니다!

코드 스니펫

프로젝트에 바로 사용할 수 있는 설정 파일 예시

Dockerfile
# Node.js 애플리케이션 예시
FROM node:20-alpine AS base

# Dependencies
FROM base AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci

# Builder
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN npm run build

# Runner
FROM base AS runner
WORKDIR /app
ENV NODE_ENV=production

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public
COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs
EXPOSE 3000
ENV PORT=3000
CMD ["node", "server.js"]

Nixpacks 추천

Dockerfile이 없으면 Nixpacks가 자동으로 빌드 설정을 감지합니다.

보안 주의

.env 파일은 Git에 커밋하지 말고 Coolify 환경변수로 관리하세요.

배포 전 체크리스트

첫 배포 전 확인해야 할 항목들을 체크하세요

진행률0 / 15 완료

서버 설정

레포지토리

빌드 설정

환경변수

도메인 & SSL