운영자 Portal 가이드

1. 문서 개요

1.1. 목적

본 문서는 JAVA로 작성된 PaaS-TA 운영자 포탈 웹 사이트를 사용하고 관리하는 방법에 대해 설명한다.

1.2. 범위

이미 설치된 PaaS-TA 운영자 포탈 웹 사이트 사용하는 방법에 대해 기술하였다.

1.3. 운영자 포탈 설치

본 사용 가이드는 설치에 대한 내용은 기술하지 않았다.

운영자 포탈 설치는 PaaS-TA Portal 배포 가이드 문서를 참고한다.

2. PaaS-TA 운영자 포탈 시작

PaaS-TA 운영자 포탈 웹 사이트에 접속한다.

2.1. PaaS-TA 운영자 포탈 로그인

PaaS-TA 운영자 포탈에 접속하면 인증을 위한 로그인 화면이 나타난다.
아이디와 비밀번호를 입력후 "로그인" 버튼을 클릭한다.

2.2. PaaS-TA 운영자 포탈 로그아웃

로그인 후 메인화면 ① "로그아웃" 버튼을 클릭하여 로그아웃을 한다.

3. PaaS-TA 운영자 포탈 대시보드

PaaS-TA에 등록된 조직, 공간, APP, 사용자 통계 정보를 보여준다.

3.1. 대시보드 정보 조회

조직의 ①공간, ②APP, ③사용자 정보를 보여준다.
①조직명을 클릭하면 조직의 영역 상세 정보를 확인 할 수 있다.

4. 운영 관리 메뉴

PaaS-TA 포탈의 운영에 필요한 관리를 수행하기 위한 메뉴이다.

4.1. 조직 및 공간 조회

관리자가 모든 사용자의 조직 및 공간을 관리한다.

①조직과 ②공간을 조회한다. ③검색어 조회도 가능하다.
조직이름 옆의 ①상세정보 버튼을 클릭한다. ②조직 상세 정보를 조회한다.
공간이름 옆의 ①상세정보 버튼을 클릭한다. ②공간 영역 상세 정보를 조회한다.

4.2. 클라이언트

관리자가 클라이언트 조회,등록,삭제 기능을 제공한다.

클라이언트 목록을 조회한다.
클라이언트 ID를 클릭 후 클라이언트 상세화면을 이동한다. 클라이언트 상세화면에서 "삭제" 버튼을 클릭하면 클라이언트 ID 삭제가 가능하다.
①"클라이언트 등록" 버튼을 클릭한다. 클라이언트 아이디, 패스워드, 옵션, 옵션 가이드를 입력하고 ②"등록" 버튼을 클릭하여 등록한다.

4.3. 카탈로그

관리자가 카탈로그의 앱 템플릿, 앱 개발환경, 앱서비스 조회,등록,수정,삭제를 기능을 제공한다.

4.3.1 카탈로그 관리 앱 템플릿

카탈로그 앱 템플릿 목록을 조회한다. 이름, 요약, 분류, 공개여부를 조회할 수 있다. 검색창에서 검색유형, 검색항목, 공개여부, 검색어로 검색이 가능하다.
앱 템플릿 이름을 클릭하면 상세화면이 나온다. 수정할 내역이 있을 경우 수정 한 후 ①"저장"버튼을 클릭하여 저장한다.
②"삭제" 버튼을 클릭하여 앱 템플릿을 삭제한다.
앱 템플릿을 등록 시, ①"앱 템플릿 등록" 버튼을 클릭한다. 앱 템플릿 등록 팝업에 이름, 분류, 앱 개발환경, 서비스, 썸네일, 공개여부, 요약, 설명을 입력한다. ②"등록" 버튼을 누르면 새로운 앱 템플릿이 등록된다.

4.3.2 카탈로그 관리 앱 개발환경

