포털 설치

K-PaaS 가이드 문서
컨테이너 플랫폼 포털 설치 가이드 문서

포털 배포 파일 다운로드

• 컨테이너플랫폼포털배포(Deployment) 파일을 다운로드하여 해당경로에 위치
• ✅ 이 단계는 반드시 Kubernetes Control Plane(Master Node) 노드에서 진행해야 함

1. 컨테이너 플랫폼포털배포(Deployment) 파일 다운로드

# Deployment 파일 다운로드 경로 생성 
$ mkdir -p ~/workspace/container-platform 
$ cd ~/workspace/container-platform 
# Deployment 파일 다운로드 및 파일 경로확인 
$ wget --content-disposition https://nextcloud.k-paas.org/index.php/s/ZcFt4cpeXj8d4o4/download 
$ ls ~/workspace/container-platform 
cp-portal-deployment-v1.6.0.tar.gz 
# Deployment 파일 압축 해제 
$ tar -xvf cp-portal-deployment-v1.6.0.tar.gz

2. 배포(Deployment) 파일 디렉토리 구성

포털 변수 정의

• 컨테이너플랫폼포털배포 전변숫값정의가 필요하므로 배포에 필요한 정보를 확인하여 변수를 설정
• Keycloak 기본배포프로토콜은 HTTP이며 인증서를 통한 HTTPS를 설정하고자 하는 경우 아래가이드를 참조하여 먼저 처리한다.

1. 쉘파일 실행

$ cd ~/workspace/container-platform/cp-portal-deployment/script 
$ vi cp-portal-vars.sh

2. 컨테이너 플랫폼 포털 변수 정의

$ cd ~/workspace/container-platform/cp-portal-deployment/script 
$ vi cp-portal-vars.sh

포털 배포

• 컨테이너 플랫폼 포털 배포 스크립트 실행 및 정상 배포 확인

1. 쉘파일 실행

$ chmod +x deploy-cp-portal.sh 
$ ./deploy-cp-portal.sh

2. 리소스별로 정상 배포되었는지 확인

$ kubectl get all -n harbor 
$ kubectl get all –n mariadb 
$ kubectl get all –n keycloak 
$ kubectl get all –n cp-portal 
$ kubectl get all –n vault 
$ kubectl get all –n chartmuseum 
$ kubectl get all –n chaos-mesh

• ✅ 리소스 Pod의 경우 Node에 바인딩 및 컨테이너생성 후 Running 상태로 전환되기까지 몇 초 소요됨
• 서비스접속 Host 조회 $ kubectl get ingress –A

포털 리소스 정상 배포 확인

• Harbor 리소스 조회 : $ kubectl get all -n harbor
  ✅ Harbor는 Kubespray를 통해 설치된 Kubernetes Cluster 환경에 포털이미지 및 Helm Chart를 관리
• MariaDB 리소스 조회 : $ kubectl get all -n mariadb
  ✅ MariaDB(RDBMS)는 메타 데이터(다른 데이터를 기술하기 위해 사용하는 데이터)를관리
• Keycloak 리소스 조회 : $ kubectl get all -n keycloak
  ✅ Keycloak 은 컨테이너 플랫폼 포털 사용자 인증을 관리
• Keycloak 리소스 조회 : $ kubectl get all -n cp-portal
• Vault Pod 조회 : $ kubectl get pods -n vault
  ✅ Vault는 인증데이터를 관리
• Vault Pod 조회 : $ kubectl get pods -n chartmuseum
• Vault Pod 조회 : $ kubectl get pods -n chaos-mesh

포털 리소스 삭제

• 배포된 포털 리소스의 삭제를 원하는 경우 아래 스크립트를 실행
• 🚨 포털이 운영되는 상태에서 해당 스크립트 실행 시, 운영에 필요한 리소스가 모두 삭제되므로 주의 필요

$ cd ~/workspace/container-platform/cp-portal-deployment/script 
$ chmod +x uninstall-cp-portal.sh 
$ ./uninstall-cp-portal.sh 
Are you sure you want to delete the container platform portal? <y/n> y