2장. 웹 콘솔에서 Red Hat OpenShift Pipelines 작업

프로세스

1. 개발자 화면의 +추가 보기에서 파이프라인 타일을 클릭하여 파이프라인 빌더 페이지를 표시합니다.

2. 파이프라인 빌더 보기 또는 YAML 보기를 사용하여 파이프라인을 구성합니다.

   참고

   파이프라인 빌더 보기에서는 제한된 수의 필드를 지원하는 반면 YAML 보기는 사용 가능한 모든 필드를 지원합니다. 필요한 경우 Operator가 설치한 재사용 가능한 스니펫과 샘플을 사용하여 자세한 파이프라인을 생성할 수도 있습니다.

   그림 2.1. YAML보기

   

3. 파이프라인 빌더를 사용하여 파이프라인 을 구성합니다.

   1. 이름 필드에 파이프라인의 고유 이름을 입력합니다.

   2. 작업 섹션에서 다음을 수행합니다.

      1. 작업 추가를 클릭합니다.
      2. 빠른 검색 필드를 사용하여 작업을 검색하고 표시된 목록에서 필요한 작업을 선택합니다.

      3. 추가 또는 설치를 클릭하고 추가합니다. 이 예제에서는 s2i-nodejs 작업을 사용합니다.

         참고

         검색 목록에는 클러스터에서 사용할 수 있는 모든 Tekton Hub 작업과 작업이 포함되어 있습니다. 또한 작업이 이미 설치된 경우 Add to add the task whereas it will show Install and add to install and add the task가 표시됩니다. 업데이트된 버전으로 동일한 작업을 추가할 때 Update 및 add가 표시됩니다.

         • 파이프라인에 순차적 작업을 추가하려면 다음을 수행합니다.

           • 작업 오른쪽 또는 왼쪽에 있는 더하기 아이콘을 클릭합니다. 작업 추가 를 클릭합니다.
           • 빠른 검색 필드를 사용하여 작업을 검색하고 표시된 목록에서 필요한 작업을 선택합니다.

           • 추가 또는 설치를 클릭하고 추가합니다.

             그림 2.2. 파이프라인 빌더

             

         • 최종 작업을 추가하려면 다음을 수행합니다.

           • 마지막으로 추가 작업 작업 추가 를 클릭합니다.
           • 빠른 검색 필드를 사용하여 작업을 검색하고 표시된 목록에서 필요한 작업을 선택합니다.
           • 추가 또는 설치를 클릭하고 추가합니다.

   3. 리소스 섹션에서 리소스 추가를 클릭하여 파이프라인 실행에 사용할 리소스의 이름 및 유형을 지정합니다. 그러면 파이프라인의 작업에서 이러한 리소스를 입력 및 출력으로 사용합니다. 예시의 경우:

      1. 입력 리소스를 추가합니다. 이름 필드에 Source를 입력하고 리소스 유형 드롭다운 목록에서 Git을 선택합니다.

      2. 출력 리소스를 추가합니다. 이름 필드에 Img를 입력하고 리소스 유형 드롭다운 목록에서 이미지를 선택합니다.

         참고

         리소스가 누락된 경우 작업 옆에 빨간색 아이콘이 표시됩니다.

   4. 선택 사항: 작업의 매개변수는 작업 사양에 따라 미리 채워집니다. 필요에 따라 매개 변수 섹션에 있는 매개 변수 추가 링크를 사용하여 매개변수를 더 추가합니다.
   5. 작업 공간 섹션에서 작업 공간 추가를 클릭하고 이름 필드에 고유한 작업 공간 이름을 입력합니다. 파이프라인에 여러 개의 작업 공간을 추가할 수 있습니다.

   6. 작업 섹선에서 s2i-nodejs 작업을 클릭하여 작업 세부 정보가 있는 측면 패널을 확인합니다. 작업 측면 패널에서 s2i-nodejs 작업에 대한 리소스 및 매개변수를 지정합니다.

      1. 필요에 따라 매개 변수 섹션에서 $(params.<param-name>) 구문을 사용하여 기본 매개변수에 매개변수를 더 추가합니다.
      2. 이미지 섹션에서 리소스 섹션에 지정된 대로 Img를 입력합니다.
      3. 작업 공간 섹션의 소스 드롭다운에서 작업 공간을 선택합니다.
   7. 리소스, 매개 변수 및 작업 공간을 openshift-client 작업에 추가합니다.
4. 생성을 클릭하여 파이프라인 세부 정보 페이지에서 파이프라인을 생성하고 봅니다.
5. 작업 드롭다운 메뉴를 클릭한 다음 시작을 클릭하여 파이프라인 시작 페이지를 확인합니다.
6. 작업 공간 섹션에는 이전에 생성한 작업 공간이 나열됩니다. 각 드롭다운을 사용하여 작업 공간의 볼륨 소스를 지정합니다. 빈 디렉토리,구성 맵,시크릿, 영구 볼륨 클레임, 볼륨 클레임 템플릿 옵션이 있습니다.

