PaaS-TA 포털 UI(VM Type)설치 가이드

Table of Contents

1. 문서 개요

1.1. 목적

본 문서(PaaS-TA Portal Release 설치 가이드)는 전자정부표준프레임워크 기반의 PaaS-TA에서 제공되는 PaaS-TA Portal Release를 Bosh2.0을 이용하여 설치 하는 방법을 기술하였다. PaaS-TA 3.5 버전부터는 Bosh2.0 기반으로 deploy를 진행하며 내부 네트워크는 link를 적용시켜 자동으로 Ip가 할당이 된다. 기존 Bosh1.0 기반으로 설치를 원할경우에는 PaaS-TA 3.1 이하 버전의 문서를 참고한다.

1.2. 범위

설치 범위는 PaaS-TA Portal Release를 검증하기 위한 기본 설치를 기준으로 작성하였다.

1.3. 시스템 구성도

본 문서의 설치된 시스템 구성도이다. Binary Storage, Mariadb, Proxy, Gateway Api, Registration Api, Portal Api, Common Api, Log Api, Storage Api, Webadmin, Webuser로 최소사항을 구성하였다.

  • Paas-TA Portal 설치할때 cloud config에 추가적으로 정의한 VM_Tpye명과 스펙

VM_Type

스펙

portal_tiny

1vCPU / 256MB RAM / 4GB Disk

portal_medium

1vCPU / 1GB RAM / 4GB Disk

portal_small

1vCPU / 512MB RAM / 4GB Disk

  • Paas-TA Portal각 Instance의 Resource Pool과 스펙

구분

Resource Pool

스펙

haproxy

portal_small

1vCPU / 512MB RAM / 4GB Disk

mariadb

portal_small

1vCPU / 512MB RAM / 4GB Disk +10GB(영구적 Disk)

paas-ta-portal-webadmin

portal_small

1vCPU / 512MB RAM / 4GB Disk

paas-ta-portal-webuser

portal_small

1vCPU / 512MB RAM / 4GB Disk

1.4. 참고자료

http://bosh.io/docsarrow-up-right http://docs.cloudfoundry.org/arrow-up-right

2. PaaS-TA Portal 설치

2.1. Prerequisite

본 설치 가이드는 Linux 환경에서 설치하는 것을 기준으로 하였다. 서비스팩 설치를 위해서는 먼저 BOSH CLI v2 가 설치 되어 있어야 하고 BOSH 에 로그인이 되어 있어야 한다. BOSH CLI v2 가 설치 되어 있지 않을 경우 먼저 BOSH2.0 설치 가이드 문서를 참고 하여 BOSH CLI v2를 설치를 하고 사용법을 숙지 해야 한다.

2.2. Stemcell 확인

Stemcell 목록을 확인하여 서비스 설치에 필요한 Stemcell이 업로드 되어 있는 것을 확인한다. (PaaS-TA 5.5.1 과 동일 stemcell 사용)

$ bosh -e ${BOSH_ENVIRONMENT} stemcells

2.3. Deployment 다운로드

서비스 설치에 필요한 Deployment를 Git Repository에서 받아 서비스 설치 작업 경로로 위치시킨다.

Deployment 다운로드 파일 위치 경로 생성 및 설치 경로 이동

Deployment 파일 다운로드

2.4. Deployment 파일 수정

BOSH Deployment manifest는 Components 요소 및 배포의 속성을 정의한 YAML 파일이다. Deployment 파일에서 사용하는 network, vm_type, disk_type 등은 Cloud config를 활용하고, 활용 방법은 BOSH 2.0 가이드를 참고한다.

  • Cloud config 설정 내용을 확인한다.

$ bosh -e ${BOSH_ENVIRONMENT} cloud-config

  • common_vars.yml을 서버 환경에 맞게 수정한다.

  • Portal-UI에서 사용하는 변수는 system_domain, paasta_api_version, uaa_client_portal_secret 이다.

$ vi ~/workspace/paasta-5.5.1/deployment/common/common_vars.yml

  • Deployment YAML에서 사용하는 변수 파일을 서버 환경에 맞게 수정한다.

$ vi ~/workspace/paasta-5.5.1/deployment/portal-deployment/portal-ui/vars.yml

2.5. 서비스 설치

  • 서버 환경에 맞추어 Deploy 스크립트 파일의 VARIABLES 설정을 수정하고, Option file을 추가할지 선택한다.

    (선택) -o operations/use-compiled-releases.yml (ubuntu-xenial/621.94로 컴파일 된 릴리즈 사용)

$ vi ~/workspace/paasta-5.5.1/deployment/portal-deployment/portal-ui/deploy.sh

  • 서비스를 설치한다.

2.6. 서비스 설치 - 다운로드 된 PaaS-TA Release 파일 이용 방식

  • 서버 환경에 맞추어 Deploy 스크립트 파일의 VARIABLES 설정을 수정하고 Option file 및 변수를 추가한다.

    (추가) -o operations/use-offline-releases.yml (미리 다운받은 offline 릴리즈 사용)

    (추가) -v releases_dir=""

