Dockerfile

ale의 Dockerfile 템플릿을 활용해 Dockerfile을 간편하게 배포할 수 있습니다.

ale 의 템플릿 / 프리셋은 효율적인 리소스 관리를 위한 최소한의 라이브러리만 사용합니다. Windows, Chrome 라이브러리처럼 기본으로 제공되지 않는 라이브러리를 사용하려는 경우, 예제 코드를 참고해 Dockerfile을 작성해서 배포하세요.

저장소와 템플릿 선택

대시보드의 또는 ⌘ + K 로 생성되는 배포창에서 Dockerfile 템플릿을 선택하고, 이어지는 드롭다운 메뉴에서 연동된 GitHub 계정의 저장소를 선택하거나 Git URL 탭에서 Git 저장소 URL을 입력하세요.

배포 설정과 배포

기본 설정

Environment variables(ENV) : 컨테이너를 실행할 때 참조되는 환경변수
Build arguments(ARG) : 이미지를 빌드할 때 참조되는 인자
Port : 컨테이너가 실행되는 대상포트로, docker run 명령어의 -p, --publish 옵션에 적용되는 인자
Health Check : 컨테이너 상태 검증 엔드포인트
Start commands : 컨테이너 시작 명령어

더 많은 옵션

Dockerfile text : Dockerfile의 전체 내용 입력
Build Labels(LABEL) : Dockerfile로 컨테이너 이미지 빌드 시 버전, 라이센스 등 추가 정보 주입
uid : 컨테이너에서 프로세스를 실행하는 사용자의 고유한 식별자(기본값 1000)
gid : 컨테이너에서 프로세스가 속한 그룹의 고유한 식별자(기본값 1000)
Update strategy
- Rolling Update : 새로운 버전의 서비스 배포 시점에 기존 파드 종료, 노드 가용자원 확보 필요
- Recreate : 모든 서비스 종료후 새로운 버전의 서비스 생성 및 구동, 다운타임 발생
Shell : 컨테이너가 실행된 후 실행할 쉘(sh, bash, zsh 등)

성능(리소스) 설정과 배포

리소스 유형 : 온디맨드와 스팟 리소스 중 선택
CPU : 서비스가 사용할 vCPU 리소스의 최대값을 설정하며, ‘최소 vCPU’ 선택 시 0.1 vCPU 사용
메모리 : 서비스가 사용할 메모리 리소스의 최대값을 설정
동시실행(레플리카) : 설정한 수만큼 서비스가 수평확장되어 부하 분산 및 안정성 확보
배포 : 배포하기 클릭

리소스 제한으로 배포할 수 없는 경우 스페이스 및 리소스 관리 페이지를 참고해 스페이스에 리소스를 추가하세요.

로그와 터미널

서비스 카드 또는 상세페이지의 아이콘을 클릭하면, 배포/실행로그 조회 또는 터미널에 접속할 수 있습니다.

메트릭

서비스 상세페이지의 메트릭 탭에서, 서비스의 메트릭을 조회할 수 있습니다.

재배포(업데이트)

코드 수정, 리소스 변경 등 업데이트할 내역이 있는 경우, 서비스 상세페이지 설정탭 하단부의 배포하기를 클릭하면 업데이트를 반영한 새로운 배포가 진행됩니다.

배포 자동화를 위한 GitHub Actions 적용은 GitHub Actions 페이지를 참고하세요.

롤백(복원)

서비스 상세페이지의 배포내역탭에서 이전 버전의 서비스 상태로 복원할 수 있습니다.

복원할 버전을 혼동하지 않기 위해, 커밋 메세지를 확인하세요.

언어별 참고 예제 코드

Node.js - Express

Github 저장소로 이동

# 의존성 설치
FROM node:16-buster
WORKDIR /app
COPY package*.json ./ 
RUN npm ci --only=production

ENV NODE_ENV production

COPY . .

# node 이미지에 이미 "node"라는 사용자가 uid/gid 1000번으로 생성되어 있음
USER node

EXPOSE 3000
CMD ["npm", "start"]

React

Github 저장소로 이동

# 프로젝트 빌드
FROM node:16-buster AS builder
WORKDIR /app
COPY package*.json .
RUN npm ci
COPY . .
RUN npm run build

# Production 런타임 - nginx
FROM nginxinc/nginx-unprivileged:1.23 AS runner
WORKDIR /usr/share/nginx/html
COPY --from=builder /app/build .

EXPOSE 3000
CMD ["nginx", "-g", "daemon off;"]

Python Flask

Github 저장소로 이동

FROM python:3.9-slim-buster

ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED 1

ARG UID=1000
ARG GID=1000

RUN groupadd -g "${GID}" python \
  && useradd --create-home --no-log-init -u "${UID}" -g "${GID}" python
WORKDIR /home/python

COPY --chown=python:python requirements.txt requirements.txt
RUN pip3 install -r requirements.txt

# USER 변경은 반드시 pip 패키지 설치 스크립트 이후에 작성되어야 함
USER python:python
ENV PATH="/home/${USER}/.local/bin:${PATH}"
COPY --chown=python:python . .

ARG FLASK_ENV

ENV FLASK_ENV=${FLASK_ENV}

