DevOps 기초 1편

DevOps 기초

1. DevOps란?

DevOps는 단순히 Docker나 Kubernetes 같은 기술을 사용하는 것을 의미하지 않는다.

Development + Operations

코드 작성
   ↓
테스트
   ↓
빌드
   ↓
배포
   ↓
운영
   ↓
모니터링
   ↓
문제 수정
   ↓
다시 배포

이 전체 과정을 빠르고 안정적으로 만드는 개발 및 운영 방식이라고 볼 수 있다.

DevOps의 핵심은 자동화와 재현성이다.

예를 들어,

"내 컴퓨터에서는 실행되는데 서버에서는 실행되지 않는다."

라는 상황이 반복된다면 안정적인 개발 및 운영 환경이라고 보기 어렵다.

DevOps에서는 가능한 한

같은 실행 환경
같은 테스트 과정
같은 배포 방법
같은 설정 관리 방식

을 사용하도록 만들어 이러한 문제를 줄인다.

2. 가장 먼저 알아야 할 것: Linux

DevOps에서 사용하는 서버 환경은 Linux 기반인 경우가 많다.

따라서 Docker나 AWS를 배우기 전에 기본적인 Linux 명령어와 터미널 사용법을 익혀두는 것이 좋다.

~~참 쉽죠?~~

기본적으로 다음 정도는 알아두자.

pwd
ls
cd
mkdir
cp
mv
rm

cat
less
grep

ps
top
kill

chmod
chown

curl

ssh

예를 들어 현재 실행 중인 프로세스를 확인하려면 다음과 같이 사용할 수 있다.

ps aux

PID가 1234인 프로세스를 종료하려면 다음과 같이 실행한다.

kill 1234

서버가 정상적으로 HTTP 응답을 보내는지 확인할 때는 curl을 사용할 수 있다.

curl http://localhost:8000

왜 필요한가?

실제 서버에서 문제가 발생했을 때 GUI 환경이 없는 경우가 많다.

결국 터미널에서 직접

프로세스가 실행되고 있는가?
포트가 열려 있는가?
파일 권한은 정상인가?
서버가 요청에 응답하는가?
로그에는 어떤 오류가 기록되었는가?

등을 확인해야 한다.

3. Shell과 환경변수

서버에서는 명령어를 반복해서 실행해야 하는 일이 많다.

이때 Bash와 같은 Shell을 사용한다.

예를 들어 Python 프로그램을 실행하려면 다음과 같이 입력한다.

python app.py

환경변수는 다음과 같이 설정할 수 있다.

export API_KEY="secret"

Python에서는 os.getenv()를 이용해 환경변수를 가져올 수 있다.

import os

api_key = os.getenv("API_KEY")

왜 필요한가?

API Key나 DB Password 같은 민감한 정보를 코드에 직접 작성하면 안 된다.

예를 들어 다음과 같이 작성하는 것은 좋지 않다.

API_KEY = "abcdef123456"

대신

코드
+
환경변수

를 분리해서 관리한다.

이 개념은 이후 배우게 될

Docker
GitHub Actions
AWS
Kubernetes

에서도 계속 등장한다.

4. Git과 GitHub

DevOps 자동화는 대부분 Git을 기반으로 시작한다.

기본적인 흐름은 다음과 같다.

코드 수정
   ↓
git add
   ↓
git commit
   ↓
git push
   ↓
GitHub

필수적으로 알아두어야 할 개념은 다음과 같다.

Repository
Commit
Branch
Merge
Pull Request
Conflict
.gitignore

특히 .gitignore는 중요하다.

예를 들어 Python 프로젝트에서는 다음과 같은 파일을 Git에서 제외할 수 있다.

.env
.venv/
__pycache__/

API Key가 저장된 .env 파일이나 로컬 가상환경 같은 파일은 Git 저장소에 올리지 않는 것이 기본이다.

5. 네트워크 기초

DevOps를 배우면서 의외로 자주 막히는 부분이 네트워크다.

기본적으로 다음 개념은 알아둘 필요가 있다.

IP
Port
DNS
HTTP / HTTPS
TCP
localhost
127.0.0.1
0.0.0.0
Firewall

예를 들어 FastAPI 서버를 다음과 같이 실행한다고 하자.

uvicorn main:app --host 127.0.0.1 --port 8000

127.0.0.1에 바인딩하면 기본적으로 현재 컴퓨터 내부에서만 접근할 수 있다.

반면