$ vi ~/workspace/paasta-5.5.1/deployment/portal-deployment/portal-ui/deploy.sh

  • 서비스를 설치한다.

2.7. 서비스 설치 확인

설치 완료된 서비스를 확인한다.

$ bosh -e ${BOSH_ENVIRONMENT} -d portal-ui vms

2.8. Portal SSH 설치

Portal 5.1.0 버전 이상부터는 배포된 어플리케이션의 SSH 접속이 가능하다.

이를 위해 Portal SSH App을 먼저 배포해야 한다.

  • Portal 배포를 위한 조직 및 공간 생성

  • Portal SSH 다운로드 및 배포

3. PaaS-TA Portal 운영

3.1. 사용자의 조직 생성 Flag 활성화

PaaS-TA는 기본적으로 일반 사용자는 조직을 생성할 수 없도록 설정되어 있다. 포털 배포를 위해 조직 및 공간을 생성해야 하고 또 테스트를 구동하기 위해서도 필요하므로 사용자가 조직을 생성할 수 있도록 user_org_creation FLAG를 활성화 한다. FLAG 활성화를 위해서는 PaaS-TA 운영자 계정으로 로그인이 필요하다.

3.2. 사용자포탈 UAA페이지 오류

(1) uaac portalclient가 등록이 되어있지 않다면 해당 화면과 같이 redirect오류가 발생한다.

(2) uaac client add를 통해 potalclient를 추가시켜주어야 한다.

$ uaac target $ uaac token client get Client ID: admin Client secret: *

(3) uaac client add portalclient –s “portalclient Secret”

--redirect_uri "사용자포탈 Url, 사용자포탈 Url/callback" $ uaac client add portalclient -s xxxxx --redirect_uri "http://portal-web-user.xxxx.xip.ioarrow-up-right, http://portal-web-user.xxxx.xip.io/callbackarrow-up-right" --scope "cloud_controller_service_permissions.read , openid , cloud_controller.read , cloud_controller.write , cloud_controller.admin" --authorized_grant_types "authorization_code , client_credentials , refresh_token" --authorities="uaa.resource" --autoapprove="openid , cloud_controller_service_permissions.read"

(1) uaac portalclient가 url이 잘못 등록되어있다면 해당 화면과 같이 redirect오류가 발생한다. (2) uaac client update를 통해 url을 수정해야한다.

$ uaac target $ uaac token client get Client ID: admin Client secret: * (3) uaac client update portalclient --redirect_uri "사용자포탈 Url, 사용자포탈 Url/callback" $ uaac client update portalclient --redirect_uri "http://portal-web-user.xxxx.xip.ioarrow-up-right, http://portal-web-user.xxxx.xip.io/callbackarrow-up-right"

3.3. 운영자 포탈 유저 페이지 조회 오류

페이지 이동시 정보를 가져오지 못하고 오류가 났을 경우 common-api VM으로 이동후에 DB 정보 config를 수정후 재시작을 해 주어야 한다.

3.4. Log

Paas-TA Portal 각각 Instance의 log를 확인 할 수 있다.

(1) 로그를 확인할 Instance에 접근한다.

bosh ssh -d [deployment name] [instance name]

(2) 로그파일이 있는 폴더로 이동한다.

위치 : /var/vcap/sys/log/[job name]/

(3) 로그파일을 열어 내용을 확인한다.

vim [job name].stdout.log

3.5. 카탈로그 적용

(1) Catalog 빌드팩, 서비스팩 추가

Paas-TA Portal 설치 후에 관리자 포탈에서 빌드팩, 서비스팩을 등록해야 사용자 포탈에서 사용이 가능하다.

1) 관리자 포탈에 접속한다.(portal-web-admin.[public ip].xip.io)

2) 운영관리를 누른다.

3) 카탈로그 페이지에 들어간다.

4) 빌드팩, 서비스팩 상세화면에 들어가서 각 항목란에 값을 입력후에 저장을 누른다.

5) 사용자포탈에서 변경된값이 적용되어있는지 확인한다.

3.6. 모니터링 및 오토스케일링 적용

(1) 포탈 설치 이전 모니터링 설정 적용

PaaS-TA 에서 제공하고있는 모니터링을 미리 설치를 한 후에 진행해야 한다.

1) Paas-TA Portal 설치 시 공통 변수 파일과 Deployment 변수 파일의 monitoring_api_url=<모니터링 API URL>, webuser_monitoring=true로 적용 한 후 설치 하면 정상적으로 모니터링 페이지 및 오토스케일링을 사용 할 수 있다.

(2) 포탈 설치 이후 모니터링 설정 적용

1) 사용자 포탈의 앱 상세 페이지로 이동한다.

2) ① 상세페이지 레이아웃 하단의 모니터링 버튼을 누른다.

3) ② 모니터링 오토 스케일링 화면

4) ③ 모니터링 알람 설정 화면

5) 추이차트 탭에서 디스크 메모리 네트워크 사용량을 인스턴스 별로 확인이 가능하다.

Last updated