아토믹데브_3_파이썬과 MSA 기반의 기업용 솔루션 개발 실무

3. 개발 환경 세팅: Windows 기반

이 섹션에서는 Windows 운영체제에서 파이썬 기반의 마이크로서비스 아키텍처(MSA) 개발을 위한 환경을 단계별로 설정하는 방법을 안내합니다. 각 단계에서는 파이썬 개발 환경을 구성하고 Docker를 설치하여 기본적인 컨테이너 작업을 수행하는 방법을 설명합니다.

---

1. 파이썬 개발 환경 구성

Step 1: 파이썬(Python) 설치

1. 파이썬 다운로드:
   • 웹 브라우저를 열고 파이썬 공식 웹사이트에 접속합니다.
   • 페이지에서 최신 버전의 파이썬 설치 파일(Windows Installer)을 다운로드합니다.
2. 파이썬 설치:
   • 다운로드한 설치 파일(python-<version>.exe)을 실행합니다.
   • 설치 첫 화면에서 "Add Python 3.x to PATH" 옵션을 체크한 후, **"Install Now"**를 클릭합니다. 이 옵션은 파이썬을 시스템 경로에 추가하여 명령 프롬프트에서 바로 사용할 수 있도록 합니다.
   • 설치가 완료되면, "Disable path length limit" 버튼을 클릭하여, Windows의 경로 길이 제한을 해제할 수 있습니다. 이는 나중에 길어진 파일 경로로 인한 문제를 방지합니다.

     

3. 설치 확인:
   • Win + R을 눌러 실행 창을 열고, cmd를 입력하여 명령 프롬프트를 엽니다.
   • 명령 프롬프트에서 python --version 또는 python -V 명령을 입력하여 파이썬이 제대로 설치되었는지 확인합니다.
   • 정상적으로 설치되었다면 파이썬 버전이 출력됩니다.

 

Step 2: 파이썬 패키지 관리 도구(PIP) 설정

1. pip 업그레이드:
   • 파이썬 설치와 함께 pip라는 패키지 관리 도구가 자동으로 설치됩니다. pip를 최신 버전으로 업그레이드하는 것이 좋습니다.
   • 명령 프롬프트에서 다음 명령을 실행합니다: 

     python -m pip install --upgrade pip

      
   • 업그레이드가 완료되면, pip --version을 입력하여 설치된 pip의 버전을 확인합니다.

Step 3: 가상 환경(Virtual Environment) 설정

1. 가상 환경 설치:
   • 프로젝트마다 독립된 파이썬 환경을 설정하기 위해 가상 환경을 사용합니다.
   • 명령 프롬프트에서 다음 명령을 실행하여 venv 모듈을 설치합니다:
      

     python -m pip install virtualenv

2. 가상 환경 생성:
   • 프로젝트 폴더로 이동한 후, 가상 환경을 생성합니다.
   • 예를 들어, myproject라는 이름의 폴더에서 다음 명령을 실행합니다:
      

     python -m venv venv

   • 이 명령은 venv라는 이름의 가상 환경 폴더를 생성합니다.
3. 가상 환경 활성화:
   • 가상 환경을 활성화하려면 다음 명령을 실행합니다: 
   •  

     .\venv\Scripts\activate

   • 활성화된 후에는 명령 프롬프트 앞에 (venv)라는 표시가 추가됩니다.
4. 패키지 설치:
   • 가상 환경이 활성화된 상태에서 필요한 파이썬 패키지를 설치할 수 있습니다. 예를 들어, Flask를 설치하려면 다음 명령을 실행합니다:
      

     pip install Flask

5. 가상 환경 비활성화:
   • 작업이 끝난 후 가상 환경을 비활성화하려면 다음 명령을 실행합니다:
      

     deactivate

 

---

2. Docker 설치 및 기본 사용법

Step 1: Docker Desktop 설치

