6.3. Kubernetes KMS v2 비활성화


KMS 암호화를 비활성화하고 로컬 etcd 암호화로 마이그레이션하여 작업을 간소화하거나 외부 KMS 연결 문제를 해결할 수 있습니다.

중요

Kubernetes KMS v2는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

6.3.1. KMS 암호화 비활성화

KMS 암호화를 비활성화하고 로컬 암호화로 마이그레이션하거나 암호화를 완전히 비활성화하여 작업을 간소화하거나 연결 문제를 해결할 수 있습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
  • etcd 백업을 생성했습니다.
주의

모든 etcd 데이터의 재암호화는 암호화 유형을 변경할 때 수행됩니다.

절차

  1. 다음 명령을 입력하여 APIServer 사용자 정의 리소스를 편집합니다.

    $ oc edit apiserver cluster
  2. 다음 예제를 사용하여 암호화 유형을 변경하고 kms 섹션을 제거하십시오.

    apiVersion: config.openshift.io/v1
    kind: APIServer
    metadata:
      name: cluster
    spec:
      encryption:
        type: <encryption>

    &lt ;encryption >를 aescbc,aesgcm 또는 ID 로 바꿉니다. aescbc 및 aesgcm 유형은 로컬에서 관리되는 암호화 키를 사용합니다. ID 유형은 모든 암호화를 비활성화하고 데이터를 일반 텍스트로 저장합니다. 암호화 유형이 KMS 가 아닐 때 API에서 거부하므로 전체 kms 섹션을 제거해야 합니다.

  3. 저장 및 종료합니다.

    OpenShift Container Platform은 etcd 데이터를 마이그레이션합니다. KMS 플러그인은 마이그레이션이 완료될 때까지 읽기 전용 공급자로 유지됩니다.

  4. 다음 명령을 입력하여 마이그레이션 진행 상황을 모니터링합니다.

    $ oc get kubeapiserver cluster -o jsonpath='{.status.conditions[?(@.type=="Encrypted")]}' | jq .

    EncryptionCompleted 이유가 표시될 때까지 기다립니다. kube-apiserver 는 일반적으로 마지막으로 완료된 것입니다.

  5. 다음 명령을 입력하여 kube-apiserver Pod가 롤아웃되었는지 확인합니다.

    $ oc get pods -n openshift-kube-apiserver -l app=openshift-kube-apiserver
  6. 마이그레이션이 완료되면 다음 단계를 사용하여 KMS 공급자 리소스를 정리합니다.

    1. 다음 명령을 입력하여 인증 정보 시크릿을 삭제합니다.

      $ oc delete secret vault-approle-secret -n openshift-config
    2. 선택 사항: 다음 명령을 입력하여 CA 번들 구성 맵을 삭제합니다.

      $ oc delete configmap vault-ca-bundle -n openshift-config
    3. 백업 보존 기간이 통과된 후 KMS 키를 해제하십시오.

검증

  1. 다음 명령을 입력하여 암호화 유형을 확인합니다.

    $ oc get apiserver cluster -o jsonpath='{.spec.encryption.type}'
  2. 테스트 보안에서 새 암호화 유형을 사용하는지 확인합니다.

    1. 다음 명령을 입력하여 테스트 시크릿을 생성합니다.

      $ oc create secret generic encryption-test --from-literal=key=value -n default
    2. 다음 명령을 입력하여 etcd pod 이름을 가져옵니다.

      $ oc get pods -n openshift-etcd -l app=etcd -o name | head -1
    3. 다음 명령을 입력하여 암호화 접두사를 확인합니다.

      $ oc exec -n openshift-etcd <etcd_pod_name> -- etcdctl get /kubernetes.io/secrets/default/encryption-test --print-value-only | hexdump -C | head -1

      출력은 k8s:enc:aescbc:v1:, k8s:enc:aesgcm:v1 로 시작하거나 ID 에 대해 읽을 수 있는 JSON을 표시합니다.

    4. 다음 명령을 입력하여 테스트 시크릿을 삭제합니다.

      $ oc delete secret encryption-test -n default
참고

마이그레이션이 완료될 때까지 KMS 키를 삭제하지 마십시오.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동