문제 및 풀 요청 작업

이 페이지에서는 Secure Source Manager 웹 인터페이스에서 문제 및 풀 요청을 사용하는 방법을 설명합니다.

웹 인터페이스를 통해 Secure Source Manager 인스턴스에 액세스하려면 다음 URL을 브라우저 주소 표시줄에 복사하세요.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

다음을 바꿉니다.

  • INSTANCE_ID을 인스턴스 이름으로 바꿉니다.
  • PROJECT_NUMBER를 인스턴스의 Google Cloud프로젝트 번호로 바꿉니다. 프로젝트 식별에 대한 자세한 내용은 프로젝트 식별을 참고하세요.
  • LOCATION을 인스턴스의 리전으로 바꿉니다.

필요한 역할

문제 및 풀 요청을 해결하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Secure Source Manager 역할 부여에 대한 자세한 내용은 IAM으로 액세스 제어 및 사용자에게 인스턴스 액세스 권한 부여를 참고하세요.

풀 요청 보기

액세스 권한이 있는 모든 풀 요청 또는 특정 저장소의 풀 요청을 볼 수 있습니다.

빈 저장소에는 Pull 요청 탭이 없습니다. 저장소에 푸시하면 pull 요청 탭을 볼 수 있습니다.

나에게 할당된 풀 요청 또는 문제를 보려면 Secure Source Manager 문제 또는 풀 요청 탭으로 이동하여 나에게 할당됨을 클릭합니다.

저장소의 풀 요청을 보려면 다음 단계를 따르세요.

  1. Secure Source Manager 웹 인터페이스에서 저장소를 선택합니다.
  2. 저장소 페이지에서 Pull 요청 탭을 클릭합니다.
  3. 담당자, 유형 또는 정렬 드롭다운 메뉴를 사용하여 풀 요청을 필터링하거나 정렬할 수 있습니다.

모든 풀 요청을 보려면 다음 단계를 따르세요.

  1. Secure Source Manager 웹 인터페이스에서 Pull 요청 탭을 클릭합니다.

  2. 담당자, 유형 또는 정렬 드롭다운 메뉴를 사용하여 풀 요청을 필터링하거나 정렬할 수 있습니다.

풀 요청 만들기

  1. Secure Source Manager 웹 인터페이스에서 pull 요청을 만들 저장소를 선택합니다.
  2. 저장소 페이지에서 Pull 요청 탭을 클릭합니다.
  3. 새 pull 요청을 클릭합니다.
  4. 병합 대상 메뉴에서 병합할 브랜치를 선택합니다.
  5. 다음에서 가져오기 메뉴에서 가져올 브랜치를 선택합니다.
  6. 새 pull 요청을 클릭합니다.
  7. pull 요청에 제목과 설명을 지정하고 관련 파일을 첨부합니다.

  8. pull 요청 만들기를 클릭합니다.

    검토자, 라벨, 마일스톤, 담당자를 추가할 수 있는 pull 요청 페이지로 이동합니다.

풀 요청 세부정보 수정

pull 요청에 검토자, 라벨, 마일스톤, 담당자, 기한을 추가할 수 있습니다.

검토자, 라벨, 중요한 성과 달성, 담당자를 추가하려면 다음 단계를 따르세요.

pull 요청 페이지에서 수정하려는 세부정보 옆에 있는 톱니바퀴 아이콘 톱니바퀴 아이콘을 클릭합니다.

수정사항은 자동으로 저장됩니다.

마감일을 업데이트하려면 다음 단계를 따르세요.

  1. 마감일 섹션에서 캘린더 아이콘을 클릭하고 날짜를 선택합니다.
  2. 더하기 아이콘 더하기 아이콘을 클릭하여 기한을 저장합니다.

pull 요청 검토

검토자는 댓글을 추가하고, 변경을 요청하고, pull 요청을 승인할 수 있습니다.

