기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # PGO를 사용하여 Amazon EKS에서 PostgreSQL 배포 간소화 *Shalaka Dengale, Amazon Web Services* ## 요약 이 패턴은 Crunchy Data(PGO)의 Postgres 연산자를 Amazon Elastic Kubernetes Service(Amazon EKS)와 통합하여 클라우드 네이티브 환경에서 PostgreSQL 배포를 간소화합니다. PGO는 Kubernetes에서 PostgreSQL 데이터베이스를 관리하기 위한 자동화 및 확장성을 제공합니다. PGO를 Amazon EKS와 결합하면 PostgreSQL 데이터베이스를 효율적으로 배포, 관리 및 확장할 수 있는 강력한 플랫폼이 형성됩니다. 이 통합은 다음을 제공합니다. + 자동 배포: PostgreSQL 클러스터 배포 및 관리를 간소화합니다. + 사용자 지정 리소스 정의(CRDs): PostgreSQL 관리에 Kubernetes 프리미티브를** **사용합니다. + 고가용성: 자동 장애 조치 및 동기식 복제를 지원합니다. + 자동 백업 및 복원: 백업 및 복원 프로세스를** **간소화합니다. + 수평 조정: PostgreSQL 클러스터의 동적 조정을** **활성화합니다. + 버전 업그레이드: 가동 중지 시간을 최소화하면서 롤링 업그레이드를 용이하게 합니다. + 보안: 암호화, 액세스 제어 및 인증 메커니즘을 적용합니다. ## 사전 조건 및 제한 사항 **사전 조건 ** + 활성. AWS 계정 + [AWS Command Line Interface(AWS CLI) 버전 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html), Linux, macOS 또는 Windows에 설치 및 구성됨. + [AWS CLI Config](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html): 명령줄에서 AWS 리소스를 연결합니다. + [Docker](https://github.com/eksctl-io/eksctl#installation), Linux, macOS 또는 Windows에 설치 및 구성되었습니다. + `kubectl`, Amazon EKS 클러스터의 리소스에 액세스하도록 설치 및 구성됨. 자세한 내용은 Amazon EKS 설명서의 [kubectl 설치](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)를 참조하세요.  + Amazon EKS 클러스터에 액세스하도록 구성된 컴퓨터 터미널입니다. 자세한 내용은 Amazon EKS 설명서의 [클러스터와 통신하도록 컴퓨터 구성을 참조하세요](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-console.html#eks-configure-kubectl). **제품 버전** + Kubernetes 버전 1.21\~1.24 이상([PGO 설명서](https://access.crunchydata.com/documentation/postgres-operator/5.2.5/) 참조). + PostgreSQL 버전 9.4 이상. 이 패턴은 PostgreSQL 버전 16을 사용합니다. **제한 사항 ** + 일부 AWS 서비스 는 전혀 사용할 수 없습니다 AWS 리전. 리전 가용성은 [리전별AWS 서비스](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) 섹션을 참조하세요. 구체적인 엔드포인트는 [서비스 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) 페이지를 참조하고 서비스 링크를 선택합니다. ## 아키텍처 **대상 기술 스택 ** + Amazon EKS + Amazon Virtual Private Cloud(Amazon VPC) + Amazon Elastic Compute Cloud(Amazon EC2) **대상 아키텍처·** ![3개의 가용 영역과 2개의 복제본, 즉 PgBouncer 및 PGO 연산자와 함께 PGO를 사용하기 위한 아키텍처입니다.](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/images/pattern-img/4c164012-7527-4ebe-b6a7-c129600328d6/images/26a5572b-405b-4634-b96a-91254c3ea2c1.png) 이 패턴은 노드가 3개인 Amazon EKS 클러스터가 포함된 아키텍처를 구축합니다. 각 노드는 백엔드의 EC2 인스턴스 세트에서 실행됩니다. 이 PostgreSQL 설정은 읽기 작업이 많은 사용 사례에 특히 효과적인 기본 복제본 아키텍처를 따릅니다. 아키텍처에는 다음 구성 요소가 포함되어 있습니다. + **기본 데이터베이스 컨테이너(pg-primary)**는 모든 쓰기 작업이 전달되는 기본 PostgreSQL 인스턴스를 호스팅합니다. + **보조 복제본 컨테이너(pg-replica)**는 기본 데이터베이스에서 데이터를 복제하고 읽기 작업을 처리하는 PostgreSQL 인스턴스를 호스팅합니다. + **PgBouncer**는 PGO에 포함된 PostgreSQL 데이터베이스용 경량 연결 풀러입니다. 클라이언트와 PostgreSQL 서버 사이에 있으며 데이터베이스 연결을 위한 중개자 역할을 합니다. + **PGO**는이 Kubernetes 환경에서 PostgreSQL 클러스터의 배포 및 관리를 자동화합니다. + **Patroni**는 PostgreSQL의 고가용성 구성을 관리하고 자동화하는 오픈 소스 도구입니다. PGO에 포함되어 있습니다. Kubernetes에서 PGO와 함께 Patroni를 사용하면 PostgreSQL 클러스터의 복원력과 내결함성을 보장하는 데 중요한 역할을 합니다. 자세한 내용은 [Packer 설명서](https://patroni.readthedocs.io/en/latest/)를 참조하세요. 워크플로에는 다음 단계가 포함됩니다. + PGO 연산자를 배포합니다. Amazon EKS에서 실행되는 Kubernetes 클러스터에 PGO 연산자를 배포합니다. 이는 Kubernetes 매니페스트 또는 차트 Helm을 사용하여 수행할 수 있습니다. 이 패턴은 Kubernetes 매니페스트를 사용합니다. + **PostgreSQL 인스턴스를 정의합니다**. 연산자가 실행 중일 때 사용자 지정 리소스(CRs)를 생성하여 PostgreSQL 인스턴스의 원하는 상태를 지정합니다. 여기에는 스토리지, 복제 및 고가용성 설정과 같은 구성이 포함됩니다. + **연산자 관리**. PostgreSQL 인스턴스를 생성, 업데이트 또는 삭제하기 위해 CRs과 같은 Kubernetes API 객체를 통해 연산자와 상호 작용합니다. + **모니터링 및 유지 관리**. Amazon EKS에서 실행되는 PostgreSQL 인스턴스의 상태와 성능을 모니터링할 수 있습니다. 연산자는 모니터링 목적으로 지표와 로깅을 제공하는 경우가 많습니다. 필요에 따라 업그레이드 및 패치 적용과 같은 일상적인 유지 관리 작업을 수행할 수 있습니다. 자세한 내용은 Amazon EKS 설명서의 [클러스터 성능 모니터링 및 로그 보기를 참조하세요](https://docs.aws.amazon.com/eks/latest/userguide/eks-observe.html). + **조정 및 백업**: 운영자가 제공하는 기능을 사용하여 PostgreSQL 인스턴스를 조정하고 백업을 관리할 수 있습니다. 이 패턴은 모니터링, 유지 관리 및 백업 작업을 다루지 않습니다. **자동화 및 규모 조정** + CloudFormation 를 사용하여 인프라 생성을 자동화할 수 있습니다. 자세한 내용은 [Amazon EKS 설명서의를 사용하여 Amazon EKS 리소스 생성을 CloudFormation](https://docs.aws.amazon.com/eks/latest/userguide/creating-resources-with-cloudformation.html) 참조하세요. + GitVersion 또는 Jenkins 빌드 번호를 사용하여 데이터베이스 인스턴스 배포를 자동화할 수 있습니다. ## 도구 **AWS 서비스** + [Amazon Elastic Kubernetes Service(Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/getting-started.html)를 사용하면 자체 Kubernetes 컨트롤 플레인 또는 노드를 설치하거나 유지 관리할 필요 AWS 없이에서 Kubernetes를 실행할 수 있습니다.  + [AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)는 명령줄 셸의 명령을 AWS 서비스 통해와 상호 작용하는 데 도움이 되는 오픈 소스 도구입니다. **기타 도구** + [eksctl](https://eksctl.io/)은 Amazon EKS에 클러스터를 생성하기 위한 간단한 명령줄 도구입니다. + [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)은 Kubernetes 클러스터에 대해 명령을 실행하기 위한 명령줄 유틸리티입니다. + [PGO](https://github.com/CrunchyData/postgres-operator)는 Kubernetes에서 PostgreSQL 데이터베이스 관리를 자동화하고 확장합니다. ## 모범 사례 다음 모범 사례를 따라 원활하고 효율적인 배포를 보장합니다. + **EKS 클러스터를 보호합니다**. 서비스 계정(IRSA)에 대한 AWS Identity and Access Management (IAM) 역할 사용, 네트워크 정책 및 VPC 보안 그룹과 같은 EKS 클러스터의 보안 모범 사례를 구현합니다. EKS 클러스터 API 서버에 대한 액세스를 제한하고 TLS를 사용하여 노드와 API 서버 간의 통신을 암호화합니다. + Amazon EKS에서 실행되는 PGO와 Kubernetes 간의 **버전 호환성을 보장합니다**. 일부 PGO 기능에는 특정 Kubernetes 버전이 필요하거나 호환성 제한이 발생할 수 있습니다. 자세한 내용은 PGO 설명서의 [구성 요소 및 호환성](https://access.crunchydata.com/documentation/postgres-operator/5.2.5/references/components/)을 참조하세요. + CPU, 메모리 및 스토리지를 포함하여 PGO 배포에 대한 **리소스 할당을 계획**합니다. PGO와 PGO가 관리하는 PostgreSQL 인스턴스의 리소스 요구 사항을 모두 고려합니다. 리소스 사용량을 모니터링하고 필요에 따라 리소스를 확장합니다. + **고가용성을 위한 설계**. 가동 중지 시간을 최소화하고 신뢰성을 보장하기 위해 고가용성을 위한 PGO 배포를 설계합니다. 내결함성을 위해 여러 가용 영역에 여러 PGO 복제본을 배포합니다. + PGO가 관리하는 PostgreSQL 데이터베이스에 대한 **백업 및 복원 절차를 구현**합니다. Kubernetes 및 Amazon EKS와 호환되는 PGO 또는 서드 파티 백업 솔루션에서 제공하는 기능을 사용합니다. + PGO 배포에 대한 **모니터링 및 로깅을 설정**하여 성능, 상태 및 이벤트를 추적합니다. Prometheus와 같은 도구를 사용하여 지표를 모니터링하고 Grafana를 사용하여 시각화합니다. 문제 해결 및 감사를 위해 PGO 로그를 캡처하도록 로깅을 구성합니다. + PGO, PostgreSQL 인스턴스 및 Kubernetes 클러스터의 기타 서비스 간의 통신을 허용하도록 **네트워킹을 올바르게 구성합니다**. 네트워크 정책 적용 및 트래픽 격리를 위해 Calico 또는 Amazon VPC [CNI와 같은 Amazon VPC](https://github.com/aws/amazon-vpc-cni-k8s) 네트워킹 기능과 Kubernetes 네트워킹 플러그인을 사용합니다. + 성능, 내구성 및 확장성과 같은 요소를 고려하여 PostgreSQL 데이터베이스에 **적합한 스토리지 옵션을 선택합니다**. 영구 스토리지에 Amazon Elastic Block Store(Amazon EBS) 볼륨 또는 AWS 관리형 스토리지 서비스를 사용합니다. 자세한 내용은 [Amazon EKS 설명서의 Amazon EBS로 Kubernetes 볼륨 저장](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html)을 참조하세요. + 와 같은 **코드형 인프라(IaC) 도구를 사용하여** Amazon EKS에서 PGO의 배포 및 구성을 자동화 CloudFormation 합니다. 일관성, 반복성 및 버전 관리를 위한 코드로 EKS 클러스터, 네트워킹 및 PGO 리소스를 포함한 인프라 구성 요소를 정의합니다. ## 에픽 ### IAM 역할 생성 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | IAM 역할을 생성합니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | 관리자 | ### Amazon EKS 클러스터 생성 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | Amazon EKS 클러스터를 생성합니다. | 클러스터를 이미 배포한 경우이 단계를 건너뜁니다. 그렇지 않으면 , `eksctl`Terraform 또는를 사용하여 현재에 Amazon EKS 클러스터 AWS 계정 를 배포합니다 CloudFormation. 이 패턴은 클러스터 배포`eksctl`에를 사용합니다.이 패턴은 Amazon EC2를 Amazon EKS의 노드 그룹으로 사용합니다. 를 사용하려면 [eksctl 설명서](https://eksctl.io/usage/schema/#managedNodeGroups)의 `managedNodeGroups` 구성을 AWS Fargate참조하세요.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | AWS 관리자, Terraform 또는 eksctl 관리자, Kubernetes 관리자 | | 클러스터의 상태입니다. | 다음 명령을 실행하여 클러스터 상태를 확인합니다.
kubectl get nodes

