/install-catalog

Apache License 2.0Apache-2.0

CatalogContoller 설치 가이드

구성 요소 및 버전

Prerequisites

폐쇄망 구축 가이드

  1. 사용하는 image를 다운받고 저장합니다.

    • 작업 디렉토리 생성 및 환경 설정
    mkdir -p ~/catalog-controller-install
export CATALOG_HOME=~/catalog-controller-install
export CATALOG_VERSION=0.3.0
cd $CATALOG_HOME
    • 외부 네트워크 통신이 가능한 환경에서 필요한 이미지를 다운받습니다.
    # TEMPLATE SERVICE BROKER 이미지 Pull
docker pull quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION}

# 이미지 Save
docker save quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION} > service-catalog_v${CATALOG_VERSION}.tar

  2. 폐쇄망으로 이미지 파일(.tar)을 옮깁니다.

  3. 폐쇄망에서 사용하는 image repository에 이미지를 push 합니다.

    # 이미지 레지스트리 주소
REGISTRY=[IP:PORT]

# 이미지 Load
docker load < service-catalog_v${CATALOG_VERSION}.tar

# 이미지 Tag
docker tag quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION} ${REGISTRY}/quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION}

# 이미지 Push
docker push ${REGISTRY}/quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION}

설치 가이드

  1. 설치에 필요한 crd 생성
  2. catalog controller namespace 및 servcice account 생성
  3. catalog manager 생성
  4. webhook 인증 키 생성
  5. catalog-webhook 생성

Step 1. 설치에 필요한 crd 생성

  • 목적 : CatalogController crd 생성
  • 생성 순서 : 아래 command로 yaml 적용
    • kubectl apply -f crds/ (폴더)

Step 2. catalog controller namespace 및 servcice account 생성

  • 목적 : catalog controller namespace 및 servcice account 생성
  • 생성 순서 : 아래 command로 yaml 적용
    • kubectl create namespace catalog
    • kubectl apply -f serviceaccounts.yaml (파일)
    • kubectl apply -f rbac.yaml (파일)

Step 3. catalog manager 생성

  • 목적 : catalog manager 생성
  • 생성 순서 : 아래 command로 yaml 적용
    • kubectl apply -f controller-manager-deployment.yaml (파일)
      • 비고: 각 파일에 image 항목이 있는 경우, registry주소의 이미지를 사용해야 합니다. (${REGISTRY}/quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION})
    • kubectl apply -f controller-manager-service.yaml (파일)

Step 4. webhook 인증 키 생성

  • 목적 : webhook 인증에 필요한 키를 생성
  • 생성 순서 : 아래 command 적용
    • openssl genrsa -out rootca.key 2048
    • openssl req -x509 -new -nodes -key rootca.key -sha256 -days 3650 -subj /C=KO/ST=None/L=None/O=None/CN=catalog-catalog-webhook -out rootca.crt
      • 비고: .rnd 파일이 없어서 해당 명령어 실행이 안되는 경우, /etc/ssl/openssl.cnf 파일의 "RANDFILE = $ENV::HOME/.rnd" 부분을 주석처리 합니다.
    • v3.ext 파일 생성 (파일)
    • openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout server.key -subj /C=KO/ST=None/L=None/O=None/CN=catalog-catalog-webhook -out server.csr
    • openssl x509 -req -in server.csr -CA rootca.crt -CAkey rootca.key -CAcreateserial -out server.crt -days 3650 -sha256 -extfile ./v3.ext
    • openssl base64 -in rootca.crt -out key0
    • openssl base64 -in server.crt -out cert
    • openssl base64 -in server.key -out key

Step 5. catalog-webhook 생성

  • 목적 : catalog-webhook 생성
  • 생성 순서 : 아래 command 적용
    • kubectl apply -f webhook-register.yaml (파일)
      • 비고: 해당 파일의 변수를 7번에서 생성한 키로 대체 합니다. (단, 생성된 키 공백은 모두 지우셔야 합니다.)
        • {{ b64enc $ca.Cert }} --> key0 내부 값으로 대체
        • {{ b64enc $cert.Cert }} --> cert 내부 값으로 대체
        • {{ b64enc $cert.Key }} --> key 내부 값으로 대체
    • kubectl apply -f webhook-deployment.yaml (파일)
      • 비고: 각 파일에 image 항목이 있는 경우, registry주소의 이미지를 사용해야 합니다. (${REGISTRY}/quay.io/kubernetes-service-catalog/service-catalog:v${CATALOG_VERSION})
    • kubectl apply -f webhook-service.yaml (파일)

삭제 가이드

  1. 사용중인 리소스 제거
  2. 설치 리소스 제거
  3. CRD 제거

Step 1. 사용중인 리소스 제거

  • 목적 : 사용중인 리소스 차례로 제거
  • 삭제 순서 : 아래 command 순서대로 적용
    • kubectl delete servicebinding --all --all-namespaces
    • kubectl delete serviceinstance --all --all-namespaces
    • kubectl delete servicebinding --all --all-namespaces
    • kubectl delete clusterservicebroker --all --all-namespaces
    • kubectl delete servicebroker --all --all-namespaces

Step 2. 설치 리소스 제거

  • 목적 : 설치에 필요한 pod, service 등의 리소스 제거
  • 삭제 순서 : 설치에 진행했던 yaml 파일 역순으로 적용
    • kubectl delete -f webhook-service.yaml (파일)
    • kubectl delete -f webhook-deployment.yaml (파일)
    • kubectl delete -f webhook-register.yaml (파일)
    • kubectl delete -f controller-manager-service.yaml (파일)
    • kubectl delete -f controller-manager-deployment.yaml (파일)
    • kubectl delete -f rbac.yaml (파일)
    • kubectl delete -f serviceaccounts.yaml (파일)
    • kubectl delete namespace catalog

Step 3. CRD 제거

  • 목적 : CRD 제거
  • 삭제 순서 : 아래 command로 yaml 적용
    • kubectl delete -f crds/ (폴더)