1.3 Quickstart: 5분 만에 첫 클러스터

### Step 1. 로컬 Kubernetes 클러스터 생성### Step 2. CloudNativePG Operator 설치 1.30 릴리스의 매니페스트를 `--server-side` 모드로 적용한다. ```bash kubectl apply --server-side -f \ https://raw.githubusercontent.com/cloudnative-pg/cloudnative-pg/release-1.30/releases/cnpg-1.30.0.yaml ``` Operator가 정상적으로 떴는지는 rollout 상태로 확인한다. ```bash kubectl rollout status deployment \ -n cnpg-system cnpg-controller-manager ``` `successfully rolled out` 메시지가 나오면 Operator가 `cnpg-system` namespace에서 동작 중이다. ### Step 3. Cluster 매니페스트 작성 `cluster-example.yaml` 파일을 만든다. primary 1개 + replica 2개, 총 3개 인스턴스 구성이다. ```yaml apiVersion: postgresql.cnpg.io/v1 kind: Cluster metadata: name: cluster-example spec: instances: 3 storage: size: 1Gi ```특정 PostgreSQL 버전이 필요하면 `spec`에 `imageName`을 추가한다. ```yaml spec: instances: 3 imageName: ghcr.io/cloudnative-pg/postgresql:13.6 storage: size: 1Gi ``` ### Step 4. Cluster 배포 ```bash kubectl apply -f cluster-example.yaml ``` ### Step 5. 상태 확인 Pod가 뜨는 과정을 지켜본다. ```bash kubectl get pods -l cnpg.io/cluster=cluster-example ``` 인스턴스가 모두 준비되면 3개의 Pod가 `Running` 상태로 보인다. `cnpg` kubectl 플러그인을 설치했다면 사람이 읽기 좋은 요약도 볼 수 있다. ```bash kubectl cnpg status cluster-example ``` 여기에는 어느 Pod가 primary이고 어느 것이 replica인지, replication 지연은 얼마인지 등이 표시된다. ### Step 6. 접속 `cnpg` 플러그인으로 primary에 곧장 `psql` 세션을 연다. ```bash kubectl cnpg psql cluster-example ``` 애플리케이션 관점에서는 개별 Pod가 아니라 Operator가 만들어 준 service를 통해 접속한다. read-write 트래픽은 `cluster-example-rw` service가 항상 현재 primary를 가리킨다. ```bash kubectl get svc -l cnpg.io/cluster=cluster-example ```

    flowchart TD
    M[cluster-example.yaml] -->|kubectl apply| OP[CNPG Operator]
    OP --> RW[cluster-example-rw Service]
    OP --> PRI[Primary Pod]
    OP --> R1[Replica Pod]
    OP --> R2[Replica Pod]
    RW --> PRI
    PRI -.replication.-> R1
    PRI -.replication.-> R2