Index > CP Install > SourceControl 설치 가이드
-
컨테이너 플랫폼 소스 컨트롤 배포
3.1. 컨테이너 플랫폼 소스 컨트롤 Deployment 파일 다운로드
3.2. 컨테이너 플랫폼 소스 컨트롤 변수 정의
3.3. 컨테이너 플랫폼 소스 컨트롤 배포 스크립트 실행
3.4. (참조) 컨테이너 플랫폼 소스 컨트롤 리소스 삭제 -
컨테이너 플랫폼 소스 컨트롤 접속
4.1. 컨테이너 플랫폼 소스 컨트롤 관리자 로그인
4.2. 컨테이너 플랫폼 소스 컨트롤 사용자 회원가입/로그인
4.3. 컨테이너 플랫폼 소스 컨트롤 사용 가이드
본 문서(컨테이너 플랫폼 소스 컨트롤 단독 배포 설치 가이드)는 단독배포된 Kubernetes Cluster 환경에서 컨테이너 플랫폼 포털이 배포된 환경에서 소스 컨트롤 단독 배포 방법을 기술하였다.
설치 범위는 Kubernetes 단독 배포를 기준으로 작성하였다.
시스템 구성은 Kubernetes Cluster(Master, Worker) 환경과 데이터 관리를 위한 스토리지 서버로 구성되어 있다. Kubespray를 통해 설치된 Kubernetes Cluster 환경에 컨테이너 플랫폼 소스 컨트롤 이미지 및 Helm Chart를 관리하는 Harbor, 컨테이너 플랫폼 소스 컨트롤 사용자 인증을 관리하는 Keycloak, 컨테이너 플랫폼 소스 컨트롤 메타 데이터를 관리하는 MariaDB(RDBMS)가 컨테이너 플랫폼 포털을 통해서 제공된다. 컨테이너 플랫폼 소스 컨트롤에서는 소스를 관리하는 SCM-Server를 컨테이너로 제공한다. 총 필요한 VM 환경으로는 Master VM: 1개, Worker VM: 3개 이상이 필요하고 본 문서는 Kubernetes Cluster에 컨테이너 플랫폼 소스 컨트롤 환경을 배포하는 내용이다.
컨테이너 플랫폼 소스 컨트롤에서 사용할 인프라로 인증서버 KeyCloak Server, 데이터베이스 MariaDB, 레포지토리 서버 Harbor 설치가 사전에 진행되어야 한다. 파스타 컨테이너 플랫폼 포털 배포 시 해당 인프라를 모두 설치한다. 컨테이너 플랫폼 인프라 설치는 아래 가이드를 참조한다.
컨테이너 플랫폼 소스 컨트롤 배포를 위해 컨테이너 플랫폼 소스 컨트롤 Deployment 파일을 다운로드 받아 아래 경로로 위치시킨다.
💡 해당 내용은 Kubernetes Master Node에서 진행한다.
- 컨테이너 플랫폼 소스 컨트롤 Deployment 파일 다운로드 :
cp-source-control-deployment-v1.4.0.tar.gz
# Deployment 파일 다운로드 경로 생성
$ mkdir -p ~/workspace/container-platform
$ cd ~/workspace/container-platform
# Deployment 파일 다운로드 및 파일 경로 확인
$ wget --content-disposition https://nextcloud.paas-ta.org/index.php/s/bBKm3JcQFHRw6mB/download
$ ls ~/workspace/container-platform
...
cp-source-control-deployment-v1.4.0.tar.gz
...
# Deployment 파일 압축 해제
$ tar xvfz cp-source-control-deployment-v1.4.0.tar.gz
- Deployment 파일 디렉토리 구성
├── script # 컨테이너 플랫폼 소스 컨트롤 배포 관련 변수 및 스크립트 파일 위치
├── images # 컨테이너 플랫폼 소스 컨트롤 이미지 파일 위치
├── charts # 컨테이너 플랫폼 소스 컨트롤 Helm Charts 파일 위치
├── values_orig # 컨테이너 플랫폼 소스 컨트롤 Helm Charts values.yaml 원본 파일 위치
컨테이너 플랫폼 소스 컨트롤을 배포하기 전 변수 값 정의가 필요하다. 배포에 필요한 정보를 확인하여 변수를 설정한다.
$ cd ~/workspace/container-platform/cp-source-control-deployment/script
$ vi cp-source-control-vars.sh
# COMMON VARIABLE
K8S_MASTER_NODE_IP="{k8s master node public ip}" # Kubernetes master node public ip
PROVIDER_TYPE="{container platform source control provider type}" # Container platform source-control provider type (Please enter 'standalone' or 'service')
....
# Example
K8S_MASTER_NODE_IP="xx.xxx.xxx.xx"
PROVIDER_TYPE="standalone"
- K8S_MASTER_NODE_IP
Kubernetes Master Node Public IP 입력 - PROVIDER_TYPE
컨테이너 플랫폼 소스 컨트롤 제공 타입 입력
- 본 가이드는 단독 배포 설치 가이드로 'standalone' 값 입력 필요
💡 Keycloak 기본 배포 방식은 HTTP이며 인증서를 통한 HTTPS를 설정되어 있는 경우
컨테이너 플랫폼 소스 컨트롤 변수 파일 내 아래 내용을 수정한다.
$ vi cp-source-control-vars.sh
# KEYCLOAK_URL 값 http -> https 로 변경
# Domain으로 nip.io를 사용하는 경우 아래와 같이 변경
....
# KEYCLOAK
KEYCLOAK_URL="https://${K8S_MASTER_NODE_IP}.nip.io:32710" #if apply TLS, https://
....
컨테이너 플랫폼 소스 컨트롤 배포를 위한 배포 스크립트를 실행한다.
$ chmod +x deploy-cp-source-control.sh
$ ./deploy-cp-source-control.sh
컨테이너 플랫폼 소스 컨트롤 관련 리소스가 정상적으로 배포되었는지 확인한다.
리소스 Pod의 경우 Node에 바인딩 및 컨테이너 생성 후 Running 상태로 전환되기까지 몇 초가 소요된다.
- 컨테이너 플랫폼 소스 컨트롤 리소스 조회
$ kubectl get all -n cp-source-control
NAME READY STATUS RESTARTS AGE
pod/cp-source-control-api-deployment-588fdfbfd7-727w2 1/1 Running 0 54s
pod/cp-source-control-manager-deployment-69b9b87cfd-kcv8l 1/1 Running 0 53s
pod/cp-source-control-ui-deployment-867557b66d-pq5w9 1/1 Running 0 51s
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
service/cp-source-control-api-service NodePort 10.233.21.183 <none> 8091:30091/TCP 54s
service/cp-source-control-manager-service NodePort 10.233.22.163 <none> 8080:30092/TCP 53s
service/cp-source-control-ui-service NodePort 10.233.14.98 <none> 8094:30094/TCP 51s
NAME READY UP-TO-DATE AVAILABLE AGE
deployment.apps/cp-source-control-api-deployment 1/1 1 1 54s
deployment.apps/cp-source-control-manager-deployment 1/1 1 1 53s
deployment.apps/cp-source-control-ui-deployment 1/1 1 1 51s
NAME DESIRED CURRENT READY AGE
replicaset.apps/cp-source-control-api-deployment-588fdfbfd7 1 1 1 54s
replicaset.apps/cp-source-control-manager-deployment-69b9b87cfd 1 1 1 53s
replicaset.apps/cp-source-control-ui-deployment-867557b66d 1 1 1 51s
배포된 컨테이너 플랫폼 소스 컨트롤 리소스의 삭제를 원하는 경우 아래 스크립트를 실행한다.
$ cd ~/workspace/container-platform/cp-source-control-deployment/script
$ chmod +x uninstall-cp-source-control.sh
$ ./uninstall-cp-source-control.sh
Are you sure you want to delete the container platform source control? <y/n> # y 입력
release "cp-source-control-api" uninstalled
release "cp-source-control-manager" uninstalled
release "cp-source-control-broker" uninstalled
release "cp-source-control-ui" uninstalled
namespace "cp-source-control" deleted
...
...
컨테이너 플랫폼 소스 컨트롤 페이지는 아래 주소로 접속 가능하다.
{K8S_MASTER_NODE_IP} 값은 Kubernetes Master Node Public IP 값을 입력한다.
- 컨테이너 플랫폼 소스 컨트롤 standalone 접속 URI : http://{K8S_MASTER_NODE_IP}:30094
컨테이너 플랫폼 소스 컨트롤 접속 초기 정보를 확인한 후 소스 컨트롤에 로그인한다.
- http://{K8S_MASTER_NODE_IP}:30094에 접속
- 초기 계정정보 확인하여 로그인
초기 계정정보는 아래 명령어를 통해 확인
$ kubectl get configmap -n cp-portal cp-portal-configmap -o yaml | grep KEYCLOAK_ADMIN
- Keycloak(http://{K8S_MASTER_NODE_IP}:32710)에 접속한다.
- Administration Console(관리자 페이지)로 접속한다.
- 관리자 계정으로 접속한다.
- 좌측 메뉴 하단의 'Users' 목록을 클릭한다.
- 오른쪽 버튼인 Add User를 클릭한다.
- Username 을 입력하고, Email Verified 스위치를 On으로 변경한다. 그 후 Save를 누른다.
- Credentials 탭으로 이동한다.
- Password / PassWord Confirmation을 입력하여 비밀번호를 설정한다.
- 임시번호가 아니라면 Temporary 스위치를 Off로 설정한다.
- http://{K8S_MASTER_NODE_IP}:30094에 접속한다.
- 회원가입을 통해 등록된 계정으로 컨테이너 플랫폼 소스 컨트롤에 로그인한다.
- 컨테이너 플랫폼 소스컨트롤 사용 방법은 아래 사용가이드를 참고한다.