3.4. GitOps를 사용하여 정책 배포
거버넌스 프레임워크를 사용하여 여러 관리 클러스터에 일련의 정책을 배포할 수 있습니다. 리포지토리의 정책에 기여하고 사용하여 오픈 소스 커뮤니티에 정책 수집
할 수 있습니다. 자세한 내용은 사용자 지정 정책 Contributing을 참조하십시오. 오픈 소스 커뮤니티의 안정
및 커뮤니티
폴더에 있는 각 정책은 NIST의 특수한 800-53 에 따라 추가로 구성됩니다.
GitOps를 사용하는 모범 사례를 계속 읽고 Git 리포지토리를 통해 정책 업데이트 및 생성을 자동화하고 추적합니다.
사전 요구 사항: 시작하기 전에 정책 수집
리포지토리를 분기해야 합니다.
3.4.1. 로컬 리포지토리 사용자 정의 링크 복사링크가 클립보드에 복사되었습니다!
안정적인
및 커뮤니티
정책을 단일 폴더에 통합하여 로컬 리포지토리를 사용자 정의합니다. 사용하지 않으려는 정책을 제거합니다. 로컬 리포지토리를 사용자 지정하려면 다음 단계를 완료합니다.
리포지토리에 배포하려는 정책을 유지하기 위해 새 디렉터리를 생성합니다. GitOps의 기본 기본 분기의 로컬
정책 수집
리포지토리에 있는지 확인합니다. 다음 명령을 실행합니다.mkdir my-policies
mkdir my-policies
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 모든
안정
및커뮤니티
정책을my-policies
디렉터리에 복사합니다. 먼저커뮤니티
정책부터stable
폴더에 커뮤니티에서 사용할 수 있는 항목이 중복되는 경우부터 시작합니다. 다음 명령을 실행합니다.cp -R community/* my-policies/ cp -R stable/* my-policies/
cp -R community/* my-policies/ cp -R stable/* my-policies/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이제 단일 상위 디렉터리 구조에 모든 정책이 있으므로 포크의 정책을 편집할 수 있습니다.
팁:
- 사용하지 않으려는 정책을 제거하는 것이 좋습니다.
다음 목록에서 정책 및 정책 정의에 대해 알아보십시오.
- 목적: 정책이 수행하는 작업을 파악합니다.
수정 작업: 정책은 규정 준수를 사용자에게만 알리거나 정책을 적용하고 변경합니까?
spec.remediationAction
매개변수를 참조하십시오. 변경 사항이 적용되는 경우 기능적 기대치를 이해해야 합니다. 어떤 정책이 시행을 지원하는지 확인하십시오. 자세한 내용은 Validate 섹션을 참조하십시오.참고: 정책에 대해 설정된
spec.remediationAction
은 개별spec.policy-templates
에 설정된 모든 수정 작업을 덮어씁니다.-
배치: 정책이 배포되는 클러스터는 무엇입니까? 기본적으로 대부분의 정책은
environment: dev
레이블을 사용하여 클러스터를 대상으로 합니다. 일부 정책은 OpenShift Container Platform 클러스터 또는 다른 레이블을 대상으로 할 수 있습니다. 다른 클러스터를 포함하도록 라벨을 업데이트하거나 추가할 수 있습니다. 특정 값이 없는 경우 정책이 모든 클러스터에 적용됩니다. 하나의 클러스터 세트에 대해 한 가지 방식으로 구성된 정책을 사용하고 다른 클러스터 세트에 대해 다른 방식으로 구성하려는 경우 정책 복사본을 여러 개 생성하고 각 사본을 사용자 지정할 수도 있습니다.
3.4.2. 로컬 리포지토리에 커밋 링크 복사링크가 클립보드에 복사되었습니다!
디렉터리에 대한 변경 사항을 충족한 후 클러스터에서 액세스할 수 있도록 변경 사항을 커밋 및 내보냅니다.
참고: 이 예제는 GitOps에서 정책을 사용하는 방법에 대한 기본을 표시하는 데 사용되므로 분기를 변경할 수 있는 다른 워크플로우가 있을 수 있습니다.
다음 단계를 완료합니다.
터미널에서
git status
를 실행하여 이전에 생성한 디렉터리의 최근 변경 사항을 확인합니다. 다음 명령을 사용하여 커밋할 변경 사항 목록에 새 디렉터리를 추가합니다.git add my-policies/
git add my-policies/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 변경 사항을 커밋하고 메시지를 사용자 지정합니다. 다음 명령을 실행합니다.
git commit -m “Policies to deploy to the hub cluster”
git commit -m “Policies to deploy to the hub cluster”
Copy to Clipboard Copied! Toggle word wrap Toggle overflow GitOps에 사용되는 분기된 리포지토리 분기로 변경 사항을 내보냅니다. 다음 명령을 실행합니다.
git push origin <your_default_branch>master
git push origin <your_default_branch>master
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
변경 사항이 커밋됩니다.
3.4.3. 클러스터에 정책 배포 링크 복사링크가 클립보드에 복사되었습니다!
변경 사항을 푸시한 후 Kubernetes용 Red Hat Advanced Cluster Management에 정책을 배포할 수 있습니다. 배포 후 hub 클러스터가 Git 리포지토리에 연결되어 있습니다. Git 리포지토리의 선택한 분기에 대한 추가 변경 사항은 클러스터에 반영됩니다.
참고: 기본적으로 GitOps와 함께 배포된 정책은 병합
조정 옵션을 사용합니다. 대신 교체
조정 옵션을 사용하려면 apps.open-cluster-management.io/reconcile-option:
주석을 Subscription
리소스에 추가합니다. 자세한 내용은 애플리케이션 라이프사이클 을 참조하십시오.
deploy.sh
스크립트는 허브 클러스터에 채널
및 서브스크립션
리소스를 생성합니다. 채널은 Git 리포지토리에 연결되고 서브스크립션은 채널을 통해 클러스터에 가져올 데이터를 지정합니다. 결과적으로 지정된 하위 디렉터리에 정의된 모든 정책이 허브에 생성됩니다. 서브스크립션을 통해 정책을 생성한 후 Red Hat Advanced Cluster Management는 정책을 분석하고 정의된 배치 규칙에 따라 정책이 적용되는 각 관리 대상 클러스터와 연결된 네임스페이스에 추가 정책 리소스를 생성합니다.
그런 다음 이 정책은 hub 클러스터의 해당 관리 클러스터 네임스페이스에서 관리 클러스터에 복사됩니다. 결과적으로 Git 리포지토리의 정책은 정책의 배치 규칙에 정의된 clusterSelector
와 일치하는 라벨이 있는 모든 관리 클러스터로 푸시됩니다.
다음 단계를 완료합니다.
policy-collection
디렉토리에서 다음 명령을 실행하여 디렉터리를 변경합니다.cd deploy
cd deploy
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 사용하여 올바른 클러스터에 리소스를 생성하도록 CLI(명령줄 인터페이스)가 구성되어 있는지 확인합니다.
oc cluster-info
oc cluster-info
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령 출력은 Red Hat Advanced Cluster Management가 설치된 클러스터의 API 서버 세부 정보를 표시합니다. 올바른 URL이 표시되지 않으면 올바른 클러스터를 가리키도록 CLI를 구성합니다. 자세한 내용은 OpenShift CLI 사용을 참조하십시오.
정책을 생성하여 액세스를 제어하고 정책을 구성합니다. 다음 명령을 실행합니다.
oc create namespace policy-namespace
oc create namespace policy-namespace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 클러스터에 정책을 배포합니다.
./deploy.sh -u https://github.com/<your-repository>/policy-collection -p my-policies -n policy-namespace
./deploy.sh -u https://github.com/<your-repository>/policy-collection -p my-policies -n policy-namespace
Copy to Clipboard Copied! Toggle word wrap Toggle overflow your-repository
를 Git 사용자 이름 또는 리포지토리 이름으로 바꿉니다.참고: 참조를 위해
deploy.sh
스크립트의 전체 인수 목록은 다음 구문을 사용합니다../deploy.sh [-u <url>] [-b <branch>] [-p <path/to/dir>] [-n <namespace>] [-a|--name <resource-name>]
./deploy.sh [-u <url>] [-b <branch>] [-p <path/to/dir>] [-n <namespace>] [-a|--name <resource-name>]
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 각 인수에 대한 다음 설명을 확인합니다.
-
URL: 기본
정책 수집
리포지토리에서 분기한 리포지토리의 URL입니다. 기본 URL은https://github.com/stolostron/policy-collection.git
입니다. -
분기: 을 가리키는 Git 리포지토리의 분기입니다. 기본 분기는
main
입니다. -
하위 디렉터리 경로: 사용하려는 정책을 포함하도록 생성한 하위 디렉터리 경로입니다. 이전 샘플에서는
my-policies
하위 디렉터리를 사용했지만 시작할 폴더를 지정할 수도 있습니다. 예를 들어my-policies/AC-Access-Control
을 사용할 수 있습니다. 기본 폴더는stable
입니다. -
namespace: 허브 클러스터에서 리소스 및 정책이 생성되는 네임스페이스입니다. 이 명령은
policy-namespace
네임스페이스를 사용합니다. 기본 네임스페이스는 policy입니다
. -
이름 접두사:
채널
및서브스크립션
리소스의 접두사입니다. 기본값은demo-stable-policies
입니다.
-
URL: 기본
deploy.sh
스크립트를 실행하면 리포지토리에 액세스할 수 있는 모든 사용자가 분기에 대한 변경 사항을 커밋할 수 있으므로 클러스터의 기존 정책으로 변경 사항이 푸시됩니다.
참고: 서브스크립션을 사용하여 정책을 배포하려면 다음 단계를 완료하십시오.
-
open-cluster-management:subscription-admin
ClusterRole을 서브스크립션을 생성한 사용자에게 바인딩합니다. 서브스크립션에서 허용 목록을 사용하는 경우 다음 API 항목을 포함합니다.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.4. 콘솔에서 GitOps 정책 배포 확인 링크 복사링크가 클립보드에 복사되었습니다!
콘솔에서 변경 사항이 정책에 적용되었는지 확인합니다. 콘솔에서 정책을 추가로 변경할 수도 있지만 서브스크립션
이 Git 리포지토리로 조정되면 변경 사항이 되돌아갑니다. 다음 단계를 완료합니다.
- Red Hat Advanced Cluster Management 클러스터에 로그인합니다.
- 탐색 메뉴에서 Governance 를 선택합니다.
- 표에 배포한 정책을 찾습니다. GitOps를 사용하여 배포되는 정책에는 소스 열에 Git 레이블이 있습니다. 레이블을 클릭하여 Git 리포지토리의 세부 정보를 확인합니다.
3.4.4.1. CLI에서 GitOps 정책 배포 확인 링크 복사링크가 클립보드에 복사되었습니다!
다음 단계를 완료합니다.
다음 정책 세부 정보를 확인합니다.
- 배포된 클러스터에 대한 특정 정책을 준수하거나 비준수하는 이유는 무엇입니까?
- 올바른 클러스터에 정책이 적용됩니까?
- 이 정책이 클러스터에 배포되지 않은 경우 이유는 무엇입니까?
생성하거나 수정한 GitOps 배포 정책을 식별합니다. GitOps 배포된 정책은 자동으로 적용되는 주석으로 식별할 수 있습니다. GitOps 배포 정책에 대한 주석은 다음 경로와 유사합니다.
apps.open-cluster-management.io/hosting-deployable: policies/deploy-stable-policies-Policy-policy-role9 apps.open-cluster-management.io/hosting-subscription: policies/demo-policies apps.open-cluster-management.io/sync-source: subgbk8s-policies/demo-policies
apps.open-cluster-management.io/hosting-deployable: policies/deploy-stable-policies-Policy-policy-role9 apps.open-cluster-management.io/hosting-subscription: policies/demo-policies apps.open-cluster-management.io/sync-source: subgbk8s-policies/demo-policies
Copy to Clipboard Copied! Toggle word wrap Toggle overflow GitOps 주석은 정책을 생성한 서브스크립션을 확인하는 데 유용합니다. 레이블을 기반으로 정책을 선택하는 런타임 쿼리를 작성할 수 있도록 정책에 고유한 레이블을 추가할 수도 있습니다.
예를 들어 다음 명령을 사용하여 정책에 라벨을 추가할 수 있습니다.
oc label policies.policy.open-cluster-management.io <policy-name> -n <policy-namespace> <key>=<value>
oc label policies.policy.open-cluster-management.io <policy-name> -n <policy-namespace> <key>=<value>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 그런 다음 다음 명령을 사용하여 라벨이 있는 정책을 쿼리할 수 있습니다.
oc get policies.policy.open-cluster-management.io -n <policy-namespace> -l <key>=<value>
oc get policies.policy.open-cluster-management.io -n <policy-namespace> -l <key>=<value>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
정책은 GitOps를 사용하여 배포됩니다.