안녕하세요 이정운 입니다.
요즘에는 DevOps 때문에 기존의 일반적인 설치 방식이 아니라 Docker 컨테이너를 사용한 설치 방식에 대한 요청이 많습니다.
이에 따라, IBM API Connect 도 v5.0.6 부터 기존의 VM 형태의 설치 방식에 추가하여 Docker 를 통한 설치 방식을 제공하고 있습니다.
(현재는 개발/테스트 환경을 위한 목적만 지원 가능하지만 곧 운영환경도 지원하지 않을까 합니다.)
기회가 생겨서 Docker 설치 및 구성에 대한 테스트를 수행한 후 그 내용을 가이드 형태로 공유드리오니 참고하시기 바라겠습니다.
IBM API Connect Docker install
참고문서 :
Installing and configuring IBM API Connect in a Docker container
IBM API Connect on Docker
고려사항 :
System Requirements - This package requires a minimum of 8GB RAM and 2 CPUs.
docker 1.12.0 or later.
docker-compose 1.8.1 or later.
IBM API Connect Toolkit
그러나 10GB RAM 정도는 되어야 운영에 큰 이슈는 없을듯 합니다.
설치작업 :
#1) git 에 있는 정보 동기화
#2) IBM API Connect 5.0.6 docker 이미지 다운로드
docker run -it --rm --env SHOW_LICENSE=1 ibmcom/apiconnect:manager-v5.0.6.0
#3) .env 파일의 수정하여 기본 정보 변경(git 동기화한 /apiconnect-docker 폴더)
-> IBM API Connect 는 기본 등록이나 확인을 메일 방식을 사용합니다. 여기서 SMTP 주소는 각 환경에 맞게 변경하시면 됩니다.
혹은, SMTP 서버가 없는 경우 fakeSMTP 와 같은 모듈을 활용해도 큰 이슈 없습니다.
vi .env
#4) docker-compose 를 활용하여 docker container 들을 구동(IBM DataPower 사용 경우) - APIC 와 연관된 docker 이미지를 추가로 받으므로 오랜시간 걸림
docker-compose.yaml 예시
docker-compose up -d
#5) 위의 작업이 완료되면 IBM API Connect 연관된 다양한 docker 이미지가 다운로드 된것을 확인가능(docker-compose.yaml 에 따라)
docker images
#6) 'docker-compose ps' 명령을 통해서 docker 안에서 떠있는 Process 를 확인 가능합니다.
docker-compose ps
#7) 접속하고자 하는 컴퓨터에서 하단과 같이 docker 가 서비스 되는 IP 기반으로 DNS 호출이 되도록 hosts 파일에 다음을 추가 합니다.
#8) IBM API Connect 의 Cloud Manager Console 에 접속합니다.
https://apim/cmcUsername: adminPassword: !n0r1t5@C
#9) 최초 접속이면 라이센스 계약이 나오며 수락을 하고 admin 사용자에 대한 설정을 합니다.
#10) 그러면 다음과 같이 정상적으로 CMC 에 접속이 가능하며 이제 API Gateway 로써 IBM DataPower Gateway 를 추가하기 위하여 서비스 메뉴에서 오른쪽 상단의 꽃모양 아이콘을 클릭합니다.
#11) 주소를 datapower 로 해서 저장하면 되며 이후 해당 화면에서 서버 추가를 클릭합니다.
#11) 주소를 datapower 로 해서 저장하면 되며 이후 해당 화면에서 서버 추가를 클릭합니다.
#12) 추가되는 DataPower 서버의 정보를 하단과 같이 추가합니다.(참고로 초기 admin 의 비밀번호는 admin 입니다.)
#13) 이 작업이 정상적으로 완료되면 하단과 같이 API Gateway 로써 IBM DataPower Gateway 가 추가된 것을 확인 가능합니다.
#14) IBM API Connect 는 조직별로 멀티테넌시를 지원하므로 테스트를 위하여 CMC 에서 하나의 조직을 생성합니다.
#15) 조직에 관리자를 등록하면 등록된 이메일로 자동으로 메일이 발송됩니다. 해당 메일을 확인해서 링크를 클릭하면 하단과 같은 등록 화면이 나타나게 됩니다.
#16) 등록이 완료되면 하단과 같이 CMC 콘솔의 조직에서 이해 해당 조직이 Active 상태인 것을 확인 가능합니다.
#17) 이제 모든 준비는 다 되었으니 IBM API Connect 의 API Manager 콘솔로 접속합니다.
#17) 이제 모든 준비는 다 되었으니 IBM API Connect 의 API Manager 콘솔로 접속합니다.
https://apim/apim/
#18) 이제 API Manager 콘솔에 접속이 가능하며 하단과 같이 API 생성도 가능합니다.
#19) 추가적으로 개발자 포탈을 추가 구성하기 위하여 대시보드 > 샌드박스 > 설정 > 포털을 선택한후 IBM 개발자 포털을 선택하고 URL 을 입력합니다.
#20) 개발자 포탈 구성에 일정 시간이 필요하며 일정시간 이후에 지정된 URL 로 호출하면 하단과 같이 개발자 포탈에 접속 가능한 것을 확인 가능합니다.
여기까지 잘 따라오셨다면 Docker 를 통한 IBM API Connect 에 대한 구성을 완료하신 것이며 이제는 이를 활용하여 다양한 테스트가 가능합니다.
여기까지 잘 따라오셨다면 Docker 를 통한 IBM API Connect 에 대한 구성을 완료하신 것이며 이제는 이를 활용하여 다양한 테스트가 가능합니다.
예를 들어 예전에 공유한 하단의 모든 강좌에 대해서 이제 직접 Docker 환경에서 테스트 가능합니다.
[APIC]본격적으로 살펴보는 IBM API Connect 01 - API 등록 및 테스트 1/3
참고하시기 바라며 이만 줄이도록 하겠습니다.
추신 #1) 당연히 Docker 구성이기 때문에 'docker-compose stop', '
docker-compose up -d' 명령을 통해 원하실 때 내리거나 올리는 것이 가능합니다.
댓글