윈도우에서 시작하기

☑ 사전 설치

윈도우에서는 linux사용을 위한 wsl2 및 docker engine설치가 필요하다. 해당 문서는 wsl2로 ubuntu를 이용해 bxi도커를 실행한다.

1. 리눅스 커널 업데이트 패키지 설치

리눅스 커널 업데이트 패키지를 설치한다. [다운로드]

• 참조 : https://docs.microsoft.com/ko-kr/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package

2. WSL2설치

명령 프롬프트 실행 후 Ubuntu 20.04를 설치한다.

C:\Users>wsl --set-default-version 2
WSL 2와의 주요 차이점에 대한 자세한 내용은 https://aka.ms/wsl2를 참조하세요
작업을 완료했습니다.

C:\Users>wsl --install -d Ubuntu-20.04
다운로드 중: Ubuntu 20.04 LTS
설치 중: Ubuntu 20.04 LTS
Ubuntu 20.04 LTS이(가)설치되었습니다.
Ubuntu 20.04 LTS실행 중...

• 참조: https://docs.microsoft.com/ko-kr/windows/wsl/install

3. WSL2접속

명령 프롬프트를 통해 wsl에 접속하거나, 메뉴의 Ubuntu 20.04 LTS를 선택한다.

C:\Users>wsl

4. 도커 설치

$ sudo apt-get update
$ sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io

$ sudo service docker start

• 참조: https://docs.docker.com/engine/install/ubuntu

☑ 실행

sudo docker login docker.bxi.link -u guest -p guest
sudo docker run -d -p 8080:8080 docker.bxi.link/bxi:3.4.4

도커 이미지를 실행하면 mysql, webadmin, 엔진이 실행된다.

포트를 정상적으로 설정했다면, http://localhost:8080/admin으로 웹어드민에 접속할 수 있다. 기본 fep가 실행되며, 다른 엔진타입은 -e ENGINE=eai 혹은 -e ENGINE=mci옵션을 통해 설정한다.

예시

sudo docker run -d \
  -p 8080:8080 \
  -p 3306:3306 \
  -e ENGINE=fep \
  -v ${HOST_PC_MYSQL_PATH}:/var/lib/mysql \
  -v ${HOST_PC_BXI_PATH}:/bxi \
  docker.bxi.link/bxi:3.4.4

info

전체 정상 기동에는 2,3분 정도 시간이 소요되며, 초기 계정은 bxiadmin/bxi1231!이다.

☑ DB접속정보

3306포트를 포트포워딩했다면, 호스트PC에서 BXI데이터베이스에 접근할 수 있다.

• ID: ${ENGINE_TYPE}${VERSION}
• PASSWORD: ${ENGINE_TYPE}${VERSION123}

예시

• jdbc url: jdbc:mysql://localhost:3306/fep344?useSSL=false
• id: fep344
• password: fep344123

☑ 테스트케이스 실행

실행한 BXI컨테이너에 접속해 기본 테스트케이스를 실행할 수 있다. sudo docker ps로 컨테이너ID를 확인한 후 해당 컨테이너에 접속한다.

bxi:~$ sudo docker exec -it 36efcedeb0ea bash
root:/bxi$ cd $TESTHOME
root:/bxi$ java -jar BxiIntegrationTest-Core-1.1-all.jar -i #테스트케이스 전체 실행
root:/bxi$ java -jar BxiIntegrationTest-Core-1.1-all.jar -f fep_inbound_group.yaml #특정 yaml 테스트케이스 실행

☑ FAQ

WslRegisterDistribution failed with error: 0x800701bc

리눅스 커널 업데이트 패키지를 설치한 후 WSL을 재실행한다.