프로세스

1. 개발자 화면에서 GitHub 리포지토리를 추가할 네임스페이스 또는 프로젝트를 선택합니다.
2. 왼쪽 탐색 창을 사용하여 Pipeline 으로 이동합니다.
3. Pipelines 페이지 오른쪽에 있는 생성 리포지토리 를 클릭합니다.
4. Git Repo URL 을 입력하면 콘솔에서 리포지터리 이름을 자동으로 가져옵니다.

5. 구성 옵션 표시를 클릭합니다. 기본적으로 Webhook 를 설정하는 방법은 한 가지뿐입니다. GitHub 애플리케이션이 구성된 경우 다음 두 가지 옵션이 표시됩니다.

   • GitHub App: 리포지토리에 GitHub 애플리케이션을 설치하려면 이 옵션을 선택합니다.
   • Webhook 설정: GitHub 애플리케이션에 Webhook를 추가하려면 이 옵션을 선택합니다.

6. 시크릿 섹션에서 다음 옵션 중 하나를 사용하여 Webhook를 설정합니다.

   • Git 액세스 토큰 을 사용하여 Webhook를 설정합니다.

     1. 개인 액세스 토큰을 입력합니다.

     2. Webhook 시크릿 필드에 해당하는 생성 을 클릭하여 새 Webhook 시크릿을 생성합니다.

        
        참고

        개인 액세스 토큰이 없고 새 액세스 토큰을 생성하려는 경우 Git 액세스 토큰 필드 아래에 링크를 클릭하면 됩니다.

   • Git 액세스 토큰 시크릿 을 사용하여 Webhook를 설정합니다.

     • 드롭다운 목록에서 네임스페이스의 시크릿을 선택합니다. 선택한 보안에 따라 Webhook 보안이 자동으로 생성됩니다.

       

7. GitHub 리포지토리에 Webhook 시크릿 세부 정보를 추가합니다.

   1. Webhook URL 을 복사하고 GitHub 리포지토리 설정으로 이동합니다.
   2. Webhook Webhook 추가 를 클릭합니다.
   3. 개발자 콘솔에서 Webhook URL 을 복사하여 GitHub 리포지토리 설정의 페이로드 URL 필드에 붙여넣습니다.
   4. 콘텐츠 유형을 선택합니다.
   5. 개발자 콘솔에서 Webhook 시크릿을 복사하여 GitHub 리포지토리 설정의 Secret 필드에 붙여넣습니다.
   6. SSL 확인 옵션 중 하나를 선택합니다.
   7. 이 Webhook를 트리거할 이벤트를 선택합니다.
   8. Webhook 추가를 클릭합니다.
8. 개발자 콘솔로 돌아가서 추가 를 클릭합니다.
9. 수행해야 하는 단계의 세부 정보를 읽고 닫기 를 클릭합니다.
10. 방금 생성한 리포지토리의 세부 정보를 확인합니다.

프로세스

1. 개발자 화면의 파이프라인 보기에서 프로젝트 드롭다운 목록에 있는 프로젝트를 선택하여 해당 프로젝트의 파이프라인을 확인합니다.

2. 필요한 파이프라인을 클릭하여 파이프라인 세부 정보 페이지를 확인합니다.

   기본적으로 세부 정보 탭에는 모든 직렬 작업, 병렬 작업, finally 작업 및 파이프라인의 when 표현식이 시각적으로 표시됩니다. 작업 및 finally 작업은 페이지 오른쪽 하단 목록에 표시됩니다.

   작업 세부 정보를 보려면 나열된 Task 및 최종 작업을 클릭합니다. 또한 다음을 수행할 수 있습니다.

   • Pipeline 세부 정보 시각화의 왼쪽 아래에 표시된 표준 아이콘을 사용하여 확대, 축소, 화면에 맞게 보기 기능을 사용합니다.
   • 마우스 휠을 사용하여 파이프라인 시각화의 확대/축소 요소를 변경합니다.

   • 작업 위로 마우스를 가져가 작업 세부 정보를 확인합니다.

     그림 2.3. 파이프 라인 세부 정보

     

3. 선택 사항: 파이프 라인 세부 정보 페이지에서 Metrics 탭을 클릭하여 파이프라인에 대한 다음 정보를 확인합니다.

   • 파이프 라인 성공률
   • 파이프 라인 실행 수
   • 파이프 라인 실행 기간

   • 작업 실행 기간

     이 정보를 사용하여 파이프라인 라이프사이클 초기에 파이프라인 워크플로를 개선하고 문제를 제거할 수 있습니다.