uvicorn main:app --host 0.0.0.0 --port 8000

으로 실행하면 서버가 모든 네트워크 인터페이스에서 들어오는 요청을 받을 수 있도록 바인딩된다.

다만 실제 외부 접근 가능 여부는 방화벽, 공유기, 클라우드 보안 설정 등에 따라서도 달라진다.

이런 차이를 이해해야 Docker나 Cloud 환경에서 서버를 배포할 때 발생하는 문제를 쉽게 파악할 수 있다.

6. 패키지와 실행 환경 관리

DevOps에서 중요한 원칙 중 하나는 다음과 같다.

내가 아니더라도 다른 사람이 같은 실행 환경을 재현할 수 있어야 한다.

개발하면서 자주 발생하는 문제가 있다.

"내 컴퓨터에서는 되는데?"

실제로는 다음과 같은 차이가 원인일 수 있다.

Python 3.11
Python 3.12

Pydantic 1.x
Pydantic 2.x

NumPy 버전 차이

따라서 프로젝트에서 사용하는 의존성을 기록한다.

대표적인 방법이 requirements.txt이다.

fastapi
uvicorn
pydantic
httpx
pytest
ruff

예를 들어 다음 명령어로 설치할 수 있다.

pip install -r requirements.txt

최근 Python 프로젝트에서는 pyproject.toml을 중심으로 프로젝트 설정과 의존성을 관리하는 방식도 많이 사용한다.

결국 중요한 것은

누가 실행하더라도 동일한 환경을 최대한 재현할 수 있도록 만드는 것

이다.

7. 코드 품질 검사

여기서 앞에서 배운 Ruff가 연결된다.

코드 문제를 검사하려면 다음과 같이 실행한다.

ruff check .

자동으로 수정 가능한 문제를 고치려면 다음과 같이 사용할 수 있다.

ruff check . --fix

코드 포맷을 정리하려면 다음과 같이 실행한다.

ruff format .

DevOps에서는 이러한 코드 품질 검사를 사람이 매번 직접 수행하는 것이 아니라 자동화된 파이프라인에 포함시키는 것이 중요하다.

Developer
   ↓
Ruff
   ↓
문제 없음
   ↓
다음 단계

문제가 발견되면 다음 단계로 넘어가지 않도록 만들 수도 있다.

8. 자동 테스트

그다음 연결되는 것이 pytest이다.

pytest

예를 들어 다음과 같은 함수가 있다고 하자.

def add(a, b):
    return a + b

테스트 코드는 다음과 같이 작성할 수 있다.

def test_add():
    assert add(1, 2) == 3

코드를 수정할 때마다 사람이 모든 기능을 직접 확인하는 대신 테스트 프로그램이 코드의 동작을 자동으로 검사한다.

코드 변경
   ↓
pytest
   ↓
PASS / FAIL

기능이 많아질수록 자동 테스트의 중요성은 더욱 커진다.

9. CI - Continuous Integration

여기서 GitHub Actions가 등장한다.

CI(Continuous Integration)는 간단하게 말하면

코드가 저장소에 올라왔을 때 자동으로 검사하고 검증하는 과정

이라고 이해할 수 있다.

예를 들어 다음과 같은 Pipeline을 구성할 수 있다.

git push
   ↓
GitHub Actions
   ↓
Ruff
   ↓
pytest
   ↓
Build

즉 개발자가 코드를 Push하거나 Pull Request를 생성하면 GitHub Actions가 자동으로 코드 품질과 테스트 결과를 검사한다.

.github/workflows/ci.yml

name: CI

on:
  push:
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - run: pip install -r requirements.txt

      - run: ruff check .

      - run: pytest

이렇게 설정해두면 코드가 GitHub에 올라올 때마다 자동으로

Repository의 코드를 가져오고
Python 3.11 환경을 구성하고
필요한 패키지를 설치하고
Ruff로 코드 품질을 검사하고
pytest로 테스트를 수행한다.

하나라도 실패하면 CI 역시 실패한다.

~~신기한데?~~

개발자 코드 작성
       ↓
    git push
       ↓
 GitHub Actions
       ↓
 ┌───────────────┐
 │               │
Ruff            pytest
 │               │
 └───────┬───────┘
         ↓
     PASS / FAIL

결국 DevOps의 시작은 Docker, Kubernetes가 아니라,

코드를 작성하고 → 검사하고 → 테스트하고 → 동일한 방법으로 실행하는 과정을 자동화하는 것

부터 시작한다