카탈로그 앱 개발환경 목록을 조회한다. 이름, 요약, 분류, 공개여부를 조회할 수 있다. 검색창에서 검색유형, 검색항목, 공개여부, 검색어로 검색이 가능하다.
앱 개발환경 이름을 클릭하면 상세화면이 나온다. 수정 내역 완료 후 ①"저장"버튼을 클릭하여 저장(수정)한다.
②"삭제" 버튼을 클릭하여 앱 개발환경을 삭제한다.
카탈로그 화면에서 앱 개발환경을 등록하기 위해 ①"앱 개발환경 등록" 버튼을 클릭한다. 앱 개발환경 등록 팝업에 이름, 분류, 앱 개발환경, 서비스, 썸네일, 공개여부, 요약, 설명을 입력한다. ②"등록" 버튼을 누르면 새로운 앱 개발환경이 등록된다.

4.3.3 카탈로그 관리 서비스

카탈로그 서비스 목록을 조회한다. 이름, 요약, 분류, 공개여부를 조회할 수 있다. 검색창에서 검색유형, 검색항목, 공개여부, 검색어로 검색이 가능하다.
서비스 이름을 클릭하면 상세화면이 나온다. 수정 내역 완료 후 ①"저장"버튼을 클릭하여 저장한다.
②"삭제" 버튼을 클릭하여 서비스를 삭제한다.
카탈로그 화면에서 앱 서비스를 등록 시, ①"앱 서비스 등록버튼"을 클릭한다. 이름, 분류, 서비스, 썸네일, 파라미터, 공개여부, 요약, 설명을 입력한다. ②"등록" 버튼을 누르면 새로운 서비스가 등록된다.

※ delivery-pipeline 앱 서비스 등록 방법 예시 1. 앱 서비스 등록 폼 화면에 앱 서비스 등록에 필요한 내용을 입력한다. 2. 앱 서비스에 등록할 이름을 입력한다. 3. 분류는 "개발 지원 도구"로 지정한다. 4. 서비스는 "delivery-pipeline-v2" 로 지정한다. 5. 썸네일는 사용자가 등록하고자 하는 이미지를 지정하여 선택한다.

썸네일 적용 시 'PaaS-TA 사용자'에서 카탈로그 서비스 리스트 및 서비스 등록 시 이미지를 확인 할 수 있다. 6. 문서 URL을 넣어준다. (예) https://github.com/PaaS-TA/DELIVERY-PIPELINE-UI 문서 URL 적용 시 'PaaS-TA 사용자'카탈로그 서비스 등록 '문서보기' 버튼 활성화 된다.

서비스 생성시 필요한 파라미터값을 설정한다.
(예) owner : '자동입력' / org_name : '자동입력'
앱 바인드 사용 은 "N"으로 선택한다.
대시보드 사용 시 "Y" 를 필수 설정한다. 대시보드 "N" 설정시 대시보드 버튼이 비 활성화 된다.
대시보드 적용 시 'PaaS-TA 사용자'에서 카탈로그 앱 서비스 "대시보드" 버튼 활성화 된다
그 외 공개여부, 요약, 설명을 입력한다. "저장" 버튼을 클릭하여 서비스 등록을 완료한다.

※ sourcecontrol 앱 서비스 등록 방법 예시 1. 앱 서비스 등록 폼 화면에 앱 서비스 등록에 필요한 내용을 입력한다. 2. 앱 서비스에 등록할 이름을 입력한다. 3. 분류는 "개발 지원 도구"로 지정한다. 4. 서비스는 "paasta-sourcecontrol" 로 지정한다. 5. 썸네일는 사용자가 등록하고자 하는 이미지를 지정하여 선택한다. 6. 문서 URL을 넣어준다.

