Bahmni 개발자 빠른 설정 가이드

Bahmni 코드베이스를 시작하는 방법을 알아봅니다. 이 문서는 코드베이스를 빠르게 시작하는 방법을 설명합니다. 자세한 가이드는 https://bahmni.atlassian.net/wiki/spaces/BAH/pages/1310748/Developer+s+Guide를 참고하십시오.관련 문서: 개발자 가이드

목차

진행에 도움이 되는 필수 링크는 다음과 같습니다.

• Bahmni GitHub 조직관련 문서: Bahmni GitHub Organization
• Bahmni Docker
• Bahmni Core
• Bahmni Apps
• 개발자 가이드
• Docker에서 Bahmni 실행
• Docker Compose 프로필
• SSH 키를 사용한 GitHub 저장소 Push/Pull관련 문서: Ability to push/pull to Github repositories (using SSH Keys)
• GitHub Codespaces를 사용한 클라우드 개발용 Bahmni 설정관련 문서: Setting up Bahmni on the cloud for development using Github Codespaces

다음 가이드는 Docker를 사용해 Bahmni를 설치하는 방법을 설명합니다.

• 안정 버전의 Git을 설치합니다.
• 운영 체제에 맞는 최신 안정 버전의 Docker와 Docker Compose를 설치합니다.
• Bahmni Docker 저장소를 복제합니다.

이제 Docker로 Bahmni를 설정합니다.

1. 원하는 구성에 해당하는 하위 폴더로 이동합니다.bash.env.dev 파일을 편집하여 다음 내용을 변경합니다:.env.dev 파일에서 COMPOSE_PROFILES=bahmni-standard 또는 COMPOSE_PROFILES=bahmni-lite로 변경합니다(기본값인 emr만 사용해도 됩니다). Bahmni가 사용하는 Docker Compose 프로필에 대한 자세한 내용은 Docker Compose Profiles를 참고하십시오.스크립트를 실행합니다:bash이 스크립트에는 시작, 중지, 로그 보기, 업데이트 가져오기, 초기화 등의 옵션이 있습니다. 스크립트에 대한 자세한 내용은 관련 문서를 참고하십시오.

   cd bahmni-docker/bahmni-standard OR cd bahmni-docker/bahmni-lite

./run-bahmni.sh .env.dev

Bahmni Apps를 변경하려면 다음 단계를 따르십시오.

1. openmrs-module-bahmniapps 저장소를 복제하고 README.md에 설명된 일회성 설치 단계를 완료합니다.관련 문서: openmrs-module-bahmniapps repository
2. .env.dev 파일의 BAHMNI_APPS_PATH 값으로 Bahmni Apps 폴더 경로를 설정합니다.
3. docker-compose.yml 파일의 bahmni-web 서비스 정의에서 주석 처리된 다음 두 줄을 찾습니다:yaml위 줄의 주석을 해제합니다.

   # - "${BAHMNI_APPS_PATH:?}/ui/app/:/usr/local/apache2/htdocs/bahmni" 
   # - "${BAHMNI_APPS_PATH:?}/ui/node_modules/@bower_components/:/usr/local/apache2/htdocs/bahmni/components"

4. 탭을 새로 고치면 변경 사항이 로컬 서버에 반영됩니다.

Bahmni의 OpenMRS 서비스에서 변경 사항을 실행하려면 다음 단계를 따르십시오.

1. bahmni-core 저장소를 복제하고 README.md에 설명된 요구 사항을 충족하는지 확인합니다.관련 문서: bahmni-core repository
2. 다음 명령으로 bahmni-core/omod를 빌드합니다:bashbahmni-core/bahmnicore-omod/target/bahmnicore-omod-VERSION-SNAPSHOT.omod를 OpenMRS 모듈 디렉터리에 복사하고 OpenMRS를 다시 시작합니다:bash bahmni-standard-openmrs-1:/openmrs/data/modules]]>다음 명령을 실행하여 OpenMRS 컨테이너에 접속합니다:bashmodules 폴더로 이동합니다:bash폴더의 모든 파일을 나열합니다:bash

   mvn clean install -DskipTests

docker cp <bahmni-core/bahmnicore-omod/target/bahmnicore-omod-VERSION-SNAPSHOT.omod> bahmni-standard-openmrs-1:/openmrs/data/modules

docker exec -it bahmni-standard-openmrs-1

cd data/modules

ls -ltr

선택적으로 다음 단계로 진행하기 전에 이전 bahmnicore-omod를 제거할 수 있습니다.

1. 이제 omod에 root 권한을 부여합니다:bash]]>컨테이너에서 나옵니다.마지막으로 OpenMRS를 다시 시작하여 변경 사항을 반영합니다.

   chown -R root:root <bahmnicore-omod-VERSION-SNAPSHOT.omod>

docker compose restart openmrs

OpenMRS용 디버거를 설정하려면 다음 단계를 수행하십시오.

1. .env.dev 파일을 편집하여 다음 내용을 변경합니다.
2. #OMRS_DEV_DEBUG_PORT=를 OMRS_DEV_DEBUG_PORT=8200으로 변경합니다.
3. docker-compose.yml 파일의 openmrs 서비스 정의에서 주석 처리된 다음 세 줄을 찾습니다.

   #OMRS_DEV_DEBUG_PORT: ${OMRS_DEV_DEBUG_PORT} 
   
   #ports: 
         # - ${OMRS_DEV_DEBUG_PORT}:${OMRS_DEV_DEBUG_PORT}

4. 위 줄의 주석을 해제합니다.
5. 디버거를 실행하면 Bahmni 코드를 디버깅할 준비가 완료됩니다.

Visual Studio Code 디버거 설정은 ‘Running and debugging Java’를 참고하고, IntelliJ IDEA는 ‘Debug your first Java application’을 참고하십시오.

1. 다음 명령으로 서비스를 빌드합니다:/: -f .]]>OpenMRS를 다시 시작합니다.

   docker build -t <org-name>/<image-name>:<image-tag> -f <Dockerfile-path> .

이 단계를 마치면 Bahmni 개발 여정을 시작할 준비가 완료됩니다.