1. Docker Desktop 다운로드:
   • Docker 공식 웹사이트에서 Docker Desktop for Windows를 다운로드합니다.
2. Docker Desktop 설치:
   • 다운로드한 설치 파일(Docker Desktop Installer.exe)을 실행합니다.
   • 설치 과정에서 기본 옵션을 사용하고, Docker가 필요한 컴포넌트(예: WSL 2 또는 Hyper-V)가 설치되도록 합니다.
   • 설치가 완료되면, Docker Desktop을 실행합니다.

     

3. Docker Desktop 설정:
   • 첫 실행 시, Docker가 Windows에 필요한 구성 요소를 설치하도록 허용합니다.
   • WSL 2(Windows Subsystem for Linux 2)를 기본 백엔드로 사용할 것을 권장합니다. Docker Desktop 설정에서 WSL 2를 사용하도록 선택할 수 있습니다.
   • Docker Desktop이 정상적으로 실행되면, 시스템 트레이에 고래 아이콘이 나타납니다.

 

Step 2: Docker 기본 사용법

1. Docker 명령어 확인:
   • 명령 프롬프트 또는 PowerShell을 열고 docker --version 명령을 실행하여 Docker가 정상적으로 설치되었는지 확인합니다.
   • 다음으로 docker run hello-world 명령을 실행하여 Docker가 제대로 작동하는지 확인합니다. 이 명령은 간단한 컨테이너를 실행하여 "Hello from Docker!" 메시지를 출력합니다.
2. Docker 이미지 가져오기:
   • Docker 이미지를 가져오려면 docker pull 명령을 사용합니다. 예를 들어, Python 이미지를 가져오려면 다음 명령을 실행합니다:

     docker pull python:latest

3. Docker 컨테이너 실행:
   • 가져온 이미지를 기반으로 컨테이너를 실행하려면 docker run 명령을 사용합니다.
   • 예를 들어, 파이썬 인터프리터를 실행하는 컨테이너를 실행하려면 다음 명령을 사용합니다:

     docker run -it python:latest

   • -it 옵션은 인터랙티브 모드에서 터미널로 실행하기 위한 옵션입니다.
4. Docker 컨테이너 관리:
   • 실행 중인 컨테이너를 확인하려면 docker ps 명령을 사용합니다.
   • 특정 컨테이너를 중지하려면 다음 명령을 실행합니다:

     docker stop <컨테이너_ID>

   • 컨테이너를 삭제하려면 docker rm <컨테이너_ID> 명령을 사용합니다.
5. Docker 이미지 생성:
   • Dockerfile을 작성하여 자신만의 Docker 이미지를 생성할 수 있습니다. Dockerfile은 컨테이너를 빌드하기 위한 지침서입니다.
   • 예를 들어, Dockerfile 파일을 생성하고 다음과 같은 내용을 추가합니다:

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

   • 그런 다음, docker build -t my-python-app . 명령을 실행하여 Docker 이미지를 빌드합니다.
6. Docker Compose 사용:
   • 여러 개의 컨테이너를 한꺼번에 관리하려면 Docker Compose를 사용할 수 있습니다.
   • docker-compose.yml 파일을 작성하고, 필요한 모든 서비스(컨테이너)를 정의할 수 있습니다.
   • 예를 들어, Flask 앱과 Redis를 포함하는 Docker Compose 파일:

     version: '3'
     services:
       web:
         image: python:3.8
         command: python app.py
         volumes:
           - .:/code
         ports:
           - "5000:5000"
       redis:
         image: "redis:alpine"

   • docker-compose up 명령을 실행하여 모든 서비스를 한꺼번에 시작할 수 있습니다.

이와 같이, Windows에서 파이썬 개발 환경을 구성하고 Docker를 설치 및 사용하는 방법을 단계별로 설명했습니다. 이 설정을 완료하면, 파이썬 기반의 마이크로서비스 아키텍처를 구축하고 운영할 준비가 됩니다.