3.13. OpenShift Pipelines에 대한 컴퓨팅 리소스 할당량 설정

절차

1. 파이프라인에 대한 우선순위 클래스를 생성합니다.

   예: 파이프라인의 우선 순위 클래스

   apiVersion: scheduling.k8s.io/v1
   kind: PriorityClass
   metadata:
     name: pipeline1-pc
   value: 1000000
   description: "Priority class for pipeline1"

2. 파이프라인에 대한 리소스 할당량을 생성합니다.

   예: 파이프라인에 대한 리소스 할당량

   apiVersion: v1
   kind: ResourceQuota
   metadata:
     name: pipeline1-rq
   spec:
     hard:
       cpu: "1000"
       memory: 200Gi
       pods: "10"
     scopeSelector:
       matchExpressions:
       - operator : In
         scopeName: PriorityClass
         values: ["pipeline1-pc"]

3. 파이프라인의 리소스 할당량 사용량을 확인합니다.

   예: 파이프라인에 대한 리소스 할당량 사용 확인

   $ oc describe quota

   샘플 출력

   Name:       pipeline1-rq
   Namespace:  default
   Resource    Used  Hard
   --------    ----  ----
   cpu         0     1k
   memory      0     200Gi
   pods        0     10

   Pod가 실행 중이 아니므로 할당량이 사용되지 않습니다.

4. 파이프라인 및 작업을 생성합니다.

   예: 파이프라인의 YAML

   apiVersion: tekton.dev/v1beta1
   kind: Pipeline
   metadata:
     name: maven-build
   spec:
     workspaces:
     - name: local-maven-repo
     resources:
     - name: app-git
       type: git
     tasks:
     - name: build
       taskRef:
         name: mvn
       resources:
         inputs:
         - name: source
           resource: app-git
       params:
       - name: GOALS
         value: ["package"]
       workspaces:
       - name: maven-repo
         workspace: local-maven-repo
     - name: int-test
       taskRef:
         name: mvn
       runAfter: ["build"]
       resources:
         inputs:
         - name: source
           resource: app-git
       params:
       - name: GOALS
         value: ["verify"]
       workspaces:
       - name: maven-repo
         workspace: local-maven-repo
     - name: gen-report
       taskRef:
         name: mvn
       runAfter: ["build"]
       resources:
         inputs:
         - name: source
           resource: app-git
       params:
       - name: GOALS
         value: ["site"]
       workspaces:
       - name: maven-repo
         workspace: local-maven-repo

   예: 파이프라인의 작업에 대한 YAML

   apiVersion: tekton.dev/v1beta1
   kind: Task
   metadata:
     name: mvn
   spec:
     workspaces:
     - name: maven-repo
     resources:
       inputs:
       - name: source
         type: git
     params:
     - name: GOALS
       description: The Maven goals to run
       type: array
       default: ["package"]
     steps:
       - name: mvn
         image: gcr.io/cloud-builders/mvn
         workingDir: /workspace/source
         command: ["/usr/bin/mvn"]
         args:
           - -Dmaven.repo.local=$(workspaces.maven-repo.path)
           - "$(params.GOALS)"

5. 파이프라인 실행을 생성하고 시작합니다.

   예: 파이프라인 실행을 위한 YAML

   apiVersion: tekton.dev/v1beta1
   kind: PipelineRun
   metadata:
     generateName: petclinic-run-
   spec:
     pipelineRef:
       name: maven-build
     podTemplate:
       priorityClassName: pipeline1-pc
     workspaces:
     - name: local-maven-repo
       emptyDir: {}
     resources:
     - name: app-git
       resourceSpec:
         type: git
         params:
           - name: url
             value: https://github.com/spring-projects/spring-petclinic

   참고

   파이프라인 실행이 실패하고 할당량 실패: <quota name>에서 cpu, memory를 지정해야 합니다.

   이 오류를 방지하려면 네임스페이스에 대한 제한 범위를 설정합니다. 여기서 LimitRange 오브젝트의 기본값은 빌드 프로세스 중 생성된 Pod에 적용됩니다.

   제한 범위 설정에 대한 자세한 내용은 Additional resources 섹션에서 제한 범위를 사용하여 리소스 소비 제한 을 참조하십시오.

6. Pod가 생성되면 파이프라인 실행에 대한 리소스 할당량 사용량을 확인합니다.

   예: 파이프라인에 대한 리소스 할당량 사용 확인

   $ oc describe quota

   샘플 출력

   Name:       pipeline1-rq
   Namespace:  default
   Resource    Used  Hard
   --------    ----  ----
   cpu         500m  1k
   memory      10Gi  200Gi
   pods        1     10

   출력에서는 우선순위 클래스당 리소스 할당량을 지정하여 우선순위 클래스에 속하는 모든 동시 실행 중인 Pod에 대해 결합된 리소스 할당량을 관리할 수 있음을 나타냅니다.