오류가 발생하는 경우 [문제 해결](https://docs.aws.amazon.com/eks/latest/userguide/troubleshooting.html) 섹션을 참조하세요. | AWS 관리자, Terraform 또는 eksctl 관리자, Kubernetes 관리자 | ### OIDC 자격 증명 공급자를 생성하는 방법() | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | IAM OIDC 공급자를 활성화합니다. | Amazon EBS 컨테이너 스토리지 인터페이스(CSI) 드라이버의 사전 조건으로 클러스터에 대한 기존 IAM OpenID Connect(OIDC) 공급자가 있어야 합니다.
다음 명령을 사용하여 IAM ID 제공업체를 만듭니다.
eksctl utils associate-iam-oidc-provider --region={region} --cluster={YourClusterNameHere} --approve

이에 대한 자세한 내용은 Amazon EKS 설명서의 [kubectl 설치](https://docs.aws.amazon.com/eks/latest/userguide/ebs-csi.html)를 참조하세요. | 관리자 | | Amazon EBS CSI 드라이버 IAM 역할 생성 | 다음 `eksctl` 명령을 사용하여 CSI 드라이버의 IAM 역할을 만듭니다.
eksctl create iamserviceaccount \
  --region {RegionName} \
  --name ebs-csi-controller-sa \
  --namespace kube-system \
  --cluster {YourClusterNameHere} \
  --attach-policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \
  --approve \
  --role-only \
  --role-name AmazonEKS_EBS_CSI_DriverRole

암호화된 Amazon EBS 드라이브를 사용하는 경우 정책을 추가로 구성해야 합니다. 자세한 지침은 [Amazon EC2 설명서](https://github.com/kubernetes-sigs/aws-ebs-csi-driver/blob/master/docs/install.md#installation-1)를 참조하십시오. | 관리자 | | Amazon EBS CSI 드라이버 추가 기능 받기 | 다음 `eksctl` 명령을 사용하여 Amazon EBS CSI 드라이버를 추가합니다.
eksctl create addon \
  --name aws-ebs-csi-driver \
  --cluster  service-account-role-arn arn:aws:iam::$(aws sts get-caller-identity \
  --query Account \
  --output text):role/AmazonEKS_EBS_CSI_DriverRole \
  --force
| 관리자 | ### PHP를 설치합니다. | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | 리포지토리를 복제합니다. | GitHub 리포지토리를 복제합니다.
git clone https://github.com/CrunchyData/postgres-operator-examples.git
| DevOps | | 서비스 계정 생성을 위한 역할 세부 정보를 제공합니다. | Amazon EKS 클러스터에 필요한 AWS 리소스에 대한 액세스 권한을 부여하려면 [GitHub](https://github.com/CrunchyData/postgres-operator/blob/main/config/rbac/cluster/service_account.yaml)에 있는 `service_account.yaml` 파일에서 앞서 생성한 OIDC 역할의 Amazon 리소스 이름(ARN)을 지정합니다.
cd postgres-operator-examples
---
metadata:
  annotations:
    eks.amazonaws.com/role-arn: arn:aws:iam:::role/ # Update the OIDC role ARN created earlier
| AWS 관리자, Kubernetes 관리자 | | 네임스페이스 및 PGO 사전 조건을 생성합니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | Kubernetes 관리자 | | 포드 생성을 확인합니다. | 네임스페이스와 기본 구성이 생성되었는지 확인합니다.
kubectl get pods -n postgres-operator
| AWS 관리자, Kubernetes 관리자 | | PVCs 확인합니다. | 다음 명령을 사용하여 영구 볼륨 클레임(PVCs
kubectl describe pvc -n postgres-operator
| AWS 관리자, Kubernetes 관리자 | ### 연산자 생성 및 배포 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | CREATE OPERATOR | 다음과 `/kustomize/postgres/postgres.yaml` 일치하도록에 있는 파일의 내용을 수정합니다.
spec:
  instances:
    - name: pg-1
      replicas: 3
  patroni:
    dynamicConfiguration:
      postgresql:
      pg_hba:
        - "host all all 0.0.0.0/0 trust" # this line enabled logical replication with programmatic access
        - "host all postgres 127.0.0.1/32 md5"
      synchronous_mode: true
  users:
  - name: replicator
    databases:
      - testdb
    options: "REPLICATION"

이러한 업데이트는 다음을 수행합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | AWS 관리자, DBA, Kubernetes 관리자 | | 연산자 배포 | PGO 연산자를 배포하여 Kubernetes 환경에서 PostgreSQL 데이터베이스의 간소화된 관리 및 운영을 활성화합니다.
kubectl apply -k kustomize/postgres
| AWS 관리자, DBA, Kubernetes 관리자 | | 배포를 확인합니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html)명령 출력에서 기본 복제본(`primary_pod_name`)과 읽기 전용 복제본()을 기록해 둡니다`read_pod_name`. 다음 단계에서 이 항목을 편집합니다. | AWS 관리자, DBA, Kubernetes 관리자 | ### 스트리밍 복제 확인 | 작업 | 설명 | 필요한 기술 | | --- | --- | --- | | 기본 복제본에 데이터를 씁니다. | 다음 명령을 사용하여 PostgreSQL 기본 복제본에 연결하고 데이터베이스에 데이터를 씁니다.
kubectl exec -it  bash -n postgres-operator
psql
CREATE TABLE customers (firstname text, customer_id serial, date_created timestamp);
\dt
| AWS 관리자, Kubernetes 관리자 | | 읽기 전용 복제본의 데이터가 동일한지 확인합니다. | PostgreSQL 읽기 전용 복제본에 연결하고 스트리밍 복제가 올바르게 작동하는지 확인합니다.
kubectl exec -it {read_pod_name} bash -n postgres-operator
psql
\dt

읽기 전용 복제본에는 이전 단계의 기본 복제본에서 생성한 테이블이 있어야 합니다. | AWS 관리자, Kubernetes 관리자 | ## 문제 해결 | 문제 | Solution | | --- | --- | | 포드가 시작되지 않습니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | | 복제본은 기본 데이터베이스보다 훨씬 뒤쳐져 있습니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | | PostgreSQL 클러스터의 성능과 상태를 볼 수 없습니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | | 복제가 작동하지 않습니다. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/prescriptive-guidance/latest/patterns/streamline-postgresql-deployments-amazon-eks-pgo.html) | ## 관련 리소스 + [Amazon Elastic Kubernetes Service](https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/amazon-elastic-kubernetes-service.html)(*AWS 백서의 배포 옵션 개요*) + [CloudFormation](https://docs.aws.amazon.com/whitepapers/latest/overview-deployment-options/aws-cloudformation.html) (*AWS 백서의 배포 옵션 개요*) + [Amazon EKS 시작하기 – eksctl](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-eksctl.html)(*Amazon EKS 사용 설명서*) + [kubectl 및 eksctl 설정](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)(*Amazon EKS 사용 설명서*) + [OpenID Connect 페더레이션을 위한 역할 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)(*IAM 사용 설명서*) + (*AWS CLI 사용 설명서*)[에 대한 설정 구성 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) + [Kubernetes용 Crunchy Postgres 설명서](https://access.crunchydata.com/documentation/postgres-operator/latest) + [Crunch & Learn: Kubernetes 5.0용 Crunchy Postgres](https://www.youtube-nocookie.com/embed/IIf9WZO3K50)(비디오)