본문으로 건너뛰기

Claims

Crossplane에 새 XR의 세부 정보를 구성한 후, XR을 직접 생성하거나 Claim을 사용할 수 있습니다. 일반적으로 Crossplane을 구성하는 책임을 가진 팀(종종 플랫폼 또는 SRE 팀)만 XR을 직접 생성할 권한을 갖습니다. 다른 모든 사용자는 Composite Resource Claim(줄여서 claim)이라는 경량 프록시 리소스를 통해 XR을 관리합니다.

이 claim을 사용하면 개발자는 테이블을 생성하기 위해 기본 DynamoDB 테이블 이름, 해시 키, 그리고 글로벌 인덱스 이름만 지정하면 됩니다. 이를 통해 플랫폼 또는 SRE 팀은 결제 모드, 기본 읽기/쓰기 용량, 프로젝션 타입, 비용 및 인프라 관련 태그와 같은 측면을 표준화할 수 있습니다.

~/environment/eks-workshop/modules/automation/controlplanes/crossplane/compositions/claim/claim.yaml
apiVersion: awsblueprints.io/v1alpha1
kind: DynamoDBTable
metadata:
  name: "${EKS_CLUSTER_NAME}-carts-crossplane"
spec:
  dynamoConfig:
    attribute:
      - name: id
        type: S
      - name: customerId
        type: S
    globalSecondaryIndex:
      - name: idx_global_customerId
A

클러스터 이름 환경 변수를 접두사로 사용하여 DynamoDB 테이블 이름 지정

B

Primary key 속성으로 id 지정

C

Secondary 속성으로 customerId 지정

D

Global Secondary Index 이름으로 idx_global_customerId 지정

먼저 이전 Managed Resource 섹션에서 생성한 DynamoDB 테이블을 정리해 보겠습니다:

~$kubectl delete tables.dynamodb.aws.upbound.io --all --ignore-not-found=true
~$kubectl wait --for=delete tables.dynamodb.aws.upbound.io --all --timeout=5m


이제 Claim을 생성하여 테이블을 다시 생성할 수 있습니다:


~$cat ~/environment/eks-workshop/modules/automation/controlplanes/crossplane/compositions/claim/claim.yaml \
  | envsubst | kubectl -n carts apply -f -
dynamodbtable.awsblueprints.io/eks-workshop-carts-crossplane created
~$kubectl wait dynamodbtables.awsblueprints.io ${EKS_CLUSTER_NAME}-carts-crossplane -n carts \
  --for=condition=Ready --timeout=5m


AWS 관리형 서비스를 프로비저닝하는 데는 시간이 걸리며, DynamoDB의 경우 최대 2분이 소요됩니다. Crossplane은 Kubernetes Composite 및 Managed 리소스의 SYNCED 필드에 조정(reconciliation) 상태를 보고합니다.


~$kubectl get table
NAME                                        READY   SYNCED   EXTERNAL-NAME                   AGE
eks-workshop-carts-crossplane-bt28w-lnb4r   True   True      eks-workshop-carts-crossplane   6s


이제 이 claim을 사용하여 DynamoDB 테이블이 어떻게 배포되는지 이해해 보겠습니다:


Crossplane reconciler concept


carts 네임스페이스에 배포된 claim DynamoDBTable을 조회하면, 이것이 Composite Resource (XR) XDynamoDBTable을 가리키고 생성하는 것을 확인할 수 있습니다:


~$kubectl get DynamoDBTable -n carts -o yaml | grep "resourceRef:" -A 3
 
    resourceRef:
      apiVersion: awsblueprints.io/v1alpha1
      kind: XDynamoDBTable
      name: eks-workshop-carts-crossplane-bt28w


Composition table.dynamodb.awsblueprints.io는 Composite Resource Kind (XR-KIND)를 XDynamoDBTable로 표시합니다. 이 Composition은 XDynamoDBTable XR을 생성할 때 Crossplane이 수행할 작업을 알려줍니다. 각 Composition은 XR과 하나 이상의 Managed Resource 집합 간의 링크를 생성합니다.


~$kubectl get composition
NAME                              XR-KIND          XR-APIVERSION               AGE
table.dynamodb.awsblueprints.io   XDynamoDBTable   awsblueprints.io/v1alpha1   143m


네임스페이스에 제한되지 않는 XDynamoDBTable XR을 조회하면, DynamoDB Managed Resource Table을 생성하는 것을 확인할 수 있습니다:


~$kubectl get XDynamoDBTable -o yaml | grep "resourceRefs:" -A 3
 
    resourceRefs:
    - apiVersion: dynamodb.aws.upbound.io/v1beta1
      kind: Table
      name: eks-workshop-carts-crossplane-bt28w-lnb4r