윈도우에서 시작하기

1. 사전 설치

윈도우에서는 Linux 사용을 위한 wsl2 및 Docker 설치가 필요하다. 해당 문서는 wsl2로 Ubuntu를 이용해 BXI Docker를 실행한다.

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

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

1.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실행 중...

1.3. WSL2 접속

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

C:\Users>wsl

1.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

2. 실행

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

도커 이미지를 실행하면 Mysql, BXI의 웹어드민과 엔진이 실행된다.

포트를 정상적으로 설정했다면, 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

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

2.1. DB 접속정보

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

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

예시

jdbc url: jdbc:mysql://localhost:3306/fep40?useSSL=false
id: fep40
password: fep40123

2.2. 테스트케이스 실행

실행한 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 테스트케이스 실행

3. FAQ

3.1. WslRegisterDistribution failed with error: 0x800701bc

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