FHIR 환경 설정 가이드

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

• 초보자 (VS Code, Git, Docker, FHIR 등 도구 사용 경험 없음)
• 난이도: 기본 설정 및 설치 절차 중심으로 구성된 초보자 친화적인 내용

핵심 요약

• VS Code, Git, Docker, Python, Jupyter 설치가 필수 조건
• Docker를 통한 InterSystems IRIS for Health 커뮤니티 실행은 FHIR 서버 구동의 핵심
• docker-compose 명령어로 컨테이너 빌드 및 실행 (예: docker-compose build, docker-compose up -d)

섹션별 세부 요약

1. VS Code 설치

• VS Code 다운로드 (https://code.visualstudio.com/)
• OS별 설치 파일 선택 (Windows: .exe, macOS: .dmg)
• PATH 설정 (Windows 설치 시 "Add to PATH" 체크)
• 설치 확인: code --version 명령어 실행

2. Git 설치

• Git 다운로드 (https://git-scm.com/downloads)
• Windows 사용 시 "Use Git from the Windows Command Prompt" 선택
• 설치 확인: git --version 명령어 실행

3. Docker 설치

• Docker Desktop 다운로드 (https://www.docker.com/products/docker-desktop)
• WSL 2 백엔드 활성화 (Windows 설치 시 필수)
• 설치 확인: docker --version 또는 docker info 명령어 실행

4. FHIR 서버 설정

• FHIR 리포지토리 클론: git clone 명령어 사용
• Docker 이미지 빌드: docker pull 및 docker-compose build 명령어 실행
• 컨테이너 실행: docker-compose up -d 명령어로 IRIS 컨테이너 실행
• 실행 확인: docker ps 명령어로 iris-fhir 컨테이너 상태 확인

5. Python 및 Jupyter 설치

• Python 설치 (https://www.python.org/downloads/)
• PATH 설정 (Windows 설치 시 "Add Python to PATH" 체크)
• Jupyter 설치: pip install jupyter 명령어로 설치 및 실행 (jupyter notebook)

6. 설치 검증 및 문제 해결

• 설치 검증: code --version, git --version, docker --version, python --version, jupyter --version 명령어 실행
• 문제 해결:
• Command not found: PATH 설정 확인
• Docker 실행 실패: WSL 2 활성화 확인 또는 Docker Desktop 재시작
• IRIS 컨테이너 시작 실패: docker logs iris-fhir 로 로그 확인

결론

• 모든 도구 설치 후 code --version 등 명령어로 검증
• Docker 컨테이너 실행 실패 시 docker logs 명령어로 로그 분석
• FHIR 서버 접속 시 기본 계정 (_SYSTEM, ISCDEMO) 확인