QA 원격 디바이스 팜 STF(Smartphone Test Farm) 도입기 2 - MacOS 환경 STF 설치

앞 글에서 STF 디바이스 팜이 무엇인지와 STF 지원 기능을 간단히 살펴 보았다. 이제 본격적으로 STF 환경 구성에 들어가 보자. 구성 장비는 MacOS 미니 장비에서 환경 구성을 진행 했다.

 

STF설치 가능한 환경 요구사항은 리눅스 기반 OS이기 때문에 Window에서 구성할 수 없지만, Window WSL환경으로 STF의 기본적인 설치와 구동은 가능하다. 추후 기회가 된다면 WSL환경에서 설치 진행 방법에 대한 글을 포스팅 해보겠다.

 

STF 공식 문서의 구조를 보면 마이크로 서비스로 구성 되어 있다. 각 서비스는 ZeroMQ와 프로토콜 버퍼를 통해 통신하는 여러 독립된 프로세스로 구성되어 있다. 아래 공식 문서에서는 systemd + Docker 배포 방법을 기술해 놓았다. 

이 포스터 에서는 Docker는 사용하지 않고 homebrew를 통한 설치를 진행 할 예정이다. 

 

STF Docker 배포 공식 문서

---

STF 구성에 필요한 요구 사항 

• Node.js 8.x required (some dependencies don't support newer versions)
• ADB properly set up
• RethinkDB >= 2.2
• CMake >= 3.9 (for node-jpeg-turbo)
• GraphicsMagick (for resizing screenshots)
• ZeroMQ libraries installed
• Protocol Buffers libraries installed
• yasm installed (for compiling embedded libjpeg-turbo)
• pkg-config so that Node.js can find the libraries

---

STF 설치 하기 

1. MacOS homebrew 설치 확인 

• MacOS 패키지 관리자 homewbrew가 설치 되지 않았다면, homebrew부터 설치를 진행 한다. 

2. Node.js 버전 관리자 nvm 설치 

• $brew install nvm // node.js 버전 관리자 nvm 설치 진행  
• $vim ~/.bash_profile  // nvm 환경 변수 작성 진행(각 설치 환경에 따라 달라 진다.)

• $source ~/.bash_profile // 환경변수 적용
• $nvm -v 또는 $ nvm --version // nvm 설치 확인

3. Node.js 설치

node.js 설치 진행 시 버전에 유의 하여 설치를 진행 한다. 8.x 버전 이외의 버전으로 설치를 진행하면, 실행 또는 stf 설치 진행시 에러가 발생 할 수 있다. 

• $nvm ls-remote  //설치할 수 있는 버전을 확인
• $nvm install v8.17.0  //stf는 8.x 버전만 지원, 8.x lts 버전으로 설치
• $node --version //node 설치 확인
• $npm --version  //npm 설치 확인

4. adb 설치 

• $brew install --cask android-platform-tools

5. Dependency 설치

• $brew install rethinkdb graphicsmagick zeromq protobuf yasm pkg-config cmake //종속성 모두 설치

6. STF 설치 

• $npm install -g @devicefarmer/stf

---

STF 실행 확인

1. Rethinkdb 실행  

• $ rethinkdb --bind all --http-port {포트번호} //rethinkdb 실행 

2.STF 실행

• $ stf doctor // stf에 실행에 필요한 환경 설치 확인
• $stf local    //로컬전용
• $stf local --public-ip <your_internal_network_ip_here> // 아이피로 접근 허용