전제조건

개인용 작업자를 설정하기 전에 다음 리소스가 준비되어 있는지 확인하십시오.

• Kubernetes 클러스터. 개인용 작업자를 설치하려면 클러스터가 있어야 합니다. 사용자만의 클러스터를 제공하거나, IBM Cloud Kubernetes Service 에서 클러스터를 설정할 수 있습니다.

• 선택사항입니다. 하나 이상의 단계가 포함된 파이프라인이 있는 도구 체인. Delivery Pipeline Private Worker 도구 통합을 사용하여 도구 체인을 작성할 수 있습니다. Kubernetes 앱 개발 도구 체인 템플리트를 사용하여 도구 체인을 작성할 수도 있습니다.

  1. IBM Cloud에 로그인하십시오.
  2. 다음으로 이동하여 https://cloud.ibm.com/devops/create 로 이동하여 'Kubernetes 앱 개발 ' 툴체인 템플릿을 선택하십시오.
  3. Delivery Pipeline에 대한 필드를 완료하십시오.
  4. 작성을 클릭하여 Kubernetes 앱 도구 체인을 작성하십시오.

Delivery Pipeline Private Worker 설정

도구 체인은 앱을 빌드, 배치 및 관리하는 통합 도구 세트를 제공합니다. 도구 통합은 도구 체인의 구성 요소입니다. 하나 이상의 비공개 작업자 통합이 있는 도구 체인에 포함된 파이프라인에는 추가 옵션을 사용할 수 있습니다. Classic 파이프라인의 경우 이러한 옵션은 스테이지 구성 페이지의 작업자 탭에서 사용 가능합니다. Tekton 파이프라인의 경우 이러한 옵션은 작업자 페이지에 지정된 설정 내에서 사용 가능합니다.

Tekton Pipeline의 경우 트리거당 하나의 작업자를 지정할 수도 있으며, 이는 작업자 페이지의 파이프라인 레벨에서 구성된 작업자를 대체합니다.

다음 단계를 완료하여 개인용 작업자를 설정하십시오.

1. 도구 체인에 맞는 Delivery Pipeline Private Worker 도구 통합을 구성하십시오.
2. 개인용 작업자로 Kubernetes 클러스터를 구성하십시오.
3. 파이프라인에서 개인용 작업자를 사용하십시오.

Delivery Pipeline Private Worker 도구 통합 인증 정보 수정

개인용 작업자를 설정한 후 도구 통합에 사용되는 인증 정보를 업데이트할 수 있습니다. 이러한 인증 정보가 삭제되거나 만료되거나 손상된 경우 해당 인증 정보를 변경할 수 있습니다. 새 서비스 ID를 작성하거나 API 키를 업데이트하여 인증 정보를 업데이트할 수 있습니다.

Delivery Pipeline Private Worker 삭제

다음 단계를 완료하여 개인용 작업자를 삭제하십시오.

1. 작업자 풀에서 개인용 작업자를 삭제하십시오.
2. Kubernetes 클러스터에서 개인용 작업자를 삭제하십시오.

kubectl delete --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/install/worker?serviceId={SERVICE_ID}&apikey={APIKEY}&name={WORKER_NAME}"

Delivery Pipeline 개인용 작업자 상태 보기

클러스터에서 개인용 작업자 상태를 보고 개인용 작업자가 등록되었으며 올바른 API키를 사용하는지 확인할 수 있습니다. 개인용 작업자 등록 및 API키 지정은 초기 개인용 작업자 등록 중에 설정됩니다. 이러한 설정을 사용하면 개인용 작업자가 IBM Cloud® Continuous Delivery 프레임워크와 통신하고 활성으로 간주될 수 있습니다.

설치된 클러스터에서 개인용 작업자 상태를 보려면 다음 단계를 완료하십시오.

1. 작업자를 호스팅하는 클러스터에 권한이 부여된 사용자로 로그인하십시오.

2. 다음 명령을 실행하여 클러스터에 등록된 모든 에이전트를 나열하십시오.

   kubectl get workeragents
   

   각 에이전트에 대해 다음과 같은 정보가 나열되어 있습니다:

   • 이름: 이 작업자에 대해 등록된 이름입니다.
   • ServiceID: 이 작업자의 serviceId.
   • 에이전트: 작업자 에이전트가 OK 를 지정하거나 오류 메시지를 표시하여 클러스터에서 올바르게 작동 중인지 여부를 표시합니다.
   • 등록됨: 작업자의 등록 상태입니다 (예: Succeeded 또는 Unregistered).
   • 버전: 프레임워크에서 사용되는 현재 버전에 대한 이 작업자의 버전입니다 (예: OK, Outdated 또는 Unsupported).
   • 인증: 작업자가 사용하는 API키의 유효성입니다 (예: OK 또는 Error).
   • 제한: OK 를 지정하거나 오류 메시지를 표시하여 작업자에 영향을 주는 클러스터 문제가 있는지 여부를 표시합니다.
   • 일시정지됨: 에이전트가 true 또는 false 를 지정하여 새 태스크를 적극적으로 검색하는지 여부를 표시합니다.