(예) https://github.com/PaaS-TA/Guide-3.0-Penne-/blob/master/Service-Guide/Tools/PaaS-TA %ED%98%95%EC%83%81%EA%B4%80%EB%A6%AC %EC%84%9C%EB%B9%84%EC%8A%A4%ED%8C%A9 %EC%84%A4%EC%B9%98 %EA%B0%80%EC%9D%B4%EB%93%9C_v1.0.md 문서 URL 적용 시 'PaaS-TA 사용자'카탈로그 서비스 등록 '문서보기' 버튼 활성화 된다. 7. 서비스 생성시 필요한 파라미터값을 설정한다. (예) owner : '자동입력' / org_name : '자동입력' 8. 앱 바인드 사용 은 "N"으로 선택한다. 9. 대시보드 사용 시 "Y" 를 필수 설정한다. 대시보드 "N" 설정 시 대시보드 버튼이 비 활성화 된다. 대시보드 적용 시 'PaaS-TA 사용자'에서 카탈로그 앱 서비스 "대시보드" 버튼 활성화 된다 10. 그 외 공개여부, 요약, 설명을 입력한다. "저장" 버튼을 클릭하여 서비스 등록을 완료한다.

4.4. 사용자 관리

관리자가 사용자의 정보를 조회 및 계정 승인 기능을 한다.

사용자 리스트를 조회한다. 사용자 계정, 이름, 전화번호, 관리자유무, 승인상태를 조회 할 수 있다. 검색창에서 검색어로 검색할 수 있다.
①"관리" 버튼 클릭 후 "비밀번호 초기화"를 클릭하여 비밀번호를 초기화 한다.
①"관리" 버튼 클릭 후 "운영자권한 삭제"를 클릭하여 운영권한 삭제를 한다.
"실행" 버튼 클릭 후 사용자 관리 리스트 확인 시[관리자] Y에서 N 으로 변한다. 사용자 관리 리스트 [관리자] N 경우 ①"관리" 버튼 클릭 후 "운영자권한 부여"를 클릭한다.
①"관리" 버튼 클릭 후 "가입 해제"를 클릭하여 CF 로그인을 차단한다. 비승인일시 "가입 승인"을 클릭하여 CF 로그인을 승인한다.
"수정" 버튼 클릭 후 사용자 관리 리스트를 확인 시 [상태] 승인에서 비승인으로 변한다. 비승인시 포탈 및 CF 로그인 불가
①"관리" 버튼 클릭 후 "계정 삭제"를 클릭하여 해당 계정을 삭제한다.

4.5. 권한 관리

관리자가 Cloud Foundry 시큐리티 그룹을 조회,수정,삭제기능을 제공 및 사용자 권한을 관리한다.

권한 그룹과 사용자를 조회한다.
①"그룹 생성" 버튼을 클릭 후 그룹 이름을 입력한다. ②"저장" 버튼 클릭하여 권한그룹을 생성한다.
① 권한 그룹에서 삭제할 그룹을 선택한다. 확인 폼 레이어가 팝업되면 ②"삭제"를 클릭하여 권한 그룹을 삭제한다.
① 권한 그룹 리스트에서 해당 그룹을 클릭하여 사용자를 확인한다. ②"유저 등록" 버튼을 클릭한다. ③ 리스트에서 사용자를 클릭한다. ④"저장"버튼을 클릭하여 유저를 등록한다.
① 권한 그룹 리스트에서 해당 그룹을 클릭하여 사용자를 확인한다. 사용자 리스트에서 삭제할 사용자 ②체크박스 선택한다. ③ 활성화 된 "유저 삭제" 버튼을 클릭한다. 팝업의 ④ "삭제" 를 클릭하여 유저를 삭제한다.

4.6. 코드 관리

관리자가 PaaS-TA 포탈의 코드를 관리한다.

PaaS-TA 포탈에서 사용하는 코드를 코드그룹별로 조회한다. 사용여부, 검색유형, 검색어로도 조회가 가능하다.
코드 그룹의 코드 ID를 클릭하면 상세 코드 정보가 조회된다.
Group Table 에서 ①"등록" 버튼을 클릭한다. 팝업 창에서 코드ID와 코드이름을 입력하고 ②"등록" 버튼을 클릭하여 코드 등록을 한다.
Detail Table 에서 ①"등록" 버튼을 클릭한다. 코드 상세 등록 팝업 창에서 Key, Value, 요약, 사용여부를 입력하고 ②"등록"버튼을 클릭하여 코드를 등록(추가)한다.
Detail Table 에서 해당 코드(Key, Value, 요약, 사용)를 클릭한다. 코드 상세 팝업에서 ①"삭제" 버튼을 클릭하여 코드 삭제를 한다.