4. 선택 사항: YAML 탭을 클릭하여 파이프라인의 YAML 파일을 편집합니다.

5. 선택 사항: 파이프라인 실행 탭을 클릭하여 파이프라인 실행 상태가 완료, 실행 중 또는 실패인지 확인합니다.

   파이프라인 실행 탭에는 파이프라인 실행, 작업 상태 및 실패한 파이프라인 실행 디버그 링크에 대한 세부 정보가 있습니다. 옵션 메뉴 를 사용하여 실행 중인 파이프라인을 중지하거나, 이전 파이프라인 실행과 동일한 매개변수 및 리소스를 사용하여 파이프라인 재실행 또는 파이프라인 실행을 삭제합니다.

   • 필요한 파이프라인 실행을 클릭하여 파이프라인 실행 세부 정보 페이지를 확인합니다. 기본적으로 세부 정보 탭에는 모든 직렬 작업, 병렬 작업, finally 작업 및 파이프라인 실행의 When 표현식의 시각적 표현이 표시됩니다. 성공적인 실행 결과는 페이지 하단의 파이프라인 실행 결과 창에 표시됩니다. 또한 클러스터에서 지원하는 Tekton Hub의 작업만 볼 수 있습니다. 작업을 보는 동안 옆에 있는 링크를 클릭하여 작업 문서로 이동할 수 있습니다.

     참고

     파이프라인 실행 세부 정보 페이지의 세부 정보 섹션에는 실패한 파이프라인 실행에 대한 로그 조각이 표시됩니다. 로그 조각에는 일반적인 오류 메시지와 해당 로그의 조각이 있습니다. 로그 섹션 링크를 사용하면 실패한 실행에 대한 세부 정보에 빠르게 액세스할 수 있습니다.

   • 파이프라인 실행 세부 정보 페이지에서 작업 실행 탭을 클릭하여 작업 상태가 완료, 실행 중 또는 실패인지 확인합니다.

     작업 실행 탭은 해당 작업 및 pod에 대한 링크, 작업 실행 상태 및 기간과 함께 작업 실행에 대한 정보를 제공합니다. 옵션 메뉴 를 사용하여 작업 실행을 삭제합니다.

     참고

     TaskRuns 목록 페이지에는 열 관리 버튼이 있으며, 이 버튼을 사용하여 Duration 열을 추가할 수도 있습니다.

   • 필요한 작업 실행을 클릭하여 작업 실행 세부 정보 페이지를 확인합니다. 성공적으로 실행된 결과는 페이지 하단에 있는 작업 실행 결과 창에 표시됩니다.

     참고

     작업 실행 세부 정보 페이지의 세부 정보 섹션에는 실패한 작업 실행에 대한 로그 조각이 표시됩니다. 로그 조각에는 일반적인 오류 메시지와 해당 로그의 조각이 있습니다. 로그 섹션 링크를 사용하면 실패한 작업 실행에 대한 세부 정보에 빠르게 액세스할 수 있습니다.

6. 매개변수 탭을 클릭하여 파이프라인에 정의된 매개변수를 확인합니다. 필요에 따라 매개변수를 추가하거나 편집할 수도 있습니다.
7. 리소스 탭을 클릭하여 파이프라인에 정의된 리소스를 확인합니다. 필요에 따라 리소스를 추가하거나 편집할 수도 있습니다.

1. 개발자 화면의 파이프라인 보기에서 파이프라인 옆에 있는 옵션 메뉴를 클릭하고 시작을 선택합니다.

2. 파이프라인 정의에 따라 파이프라인 시작 대화 상자에 Git 리소스 및 이미지 리소스가 표시됩니다.

   참고

   Git에서 옵션을 사용하여 생성한 파이프라인의 경우 파이프라인 시작 대화 상자의 매개변수 섹션에 APP_NAME 필드도 표시되며, 대화 상자의 모든 필드가 파이프라인 템플릿에 의해 미리 채워집니다.

   1. 네임스페이스에 리소스가 있는 경우 Git Resources 및 Image Resources 필드에 해당 리소스가 미리 채워집니다. 필요한 경우 드롭다운 목록을 사용하여 필요한 리소스를 선택하거나 생성한 다음 파이프라인 실행 인스턴스를 사용자 정의합니다.