EXPOSE 5000

# WSGI, 포트 번호, 모듈명 등은 각 소스 코드에 알맞게 수정하여 배포 진행
CMD ["gunicorn", "-b", "0.0.0.0:5000", "app:app"]

Spring Boot

Github 저장소로 이동

# JDK 이미지를 통한 executable jar 빌드
FROM eclipse-temurin:17-alpine AS build
RUN apk add --no-cache bash

WORKDIR /app

COPY gradlew .
COPY gradle gradle
COPY build.gradle settings.gradle ./
# COPY build.gradle.kts settings.gradle.kts ./    Kotlin인 경우 .kts 확장자 적용

RUN ./gradlew dependencies --no-daemon

COPY . .

RUN chmod +x ./gradlew

RUN ./gradlew bootJar --no-daemon

# jar 실행을 위한 JRE 이미지 적용
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app

RUN addgroup -g 1000 worker && \
    adduser -u 1000 -G worker -s /bin/sh -D worker

COPY --from=build --chown=worker:worker /app/build/libs/*.jar ./main.jar

USER worker:worker

EXPOSE 8080

ENTRYPOINT ["java", "-jar", "main.jar"]

Spring Boot(멀티모듈)

Github 저장소로 이동

# JDK 이미지를 통한 executable jar 빌드
FROM eclipse-temurin:17-alpine AS build
RUN apk add --no-cache bash

WORKDIR /app

COPY gradlew .
COPY gradle gradle
COPY build.gradle settings.gradle ./
# COPY build.gradle.kts settings.gradle.kts ./    Kotlin인 경우 .kts 확장자 적용

RUN ./gradlew dependencies --no-daemon

COPY . .

RUN chmod +x ./gradlew

RUN ./gradlew bootJar :api:bootJar --no-daemon
# RUN ./gradlew bootJar :<main 지정 모듈명>:bootJar --no-daemon

# jar 실행을 위한 JRE 이미지 적용
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app

RUN addgroup -g 1000 worker && \
    adduser -u 1000 -G worker -s /bin/sh -D worker

COPY --from=build --chown=worker:worker /app/api/build/libs/*.jar ./main.jar
# COPY --from=build --chown=worker:worker /app/<main 지정 모듈명>/build/libs/*.jar ./main.jar

USER worker:worker

EXPOSE 8080

ENTRYPOINT ["java", "-jar", "main.jar"]

Spring Boot CRUD App(Gradle)

Github 저장소로 이동

# Build
FROM eclipse-temurin:17-alpine AS build
RUN apk add --no-cache bash

WORKDIR /app

COPY gradlew .
COPY gradle gradle
COPY build.gradle.kts settings.gradle.kts ./

RUN ./gradlew dependencies --no-daemon

COPY . .

RUN chmod +x ./gradlew

RUN ./gradlew build --no-daemon -x test


# Runtime
FROM eclipse-temurin:17-jre-alpine AS runtime
WORKDIR /app

RUN addgroup -g 1000 worker && \
    adduser -u 1000 -G worker -s /bin/sh -D worker

COPY --from=build --chown=worker:worker /app/build/libs/*.jar ./main.jar

USER worker:worker

ENV PROFILE=${PROFILE}

EXPOSE 8080

ENTRYPOINT ["java", "-Dspring.profiles.active=${PROFILE}", "-jar", "main.jar"]

Spring Boot CRUD App(Maven)

Github 저장소로 이동

# Build
FROM eclipse-temurin:17-alpine AS build
RUN apk add --no-cache bash

WORKDIR /app

COPY mvnw .
COPY .mvn .mvn
COPY pom.xml .

RUN ./mvnw dependency:go-offline -B

COPY . .

RUN chmod +x ./mvnw

RUN ./mvnw package -DskipTests


# Runtime
FROM eclipse-temurin:17-jre-alpine as runtime

WORKDIR /app

RUN addgroup -g 1000 worker && \
    adduser -u 1000 -G worker -s /bin/sh -D worker

COPY --from=build --chown=worker:worker /app/target/*.jar ./main.jar

USER worker:worker

ENV PROFILE=${PROFILE}

EXPOSE 8080

ENTRYPOINT ["java", "-Dspring.profiles.active=${PROFILE}", "-jar", "main.jar"]

Getting Started

배포하기

관리하기

기능

애플리케이션 배포 예제

CLI

Dockerfile

저장소와 템플릿 선택

배포 설정과 배포

기본 설정

더 많은 옵션

성능(리소스) 설정과 배포

로그와 터미널

메트릭

재배포(업데이트)

롤백(복원)

언어별 참고 예제 코드

Getting Started

배포하기

관리하기

기능

애플리케이션 배포 예제

CLI

​저장소와 템플릿 선택

​배포 설정과 배포

​기본 설정

​더 많은 옵션

​성능(리소스) 설정과 배포

​로그와 터미널

​메트릭

​재배포(업데이트)

​롤백(복원)

​언어별 참고 예제 코드

저장소와 템플릿 선택

배포 설정과 배포

기본 설정

더 많은 옵션

성능(리소스) 설정과 배포

로그와 터미널

메트릭

재배포(업데이트)

롤백(복원)

언어별 참고 예제 코드