4.7. 설정 정보

관리자가 PaaS-TA 포탈의 설정 정보를 조회,등록,수정 기능을 제공한다.

PaaS-TA 포탈에서 사용하는 설정 정보들을 조회한다.
PaaS-TA 포탈에서 사용하는 설정 정보들을 수정하고 저장한다.

4.8. 할당량 관리

관리자가 PaaS-TA 포탈의 조직 및 공간 할당량을 조회,등록,수정,삭제를 기능을 제공한다.

"조직 할당량 등록" 버튼을 클릭하여 조직 할당량을 등록한다.
조직 할당량 등록 팝업에 이름, 메모리, 인스턴스 메모리, 라우트, 서비스 인스턴스, APP 인스턴스, 무료여부, 예약된 라우트 포트를 입력한다. "등록" 버튼을 클릭하여 조직 할당량을 등록한다.
수정 할 조직 할당량을 클릭한다. 조직 할당량 상세 팝업에서 ① "저장" 버튼을 클릭하여 조직 할당량을 저장(수정)한다.
삭제 할 조직 할당량을 클릭한다. 조직 할당량 상세 팝업에서 ② "삭제" 버튼을 클릭하여 조직 할당량을 삭제한다.
"공간 할당량 등록" 버튼을 클릭하여 공 할당량을 등록한다.
공간 할당량 등록 팝업에 이름, 생성조직명, 메모리, 인스턴스 메모리, 라우트, 서비스 인스턴스, APP 인스턴스, 무료여부, 예약된 라우트 포트를 입력한다. "등록" 버튼을 클릭하여 공간 할당량을 등록한다.
수정 할 공간 할당량을 클릭한다. 공간 할당량 상세 팝업에서 ①"저장" 버튼을 클릭하여 공간 할당량을 저장(수정)한다.
삭제 할 공간 할당량을 클릭한다. 공간 할당량 상세 팝업에서 ② "삭제" 버튼을 클릭하여 공간 할당량을 삭제한다.

4.9. 분할 관리

관리자가 새 격리 세그먼트를 만든 후, Cloud Foundry 배포의 조직과 공간 및 새 격리 세그먼트 간의 관계를 생성하고 관리한다.

PaaS-TA 포탈에서 사용하는 분활 관리 내역을 조회한다.
Segment Name 입력 칸에 생성할 이름을 입력한다. "Segment 등록" 버튼을 클릭하여 등록한다.
분할 관리 리스트 이름을 클릭하면 조직 정보가 조회된다. ① "Add Organization" 리스트에서 추가 할 조직을 클릭하여 추가한다.
Organization Name 리스트 이름을 클릭하면 조직 상세 정보가 조회된다. ① "Isolation Segments Name" 리스트에서 모든 분할관리에 포한 된 조직을 확인 할 수 있다.
①"삭제" 버튼을 클릭하여 분할 관리를 삭제한다.

5. 서비스 관리

PaaS-TA 포탈의 서비스 관리를 수행하기 위한 메뉴이다.

5.1. 빌드팩

관리자가 빌드팩의 조회,수정,사용유무 및 Lock유무를 관리한다.

PaaS-TA 포탈에서 사용하는 빌드팩 정보들을 조회한다.
빌드팩 순서를 변경하기 위해 순서 콤보박스를 변경한다.
빌드팩 사용유무를 변경하기 위해 사용유무 체크박스를 변경한다.
빌드팩 Lock유무를 변경하기 위해 Lock 체크박스를 변경한다.

5.2 서비스 브로커

관리자가 서비스 브로커 URL를 등록,브로커 조회,수정,삭제 기능을 제공한다.