등록된 개인용 작업자 풀의 전체 상태를 확인하려면 사용되는 도구 체인에서 Delivery Pipeline 개인용 작업자의 개요 페이지를 확인하십시오.

1. 콘솔에서 IBM Cloud 메뉴 아이콘( ) > 플랫폼 자동화 > 툴체인(Toolchains) 을 클릭합니다. 도구 체인 페이지에서 도구 체인을 클릭하여 해당 개요 페이지를 여십시오.

2. Delivery Pipeline 카드에서 등록된 모든 작업자의 목록을 보려는 개인용 작업자 도구 통합을 클릭하십시오. 이 작업자 풀에는 다른 클러스터에 설치되어 있지만 ServiceId 를 공유하는 하나 이상의 개인용 작업자가 포함되어 있습니다. 개인용 작업자 풀에 작업이 지정되면 풀에 나열된 개인용 작업자가 워크로드를 실행할 수 있습니다.

   이 풀에 등록된 각 작업자에 대해 다음 정보가 제공됩니다.

   • 이름: 등록된 작업자의 이름입니다.
   • 상태: 작업자의 현재 상태.
   • 버전: 작업자의 현재 버전입니다. 현재 버전이 최신 버전이 아닌 경우 알림이 표시됩니다.
   • Tekton 버전: Tekton 릴리스 버전입니다.
   • 클러스터: 작업자가 등록된 클러스터의 이름입니다 (사용 가능한 경우).
   • 마지막 활성: 에이전트가 보고한 마지막 시간입니다.

   개인용 작업자의 상태는 다음 중 하나입니다.

   • active: 개인용 작업자가 정상적으로 작동합니다.
   • inactive: 개인용 작업자가 오프라인입니다. 클러스터를 확인하십시오. 개인용 작업자를 다시 등록해야 할 수 있습니다.
   • unsupported: 사용 중인 개인용 작업자 버전이 더 이상 지원되지 않습니다. 개인용 실행 파일은 실행할 수 없으므로 최신 버전으로 업데이트해야 합니다.

Delivery Pipeline Private Worker 업데이트

최신 버전을 사용하려면 다음 단계를 완료하여 개인용 작업자를 업데이트하십시오.

1. 작업자를 호스팅하는 클러스터에 권한이 부여된 사용자로 로그인하십시오.
2. 다음 명령을 실행하십시오.

kubectl apply --filename "https://private-worker-service.{REGION}.devops.cloud.ibm.com/update"

Delivery Pipeline 민간 근로자 사진

Private Worker 설치 스크립트는 글로벌 IBM Cloud® Container Registry에서 필요한 이미지를 가져옵니다. 이는 Pipeline Private Worker의 가장 최근 이미지와 발견된 취약성에 대한 수정사항을 포함하는 각각의 Tekton 프레임워크 이미지를 가져옵니다.

Pipeline Private Worker의 이미지 URL은 icr.io/continuous-delivery/pipeline/pipeline-private-worker:<agent version>입니다.

사내용 워커 설치 시에는 다음의 보조 오픈소스 이미지들도 클러스터로 가져옵니다:

icr.io/continuous-delivery/pipeline/tekton/controller
icr.io/continuous-delivery/pipeline/tekton/entrypoint
icr.io/continuous-delivery/pipeline/tekton/nop
icr.io/continuous-delivery/pipeline/tekton/sidecarlogresults
icr.io/continuous-delivery/pipeline/tekton/events
icr.io/continuous-delivery/pipeline/tekton/workingdirinit
icr.io/continuous-delivery/pipeline/tekton/powershell
icr.io/continuous-delivery/pipeline/tekton/resolvers
icr.io/continuous-delivery/pipeline/tekton/webhook

Private Worker 에이전트는 다음과 같은 내부 이미지도 사용합니다.

icr.io/continuous-delivery/pipeline/pipeline-private-worker-util
icr.io/continuous-delivery/pipeline/tekton/kubectl-jq
icr.io/continuous-delivery/pipeline/tekton/ubi
icr.io/continuous-delivery/pipeline/tekton/base