3. 선택 사항: 고급 옵션을 수정하여 지정된 프라이빗 Git 서버 또는 이미지 레지스트리를 인증하는 자격 증명을 추가합니다.

   1. Advanced Options에서 Show Credentials Options를 클릭하고 Add Secret을 선택합니다.

   2. Create Source Secre 섹션에서 다음 사항을 지정합니다.

      1. 보안에 대한 고유한 보안 이름입니다.
      2. Designated provider to be authenticated 섹션에서 Access to 필드에 인증할 공급자를 지정하고 기본 Server URL을 지정합니다.

      3. Authentication Type을 선택하고 자격 증명을 제공합니다.

         • 인증 유형 Image Registry Crendentials의 경우 인증할 레지스트리 서버 주소를 지정하고 사용자 이름, 암호, 이메일 필드에 자격 증명을 제공합니다.

           추가 Registry Server Address를 지정하려면 Add Credentials를 선택하십시오.

         • Authentication Type Basic Authentication의 경우 UserName 및 Password or Token 필드 값을 지정합니다.

         • 인증 유형 SSH Keys의 경우 SSH 개인 키 필드 값을 지정합니다.

           참고

           기본 인증 및 SSH 인증의 경우 다음과 같은 주석을 사용할 수 있습니다.

           • tekton.dev/git-0: https://github.com
           • tekton.dev/git-1: https://gitlab.com.
      4. 확인 표시를 선택하여 보안을 추가합니다.

   파이프라인의 리소스 수에 따라 여러 개의 보안을 추가할 수 있습니다.

4. 시작을 클릭하여 파이프라인을 시작합니다.

5. PipelineRun 세부 정보 페이지에는 실행 중인 파이프라인이 표시됩니다. 파이프라인이 시작된 후 작업과 각 작업 내 단계가 실행됩니다. 다음을 수행할 수 있습니다.

   • PipelineRun 세부 정보 페이지 시각화의 왼쪽 아래에 있는 표준 아이콘을 사용하여 확대, 축소, 화면에 맞는 보기 기능을 사용합니다.
   • 마우스 휠을 사용하여 pipelinerun 시각화의 확대/축소 요소를 변경합니다. 특정 확대/축소 요인에서 작업의 배경 색상이 변경되어 오류 또는 경고 상태를 나타냅니다.
   • 작업 위로 마우스를 이동하여 각 단계, 작업 이름 및 작업 상태를 실행하는 데 걸린 시간과 같은 세부 정보를 확인합니다.
   • 작업 배지 위로 마우스를 이동하여 완료된 총 작업 수 및 작업 수를 확인합니다.
   • 작업을 클릭하여 각 작업 단계에 대한 로그를 확인합니다.
   • 로그 탭을 클릭하여 작업 실행 순서와 관련된 로그를 확인합니다. 관련 버튼을 사용하여 창을 확장하고 로그를 개별적 또는 일괄적으로 다운로드할 수도 있습니다.

   • 이벤트 탭을 클릭하여 파이프라인 실행으로 생성된 이벤트 스트림을 확인합니다.

     작업 실행, 로그, 이벤트 탭을 사용하면 실패한 파이프라인 실행 또는 실패한 작업 실행을 디버깅하는 데 도움이 될 수 있습니다.

     그림 2.4. ‘파이프 라인 실행' 세부 정보

     

프로세스

1. 왼쪽 탐색 패널에서 Topology 를 클릭합니다.
2. 애플리케이션을 클릭하여 측면 패널에 파이프라인 실행을 표시합니다.

3. 파이프라인 실행 에서 마지막 실행 시작을 클릭하여 이전 파이프라인과 동일한 매개변수 및 리소스로 새 파이프라인 실행을 시작합니다. 파이프라인 실행이 시작되지 않은 경우 이 옵션이 비활성화되어 있습니다. 또한 파이프라인 실행을 생성할 때 시작할 수도 있습니다.

   그림 2.5. 토폴로지 보기의 파이프라인

   

프로세스

1. 개발자 화면의 Pipelines 보기에서 편집할 파이프라인을 선택하여 파이프라인의 세부 정보를 확인합니다. Pipeline Details 페이지에서 Actions를 클릭하고 Edit Pipelin을 선택합니다.

2. Pipeline 빌더 페이지에서 다음 작업을 수행할 수 있습니다.

   • 파이프라인에 추가 작업, 매개변수 또는 리소스를 추가합니다.
   • 수정할 작업을 클릭하여 측면 패널에 작업 세부 정보를 표시하고 표시 이름, 매개변수 및 리소스와 같은 필요한 작업 세부 정보를 수정합니다.
   • 또는 작업을 삭제하려면 작업을 클릭하고 측면 패널에서 작업을 클릭하고 작업 제거를 선택합니다.
3. 저장을 클릭하여 수정된 파이프라인을 저장합니다.

프로세스

1. 개발자 화면의 Pipelines 보기에서 Pipeline 옆에 있는 Options 메뉴를 클릭하고 Delete Pipeline 을 선택합니다.
2. Delete Pipeline 확인 프롬프트에서 Delete를 클릭하여 삭제를 확인합니다.