PaaS-TA 포탈에서 사용하는 서비스 브로커 내역을 조회한다.
서비스 브로커 리스트의 서비스 이름을 클릭하면 해당 서비스 브로커 상세를 볼 수 있다. 수정할 내역이 있을 경우 수정 후 ①"저장" 버튼을 클릭하여 서비스 브로커를 저장한다.
5.2- 2 ②"삭제" 버튼을 클릭하여 서비스 브로커를 삭제한다.
서비스 브로커 리스트의 ①"서비스 브로커 등록" 버튼을 클릭한다. 서비스 브로커 이름, 사용자 이름, 사용자 패스워드,URL 정보를 입력한다. ②"등록"버튼을 클릭하면 서비스 브로커 등록이 완료된다.

5.3 서비스 제어

관리자가 사용자에게 사용 할 수 있는 서비스 계획을 제어하고 제한된 서비스 가용성을 관리한다.

PaaS-TA 포탈에서 사용하는 서비스 내역을 조회한다.
서비스 제어 리스트의 서비스를 클릭하면 해당 서비스 또는 서비스 플랜에 대한 권한 활성화를 볼 수 있다. ①"접근" 리스트를 클릭하여 하위 집합에 대한 권한 활성화 변경이 가능하다. ② 리스트 서비스 또는 서비스 플랜에 지정된 조직 권한을 부여할 수 있다. "접근"이 ALL(활성화)의 경우, 하나 또는 모든 조직에 대한 서비스 또는 서비스 플랜 대한 액세스를 'NONE(비 활성화)'으로 변경해야한다.
① "Add Organization" 리스트에서 권한 추가 할 조직을 클릭하여 추가한다.
①"삭제" 버튼을 클릭하여 조직을 삭제한다. 삭제가 완료 되면, 처음의 접근 상태 "ALL"로 변경된다.

6. 보안 관리

PaaS-TA 포탈의 보안 관리를 수행하기 위한 메뉴이다.

6.1 시큐리티 그룹

관리자가 staging, running 규칙을 사용하여 앱 및 작업 준비하고 특정 spaces에 대한 접근제어 관리한다.

PaaS-TA 포탈에서 사용하는 시큐리티 그룹 정보들을 조회한다.
①"시큐리티 그룹 등록" 버튼을 클릭하여 시큐리트 그룹을 등록한다.
시큐리티 그룹 등록 팝업에 이름을 입력(필수)하고 staging default설정(필수), running default설정(필수) 체크박스를 선택한다. 팝업의 탭의 내용 입력 부분에 설명, 규칙(필수), 로그, 포트, 프로토콜을 입력한다. ① "+" 를 클릭하여 탭을 증가시킨다. ② "텝 삭제" 버튼을 클릭하여 탭을 삭제한다.
시큐리티 그룹 등록 팝업에서 ①"파일 내보내기" 버튼을 클릭하여 시큐리트 그룹 정보를 ②.txt 파일로 확인 할 수 있다.
시큐리티 그룹 등록 팝업에서 ①"파일 불러오기" 버튼을 클릭하여 시큐리트 그룹 정보를 ②.txt 파일로 확인 할 수 있다. 불러온 파일은 추가 된 새 탭에서 확인 할 수 있다.
시큐리티 그룹 등록 팝업에서 ①"org"를 클릭한다. ②"space"를 클릭한다. ③"등록" 버튼을 클릭하여 org,space 를 등록한다.
시큐리티 그룹 등록 팝업에서 ①"삭제" 버튼을 클릭하여 org,space 를 삭제한다. ②"등록 "버튼을 클릭하여 시큐리티 그룹 정보를 저장한다.
수정 할 시큐리티 그룹을 선택한다. 시큐리티 그룹 상세 팝업에서 ①"수정" 버튼을 클릭하여 시큐리티 그룹을 수정한다.
삭제 할 시큐리티 그룹을 선택한다. 시큐리티 그룹 상세 팝업에서 ①"삭제" 버튼을 클릭하여 시큐리티 그룹을 삭제한다.