DevOps 실무 활용 팁 초급 가이드

DevOps 실무에서 자주 사용되는 핵심 도구와 기법을 다룹니다. Docker, CI/CD, 모니터링 등 초급 개발자가 알아야 할 필수 DevOps 개념을 실제 코드 예제와 함께 학습합니다.

---

---

들어가며

이 글에서는 DevOps 실무 활용 팁 초급 가이드에 대해 상세히 알아보겠습니다. 총 10가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. Docker_컨테이너_기본_사용
2. Docker_Compose로_다중_컨테이너_관리
3. GitHub_Actions_CI/CD_파이프라인
4. 환경_변수_안전하게_관리하기
5. 헬스_체크_엔드포인트_구현
6. 로깅_구조화하기
7. 간단한_모니터링_메트릭_수집
8. 배포_자동화_스크립트
9. 리소스_사용량_제한하기
10. 롤링_업데이트_전략

---

1. Docker 컨테이너 기본 사용

개요

Dockerfile을 작성하여 애플리케이션을 컨테이너화하는 방법입니다. 간단한 Python 웹 앱을 Docker 이미지로 만들 수 있습니다.

코드 예제

FROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "app.py"]

설명

Python 3.9 베이스 이미지를 사용하고, 의존성을 설치한 후 애플리케이션을 실행합니다. 8000번 포트로 서비스를 제공합니다.

---

2. Docker Compose로 다중 컨테이너 관리

개요

여러 서비스(웹 서버, 데이터베이스)를 함께 실행할 때 Docker Compose를 사용합니다. 하나의 명령으로 전체 스택을 시작할 수 있습니다.

코드 예제

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8000:8000"
  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: secret

설명

웹 애플리케이션과 PostgreSQL 데이터베이스를 동시에 실행합니다. docker-compose up 명령 하나로 전체 환경을 구성할 수 있습니다.

---

3. GitHub Actions CI/CD 파이프라인

개요

코드를 푸시할 때마다 자동으로 테스트를 실행하는 CI 파이프라인입니다. GitHub Actions를 사용하여 자동화된 테스트 환경을 구축합니다.

코드 예제

name: CI
on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - run: pip install -r requirements.txt
      - run: pytest tests/

설명

코드가 푸시되면 자동으로 의존성을 설치하고 pytest로 테스트를 실행합니다. 테스트 실패 시 즉시 알림을 받을 수 있습니다.

---

4. 환경 변수 안전하게 관리하기

개요

비밀번호나 API 키 같은 민감한 정보는 환경 변수로 관리해야 합니다. .env 파일과 python-dotenv를 사용하여 안전하게 관리합니다.

코드 예제

from dotenv import load_dotenv
import os

load_dotenv()

DB_PASSWORD = os.getenv('DB_PASSWORD')
API_KEY = os.getenv('API_KEY')
print(f"Using API: {API_KEY[:4]}***")

설명

.env 파일에서 환경 변수를 불러와 사용합니다. 코드에 직접 비밀번호를 작성하지 않아 보안이 강화됩니다.

---

5. 헬스 체크 엔드포인트 구현

개요

애플리케이션이 정상 작동하는지 확인하는 헬스 체크 API입니다. 모니터링 시스템이나 로드 밸런서가 서비스 상태를 확인할 때 사용합니다.

코드 예제

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/health')
def health_check():
    return jsonify({"status": "healthy"}), 200

설명

/health 엔드포인트에 접근하면 서비스 상태를 JSON으로 반환합니다. 모니터링 도구가 주기적으로 호출하여 서비스 가용성을 확인합니다.

---

6. 로깅 구조화하기

개요

JSON 형식으로 로그를 기록하면 나중에 검색과 분석이 쉬워집니다. structlog를 사용하여 구조화된 로그를 작성합니다.

코드 예제

import structlog

logger = structlog.get_logger()

logger.info("user_login",
            user_id=123,
            ip="192.168.1.1",
            success=True)

설명

단순 텍스트 대신 구조화된 JSON 로그를 기록합니다. 나중에 user_id나 ip로 로그를 쉽게 필터링하고 분석할 수 있습니다.

---

7. 간단한 모니터링 메트릭 수집

개요

Prometheus 형식으로 애플리케이션 메트릭을 노출합니다. 요청 수, 응답 시간 등을 모니터링할 수 있습니다.

코드 예제

from prometheus_client import Counter, generate_latest
from flask import Response

request_count = Counter('requests_total', 'Total requests')

@app.route('/metrics')
def metrics():
    request_count.inc()
    return Response(generate_latest(), mimetype='text/plain')

설명

요청이 올 때마다 카운터를 증가시키고 /metrics 엔드포인트에서 메트릭을 제공합니다. Prometheus가 주기적으로 수집하여 모니터링합니다.

---

8. 배포 자동화 스크립트

개요

빌드, 테스트, 배포를 자동화하는 쉘 스크립트입니다. 한 번의 명령으로 전체 배포 프로세스를 실행할 수 있습니다.

코드 예제

#!/bin/bash
set -e
echo "Running tests..."
pytest tests/
echo "Building Docker image..."
docker build -t myapp:latest .
echo "Deploying..."
docker push myapp:latest

설명

테스트 실행, Docker 이미지 빌드, 레지스트리에 푸시하는 과정을 자동화합니다. set -e로 에러 발생 시 즉시 중단됩니다.

---

9. 리소스 사용량 제한하기

개요

Docker 컨테이너의 CPU와 메모리 사용량을 제한하여 시스템 리소스를 효율적으로 관리합니다.

코드 예제

version: '3.8'
services:
  web:
    image: myapp:latest
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 512M

설명

컨테이너가 최대 CPU 50%, 메모리 512MB만 사용하도록 제한합니다. 리소스 고갈을 방지하고 안정적인 서비스 운영이 가능합니다.

---

10. 롤링 업데이트 전략

개요

서비스 중단 없이 새 버전을 배포하는 롤링 업데이트 설정입니다. 점진적으로 새 버전으로 교체됩니다.

코드 예제

version: '3.8'
services:
  web:
    image: myapp:latest
    deploy:
      replicas: 3
      update_config:
        parallelism: 1
        delay: 10s

설명

3개의 복제본 중 한 번에 하나씩 업데이트합니다. 10초 간격으로 순차적으로 배포하여 서비스 중단을 최소화합니다.

---

마치며

이번 글에서는 DevOps 실무 활용 팁 초급 가이드에 대해 알아보았습니다. 총 10가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#DevOps #Docker #CI/CD #Monitoring #Automation