service-catalog/manifests/helm/postgresql-ha/11.9.4/BUILD-README.md

postgres-ha 버전 갱신 가이드

1. git 작업 환경 구성

• 서비스 카탈로그 git 다운로드

$ git clone https://github.com/paasup/service-catalog.git

• 작업 브랜치로 체크아웃

$ git checkout -b update-postgresql-ha/11.9.4

2. helm chart 업데이트

1) 차트 버전 변경

• BUILD-README.md, CUSTOM-README.md, custom-values.yaml, templates/_configuration.tpl을 제외한 파일 삭제

  # chart 디렉토리로 이동
  cd ~/service-catalog/charts/postgresql-ha
  
  # 파일 삭제 전 삭제할 파일 목록 확인
  find . -mindepth 1 \( -name "CUSTOM-README.md" -o -name "BUILD-README.md"  -o -name "custom-values.yaml" -o -path "./templates/_configuration.tpl" \) -prune -o -print
  
  # 파일 삭제
  find . -mindepth 1 \(-name "CUSTOM-README.md" -o -name "BUILD-README.md"  -o -name "custom-values.yaml" -o -path "./templates/_configuration.tpl" \) -prune -o -exec rm -rf {} +
  

• bitnami/postgres-ha 차트 다운로드

  # charts 디렉토리로 이동
  cd ~/service-catalog/charts
  
  # helm repo 추가
  helm repo add bitnami https://charts.bitnami.com/bitnami
  helm repo update
  
  # helm 차트 
  helm pull bitnami/postgresql-ha --version="11.9.4"
  
  # 차트 변경
  tar xzvf postgresql-ha*.tgz
  
  # 필요 없는 파일 삭제
  rm postgresql-ha-*.tgz
  

2) 차트 수정 사항 반영

• 다음은 Postgresql 설정을 추가하기 위하여 수정한 파일 목록 및 내용이다.

./template/postgresql/statefulset.yaml

• postgresql의 설정을 적용하기 위한 변경 사항이다.
• ./template/postgresql/statefulset.yaml에 다음 내용을 추가한다.

            ## line 125 아래 추가
            command:
            ...
              {{- if ( include "postgresql-ha.configuration.postgresql.enabled" . ) }}
              chmod -R 777 /dev/shm
              {{- end }}

            volumeMount:
            ...
            ## line 460 아래 추가
            {{- if ( include "postgresql-ha.configuration.postgresql.enabled" . ) }}
            - name: postgresql-config
              mountPath: /bitnami/repmgr/conf
            - name: dshm
              mountPath: /dev/shm
            {{- end }}
        ...
        voluems:
        ...
        ## line 600 아래 추가
        {{- if ( include "postgresql-ha.configuration.postgresql.enabled" . ) }}
        - name: postgresql-config
          configMap:
            name: {{ include "postgresql-ha.postgresqlConfigurationCM" . }}
        - name: dshm
          emptyDir:
            medium: Memory
            sizeLimit: {{ include "postgresql-ha.configuration.postgresql.sharedMemory" . }}
        {{- end }}

./template/postgresql/configmap.yaml

• postgresql.resources.limits.memory에 따라 postgresql에 설정 변경 사항을 반영하기 위해 다음 내용을 추가한다.
• ./template/postgresql/configmap.yaml에 다음 내용을 추가한다.

## line 29 아래 추가
...
{{- else }}
apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ printf "%s-configuration" (include "postgresql-ha.postgresql" .) }}
  namespace: {{ include "common.names.namespace" . | quote }}
  labels: {{- include "common.labels.standard" ( dict "customLabels" .Values.commonLabels "context" $ ) | nindent 4 }}
    app.kubernetes.io/component: postgresql
  {{- if .Values.commonAnnotations }}
  annotations: {{- include "common.tplvalues.render" ( dict "value" .Values.commonAnnotations "context" $ ) | nindent 4 }}
  {{- end }}
data:
  postgresql.conf: |-
        {{- include "postgresql-ha.configuration.postgresConf" . | nindent 4 }}
...

3. git push 및 tag 추가

• 갱신작업 진행후 commit

$ git add .
$ git commit -m "update postgresql-ha/11.9.4-1"

• main 브랜치에 체크아웃 후 merge

$ git checkout main
$ git merge update-postgresql-ha/11.9.4-1

• git에 push 후 작업 브랜치 삭제

$ git push -u origin main
$ git branch -d update-postgresql-ha/11.9.4-1

• git tag 추가 후 push

$ git tag postgresql-ha/11.9.4-1
$ git push origin postgresql-ha/11.9.4-1

4. 차트 버전 정보

• postgresql-ha/11.9.4
  • 서비스 배포를 위하여 custom-values.yam에 정의하였다.
  • 차트의 빌드 방법과 배포 방법을 BUILD-README.md, CUSTOM-README.md 문서에 작성하였다.
  • values.yaml의 설정에 따라 postgresql.conf를 생성하여 postgresql에 적용하도록 차트를 수정하였다.
• postgresql-ha/11.9.4-1
  • values.yaml의 설정에 따라 생성한 postgresql.conf가 적용되지 않는 오류 수정를 수정하였다.