스테이트풀(Stateful) 워크로드 확장

이 문서에서는 Google Distributed Cloud(GDC) 오프라인 Kubernetes 클러스터에서 실행되는 기존 스테이트풀(Stateful) 워크로드를 확장하는 방법을 설명합니다. 컨테이너 워크로드 요구사항이 변경되면 스테이트풀 워크로드에서 실행되는 포드를 확장해야 합니다.

이 문서는 조직의 애플리케이션 워크로드를 관리하는 애플리케이션 운영자 그룹의 개발자를 대상으로 합니다. 자세한 내용은 GDC 오프라인 문서의 대상을 참고하세요.

시작하기 전에

이 문서의 작업을 완료하려면 다음 리소스와 역할이 있어야 합니다.

  • Kubernetes 클러스터에 대해 명령어를 실행하려면 다음 리소스가 있어야 합니다.

    • Kubernetes 클러스터 이름을 찾거나 플랫폼 관리자 그룹의 구성원에게 클러스터 이름을 묻습니다.

    • Kubernetes 클러스터의 kubeconfig 파일이 없는 경우 로그인하여 생성합니다.

    • Kubernetes 클러스터의 kubeconfig 경로를 사용하여 이 안내의 KUBERNETES_CLUSTER_KUBECONFIG를 바꿉니다.

  • 공유 클러스터에서 스테이트풀 워크로드를 확장하는 데 필요한 권한을 얻으려면 조직 IAM 관리자에게 프로젝트 네임스페이스의 네임스페이스 관리자 역할(namespace-admin)을 부여해 달라고 요청하세요.

  • 표준 클러스터에서 스테이트풀 워크로드를 확장하는 데 필요한 권한을 얻으려면 조직 IAM 관리자에게 표준 클러스터의 클러스터 개발자 역할 (cluster-developer)을 부여해 달라고 요청하세요.

StatefulSet 리소스 확장

Kubernetes의 확장 기능을 사용하여 StatefulSet 리소스에서 실행되는 포드 수를 적절하게 확장합니다.

StatefulSet 리소스의 포드를 수동으로 확장

StatefulSet 리소스를 수동으로 확장하려면 다음을 실행하세요.

kubectl --kubeconfig KUBERNETES__CLUSTER_KUBECONFIG -n NAMESPACE \
    scale statefulset STATEFULSET_NAME \
    --replicas NUMBER_OF_REPLICAS

다음을 바꿉니다.

  • KUBERNETES_CLUSTER_KUBECONFIG: 클러스터의 kubeconfig 파일입니다.

  • NAMESPACE: 네임스페이스입니다. 공유 클러스터의 경우 프로젝트 네임스페이스여야 합니다. 표준 클러스터의 경우 모든 네임스페이스가 될 수 있습니다.

  • STATEFULSET_NAME: 확장할 StatefulSet 객체의 이름입니다.

  • NUMBER_OF_REPLICAS: StatefulSet 객체에 복제된 Pod 객체의 수입니다.

인플레이스 업데이트를 실행하여 포드 확장

매니페스트 파일에서 StatefulSet 리소스의 포드를 직접 확장하려면 다음을 실행합니다.

kubectl --kubeconfig KUBERNETES__CLUSTER_KUBECONFIG -n NAMESPACE \
    patch statefulsets STATEFULSET_NAME \
    -p '{"spec":{"replicas":NUMBER_OF_REPLICAS}}'

다음을 바꿉니다.

  • KUBERNETES__CLUSTER_KUBECONFIG: 클러스터의 kubeconfig 파일입니다.

  • NAMESPACE: 네임스페이스입니다. 공유 클러스터의 경우 프로젝트 네임스페이스여야 합니다. 표준 클러스터의 경우 모든 네임스페이스가 될 수 있습니다.

  • STATEFULSET_NAME: 확장할 StatefulSet 객체의 이름입니다.

  • NUMBER_OF_REPLICAS: StatefulSet 객체에 복제된 Pod 객체의 수입니다.

다음 단계