나에게 할당된 pull 요청을 검토하려면 다음 단계를 따르세요.

  1. Secure Source Manager 웹 인터페이스에서 Pull 요청 탭을 클릭합니다.
  2. 나에게 할당됨을 클릭합니다.

  3. 검토할 pull 요청을 클릭합니다.

    대화 페이지가 열립니다. 풀 요청 작성자 또는 다른 검토자가 남긴 댓글을 볼 수 있습니다.

  4. 변경된 파일을 보고 댓글을 달려면 변경된 파일 탭을 클릭합니다. 공백, 분할 뷰/통합 뷰, 차이 옵션 드롭다운 메뉴를 클릭하여 공백 표시, 보기 및 차이 옵션의 동작을 변경할 수 있습니다.

  5. 댓글을 남기려면 댓글을 달 줄 옆에 있는 더하기 아이콘을 클릭합니다.

  6. 검토 시작을 클릭합니다.

  7. 댓글을 달고 싶은 줄의 더하기 아이콘을 클릭한 다음 댓글 추가를 클릭하여 추가 댓글을 남깁니다.

    댓글은 마크다운을 사용한 스타일 지정을 지원합니다.

  8. 의견을 보내거나, pull 요청을 승인하거나, 변경사항을 요청하려면 검토를 클릭합니다.

  9. 변경사항을 요약하는 댓글을 남기거나 댓글 공간을 비워 두고 다음 옵션 중에서 선택합니다.

    • 승인: 변경사항을 승인합니다.
    • 댓글: pull 요청을 승인하지 않고 댓글을 보냅니다.

    • 변경 요청: pull 요청의 변경을 요청합니다.

pull 요청 병합

  1. 저장소 페이지에서 Pull 요청 탭을 클릭합니다.
  2. 병합할 pull 요청을 선택합니다.
  3. 충돌이 없으면 pull 요청 병합을 클릭합니다.

문제 보기

  1. Secure Source Manager 웹 인터페이스에서 저장소를 선택합니다.
  2. 저장소 페이지에서 문제 탭을 클릭합니다.
  3. 담당자, 유형 또는 정렬 메뉴를 사용하여 문제를 필터링하거나 정렬할 수 있습니다.

문제 만들기

  1. Secure Source Manager 웹 인터페이스에서 저장소를 선택합니다.
  2. 저장소 페이지에서 문제 탭을 클릭합니다.
  3. 새 문제를 클릭합니다.
  4. 문제 제목과 설명을 입력한 다음 문제 만들기를 클릭합니다.

  5. 문제 세부정보 페이지에서 라벨, 마일스톤, 담당자를 할당하고 브랜치 또는 태그를 지정할 수 있습니다.

Mermaid로 다이어그램 추가하기

Secure Source Manager는 마크다운 파일 (예: README.md), pull 요청 설명, 문제, 댓글에서 Mermaid 다이어그램 렌더링을 지원합니다.

다이어그램을 추가하려면 mermaid 펜스 코드 블록을 사용하세요.

```mermaid
graph TD
    A[Write Markdown] --> B(Click Preview Tab)
    B --> C{Does it render?}
    C -- Yes --> D[Success]
    C -- No --> E[Check Syntax]
```

마크다운 편집기에서 미리보기 탭을 클릭하여 저장하기 전에 다이어그램이 렌더링되는지 확인합니다.

지원되는 다이어그램 유형

Secure Source Manager는 다음 Mermaid 다이어그램 유형을 지원합니다.

  • 플로우 차트: graph 또는 flowchart (TD, TB, LR, BT, RL 지원)
  • 시퀀스 다이어그램: sequenceDiagram
  • 클래스 다이어그램: classDiagram
  • 엔티티-관계 다이어그램: erDiagram
  • 상태 다이어그램: stateDiagram 또는 stateDiagram-v2
  • XY 차트: xychart-beta 또는 xychart

렌더링 동작 및 제한사항

  • 정적 렌더링: 다이어그램이 정적 이미지로 렌더링됩니다. 보안을 위해 대화형 기능(예: click 콜백 및 도움말)과 외부 스크립트는 사용 중지됩니다.
  • 테마 적응: 다이어그램이 밝은 테마와 어두운 테마에 자동으로 적응합니다.
  • 접근성: 렌더링된 다이어그램에는 스크린 리더를 위한 다이어그램 소스 코드로 채워진 대체 텍스트가 포함됩니다.
  • 지원되지 않는 다이어그램 유형: 지원되지 않는 다이어그램 유형에는 오류 메시지가 표시되며 렌더링되지 않습니다. 여기에는 Gantt, Mindmap, Pie, Gitgraph, User Journey, Requirement, C4, Timeline, Sankey, Block 다이어그램이 포함됩니다. 지원되지 않는 다이어그램 유형의 경우 다이어그램을 이미지 (PNG 또는 SVG)로 로컬에 렌더링하고 표준 Markdown 이미지 구문을 사용하여 삽입합니다.

다음 단계