問題と pull リクエストを操作する

このページでは、Secure Source Manager ウェブ インターフェースで問題と pull リクエストを操作する方法について説明します。

ウェブ インターフェースから Secure Source Manager インスタンスにアクセスするには、次の URL をブラウザのアドレスバーにコピーします。

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

次のように置き換えます。

  • INSTANCE_ID は、インスタンス名に置き換えます。
  • PROJECT_NUMBER: インスタンスの Google Cloudプロジェクト番号。プロジェクトの識別については、プロジェクトの識別をご覧ください。
  • LOCATION は、インスタンスのリージョンに置き換えます。

必要なロール

問題と pull リクエストを操作するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Secure Source Manager のロールの付与については、IAM によるアクセス制御とユーザーにインスタンスへのアクセス権を付与するをご覧ください。

pull リクエストを表示する

アクセスできるすべてのプルリクエスト、または特定のリポジトリのプルリクエストを表示できます。

空のリポジトリには [Pull requests] タブがありません。リポジトリに push すると、pull リクエスト タブが表示されます。

自分に割り当てられた pull リクエストまたは問題を閲覧するには、Secure Source Manager の [問題] タブまたは [pull リクエスト] タブに移動し、[自分に割り当てられた] をクリックします。

リポジトリの pull リクエストを表示するには:

  1. Secure Source Manager ウェブ インターフェースで、リポジトリを選択します。
  2. リポジトリ ページで、[Pull requests] タブをクリックします。
  3. [Assignee]、[Type]、[Sort] のプルダウン メニューを使用して、プルリクエストをフィルタまたは並べ替えることができます。

すべての pull リクエストを表示するには:

  1. Secure Source Manager ウェブ インターフェースで、[Pull requests] タブをクリックします。

  2. [Assignee]、[Type]、[Sort] のプルダウン メニューを使用して、プルリクエストをフィルタまたは並べ替えることができます。

pull リクエストを作成する

  1. Secure Source Manager ウェブ インターフェースで、pull リクエストを作成するリポジトリを選択します。
  2. リポジトリ ページで、[Pull requests] タブをクリックします。
  3. [New pull request] をクリックします。
  4. [merge into] メニューで、プルリクエストをマージするブランチを選択します。
  5. [pull from] メニューで、プルするブランチを選択します。
  6. [New pull request] をクリックします。
  7. pull リクエストにタイトルと説明を付け、関連するファイルを添付します。

  8. [Create pull request] をクリックします。

    プルリクエスト ページに移動し、ここでレビュー担当者、ラベル、マイルストーン、割り当て先を追加できます。

pull リクエストの詳細を編集する

pull リクエストにレビュー担当者、ラベル、マイルストーン、割り当て先、期日を追加できます。

審査担当者、ラベル、マイルストーン、割り当て先を追加するには:

プルリクエスト ページで、編集する詳細情報の横にある 歯車のアイコン 歯車アイコンをクリックします。

編集内容は自動的に保存されます。

期限を更新するには:

  1. [期限] セクションのカレンダー アイコンをクリックして、日付を選択します。
  2. プラスアイコン プラスアイコンをクリックして、期日を保存します。

pull リクエストをレビューする

レビュー担当者は、コメントを追加したり、変更をリクエストしたり、pull リクエストを承認したりできます。

自分に割り当てられたプルリクエストを確認するには:

  1. Secure Source Manager ウェブ インターフェースで、[Pull requests] タブをクリックします。
  2. [自分に割り当てられた] をクリックします。

  3. 確認する pull リクエストをクリックします。

    [スレッド] ページが開きます。プルリクエストの作成者や他のレビュー担当者が残したコメントを表示できます。

  4. 変更されたファイルを表示してコメントするには、[Files changed] タブをクリックします。空白文字の表示、ビュー、差分オプションの動作を変更するには、[空白文字]、[分割ビュー] / [全体像]、[差分オプション] のプルダウン メニューをクリックします。

  5. コメントを残すには、コメントする行の横にあるプラスアイコンをクリックします。

  6. [審査を開始] をクリックします。

  7. コメントを追加するには、コメントを追加する行のプラスアイコンをクリックし、[コメントを追加] をクリックします。

    コメントではマークダウンによるスタイル設定がサポートされています。

  8. コメントを送信したり、pull リクエストを承認したり、変更をリクエストしたりするには、[レビュー] をクリックします。

  9. 変更内容をまとめたコメントを入力するか、コメント欄を空白のままにして、次のオプションから選択します。

    • 承認: 変更を承認します。
    • コメント: pull リクエストを承認せずにコメントを送信します。

    • 変更をリクエスト: pull リクエストの変更をリクエストします。

pull リクエストを統合する

  1. リポジトリ ページで、[Pull requests] タブをクリックします。
  2. 統合する pull リクエストを選択します。
  3. 競合がない場合は、[pull リクエストをマージ] をクリックします。

問題を表示

  1. Secure Source Manager ウェブ インターフェースで、リポジトリを選択します。
  2. リポジトリ ページで、[問題] タブをクリックします。
  3. [担当者]、[タイプ]、[並べ替え] の各メニューを使用して、問題をフィルタまたは並べ替えることができます。

問題を作成する

  1. Secure Source Manager ウェブ インターフェースで、リポジトリを選択します。
  2. リポジトリ ページで、[問題] タブをクリックします。
  3. [新しい問題] をクリックします。
  4. 問題のタイトルと説明を入力し、[Create Issue]（問題を作成）をクリックします。

  5. [Issue details] ページでは、ラベル、マイルストーン、割り当て先を割り当てたり、ブランチまたはタグを指定したりできます。

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]
```

Markdown エディタの [プレビュー] タブをクリックして、保存する前に図がレンダリングされることを確認します。

サポートされている図の種類

Secure Source Manager は、次の Mermaid 図のタイプをサポートしています。

  • フローチャート: graph または flowchart（TD、TB、LR、BT、RL をサポート）
  • シーケンス図: sequenceDiagram
  • クラス図: classDiagram
  • エンティティ関連図: erDiagram
  • 状態図: stateDiagram または stateDiagram-v2
  • XY チャート: xychart-beta または xychart

レンダリングの動作と制限事項

  • 静的レンダリング: 図が静止画像としてレンダリングされます。セキュリティ上の理由から、インタラクティブ機能（click コールバックやツールチップなど）と外部スクリプトは無効になっています。
  • テーマの適応: 図がライトモードとダークモードに自動的に適応します。
  • ユーザー補助機能: レンダリングされた図には、スクリーン リーダー用の図のソースコードが入力された代替テキストが含まれます。
  • サポートされていない図の種類: サポートされていない図の種類はエラー メッセージを表示し、レンダリングされません。これには、ガントチャート、マインドマップ、円グラフ、Gitgraph、ユーザー ジャーニー、要件、C4、タイムライン、サンキー、ブロック図が含まれます。サポートされていない図の種類については、図をローカルで画像（PNG または SVG）としてレンダリングし、標準の Markdown 画像構文を使用して埋め込みます。

次のステップ